dsh-quicknote 0.0.0-stage → 0.1.1

package/AGENTS.md

@@ -0,0 +1,28 @@
+# dsh-quicknote — agent notes
+
+Read this before changing code. User docs: [README.md](README.md).
+
+## Commands
+
+```bash
+pnpm install
+pnpm verify        # format → lint → typecheck → test → build → pack
+pnpm typecheck
+pnpm test
+pnpm build
+```
+
+## Layout
+
+- `src/host/` — Host half: services, tools, routes. No browser APIs.
+- `src/client/` — browser half: React 19 components (TSX), slots, styles. No Node APIs.
+- `src/shared/` — constants both halves import (`NAME`, `NS`, `PLUGIN_ID`).
+- `lib/` — generated. Never edit by hand.
+- `tests/` — one suite per half.
+
+## Invariants
+
+- `package.json` `name` === `src/shared/constants.ts` `NAME` === the client bundle id.
+- The `window.__ModuleLoader__.load` wrapper is generated by `tsdown.config.ts`; source must not contain it.
+- No network calls, no telemetry, no `console.log` in shipped code.
+- Any destructive action must be reversible and must state its consequence.

package/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+## 0.1.1
+
+- Restore dark-mode styling with the DSH theme tokens
+- Restore the notebook icon and use Quick Note / 随手记 consistently in the composer
+- Add search, All/Open/Done filters, timestamps, copy and insert actions
+- Add copy-all as Markdown and the primary+alt+S capture shortcut
+- Record the source Session on captured notes
+- Show a parked-draft receipt with undo after “save and clear draft”
+- Parse `#tag` in notes and filter the list by tag
+- Make delete reversible with an undo toast, including batch undo
+- Insert a note into the current Session even while the page covers the conversation
+- Open the notes page from the capture card with View all
+- Return to the conversation from the notes page, with the Session name in the link
+- Serialize note-store writes so overlapping requests cannot corrupt the JSON file
+- Stack note actions under the text in narrow windows so labels no longer wrap
+- Package homepage now points to the plugin documentation, not the GitHub repository
+
+## 0.1.0
+
+First release.
+
+- Composer toolbar button with a capture card prefilled from the current draft
+- Save note, or save and explicitly clear the draft
+- Sidebar page: newest-first list, done/reopen, delete
+- Four Agent tools: add, list, done, delete
+- Local JSON store at `~/.dsh/quicknote/notes.json` (0600, atomic writes)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-kit contributors
+
+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/PUBLISHING.md

@@ -0,0 +1,11 @@
+# Publishing
+
+1. Run `pnpm verify` and make sure it is green.
+2. Bump `version` and add the matching `CHANGELOG.md` entry.
+3. Inspect the artifact: `npm pack --dry-run`.
+4. Publish with provenance: `npm publish --provenance`.
+5. Tag the release: `git tag v<version>` and push the tag.
+6. Install the published package into a fresh profile and check the client bundle is served.
+
+For local development, `dsh plugin --profile <profile> add link:$PWD` installs the working copy instead of a
+published version.

package/README.md

@@ -1,3 +1,69 @@
-# Temporary Holding Version
+# dsh-quicknote
 
