@basementuniverse/kanbn 1.1.1 → 2.1.0

package/example/boards/.kanbn/tasks/add-usage-alert-emails.md

@@ -0,0 +1,19 @@
+---
+created: 2026-07-09T15:00:00.000Z
+tags:
+  - Medium
+---
+
+# Add Usage Alert Emails
+
+Warn an organisation by email when it crosses 80% and 100% of its plan's usage allowance.
+
+Engineering-only work, so it never reaches the design board.
+
+## History
+
+- type: created
+  date: 2026-07-09T15:00:00.000Z
+  column: Backlog
+  fromProgress: 0
+  toProgress: 0

package/example/boards/.kanbn/tasks/build-tenant-settings-page.md

@@ -0,0 +1,43 @@
+---
+created: 2026-07-02T09:15:00.000Z
+updated: 2026-07-14T11:30:00.000Z
+started: 2026-07-10T09:00:00.000Z
+designStartedAt: 2026-07-06T10:00:00.000Z
+assigned: priya
+tags:
+  - Medium
+---
+
+# Build Tenant Settings Page
+
+A single place for an organisation's owner to manage name, logo, timezone and default roles.
+
+This task is on both boards: `In Progress` on the engineering board and `Designing` on the design
+board. Its `started` date is the engineering start; `designStartedAt` is when design picked it up.
+
+## Sub-tasks
+
+- [x] Settings form layout
+- [ ] Logo upload and cropping
+- [ ] Role defaults
+
+## History
+
+- type: created
+  date: 2026-07-02T09:15:00.000Z
+  column: Backlog
+  fromProgress: 0
+  toProgress: 0
+- type: added
+  date: 2026-07-06T10:00:00.000Z
+  column: Ideas
+  board: design
+- type: moved
+  date: 2026-07-06T10:00:00.000Z
+  fromColumn: Ideas
+  toColumn: Designing
+  board: design
+- type: moved
+  date: 2026-07-10T09:00:00.000Z
+  fromColumn: Backlog
+  toColumn: 'In Progress'

package/example/boards/.kanbn/tasks/create-organization-switcher.md

@@ -0,0 +1,44 @@
+---
+created: 2026-07-03T14:00:00.000Z
+updated: 2026-07-12T16:45:00.000Z
+designStartedAt: 2026-07-05T09:30:00.000Z
+designSignedOffAt: 2026-07-12T16:45:00.000Z
+assigned: sam
+tags:
+  - Small
+---
+
+# Create Organization Switcher
+
+A dropdown for moving between the organisations a user belongs to, without signing out.
+
+Design has finished with this one - it sits in `Signed Off` on the design board - but engineering
+hasn't started it, so it's still in `Todo` on the main board. Because the design board reads
+`designSignedOffAt` rather than the shared `completed` field, finishing it here doesn't mark it done
+for engineering.
+
+## Sub-tasks
+
+- [ ] Switcher component
+- [ ] Persist last-used organisation
+
+## History
+
+- type: created
+  date: 2026-07-03T14:00:00.000Z
+  column: Backlog
+  fromProgress: 0
+  toProgress: 0
+- type: added
+  date: 2026-07-05T09:30:00.000Z
+  column: Designing
+  board: design
+- type: moved
+  date: 2026-07-08T10:00:00.000Z
+  fromColumn: Backlog
+  toColumn: Todo
+- type: moved
+  date: 2026-07-12T16:45:00.000Z
+  fromColumn: Designing
+  toColumn: 'Signed Off'
+  board: design

package/example/boards/.kanbn/tasks/design-onboarding-checklist.md

@@ -0,0 +1,22 @@
+---
+created: 2026-07-11T13:20:00.000Z
+assigned: priya
+tags:
+  - Small
+---
+
+# Design Onboarding Checklist
+
+An in-product checklist walking a new organisation through its first week.
+
+This one is only on the design board - engineering hasn't picked it up, so it isn't on the main
+board at all. `kanbn status --untracked` would not list it: it is tracked, just not here.
+
+## History
+
+- type: created
+  date: 2026-07-11T13:20:00.000Z
+  column: Ideas
+  board: design
+  fromProgress: 0
+  toProgress: 0

