dsh-super-kanban 0.0.0-stage → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md ADDED
@@ -0,0 +1,88 @@
1
+ # Changelog
2
+
3
+ All notable changes to this project are documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ ## [Unreleased]
9
+
10
+ ## [0.4.0] - 2026-11-05
11
+
12
+ UI refinement release: put the frequently used toolbar actions back on the
13
+ toolbar and bring back restrained emphasis and status marks without returning
14
+ to the earlier visual clutter.
15
+
16
+ ### Added
17
+
18
+ - **Toolbar actions are visible**: Settings and "open in right sidebar" are
19
+ now persistent icon buttons in the board header and the compact right-panel
20
+ header. The overflow menu keeps only **Export JSON**.
21
+ - **Restrained emphasis and status marks**: cards show a small status dot and a
22
+ state-tinted progress line (backlog neutral, in progress brand, blocked
23
+ amber, done green), colored priority text (P0 error, P1 amber), issue count,
24
+ artifact count, subtask progress and a low-key AI/rules marker. Column
25
+ headers and the summary line carry matching status dots.
26
+ - **Task drawer depth**: colored status/priority text, type icons for key
27
+ facts, severity-colored issues, and a brand-colored session link, while the
28
+ primary button and DSH typography stay neutral.
29
+ - **English README** (`README.en.md`) alongside the Chinese README.
30
+
31
+ ### Changed
32
+
33
+ - Color is now limited to dots, thin progress lines, small icons and short
34
+ labels; there are no colored blocks, gradients or glow effects. Light and
35
+ dark themes, the full board, the compact sidebar and narrow windows were all
36
+ checked against the DSH type scale and spacing.
37
+
38
+ ## [0.3.0] - 2026-11-05
39
+
40
+ First public release. Super Kanban turns the sessions of a DeepSeek Harness
41
+ workspace into a maintainable task board.
42
+
43
+ ### Added
44
+
45
+ - **Automatic task analysis**: sessions are scanned on a schedule and turned
46
+ into tasks with goal, status, progress, priority, issues, next steps,
47
+ milestones and traceable evidence.
48
+ - **Two analysis engines**: a zero-dependency rules engine that always works
49
+ offline, and an optional LLM engine that reuses the local DSH account quota
50
+ and degrades to rules when disabled, over budget or offline.
51
+ - **Task detail drawer**: key facts first, editable status, subtasks, issues /
52
+ next steps, session context, artifacts and evidence with a direct jump back
53
+ to the source session.
54
+ - **Session hand-off**: one-click "continue this task" prompt built locally
55
+ from the task context (no model call), inserted into the original session or
56
+ a new session in the same workspace.
57
+ - **Subtask, artifact and goal tracking**: deterministic extraction from todo
58
+ snapshots, write/edit tool calls and presented deliverables, plus DSH session
59
+ goals when available.
60
+ - **Dual presentation**: a full-page board panel and a compact right-sidebar
61
+ panel, with configurable entry visibility and a shortcut from the session
62
+ header.
63
+ - **Manual task management**: create, edit, drag between columns, archive,
64
+ delete, relink sessions, lock fields so analysis never overwrites them.
65
+ - **Local-first storage**: board state under the DSH home storage directory,
66
+ atomic writes, corrupt-file recovery and version migration.
67
+ - **DSH-native visual language**: monochrome-first styling, a restrained type
68
+ scale, hairline borders and DSH design tokens for light and dark themes.
69
+
70
+ ### Changed
71
+
72
+ - Analysis output and storage are budgeted: compact session digests, incremental
73
+ gating, per-scan and daily AI call limits, and capped evidence, key facts,
74
+ subtasks, artifacts and history.
75
+ - Evidence and task payloads are trimmed for density; the board and drawer
76
+ prioritise "what matters now" over raw transcript dumps.
77
+
78
+ ### Security
79
+
80
+ - The plugin runs locally inside DSH, reads session storage read-only, serves
81
+ its HTTP API to the authenticated owner only, and sends nothing to third
82
+ parties. When the LLM engine is enabled it calls the DeepSeek inference API
83
+ with the local DSH account token; tokens are never logged or persisted by the
84
+ plugin. See [SECURITY.md](./SECURITY.md).
85
+
86
+ [Unreleased]: https://github.com/topmindspace/dsh-super-kanban/compare/v0.4.0...HEAD
87
+ [0.3.0]: https://github.com/topmindspace/dsh-super-kanban/releases/tag/v0.3.0
88
+ [0.4.0]: https://github.com/topmindspace/dsh-super-kanban/releases/tag/v0.4.0
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 TopMindSpace
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.en.md ADDED
@@ -0,0 +1,287 @@
1
+ # Super Kanban · AI Task Command Center
2
+
3
+ [![CI](https://github.com/topmindspace/dsh-super-kanban/actions/workflows/ci.yml/badge.svg)](https://github.com/topmindspace/dsh-super-kanban/actions/workflows/ci.yml)
4
+ [![npm](https://img.shields.io/npm/v/dsh-super-kanban.svg)](https://www.npmjs.com/package/dsh-super-kanban)
5
+ [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
6
+
7
+ An AI task board that **lives inside the DeepSeek Harness UI**. It reads the real DSH sessions across your workspaces and infers each task's goal, progress, completion state and open issues — and you can also maintain the board entirely by hand. Every card can be traced back to a specific session and a specific sentence.
8
+
9
+ - **Where it lives**: "任务看板" (Task board) in the DSH sidebar, or the compact form in the right sidebar of a conversation.
10
+ - **Data**: sessions are scanned read-only on your machine; board data stays on your machine.
11
+ - **Intelligence**: reuses the model quota of the DSH account already signed in on this machine — zero configuration. Turn AI off and it falls back to local rule-based analysis.
12
+
13
+ **English** | [简体中文](README.md)
14
+
15
+ ![Task board (light)](docs/screenshots/board-light.png)
16
+
17
+ ![Board → task details → continue task demo](docs/screenshots/demo.gif)
18
+
19
+ ## Contents
20
+
21
+ - [Why Super Kanban](#why-super-kanban)
22
+ - [Features](#features)
23
+ - [Two layouts](#two-layouts)
24
+ - [Installation](#installation)
25
+ - [Usage](#usage)
26
+ - [AI and privacy](#ai-and-privacy)
27
+ - [Screenshots](#screenshots)
28
+ - [Compatibility](#compatibility)
29
+ - [FAQ](#faq)
30
+ - [Development and contributing](#development-and-contributing)
31
+ - [License](#license)
32
+
33
+ ## Why Super Kanban
34
+
35
+ You keep several workspaces and many sessions going in DSH at the same time, and task state is scattered across conversations: how far did this get? Where is it stuck? Was anything delivered? Did it quietly die?
36
+
37
+ Super Kanban turns those conversations into a maintainable board:
38
+
39
+ | Capability | Description |
40
+ | --- | --- |
41
+ | 🎯 Goal extraction | Derives the task title and goal from the real request in a session instead of using the whole prompt as a title |
42
+ | 📈 Progress estimation | Prefers todo completion inside the session, combined with deliverables and turn state |
43
+ | ✅ Completion detection | Combines the last assistant reply, deliverables (present / file writes) and whether the user asked for more changes |
44
+ | ⚠️ Issue detection | Tool errors, user corrections and unresolved questions are attached to the card as "issues" |
45
+ | 🔗 Traceability | Every card carries its source workspace / session / evidence timeline, with a jump back to the session |
46
+ | 🤝 Session hand-off | "Continue this task" builds a structured prompt and (after your confirmation) puts it in the original or a new session input — never sends automatically |
47
+ | ✅ Subtasks and goals | Subtask checklists (importable from session todos, writes back progress), task goal, and DSH Session Goal tracking |
48
+ | 📦 Artifact tracking | Collects deliverables and written files; click to open them in the DSH document preview |
49
+ | 🧾 Key facts first | Cards show a one-line goal summary; the drawer leads with 3–6 key facts and keeps raw evidence collapsed |
50
+ | ✍️ Manual control | Create, edit, drag between columns, archive, delete, lock fields — AI never overwrites what you locked |
51
+ | 🔄 Continuous maintenance | First scan in seconds, then incremental scans; new sessions join automatically and old tasks keep updating |
52
+ | 🧠 Explainable | Every inference carries a confidence and a one-line reason — no black-box status changes |
53
+
54
+ ## Features
55
+
56
+ ### Two analysis engines: better with AI, always usable offline
57
+
58
+ 1. **Collect (local)**: reads `workspace.json` and each session's `session.v4.jsonl.zstd`, parsing user requests, assistant replies, tool calls, todo snapshots, deliverables, errors and turn-end reasons.
59
+ 2. **Rules engine (always available, zero tokens)**: local heuristics derive status, progress, issues and evidence. When you are signed out, offline, or AI is disabled, the board keeps working.
60
+ 3. **LLM analysis (optional, online)**: sends a compressed session digest to the DeepSeek inference API and receives structured JSON (tasks, status, progress, issues, evidence, confidence, reason).
61
+ 4. **Merge (local)**: merges results back by session anchor; locked fields are never overwritten; every change is recorded in task history.
62
+
63
+ ### Token efficiency
64
+
65
+ - Session digests sent to the model are capped at **≤1.5KB per session**, containing only recent changes and key signals.
66
+ - Structured output is bounded: ≤6 key facts, ≤8 evidence items, `max_tokens` ≤ 2200, with per-session limits.
67
+ - **Incremental gating**: the model is called only when user messages increase, a turn ends, the session is new, or you explicitly re-analyze. Live turns are never re-analyzed, and there is a minimum interval per session.
68
+ - **Controllable budget**: per-scan and daily AI call limits are configurable; exceeding them automatically falls back to the rules engine. The settings page shows today's calls and tokens.
69
+ - Re-scanning already analyzed sessions results in **zero AI calls**.
70
+
71
+ ### Data and privacy
72
+
73
+ - Board data is written only to `~/.dsh/storages/super-kanban/` on your machine. No third-party servers, no telemetry.
74
+ - Online analysis sends **compressed digests only**: never full session text, never file contents, never account credentials.
75
+ - All AI features can be disabled in settings and take effect immediately, falling back to local rules.
76
+
77
+ ## Two layouts
78
+
79
+ The same board can be opened in two ways:
80
+
81
+ | Layout | How to open | Characteristics |
82
+ | --- | --- | --- |
83
+ | **Full-page panel** | "任务看板" in the left sidebar | Full four-column board + filters + stats line, best for focused review |
84
+ | **Right sidebar** | Board icon in the conversation header, or "任务看板" in the right sidebar's "+" tools list | Board next to the chat; width-adaptive: narrow (single column + status segments) / medium / wide (four columns) |
85
+
86
+ - **Right sidebar fullscreen**: the fullscreen control on the right sidebar header expands the board to the whole viewport; you can leave it at any time.
87
+ - **Switching**: the "open in right sidebar" icon in the full-page header, or the "open as full page" icon in the right sidebar board.
88
+ - **Entry preferences**: board settings → "Display and entry" offers "Both (default) / Full page only / Right sidebar only"; refresh the window after changing.
89
+
90
+ ## Installation
91
+
92
+ > Prerequisites: DSH desktop installed and opened at least once (`~/.dsh/profiles/desktop` exists); DSH version `>= 0.2.1-rc.5 < 0.3.0`.
93
+
94
+ ### Option A: Plugin market index (recommended)
95
+
96
+ > "Discover" comes from DSH's experimental plugin market capability: first enable **Plugin market** under **Plugins → Experimental plugins** and reload DSH as prompted. If your DSH build does not offer it, use Option B/C/D.
97
+
98
+ 1. DSH → **Plugins** → **Discover**
99
+ 2. **Add index source** and paste:
100
+ `https://topmindspace.github.io/dsh-super-kanban/index.json`
101
+ 3. Find **Super Kanban** in the list → **Install** → enable
102
+ 4. Press `Cmd+R` in the DSH window (restart DSH if needed)
103
+
104
+ > The market index becomes available after the first release is published to GitHub Pages; its content comes from this repository's `docs/`.
105
+
106
+ ### Option B: npm package
107
+
108
+ DSH → Plugins → Add plugin → enter the package name `dsh-super-kanban` (optionally with a version, e.g. `dsh-super-kanban@<version>`) → install → enable → reload the window.
109
+
110
+ > The npm package is published: `dsh-super-kanban` (https://www.npmjs.com/package/dsh-super-kanban). See [docs/MARKET.md](docs/MARKET.md) for the release and index-refresh flow.
111
+
112
+ ### Option C: Git repository
113
+
114
+ Plugins → Add plugin → paste `https://github.com/topmindspace/dsh-super-kanban` → install (DSH pins the source to a commit) → enable → reload the window.
115
+
116
+ ### Option D: Local directory / source install
117
+
118
+ For developers and users who want to track the source:
119
+
120
+ ```bash
121
+ git clone https://github.com/topmindspace/dsh-super-kanban.git
122
+ cd dsh-super-kanban
123
+ ./install.sh -y # link into the default desktop profile and register the plugin
124
+ ```
125
+
126
+ Or choose "local directory" in the DSH plugin page and point it at this repository root. After installing, reload the window and "任务看板" appears in the left sidebar.
127
+
128
+ ### Upgrade and uninstall
129
+
130
+ - **Upgrade**: market / npm / Git installs update from the plugin page; source installs run `git pull` and reload the window.
131
+ - **Uninstall**: remove it from the plugin page, or run `./uninstall.sh -y` in the source directory.
132
+ - Uninstalling **does not delete** board data; to wipe it, delete `~/.dsh/storages/super-kanban/`.
133
+
134
+ Detailed installation, upgrade and troubleshooting steps are in [docs/INSTALL.md](docs/INSTALL.md).
135
+
136
+ ## Usage
137
+
138
+ 1. Click **任务看板** in the left sidebar (or the board icon in a conversation header for the right-sidebar form).
139
+ 2. **Board**: four columns — Backlog / In progress / Blocked / Done; column headers show counts and status colors.
140
+ 3. **Cards**: status dot, title with an AI/rules marker, a one-line goal summary, source workspace and last-activity time, plus restrained priority, issue count, artifact count, subtask progress and a progress line.
141
+ 4. **Detail drawer** (click a card):
142
+ - One-line status summary (click "Edit" to change fields)
143
+ - **Key facts** (3–6 items: key progress / decisions / issues from the session)
144
+ - **Subtasks**: check / add / delete; "import todos from session"; progress writes back automatically
145
+ - **Issues / next steps**
146
+ - **Session linkage**: continue this task / open session
147
+ - **Artifacts**: click to open in the DSH right-sidebar document preview
148
+ - Evidence and history (collapsed by default)
149
+ 5. **Filters**: workspace, priority, origin, tags, keyword search, show archived.
150
+ 6. **Toolbar** (persistent in the header): search, scan, settings gear, open in right sidebar, new task; the "⋯" menu only contains "Export JSON".
151
+ 7. **Scan**: click the scan button to trigger an incremental scan immediately; progress is shown live.
152
+ 8. **Settings** (gear icon): AI toggle, auto-scan, scan interval, initial scan range, AI budget, display and entry, excluded workspaces.
153
+
154
+ ### How "Continue this task" works
155
+
156
+ 1. Open any card → click **"继续此任务"** in the drawer;
157
+ 2. The dialog contains a structured prompt (task goal / progress / key facts / issues / next steps / source session) that you can edit;
158
+ 3. Choose **original session** or **new session in the same workspace**;
159
+ 4. Click **"放入会话"**: DSH switches to the target session and puts the prompt into the input box — **it is never sent automatically**; review or edit it and press send yourself. You can also "copy only" or "polish with AI".
160
+
161
+ > The prompt is assembled locally from a template — **0 tokens by default**. Only "Polish with AI" spends one model call.
162
+
163
+ ### Manual and automatic side by side
164
+
165
+ - Automatic tasks are anchored to their source session; repeated scans update the same card instead of creating duplicates.
166
+ - Fields you edit and lock (editing locks by default) are never overwritten by AI; unlock them in the drawer to hand them back.
167
+ - Manual tasks (origin = manual) are never changed by automatic scans.
168
+ - New cards do not need a session; once linked, AI fills in the analysis on the next scan.
169
+
170
+ ### Shortcuts
171
+
172
+ | Key | Action |
173
+ | --- | --- |
174
+ | `/` | Focus search |
175
+ | `n` | New task |
176
+ | `Esc` | Close the topmost overlay / drawer |
177
+ | `Cmd+R` | Reload the DSH window (needed after plugin updates) |
178
+
179
+ ## AI and privacy
180
+
181
+ ### Data flow
182
+
183
+ ```
184
+ DSH sessions (local, read-only)
185
+ │ local parsing / rules engine
186
+ ▼
187
+ local board storage ──(optional)digest ≤1.5KB ──► DeepSeek inference API
188
+ │ │
189
+ └──────────── structured JSON ◄────────────────────┘
190
+ ```
191
+
192
+ ### What is never uploaded
193
+
194
+ - Full session transcripts, file contents, attachments
195
+ - Account credentials / tokens (read locally for the request header only, never included in the payload)
196
+ - Anything to third-party servers (no telemetry, no usage reporting)
197
+
198
+ ### Turning AI off
199
+
200
+ Settings gear in the board header → turn off "AI 联网研判" (online AI analysis); it takes effect immediately. The board keeps running on the local rules engine — no missing features, just coarser inference.
201
+
202
+ ### Cost
203
+
204
+ By default incremental scans only analyze **changed sessions**; the per-scan AI call limit defaults to 40 and the default model is `deepseek-flash`. On days without new conversations the cost is close to zero. You can lower the daily limit or disable AI entirely in settings.
205
+
206
+ ## Screenshots
207
+
208
+ | Board (light) | Board (dark) |
209
+ | --- | --- |
210
+ | ![Board light](docs/screenshots/board-light.png) | ![Board dark](docs/screenshots/board-dark.png) |
211
+
212
+ | Task details (light) | Task details (dark) |
213
+ | --- | --- |
214
+ | ![Task details light](docs/screenshots/drawer-light.png) | ![Task details dark](docs/screenshots/drawer-dark.png) |
215
+
216
+ | Continue-task dialog | Prompt placed into the session input |
217
+ | --- | --- |
218
+ | ![Continue task](docs/screenshots/continue-modal.png) | ![Prompt placed](docs/screenshots/continue-placed.png) |
219
+
220
+ | Right sidebar (narrow) | Right sidebar fullscreen |
221
+ | --- | --- |
222
+ | ![Right sidebar](docs/screenshots/side-panel.png) | ![Sidebar fullscreen](docs/screenshots/side-fullscreen.png) |
223
+
224
+ | Artifact preview entries | Settings (persistent gear) |
225
+ | --- | --- |
226
+ | ![Artifacts](docs/screenshots/drawer-artifacts.png) | ![Settings](docs/screenshots/settings-dual.png) |
227
+
228
+ | "⋯" menu (export JSON only) | 1280px window |
229
+ | --- | --- |
230
+ | ![Toolbar menu](docs/screenshots/toolbar-menu.png) | ![1280](docs/screenshots/board-1280.png) |
231
+
232
+ > All screenshots above use a fully fictional demo dataset (invented workspaces / sessions / tasks) and contain no real user or workspace information.
233
+
234
+ ## Compatibility
235
+
236
+ | Item | Requirement |
237
+ | --- | --- |
238
+ | DeepSeek Harness | `>= 0.2.1-rc.5 < 0.3.0` (verified on 0.2.1-rc.5 desktop) |
239
+ | Node.js | `>= 22.19.0` (uses the built-in `node:zlib` zstd API) |
240
+ | Platform | Verified on macOS desktop; other desktop platforms should work but are not individually verified |
241
+ | Third-party dependencies | None (plugin and tooling scripts are dependency-free) |
242
+
243
+ > The plugin relies on DSH's third-party plugin interfaces; major DSH upgrades may break compatibility. If the entry disappears after upgrading DSH, reinstall the plugin first — board data will not be lost.
244
+
245
+ ## FAQ
246
+
247
+ **Q: There is no "任务看板" in the left sidebar.**
248
+ A: Press `Cmd+R` to reload the window; restart DSH if it is still missing. If it remains missing, check the diagnostics on the DSH plugin page (a failed plugin load usually reports a reason).
249
+
250
+ **Q: Cards are not updating / still show an old status.**
251
+ A: Click the scan button in the header to trigger a manual scan, or check that "Auto scan" is enabled in settings.
252
+
253
+ **Q: The AI judgment is wrong.**
254
+ A: Open the card and edit the fields directly (editing locks them), or use "re-analyze" in the card menu to let AI look at the source session again.
255
+
256
+ **Q: I don't want certain workspaces on the board.**
257
+ A: Settings gear in the board header → Excluded workspaces (multi-select).
258
+
259
+ **Q: How much quota will this use?**
260
+ A: An incremental scan calls `deepseek-flash` once per **changed** session; the settings page shows today's calls and tokens. With AI disabled the cost is zero.
261
+
262
+ **Q: Where is the data? Is it lost after uninstalling?**
263
+ A: `~/.dsh/storages/super-kanban/` (`state.json` / `sessions-cache.json` / `backups/`). Uninstalling the plugin does not delete it.
264
+
265
+ **Q: Can I export the board?**
266
+ A: "⋯" in the board header → Export JSON, which downloads `super-kanban-YYYYMMDD.json`.
267
+
268
+ ## Development and contributing
269
+
270
+ - Zero third-party dependencies; tests run with `node --test`; `scripts/` contains validators, the privacy scanner and the market index generator.
271
+ - Common commands:
272
+
273
+ ```bash
274
+ npm test # unit tests
275
+ npm run validate # manifest, cordis patch, files and market index checks
276
+ npm run check:privacy # scan for personal paths / credentials / session ids
277
+ npm run market:index # regenerate docs/index.json
278
+ ```
279
+
280
+ - For the development setup, repository layout and debugging, see [CONTRIBUTING.md](CONTRIBUTING.md) and [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md).
281
+ - Architecture: [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md). Interface contract: [docs/CONTRACT.md](docs/CONTRACT.md). Visual spec: [docs/DESIGN.md](docs/DESIGN.md).
282
+ - Release and distribution flow (market index, npm, Git): [docs/MARKET.md](docs/MARKET.md).
283
+ - For security issues, please follow [SECURITY.md](SECURITY.md) and report privately instead of opening a public issue.
284
+
285
+ ## License
286
+
287
+ [MIT](LICENSE) © topmindspace