@basementuniverse/kanbn 1.1.1 → 2.1.0

package/routes/comment.json

@@ -9,12 +9,22 @@
       "interactive"
     ],
     "string": [
-      "text"
+      "text",
+      "board"
     ],
     "alias": {
-      "interactive": ["i"],
-      "author": ["a"],
-      "text": ["t"]
+      "interactive": [
+        "i"
+      ],
+      "author": [
+        "a"
+      ],
+      "text": [
+        "t"
+      ],
+      "board": [
+        "b"
+      ]
     }
   },
   "controller": "./src/controller/comment",

package/routes/edit.json

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

package/routes/find.json

@@ -8,7 +8,8 @@
     "boolean": [
       "interactive",
       "quiet",
-      "json"
+      "json",
+      "all-boards"
     ],
     "string": [
       "id",
@@ -32,19 +33,43 @@
       "plannedFinish",
       "workload",
       "progress",
-      "assigned"
+      "assigned",
+      "board"
     ],
     "alias": {
-      "interactive": ["i"],
-      "name": ["n"],
-      "description": ["d"],
-      "column": ["c"],
-      "quiet": ["q"],
-      "due": ["e"],
-      "sub-task": ["s"],
-      "tag": ["t"],
-      "relation": ["r"],
-      "json": ["j"]
+      "interactive": [
+        "i"
+      ],
+      "name": [
+        "n"
+      ],
+      "description": [
+        "d"
+      ],
+      "column": [
+        "c"
+      ],
+      "quiet": [
+        "q"
+      ],
+      "due": [
+        "e"
+      ],
+      "sub-task": [
+        "s"
+      ],
+      "tag": [
+        "t"
+      ],
+      "relation": [
+        "r"
+      ],
+      "json": [
+        "j"
+      ],
+      "board": [
+        "b"
+      ]
     }
   },
   "controller": "./src/controller/find",

package/routes/gantt.json

@@ -12,14 +12,28 @@
       "assigned",
       "column",
       "date",
-      "now"
+      "now",
+      "board"
     ],
     "alias": {
-      "json": ["j"],
-      "assigned": ["a"],
-      "column": ["c"],
-      "date": ["d"],
-      "now": ["n"]
+      "json": [
+        "j"
+      ],
+      "assigned": [
+        "a"
+      ],
+      "column": [
+        "c"
+      ],
+      "date": [
+        "d"
+      ],
+      "now": [
+        "n"
+      ],
+      "board": [
+        "b"
+      ]
     }
   },
   "controller": "./src/controller/gantt",

package/routes/history.json

@@ -1,27 +1,41 @@
 {
-	"name": "Task History",
-	"commands": [
-		"history",
-		"hi"
-	],
-	"args": {
-		"boolean": [
-			"json"
-		],
-		"string": [
-			"date",
-			"sprint",
-			"assigned",
-			"task"
-		],
-		"alias": {
-			"json": ["j"],
-			"date": ["d"],
-			"sprint": ["p"],
-			"assigned": ["a"],
-			"task": ["t"]
-		}
-	},
-	"controller": "./src/controller/history",
-	"help": "./docs/commands/history.txt"
+  "name": "Task History",
+  "commands": [
+    "history",
+    "hi"
+  ],
+  "args": {
+    "boolean": [
+      "json"
+    ],
+    "string": [
+      "date",
+      "sprint",
+      "assigned",
+      "task",
+      "board"
+    ],
+    "alias": {
+      "json": [
+        "j"
+      ],
+      "date": [
+        "d"
+      ],
+      "sprint": [
+        "p"
+      ],
+      "assigned": [
+        "a"
+      ],
+      "task": [
+        "t"
+      ],
+      "board": [
+        "b"
+      ]
+    }
+  },
+  "controller": "./src/controller/history",
+  "help": "./docs/commands/history.txt"
 }

package/routes/init.json

@@ -8,7 +8,8 @@
     "string": [
       "name",
       "description",
-      "column"
+      "column",
+      "board"
     ],
     "boolean": [
       "interactive"
@@ -17,6 +18,7 @@
       "name": ["n"],
       "description": ["d"],
       "column": ["c"],
+      "board": ["b"],
       "interactive": ["i"]
     }
   },

package/routes/move.json