package/example/boards/.kanbn/tasks/refresh-marketing-site.md

@@ -0,0 +1,28 @@
+---
+created: 2026-07-05T08:00:00.000Z
+updated: 2026-07-13T09:00:00.000Z
+designStartedAt: 2026-07-13T09:00:00.000Z
+assigned: priya
+tags:
+  - Large
+---
+
+# Refresh Marketing Site
+
+New landing page, pricing page and case studies, ahead of the autumn launch.
+
+Design has started, engineering hasn't - `Designing` on the design board, `Backlog` on the main one.
+This is the shape that makes per-board state fields worth having: the task genuinely is in flight on
+one board and untouched on the other.
+
+## History
+
+- type: created
+  date: 2026-07-05T08:00:00.000Z
+  column: Backlog
+  fromProgress: 0
+  toProgress: 0
+- type: added
+  date: 2026-07-13T09:00:00.000Z
+  column: Designing
+  board: design

package/example/boards/.kanbn/tasks/ship-billing-portal.md

@@ -0,0 +1,29 @@
+---
+created: 2026-06-24T10:00:00.000Z
+updated: 2026-07-07T17:10:00.000Z
+started: 2026-06-26T09:00:00.000Z
+completed: 2026-07-07T17:10:00.000Z
+assigned: sam
+tags:
+  - Large
+---
+
+# Ship Billing Portal
+
+Self-serve plan changes, payment method updates and invoice history.
+
+## History
+
+- type: created
+  date: 2026-06-24T10:00:00.000Z
+  column: Backlog
+  fromProgress: 0
+  toProgress: 0
+- type: moved
+  date: 2026-06-26T09:00:00.000Z
+  fromColumn: Backlog
+  toColumn: 'In Progress'
+- type: moved
+  date: 2026-07-07T17:10:00.000Z
+  fromColumn: 'In Progress'
+  toColumn: Done

package/example/views/.kanbn/index.md

