@agent-workshop/adoc-plugin-task 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,47 @@
+import { anchor, definePlugin, frontmatter, html, markdown, ref, slug, source } from "@agent-workshop/adoc-plugin-kit";
+function parse(doc) {
+  const { data, body, bodyLine } = frontmatter(doc.text);
+  const lines = body.split("\n");
+  const intro = [];
+  const sections = [];
+  lines.forEach((l, i) => {
+    const m = /^## (.+)$/.exec(l);
+    if (m) sections.push({ heading: m[1].trim(), anchor: slug(m[1]), line: bodyLine + i, body: "", bodyLine: bodyLine + i + 1 });
+    else if (sections.length) sections[sections.length - 1].body += l + "\n";
+    else intro.push(l);
+  });
+  const title = String(data.title ?? lines.find((l) => l.startsWith("# "))?.slice(2) ?? doc.key);
+  return { data, title, status: String(data.status ?? "TODO"), intro: intro.filter((l) => !l.startsWith("# ")).join("\n"), bodyLine, sections };
+}
+var index_default = definePlugin({
+  description: "A detailed work order: front matter with title and status, and ## sections.",
+  layout: { kind: "file", extension: ".md" },
+  summarize(doc) {
+    const { data, title, status, sections } = parse(doc);
+    const fields = { sections: sections.length };
+    if (data.assignee) fields.assignee = String(data.assignee);
+    if (Array.isArray(data.notes)) fields.notes = data.notes.join(", ");
+    if (Array.isArray(data.related)) fields.related = data.related.join(", ");
+    return { title, status, fields };
+  },
+  render(doc) {
+    const { data, intro, bodyLine, sections } = parse(doc);
+    return html`
+      <div class="adoc-toolbar">
+        ${data.assignee ? html`<span class="adoc-muted">assignee: ${String(data.assignee)}</span>` : ""}
+        ${Array.isArray(data.notes) ? html`<span class="adoc-muted">notes: ${data.notes.map((k, i) => html`${i ? ", " : ""}${ref(String(k))}`)}</span>` : ""}
+        ${Array.isArray(data.related) ? html`<span class="adoc-muted">related: ${data.related.map((k, i) => html`${i ? ", " : ""}${ref(String(k))}`)}</span>` : ""}
+      </div>
+      ${intro.trim() ? markdown(intro, { file: doc.file, line: bodyLine }) : ""}
+      ${sections.map(
+      (s) => html`
+          <section class="adoc-section" ${anchor(s.anchor)}>
+            <h2 ${source(doc.file, s.line)}>${s.heading}</h2>
+            ${markdown(s.body, { file: doc.file, line: s.bodyLine })}
+          </section>`
+    )}`;
+  }
+});
+export {
+  index_default as default
+};

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@agent-workshop/adoc-plugin-task",
+  "version": "0.1.0",
+  "license": "0BSD",
+  "type": "module",
+  "description": "The TASK plugin of adoc: work orders that go from TODO through RUNNING and REVIEW to DONE.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dirty49374/adoc.git",
+    "directory": "plugins/task"
+  },
+  "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,73 @@
+---
+name: adoc-task
+description: "TASK documents: detailed work orders with front matter and ## sections that go from TODO through RUNNING and REVIEW to DONE. Use when work needs a design and a plan before it is done, when finishing work for review, or when the user reviews, approves or archives tasks."
+---
+
+# TASK documents
+
+Document keys look like `TASK-<local id>`. Read the general workflow with `adoc skill view adoc`.
+
+## Purpose
+
+A TASK is the work order for one piece of work that needs a design and a plan: what it achieves, how, and when it counts as done, with a log of what happened. It lets the user agree on the work before it starts and review it when it ends.
+
+## States and workflow
+
+`TODO` → `RUNNING` → `REVIEW` → `DONE`, then archived.
+
+- Write the TASK and agree on it with the user before you start; it usually comes from a NOTE.
+- Set `RUNNING` when you start (a step to commit, see the adoc skill), and log progress in `## Log`.
+- When you finish, set `REVIEW`. **Only the user decides that a task is DONE:** when they approve it, you set `status: DONE`.
+- **Keep the user told.** While any TASK has `status: REVIEW`, end every report to the user in the conversation (after finishing a piece of work, when you go idle) with one line listing those TASKs in the order of `adoc document list --plugin TASK` (the most recently changed first; pick the REVIEW ones yourself): at most three keys, then the number of the others, if any: `Tasks to review: TASK-a, TASK-b, TASK-c and 4 more`.
+- **When the user says they will review:** open the first one of that order with `adoc ui open <KEY>`, say in one or two sentences what it delivered and what to look at, and wait. When they approve it, set `status: DONE`, commit, and open the next one. When they ask for changes, make them and keep the task in REVIEW. Stop when none is left or the user stops.
+- **When ten or more TASKs are DONE** (not archived), ask the user whether to archive them, at most once per session. If they agree, archive each, and the NOTEs listed in their `notes:` unless a task that stays lists them too; run `adoc check` and commit.
+
+## Instructions
+
+- When a task comes from one or more NOTEs, always list them in `notes:`, so that the task can be traced back to the discussion.
+- Keep `## Done when` checkable: concrete results the user can verify. Check an item when you have verified it, and log how.
+- Log facts in `## Log` with dates: what changed, what was checked and how, and what was not checked.
+- To split a task, create a new TASK and link both with `[[KEY]]`.
+- When the user asks for a status change the work does not allow yet, such as DONE while `## Done when` items are open, keep the status, say why in your conversation, and ask whether to drop those items.
+
+## File
+
+`TASK-<local id>.md`: YAML front matter, then Markdown with `##` sections.
+
+```markdown
+---
+title: Paginate the order list
+status: RUNNING          # TODO | RUNNING | REVIEW | DONE
+assignee: adoc-dev
+notes: [NOTE-260929-order-list-speed]
+related: [TODO-gui]
+---
+
+## Goal
+
+Order list loads in under 200 ms with 10k orders.
+
+## Method
+
+1. Replace `findAll()` with `findPage(cursor, limit)`.
+
+## Done when
+
+- [ ] p95 under 200 ms
+
+## Log
+
+- 2026-09-30: step 1 done.
+```
+
+- `title` and `status` are expected; `assignee` (who works on it, such as the agent's name), `notes` and `related` are optional and appear in tooltips. `notes` and `related` are YAML lists of document keys, even for one key: `notes: [NOTE-x]`.
+- Write `[[KEY]]` in the body to refer to another document.
+- Recommended local id: today's date (yymmdd) and a title, such as `TASK-260930-order-paging`.
+
+## Anchors
+
+The anchor of a section is its heading in lowercase, with every run of other characters than letters and digits turned into one hyphen: `## Done when` is `TASK-…#done-when`.
+
+## Actions
+
+None of its own beyond the common `archive` and `unarchive` (see the adoc skill): the user asks for a status change in a comment or in the conversation, and you edit `status:` in the front matter.