@@ -7,17 +7,33 @@
   "args": {
     "boolean": [
       "interactive",
-      "relative"
+      "relative",
+      "add"
     ],
     "string": [
       "column",
-      "position"
+      "position",
+      "board"
     ],
     "alias": {
-      "interactive": ["i"],
-      "column": ["c"],
-      "position": ["p"],
-      "relative": ["r"]
+      "interactive": [
+        "i"
+      ],
+      "column": [
+        "c"
+      ],
+      "position": [
+        "p"
+      ],
+      "relative": [
+        "r"
+      ],
+      "board": [
+        "b"
+      ]
+    },
+    "default": {
+      "add": true
     }
   },
   "controller": "./src/controller/move",

package/routes/remove.json

@@ -7,12 +7,23 @@
   "args": {
     "boolean": [
       "force",
-      "index"
+      "index",
+      "all-boards"
     ],
     "alias": {
-      "force": ["f"],
-      "index": ["x"]
-    }
+      "force": [
+        "f"
+      ],
+      "index": [
+        "x"
+      ],
+      "board": [
+        "b"
+      ]
+    },
+    "string": [
+      "board"
+    ]
   },
   "controller": "./src/controller/remove",
   "help": "./docs/commands/remove.txt"

package/routes/rename.json

@@ -9,11 +9,19 @@
       "interactive"
     ],
     "string": [
-      "name"
+      "name",
+      "board"
     ],
     "alias": {
-      "interactive": ["i"],
-      "name": ["n"]
+      "interactive": [
+        "i"
+      ],
+      "name": [
+        "n"
+      ],
+      "board": [
+        "b"
+      ]
     }
   },
   "controller": "./src/controller/rename",

package/routes/restore.json

@@ -6,10 +6,16 @@
   ],
   "args": {
     "string": [
-      "column"
+      "column",
+      "board"
     ],
     "alias": {
-      "column": ["c"]
+      "column": [
+        "c"
+      ],
+      "board": [
+        "b"
+      ]
     }
   },
   "controller": "./src/controller/restore",

package/routes/sort.json

@@ -31,19 +31,43 @@
       "plannedFinish",
       "workload",
       "progress",
-      "assigned"
+      "assigned",
+      "board"
     ],
     "alias": {
-      "interactive": ["i"],
-      "name": ["n"],
-      "description": ["d"],
-      "sub-task": ["s"],
-      "tag": ["t"],
-      "relation": ["r"],
-      "due": ["e"],
-      "workload": ["w"],
-      "ascending": ["a"],
-      "descending": ["z"]
+      "interactive": [
+        "i"
+      ],
+      "name": [
+        "n"
+      ],
+      "description": [
+        "d"
+      ],
+      "sub-task": [
+        "s"
+      ],
+      "tag": [
+        "t"
+      ],
+      "relation": [
+        "r"
+      ],
+      "due": [
+        "e"
+      ],
+      "workload": [
+        "w"
+      ],
+      "ascending": [
+        "a"
+      ],
+      "descending": [
+        "z"
+      ],
+      "board": [
+        "b"
+      ]
     }
   },
   "controller": "./src/controller/sort",

package/routes/sprint.json

@@ -10,12 +10,22 @@
     ],
     "string": [
       "name",
-      "description"
+      "description",
+      "board"
     ],
     "alias": {
-      "interactive": ["i"],
-      "name": ["n"],
-      "description": ["d"]
+      "interactive": [
+        "i"
+      ],
+      "name": [
+        "n"
+      ],
+      "description": [
+        "d"
+      ],
+      "board": [
+        "b"
+      ]
     }
   },
   "controller": "./src/controller/sprint",

package/routes/status.json

@@ -13,15 +13,31 @@
     ],
     "string": [
       "sprint",
-      "date"
+      "date",
+      "board"
     ],
     "alias": {
-      "untracked": ["u"],
-      "quiet": ["q"],
-      "json": ["j"],
-      "due": ["e"],
-      "sprint": ["p"],
-      "date": ["d"]
+      "untracked": [
+        "u"
+      ],
+      "quiet": [
+        "q"
+      ],
+      "json": [
+        "j"
+      ],
+      "due": [
+        "e"
+      ],
+      "sprint": [
+        "p"
+      ],
+      "date": [
+        "d"
+      ],
+      "board": [
+        "b"
+      ]
     }
   },
   "controller": "./src/controller/status",

package/routes/task.json

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

package/routes/validate.json