@@ -0,0 +1,140 @@
+---
+startedColumns:
+  - 'In Progress'
+completedColumns:
+  - Done
+hiddenColumns:
+  - Icebox
+taskWorkloadTags:
+  Tiny: 1
+  Small: 2
+  Medium: 3
+  Large: 5
+  Huge: 8
+views:
+
+  # The index columns, spelled out explicitly. Note that a view column with no
+  # filters would show *every* task, not the tasks in a column of that name.
+  - name: 'default'
+    columns:
+      - name: 'Backlog'
+        filters:
+          column: 'Backlog'
+      - name: 'In Progress'
+        filters:
+          column: 'In Progress'
+      - name: 'Done'
+        filters:
+          column: 'Done'
+
+  # The same columns, grouped into one lane per assignee.
+  # Lane filters are merged over each column's filters.
+  - name: 'by-assignee'
+    columns:
+      - name: 'Backlog'
+        filters:
+          column: 'Backlog'
+      - name: 'In Progress'
+        filters:
+          column: 'In Progress'
+      - name: 'Done'
+        filters:
+          column: 'Done'
+    lanes:
+      - name: 'Ana'
+        filters:
+          assigned: '^Ana$'
+      - name: 'Ben'
+        filters:
+          assigned: '^Ben$'
+      - name: 'Unassigned'
+        filters:
+          assigned: '^$'
+
+  # A root filter narrows the whole view to bugs before columns are built.
+  # The second column has no filters, so within this view it shows all bugs.
+  - name: 'triage'
+    filters:
+      tag: Bug
+    columns:
+      - name: 'Due before Aug 2026'
+        filters:
+          due:
+            - 2020-01-01
+            - 2026-08-01
+        sorters:
+          - field: workload
+            order: descending
+      - name: 'All bugs'
+        sorters:
+          - field: name
+            order: ascending
+
+  # Columns and lanes don't have to correspond to index columns at all.
+  - name: 'workload'
+    columns:
+      - name: 'Small (1-2)'
+        filters:
+          workload:
+            - 1
+            - 2
+      - name: 'Medium (3-5)'
+        filters:
+          workload:
+            - 3
+            - 5
+      - name: 'Large (6+)'
+        filters:
+          workload:
+            - 6
+            - 99
+    lanes:
+      - name: 'Not started'
+        filters:
+          column: 'Backlog'
+      - name: 'Started'
+        filters:
+          column: 'In Progress'
+
+  # A view that defines its own columns ignores hiddenColumns, so this one
+  # also shows tasks in the hidden Icebox column.
+  - name: 'everything'
+    columns:
+      - name: 'All tasks (including Icebox)'
+        sorters:
+          - field: column
+            order: ascending
+          - field: name
+            order: ascending
+---
+
+# Views Example
+
+A small board used to demonstrate views, lanes, filters and sorters. Try:
+
+- `kanbn board`
+- `kanbn board -v default`
+- `kanbn board -v by-assignee`
+- `kanbn board -v triage`
+- `kanbn board -v workload`
+- `kanbn board -v everything`
+
+## Backlog
+
+- [add-audit-log-export](tasks/add-audit-log-export.md)
+- [fix-avatar-upload-crash](tasks/fix-avatar-upload-crash.md)
+- [rewrite-search-indexer](tasks/rewrite-search-indexer.md)
+- [tidy-up-settings-copy](tasks/tidy-up-settings-copy.md)
+
+## In Progress
+
+- [fix-expired-session-redirect](tasks/fix-expired-session-redirect.md)
+- [build-webhook-retry-queue](tasks/build-webhook-retry-queue.md)
+
+## Done
+
+- [add-dark-mode-toggle](tasks/add-dark-mode-toggle.md)
+
+## Icebox
+
+- [investigate-offline-mode](tasks/investigate-offline-mode.md)

package/example/views/.kanbn/tasks/add-audit-log-export.md

@@ -0,0 +1,18 @@
+---
+created: 2026-07-02T09:00:00.000Z
+updated: 2026-07-02T09:00:00.000Z
+assigned: Ana
+due: 2026-09-30T17:00:00.000Z
+tags:
+  - Feature
+  - Medium
+---
+
+# Add Audit Log Export
+
+Let admins download an audit log as CSV.
+
+## Sub-tasks
+
+- [ ] Add an export endpoint
+- [ ] Add a download button to the audit log page

package/example/views/.kanbn/tasks/add-dark-mode-toggle.md

@@ -0,0 +1,16 @@
+---
+created: 2026-06-20T09:00:00.000Z
+updated: 2026-07-01T09:00:00.000Z
+started: 2026-06-22T09:00:00.000Z
+completed: 2026-07-01T09:00:00.000Z
+assigned: Ana
+progress: 1
+due: 2026-07-01T17:00:00.000Z
+tags:
+  - Feature
+  - Small
+---
+
+# Add Dark Mode Toggle
+
+Add a dark mode toggle to the account menu.

package/example/views/.kanbn/tasks/build-webhook-retry-queue.md

@@ -0,0 +1,15 @@
+---
+created: 2026-07-07T09:00:00.000Z
+updated: 2026-07-14T09:00:00.000Z
+started: 2026-07-11T09:00:00.000Z
+assigned: Ben
+progress: 0.3
+due: 2026-10-01T17:00:00.000Z
+tags:
+  - Feature
+  - Large
+---
+
+# Build Webhook Retry Queue
+
+Retry failed webhook deliveries with exponential backoff.

package/example/views/.kanbn/tasks/fix-avatar-upload-crash.md

