@agent-workshop/adoc-plugin-kanban 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,5 @@
+Copyright (C) 2026 adoc contributors
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,49 @@
+# Third-party notices
+
+adoc's original code and documentation use the Zero-Clause BSD License (0BSD). That license does not replace the
+licenses of third-party components, and no third-party component is relicensed by this repository.
+
+## Browser distributions
+
+Two packages carry bundled browser code:
+
+- `@agent-workshop/adoc-webapp`: the web UI in `dist/`. Its build records the packages actually bundled in
+  `dist/licenses/packages.json` and copies their upstream LICENSE, COPYING, COPYRIGHT and NOTICE files beneath
+  `dist/licenses/`.
+- `@agent-workshop/adoc-plugin-sketch`: the drawing board in `client/`, with its inventory and license files in
+  `client/licenses/`.
+
+Keep these files when redistributing the built browser assets.
+
+The main browser dependencies are React, React DOM, React Router, Mermaid (with KaTeX), xterm.js and Lucide in the web
+UI, and Excalidraw with React and Radix UI in the drawing board. Most use MIT, ISC, BSD or Apache-2.0.
+
+- DOMPurify offers MPL-2.0 OR Apache-2.0; adoc uses the Apache-2.0 option.
+- Some packages are published without a license file although their manifest names one: Excalidraw, the Radix UI
+  primitives, react-remove-scroll-bar and fastdom (all MIT). The build includes the upstream texts kept in
+  `tooling/licenses/`.
+
+### Eclipse Layout Kernel / elkjs
+
+Mermaid bundles elkjs, a separately licensed layout engine, which adoc uses under EPL-2.0 without modifying it. Its
+license is included in the generated license inventory. Corresponding source is available from:
+
+- https://github.com/kieler/elkjs (select the release matching the inventory version)
+- https://github.com/eclipse/elk (the underlying Eclipse Layout Kernel)
+- https://www.eclipse.org/legal/epl-2.0/
+
+Recipients may obtain, modify and redistribute the EPL-covered source under EPL-2.0. adoc's 0BSD license applies to its
+independent code, not to ELK.
+
+## Fonts
+
+- The web UI serves Pretendard, D2Coding (both SIL Open Font License 1.1) and Symbols Nerd Font Mono; their license
+  files are next to them in `dist/assets/fonts/`.
+- The drawing board serves the fonts that Excalidraw ships in `client/fonts/` (Excalifont, Virgil, Nunito, Lilita One,
+  Comic Shanns, Cascadia Code, Liberation Sans, Assistant and Xiaolai); they are distributed under the terms that
+  Excalidraw states for them in https://github.com/excalidraw/excalidraw.
+
+## Installed runtime dependencies
+
+The packages that npm installs next to adoc, such as the MCP SDK, ws, yaml, zod, semver, commander, markdown-it and
+highlight.js, are not bundled: each keeps its own license in its own package.

package/dist/index.js

@@ -0,0 +1,51 @@
+import { action, anchor, definePlugin, dropTarget, html, markdown, parseYaml, source } from "@agent-workshop/adoc-plugin-kit";
+const HIDDEN = "REMOVE";
+function parse(doc) {
+  const data = parseYaml(doc.text) ?? {};
+  if (!Array.isArray(data.columns) || !data.columns.length) throw new Error("columns must be a non-empty list");
+  const cards = (data.cards ?? []).map((c) => ({ id: String(c.id), text: String(c.text ?? ""), column: String(c.column) }));
+  const lines = doc.text.split("\n");
+  const lineOf = (id) => lines.findIndex((l) => new RegExp(`^\\s*-\\s*id:\\s*['"]?${id}['"]?\\s*$`).test(l)) + 1;
+  return { title: data.title ?? doc.key, columns: data.columns.map(String), cards, lineOf };
+}
+var index_default = definePlugin({
+  description: "One screen of about ten cards in columns, to see where work stands.",
+  layout: { kind: "file", extension: ".yaml" },
+  summarize(doc) {
+    const { title, columns, cards } = parse(doc);
+    const shown = cards.filter((c) => c.column !== HIDDEN && columns.includes(c.column));
+    const fields = {};
+    for (const column of columns.filter((c) => c !== HIDDEN)) fields[column] = shown.filter((c) => c.column === column).length;
+    return { title, status: `${shown.length} cards`, fields };
+  },
+  render(doc) {
+    const { columns, cards, lineOf } = parse(doc);
+    const card = (c) => html`
+      <div class="adoc-card" ${anchor(c.id)} ${source(doc.file, lineOf(c.id))} ${action({ kind: "drag", name: "move", value: c.id })}>
+        <span class="adoc-muted">${c.id}</span> ${markdown(c.text, { inline: true })}
+      </div>`;
+    return html`
+      <div class="adoc-board">
+        ${columns.filter((col) => col !== HIDDEN).map(
+      (col) => html`
+              <div class="adoc-column" ${dropTarget("move", col)}>
+                <div class="adoc-column-title">${col} <span class="adoc-muted">${cards.filter((c) => c.column === col).length}</span></div>
+                ${cards.filter((c) => c.column === col).map(card)}
+              </div>`
+    )}
+      </div>
+      ${columns.includes(HIDDEN) ? html`<div class="adoc-trash" ${dropTarget("move", HIDDEN)}>Drop here to remove</div>` : ""}`;
+  },
+  actions: {
+    move(doc, event) {
+      const { cards } = parse(doc);
+      const card = cards.find((c) => c.id === event.value);
+      if (!card) throw new Error(`no card ${event.value}`);
+      if (card.column === event.to) return {};
+      return { message: `user request: move card ${card.id} "${card.text}": ${card.column} => ${event.to}` };
+    }
+  }
+});
+export {
+  index_default as default
+};

