@comchatx/cx-board-tasks 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ComChatX
+
+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

@@ -1,3 +1,5 @@
-# Temporary Holding Version
+The to-do and question module of cx's board, installed beside `@comchatx/cx-board`.
 
-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.
+With it, a file cx writes on the board can carry a kind: a finding or a change the seller reads, a proposal the seller agrees to, a choice or an input the seller answers. The seller dismisses what they will not answer, and sends every answer to cx at once, as one message, with Send to cx.
+
+The package holds one skill, which tells cx what an entry's front matter holds and how the seller's answers come back. ComChatX draws the module's cards while both packages are installed.

package/README.zh-CN.md

@@ -0,0 +1,5 @@
+cx 看板的待办与提问模块，和 `@comchatx/cx-board` 一起安装。
+
+有了它，cx 写在看板上的文件可以带一个类型：卖家查看的发现或改动、卖家同意的建议、卖家作答的选择或填写项。卖家可以忽略不打算作答的内容，并用「交给 cx」把所有答复作为一条消息，一次交给 cx。
+
+这个包只有一个技能，告诉 cx 每一条的 front matter 写什么，以及卖家的答复如何传回。两个包都安装时，ComChatX 会显示这个模块的卡片。

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "@comchatx/cx-board-tasks",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "The to-do and question module of cx's board: proposals, choices and inputs the seller answers there.",
+  "license": "MIT",
+  "author": "ComChatX",
+  "homepage": "https://github.com/comchatx/cx-board-tasks#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/comchatx/cx-board-tasks.git"
+  },
+  "bugs": "https://github.com/comchatx/cx-board-tasks/issues",
+  "keywords": [
+    "pi-package"
+  ],
+  "type": "module",
+  "pi": {
+    "skills": [
+      "./skills"
+    ]
+  },
+  "files": [
+    "skills",
+    "README.zh-CN.md"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "comchatx": {
+    "about": "在对话旁设一块看板，cx 把发现、改动、建议和问题留在上面。",
+    "mark": {
+      "line": "clipboard"
+    },
+    "section": "extensions",
+    "order": 111,
+    "skills": {
+      "cx-board-tasks": {
+        "about": {
+          "en": "Tells cx where the board is and what an entry holds.",
+          "zh": "告诉 cx 看板在哪里、每一条写什么。"
+        }
+      }
+    }
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "1.4.0",
+    "@types/node": "26.2.0",
+    "typescript": "7.0.2",
+    "vitest": "4.1.11"
+  }
+}

package/skills/cx-board-tasks/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: cx-board-tasks
+description: The to-do and question module of the seller's board, where you leave what you found, changed, propose and ask, as entries the seller answers. Use when you leave the seller an entry with a kind, and when the seller's message answers entries on the board.
+---
+
+This module draws on the board the `cx-board` skill describes. Without it every file is read as a heading and words; with it an entry's front matter gives it a kind, and the seller answers what asks.
+
+## An entry
+
+An entry is a file on the board, under `todo/`, named as the `cx-board` skill says. It opens with front matter, then your words for the seller, drawn as your answers in the chat are:
+
+```markdown
+---
+kind: proposal
+title: Lower the price of the blue kettle to $24.99
+at: 2026-10-27T02:14:00Z
+---
+
+Your words.
+```
+
+- `kind` is one of five:
+  - `finding`: something you found. The seller reads it.
+  - `change`: a change you already made. The seller reads it.
+  - `proposal`: something you would do, and have not done. The seller may agree.
+  - `choice`: a question with options. Add `options:`, then one `- option` line each, at most twelve, each one line.
+  - `input`: a question the seller answers in words. Add `hint:`, one line shown in the empty field.
+- `title` is the one line the seller reads first.
+- `at` is when you wrote it, in ISO 8601 with its offset.
+
+A file without these three, or with another kind, is drawn as the base draws one: its heading or its name, and its words.
+
+A question that has to wait for the seller's answer can be written as a `choice` or an `input` entry on the board: you end your turn and go on, and the answer comes back to you as a message in the chat.
+
+## The page's names
+
+Call the board's parts by the names the seller sees, in the seller's language: 待处理 / To do, 已处理 / Done, 已读 / Mark as read, 忽略 / Dismiss, 交给 cx / Send to cx.
+
+## What the seller does with an entry
+
+- **已读 / Mark as read**, on a finding or a change: the file moves to `done/`. You are not told.
+- **忽略 / Dismiss**, on a proposal, a choice or an input: the file moves to `done/`. You are not told. A dismissed proposal is not agreed, and nothing is done for it.
+- **An answer**: the seller agrees to a proposal, picks an option or types into an input, and sends the answers with 交给 cx / Send to cx. The files move to `done/`.
+
+A file moved to `done/` keeps every line you wrote and gains `done` (`read`, `dismissed` or `answered`), `doneAt` and, when one went, `answer`. Nothing on the board is deleted.
+
+## The seller's answers
+
+Answers come to you as one message from the seller. Each entry answered is a marker naming its file and the time of the version answered, then the seller's words for it:
+
+```text
+<board file="20261027-021400-lower-kettle-price.md" modified="1761531240000">Lower the price of the blue kettle to $24.99</board>
+Go ahead.
+```
+
+The words inside the marker are the entry's title. The words under it are the seller's: 同意 / Go ahead. for a proposal, the option's own words for a choice, and what was typed for an input. Read the entry's file under `done/` for what you wrote. A message sent while you are working waits until your turn ends.