@@ -0,0 +1,13 @@
+---
+created: 2026-07-03T09:00:00.000Z
+updated: 2026-07-03T09:00:00.000Z
+assigned: Ben
+due: 2026-07-20T17:00:00.000Z
+tags:
+  - Bug
+  - Small
+---
+
+# Fix Avatar Upload Crash
+
+Uploading a PNG larger than 5MB crashes the avatar cropper.

package/example/views/.kanbn/tasks/fix-expired-session-redirect.md

@@ -0,0 +1,15 @@
+---
+created: 2026-07-06T09:00:00.000Z
+updated: 2026-07-12T09:00:00.000Z
+started: 2026-07-10T09:00:00.000Z
+assigned: Ana
+progress: 0.5
+due: 2026-07-25T17:00:00.000Z
+tags:
+  - Bug
+  - Medium
+---
+
+# Fix Expired Session Redirect
+
+Expired sessions redirect to the dashboard instead of the login page.

package/example/views/.kanbn/tasks/investigate-offline-mode.md

@@ -0,0 +1,12 @@
+---
+created: 2026-05-01T09:00:00.000Z
+updated: 2026-05-01T09:00:00.000Z
+due: 2027-01-01T17:00:00.000Z
+tags:
+  - Feature
+  - Huge
+---
+
+# Investigate Offline Mode
+
+Parked until after the search rewrite.

package/example/views/.kanbn/tasks/rewrite-search-indexer.md

@@ -0,0 +1,12 @@
+---
+created: 2026-07-04T09:00:00.000Z
+updated: 2026-07-04T09:00:00.000Z
+due: 2026-11-30T17:00:00.000Z
+tags:
+  - Feature
+  - Huge
+---
+
+# Rewrite Search Indexer
+
+Replace the nightly re-index with an incremental indexer.

package/example/views/.kanbn/tasks/tidy-up-settings-copy.md

@@ -0,0 +1,12 @@
+---
+created: 2026-07-05T09:00:00.000Z
+updated: 2026-07-05T09:00:00.000Z
+due: 2026-10-15T17:00:00.000Z
+tags:
+  - Chore
+  - Tiny
+---
+
+# Tidy Up Settings Copy
+
+Fix inconsistent capitalisation across the settings pages.

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@basementuniverse/kanbn",
-  "version": "1.1.1",
+  "version": "2.1.0",
   "description": "A CLI Kanban application",
   "main": "index.js",
   "scripts": {
-    "test": "KANBN_ENV=test qunit ./test/**/*.test.js"
+    "test": "KANBN_ENV=test qunit ./test/**/*.test.js",
+    "coverage": "KANBN_ENV=test c8 --reporter=text --reporter=html --include=src/** --include=index.js qunit ./test/**/*.test.js"
   },
   "preferGlobal": true,
   "bin": {
@@ -17,7 +18,7 @@
     "url": "git+https://github.com/basementuniverse/kanbn.git"
   },
   "engines": {
-    "node": ">=12.0.0"
+    "node": ">=16.13.0"
   },
   "keywords": [
     "kanbn",
@@ -37,7 +38,6 @@
     "dotenv": "^8.2.0",
     "front-matter": "^4.0.2",
     "fuzzy": "^0.1.3",
-    "git-user-name": "^2.0.0",
     "glob-promise": "^3.4.0",
     "humanize-duration": "^3.25.0",
     "inquirer": "^7.3.3",
@@ -46,24 +46,27 @@
     "inquirer-recursive": "github:basementuniverse/inquirer-recursive",
     "inquirer-select-line": "github:basementuniverse/inquirer-select-line",
     "jsonschema": "^1.4.0",
-    "marked": "^1.2.7",
-    "marked-terminal": "^4.1.1",
-    "minimist": "^1.2.5",
+    "marked": "^4.3.0",
+    "marked-terminal": "^5.2.0",
+    "minimist": "^1.2.8",
     "rimraf": "^3.0.2",
-    "terminal-kit": "^1.44.0",
+    "terminal-kit": "^3.1.4",
     "yamljs": "^0.3.0"
   },
   "devDependencies": {
     "@types/typescript": "^2.0.0",
+    "c8": "^12.0.0",
     "capture-console": "^1.0.1",
     "faker": "^5.1.0",
     "mock-argv": "^1.1.10",
-    "mock-fs": "^4.13.0",
     "mock-require": "^3.0.3",
     "mock-stdin": "^1.0.0",
     "mockdate": "^3.0.2",
     "qunit": "^2.13.0",
     "strip-ansi": "^6.0.0",
     "typescript": "^4.9.3"
+  },
+  "overrides": {
+    "tmp": "^0.2.7"
   }
 }