-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.
+[![npm](https://img.shields.io/npm/v/dsh-quicknote)](https://www.npmjs.com/package/dsh-quicknote)
+[![release](https://img.shields.io/github/v/release/dsh-kit/dsh-quicknote?label=release)](https://github.com/dsh-kit/dsh-quicknote/releases)
+
+Capture a note from the composer, keep it out of the way, and find it again on one page.
+
+- **From the composer**: click **Quick Note** in the composer toolbar. The card opens with the current draft; save it
+  as a note, save and explicitly clear the draft, or jump to the notes page with **View all**.
+- **From the sidebar**: search, filter All/Open/Done or by `#tag`, copy, insert into the active draft, and mark done or
+  delete with an undo toast.
+- **From an agent**: `quicknote_add`, `quicknote_list`, `quicknote_done`, `quicknote_delete`.
+- **Storage**: `~/.dsh/quicknote/notes.json` — local, mode `0600`, atomic writes. No telemetry.
+
+## Documentation
+
+<https://dsh-kit.github.io/dsh-quicknote/>
+
+## Install
+
+For development, link the working copy into a CLI/web profile:
+
+```bash
+dsh plugin --profile web add link:$PWD
+```
+
+For the desktop app, use the in-app plugin page; the `desktop` profile is app-managed.
+
+A published release installs by package name into a CLI/web profile:
+
+```bash
+dsh plugin --profile web add dsh-quicknote
+```
+
+For the desktop app, use its plugin page; the `desktop` profile is app-managed.
+
+## Verify
+
+```bash
+dsh --profile web --dump-config | grep -A2 "id: dsh-quicknote"
+```
+
+## Develop
+
+```bash
+pnpm install
+pnpm verify   # format → lint → typecheck → tests → build → pack
+```
+
+npm works too: `npm install && npm run verify`.
+
+- `src/host/` — store, JSON routes and four Agent tools.
+- `src/client/` — composer button, capture card, sidebar page.
+- `lib/` — generated, committed (a `link:` install never builds).
+- `tests/` — store and client registration.
+- `AGENTS.md` / `llms.txt` — agent context.
+- `PUBLISHING.md` — release checklist.
+
+## Data and API
+
+- `GET /api/quicknote/notes`
+- `POST /api/quicknote/notes/create` `{ text }`
+- `POST /api/quicknote/notes/update` `{ id, done }`
+- `POST /api/quicknote/notes/delete` `{ id }` (returns the removed note)
+- `POST /api/quicknote/notes/restore` `{ note }`
+
+## License
+
+MIT

package/README.zh.md

@@ -0,0 +1,67 @@
+# dsh-quicknote
+
+[![npm](https://img.shields.io/npm/v/dsh-quicknote)](https://www.npmjs.com/package/dsh-quicknote)
+[![release](https://img.shields.io/github/v/release/dsh-kit/dsh-quicknote?label=release)](https://github.com/dsh-kit/dsh-quicknote/releases)
+
+从输入框随手记下一条，不打断当前对话，之后在一页里找回。
+
+- **从输入框**：点击工具栏的 **随手记**；卡片会带上当前草稿。可以只保存笔记、显式选择“保存并清空输入框”，或点卡片右上角的 **查看全部** 直接打开笔记页。
+- **从侧栏**：随手记页面支持搜索、全部/未完成/已完成或 `#标签` 筛选、复制、插入当前草稿，以及完成或删除（删除后可撤销）。
+- **从 Agent**：`quicknote_add`、`quicknote_list`、`quicknote_done`、`quicknote_delete`。
+- **存储**：`~/.dsh/quicknote/notes.json`，本地、权限 `0600`、原子写入，无遥测。
+
+## 文档
+
+<https://dsh-kit.github.io/dsh-quicknote/zh/>
+
+## 安装
+
+开发时链接到 CLI/web profile：
+
+```bash
+dsh plugin --profile web add link:$PWD
+```
+
+桌面端请使用应用内插件页；`desktop` profile 由应用管理。
+
+发布后按包名安装到 CLI/web profile：
+
+```bash
+dsh plugin --profile web add dsh-quicknote
+```
+
+桌面端请使用应用内插件页；`desktop` profile 由应用管理。
+
+## 验证
+
+```bash
+dsh --profile web --dump-config | grep -A2 "id: dsh-quicknote"
+```
+
+## 开发
+
+```bash
+pnpm install
+pnpm verify   # 格式 → lint → 类型 → 测试 → 构建 → 打包
+```
+
+npm 也可用：`npm install && npm run verify`。
+
+- `src/host/`：存储、JSON 路由、四个 Agent 工具；
+- `src/client/`：输入框按钮、记录卡片、侧栏页面；
+- `lib/`：构建产物，提交进仓库（`link:` 安装不会构建）；
+- `tests/`：存储与客户端注册测试；
+- `AGENTS.md` / `llms.txt`：agent 上下文；
+- `PUBLISHING.md`：发布清单。
+
+## 数据与 API
+
+- `GET /api/quicknote/notes`
+- `POST /api/quicknote/notes/create` `{ text }`
+- `POST /api/quicknote/notes/update` `{ id, done }`
+- `POST /api/quicknote/notes/delete` `{ id }`（返回被删除的笔记）
+- `POST /api/quicknote/notes/restore` `{ note }`
+
+## 许可
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# DSH composes a profile from patch layers. Every bundle contributes one; this
+# layer inserts the plugin's own row. It does not patch another plugin.
+- insert:
+    - id: dsh-quicknote
+      name: dsh-quicknote

package/icon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none">
+  <rect x="4" y="3.5" width="16" height="17" rx="3" stroke="currentColor" stroke-width="1.6"/>
+  <path d="M8 8h8M8 12h8M8 16h5" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"/>
+</svg>