package/package.json

@@ -1,6 +1,39 @@
 {
   "name": "@agent-workshop/adoc-plugin-kanban",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "license": "0BSD",
+  "type": "module",
+  "description": "The KANBAN plugin of adoc: one board of about ten cards in columns.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dirty49374/adoc.git",
+    "directory": "plugins/kanban"
+  },
+  "files": [
+    "dist",
+    "skill",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  "peerDependencies": {
+    "@agent-workshop/adoc-plugin-kit": "^0.1.0"
+  },
+  "devDependencies": {
+    "esbuild": "0.28.2",
+    "@agent-workshop/adoc-plugin-kit": "0.1.0"
+  },
+  "scripts": {
+    "build": "esbuild index.ts --outfile=dist/index.js --format=esm --platform=node --log-level=warning"
+  }
 }

package/skill/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: adoc-kanban
+description: "KANBAN documents: one board of about ten cards in columns, to see where work stands. Use when the user wants an overview of work in progress, moves a card, or asks to add or remove cards."
+---
+
+# KANBAN documents
+
+Document keys look like `KANBAN-<local id>`. Read the general workflow with `adoc skill view adoc`.
+
+## Purpose
+
+A KANBAN board is one screen that shows where about ten pieces of work stand, so that the user sees the state of the work at a glance. It keeps no history; git does.
+
+## States and workflow
+
+- The columns are the states, in the order of `columns`, usually `TODO`, `RUNNING` and `DONE`. A column named `REMOVE` is not a state but a hidden drop target: a card dropped there is to be deleted, never left in it.
+- The user drags a card to another column in the web UI; that reaches you as a request, and you move the card in the file. Move or remove a card only when the user asks for it or agrees.
+
+## Instructions
+
+- Keep the board to about ten cards: when it has more, ask the user whether to remove DONE cards.
+- Keep each card one line; refer to the document that holds the details with `[[KEY]]`.
+- Ask the user in your conversation, not in the file: the view shows only the cards.
+- A board is independent: moving a card never changes the documents its text refers to, and changing those documents never moves a card. Update both only when the user asks for it.
+- Give a new card an id one higher than any id the board has had; never reuse the id of a removed card (look at the board's git history when the highest card was removed).
+
+## File
+
+`KANBAN-<local id>.yaml`:
+
+```yaml
+title: Sprint 12
+columns: [TODO, RUNNING, DONE, REMOVE]
+cards:
+  - id: c1
+    text: Paginate the order list [[TASK-260930-order-paging]]
+    column: RUNNING
+  - id: c2
+    text: Dark mode
+    column: DONE
+```
+
+- `columns` is the column order. A column named `REMOVE` is not shown; dropping a card on it asks for its removal.
+- Each card has a unique short `id` (`c1`, `c2`, …), a one-line `text` (may contain `[[KEY]]`) and its `column`, which must be one of `columns`; a card in another column is not shown.
+- Recommended local id: a topic, such as a project or a team: `KANBAN-adoc`, `KANBAN-sprint12`.
+
+## Anchors
+
+The anchor of a card is its `id`: `KANBAN-sprint12#c1`.
+
+## Actions
+
+| action | what adoc already did | what you do |
+|---|---|---|
+| `move` (drag a card), message `user request: move card c1 "…": RUNNING => DONE` | nothing (`applied: false`); no message when the card is already in that column | set that card's `column` to the new column; for `REMOVE`, delete the card from `cards` |

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.