package/routes/add.json

@@ -18,19 +18,43 @@
       "due",
       "plannedStart",
       "plannedFinish",
-      "progress"
+      "progress",
+      "board"
     ],
     "alias": {
-      "interactive": ["i"],
-      "name": ["n"],
-      "description": ["d"],
-      "column": ["c"],
-      "sub-task": ["s"],
-      "tag": ["t"],
-      "relation": ["r"],
-      "due": ["e"],
-      "assigned": ["a"],
-      "untracked": ["u"]
+      "interactive": [
+        "i"
+      ],
+      "name": [
+        "n"
+      ],
+      "description": [
+        "d"
+      ],
+      "column": [
+        "c"
+      ],
+      "sub-task": [
+        "s"
+      ],
+      "tag": [
+        "t"
+      ],
+      "relation": [
+        "r"
+      ],
+      "due": [
+        "e"
+      ],
+      "assigned": [
+        "a"
+      ],
+      "untracked": [
+        "u"
+      ],
+      "board": [
+        "b"
+      ]
     }
   },
   "controller": "./src/controller/add",

package/routes/archive.json

@@ -9,8 +9,16 @@
       "list"
     ],
     "alias": {
-      "list": ["l"]
-    }
+      "list": [
+        "l"
+      ],
+      "board": [
+        "b"
+      ]
+    },
+    "string": [
+      "board"
+    ]
   },
   "controller": "./src/controller/archive",
   "help": "./docs/commands/archive.txt"

package/routes/board.json

@@ -9,11 +9,19 @@
       "json"
     ],
     "string": [
-      "view"
+      "view",
+      "board"
     ],
     "alias": {
-      "view": ["v"],
-      "json": ["j"]
+      "view": [
+        "v"
+      ],
+      "json": [
+        "j"
+      ],
+      "board": [
+        "b"
+      ]
     }
   },
   "controller": "./src/controller/board",

package/routes/boards.json

@@ -0,0 +1,30 @@
+{
+  "name": "Boards",
+  "commands": [
+    "boards"
+  ],
+  "args": {
+    "boolean": [
+      "json",
+      "tasks",
+      "all",
+      "force"
+    ],
+    "string": [
+      "rename",
+      "delete",
+      "name"
+    ],
+    "alias": {
+      "json": ["j"],
+      "tasks": ["t"],
+      "all": ["a"],
+      "force": ["f"],
+      "rename": ["r"],
+      "delete": ["d"],
+      "name": ["n"]
+    }
+  },
+  "controller": "./src/controller/boards",
+  "help": "./docs/commands/boards.txt"
+}

package/routes/burndown.json

@@ -13,15 +13,31 @@
       "sprint",
       "assigned",
       "column",
-      "normalise"
+      "normalise",
+      "board"
     ],
     "alias": {
-      "json": ["j"],
-      "date": ["d"],
-      "sprint": ["p"],
-      "assigned": ["a"],
-      "column": ["c"],
-      "normalise": ["n"]
+      "json": [
+        "j"
+      ],
+      "date": [
+        "d"
+      ],
+      "sprint": [
+        "p"
+      ],
+      "assigned": [
+        "a"
+      ],
+      "column": [
+        "c"
+      ],
+      "normalise": [
+        "n"
+      ],
+      "board": [
+        "b"
+      ]
     }
   },
   "controller": "./src/controller/burndown",