@@ -6,12 +6,27 @@
   "args": {
     "boolean": [
       "json",
-      "save"
+      "save",
+      "fix",
+      "all-boards"
     ],
     "alias": {
-      "json": ["j"],
-      "save": ["s"]
-    }
+      "json": [
+        "j"
+      ],
+      "save": [
+        "s"
+      ],
+      "fix": [
+        "f"
+      ],
+      "board": [
+        "b"
+      ]
+    },
+    "string": [
+      "board"
+    ]
   },
   "controller": "./src/controller/validate",
   "help": "./docs/commands/validate.txt"

package/skills/kanbn-plan/SKILL.md

@@ -13,9 +13,18 @@ Do not use this skill to implement the project, edit source code, scaffold files
 
 Your output must stay inside the Kanbn planning surface:
 
-- `.kanbn/index.md`
+- `.kanbn/index.md` — the main board
+- `.kanbn/{board-slug}.md` — any secondary boards, in exactly the same format as the index
 - `.kanbn/tasks/*.md`
 
+A workspace may hold several boards over one shared pool of tasks. Every board file is a sibling of
+`index.md` inside `.kanbn/`, and boards own membership: a task can be referenced by several boards,
+in a different column on each. Task files never record which boards they belong to.
+
+Unless the user asks for more than one board, plan onto `.kanbn/index.md` alone. When they do want
+several, write each board file yourself in the same format, and make sure any task referenced by a
+board has a file in `.kanbn/tasks/`.
+
 Do not create application code, tests, CI files, or documentation unrelated to the Kanbn board.
 
 If the user asks for planning plus implementation, complete the planning portion in Kanbn format first and keep the planning files cleanly separated from any later work.

package/skills/kanbn-plan/references/index-structure.md

@@ -38,6 +38,7 @@ Short project summary and planning assumptions.
 - After the description, each level-2 heading defines a column.
 - Each column should contain a markdown list of task links.
 - Each task link should point to `tasks/<task-id>.md`.
+- A task placed in a column listed in `startedColumns` or `completedColumns` should carry the matching `started` / `completed` date in its metadata. Kanbn reads task state from those dates, not from the column.
 - The link text should be the task id, not the human-readable title.
 
 ## Recommended Defaults

package/skills/kanbn-plan/references/task-structure.md

@@ -106,6 +106,8 @@ Usually omit:
 
 Add metadata only when the user supplied it or when the board already relies on it.
 
+The one exception is a task you place in a started or completed column. Kanbn decides whether a task has started or been completed from its `started` and `completed` dates, not from the column it is in, so a task placed in `In Progress` or `Done` without those dates will be reported as drifted and will be missing from burndown charts. If you place a task in one of those columns because the user told you the work is already underway or finished, write the matching date. If you don't know when it happened, leave the task in a column that doesn't imply state.
+
 Good uses of metadata:
 
 - `tags` for epics, teams, domains, or sizing labels

package/skills/kanbn-replan/SKILL.md

@@ -13,9 +13,14 @@ Do not use this skill to redesign scope, rewrite completed tasks, or invent new
 
 Your output must stay inside the Kanbn task surface:
 
-- `.kanbn/index.md`
+- `.kanbn/index.md` — the main board
+- `.kanbn/{board-slug}.md` — any secondary boards, in exactly the same format as the index
 - `.kanbn/tasks/*.md`
 
+A workspace may hold several boards over one shared pool of tasks. Rescheduling changes task
+metadata dates, which are shared, so it applies to every board at once — you do not need to touch
+board files unless a task's column changes.
+
 You may read the current board and gantt output, but the end result should be a revised schedule for existing tasks, not a new plan.
 
 Do not modify completed tasks unless the user explicitly asks to reopen them. Leave completed task descriptions, relations, and completion history intact.

package/src/board.js

@@ -35,6 +35,7 @@ module.exports = (() => {
       started: 'started' in task.metadata ? formatDate(task.metadata.started, dateFormat) : '',
       completed: 'completed' in task.metadata ? formatDate(task.metadata.completed, dateFormat) : '',
       due: 'due' in task.metadata ? formatDate(task.metadata.due, dateFormat) : '',
+      assigned: 'assigned' in task.metadata ? task.metadata.assigned : '',
       tags: 'tags' in task.metadata ? task.metadata.tags : [],
       subTasks: task.subTasks,
       relations: task.relations,
@@ -177,7 +178,7 @@ module.exports = (() => {
           borderChars: 'lightRounded',
           borderAttr: { color: 'grey' },
           textAttr: { color: 'white', bgColor: 'default' },
-          width: term.width,
+          width: utility.terminalWidth(term.width),
           fit: true
         }
       );