dsh-sidebar-row-menu 0.0.0-stage → 1.3.3

package/AI_USAGE.en.md

@@ -0,0 +1,93 @@
+# AI Usage and Code Provenance
+
+[简体中文](AI_USAGE.md) · [English](AI_USAGE.en.md)
+
+This document describes how artificial intelligence (AI) was used in
+`dsh-sidebar-row-menu`, how the result was reviewed, where the code came from, and
+the limits of the warranty. It does not modify any term of [LICENSE](LICENSE) (MIT).
+
+## 1. Summary
+
+- The **source code and documentation were produced mainly with AI assistance**;
+  the project owner specified requirements, reviewed the result and verified behavior.
+- AI is not a copyright holder. The project is released under MIT; the rights and
+  obligations of users are governed solely by MIT.
+- The project comes with **no warranty**. AI-generated code may contain errors,
+  omissions, or behavior unsuitable for your environment.
+- Copyright and licenses for third-party code are listed separately in
+  [NOTICE.en.md](NOTICE.en.md); they are not changed by this project's MIT license.
+
+## 2. Tools and models
+
+- Development environment: DeepSeek Harness (DSH) coding agent.
+- Model: `deepseek-flash` (DeepSeek).
+- Interaction: the owner described requirements, reported defects and confirmed
+  behavior in natural language; the agent read DSH built-in packages and existing
+  plugin sources, wrote/refactored code, docs and tests, and verified them locally.
+
+## 3. Scope of AI involvement
+
+| Area | AI involvement | Notes |
+| --- | --- | --- |
+| `lib/client.js` | High | Initial version and all refactors written by AI |
+| `lib/host/*.js` | High | Split out of `lib/index.js` and rewritten by AI |
+| `test/*.test.mjs` | High | Cases and fake DOM/fiber written by AI |
+| `scripts/install.ps1` | High | Written by AI and executed locally |
+| `README*.md` / `NOTICE*.md` / this file | High | Drafted by AI and kept in sync |
+| Requirements, defect triage, final trade-offs | Human | Decided by the owner |
+
+No human rewrote every line. Human review focused on **behavioral verification**:
+reading critical paths, running tests, and exercising the menus in a real DSH client.
+
+## 4. Verified and not verified
+
+Verified:
+
+- 11 automated tests (host pure functions, route status codes, client wiring, slot
+  registration, menu item order, session right-click delegation, clipboard content);
+- on a Windows DSH desktop client: workspace right-click opens at the pointer,
+  session right-click opens the native menu at the pointer including the plugin entries;
+- the host `/open` route returns the expected status codes locally.
+
+Not fully verified:
+
+- every DSH version, theme, zoom level and multi-monitor setup;
+- the `darwin` / `linux` launch branches (present in code, not exercised);
+- every possible combination with other third-party plugins (the slot design is
+  meant to compose, but was not exhaustively tested).
+
+## 5. Code provenance
+
+- Adapted from `dsh-sidebar-context-menu` (MIT, miao-ge) and `dsh-workspace-menu`
+  (BSD-3-Clause, @0imzero); the exact scope, copyright notices and full license
+  texts are in [NOTICE.en.md](NOTICE.en.md).
+- DSH built-in packages were read only for public interfaces, types and runtime
+  behavior; **no source code from them is copied**.
+- The Git history records each change; `v1.0.0`, `v1.1.0` and `v1.2.0` mark
+  behavioral milestones.
+
+## 6. Data and privacy
+
+- The plugin runs locally and contains **no telemetry, analytics or remote requests**.
+- The client reads workspace/session objects already in DSH's memory (title, `cwd`,
+  archived/pinned state) to build menus and copy paths/links.
+- The host route accepts loopback requests only and opens **existing absolute
+  directories** only.
+- Clipboard writes happen only when you click "Copy path / Copy link / Copy ID".
+
+## 7. Recommendations
+
+1. Before using it in production, read `lib/client.js` and `lib/host/*.js` and
+   confirm the behavior matches your expectations.
+2. Run `npm run test` (or `npm run test:local` in restricted environments).
+3. Keep `NOTICE.md` and `LICENSE` to satisfy the upstream MIT / BSD-3-Clause
+   attribution requirements.
+4. If AI-generated code causes a problem, please open an issue or a PR; human
+   fixes are welcome.
+
+## 8. Disclaimer
+
+The project is provided "as is", without any express or implied warranty,
+including but not limited to merchantability, fitness for a particular purpose and
+non-infringement. The authors and contributors are not liable for any direct or
+indirect damages arising from its use. The complete terms are in [LICENSE](LICENSE).

package/AI_USAGE.md

@@ -0,0 +1,79 @@
+# AI 使用与代码来源声明
+
+[简体中文](AI_USAGE.md) · [English](AI_USAGE.en.md)
+
+本文说明 `dsh-sidebar-row-menu` 中人工智能（AI）的参与范围、人工审核方式、代码引用
+来源与免责边界。它不改变 [LICENSE](LICENSE)（MIT）的任何条款。
+
+## 1. 结论摘要
+
+- 本项目的**源码与文档主要由 AI 辅助生成**，由项目所有者提出需求、审阅并验证。
+- AI 不是版权主体；本项目按 MIT 许可发布，使用者获得的权利与义务以 MIT 为准。
+- 项目**不提供任何担保**。AI 生成的代码可能包含错误、遗漏或不适用于你的环境。
+- 第三方代码的版权与许可单独列在 [NOTICE.md](NOTICE.md)，不因本项目采用 MIT 而改变。
+
+## 2. 使用的工具与模型
+
+- 开发环境：DeepSeek Harness（DSH）编码智能体。
+- 模型：`deepseek-flash`（DeepSeek）。
+- 交互方式：项目所有者以自然语言提出需求、指出缺陷并确认行为；智能体读取 DSH 内置
+  包源码与现有插件源码，编写/重构代码、文档与测试，并在本机验证。
+
+## 3. AI 参与的范围
+
+| 部分 | AI 参与程度 | 说明 |
+| --- | --- | --- |
+| `lib/client.js` | 高 | 初稿与多轮重构均由 AI 完成 |
+| `lib/host/*.js` | 高 | 由 AI 从 `lib/index.js` 拆分并改写 |
+| `test/*.test.mjs` | 高 | 测试用例与伪造 DOM/fiber 由 AI 编写 |
+| `scripts/install.ps1` | 高 | 由 AI 编写并在本机执行验证 |
+| `README*.md` / `NOTICE*.md` / 本文 | 高 | 由 AI 起草并随代码更新 |
+| 需求、缺陷判断、最终取舍 | 人类 | 由项目所有者决定 |
+
+没有人类逐行重写全部代码。人工审核以**行为验证**为主：阅读关键路径、运行测试、
+在真实 DSH 客户端中触发菜单并观察结果。
+
+## 4. 已验证与未验证
+
+已验证：
+
+- 11 项自动化测试（宿主纯函数、路由状态码、客户端模块装配、slot 注册、菜单项顺序、
+  会话右键委托、剪贴板内容）；
+- 在 Windows 上的 DSH 桌面客户端中实测：工作区右键在指针处弹出、会话右键在指针处
+  展开内置菜单并包含本插件条目；
+- 宿主 `/open` 路由在本机返回预期状态码。
+
+未完全验证：
+
+- 所有 DSH 版本、所有主题、所有缩放比例与多显示器组合；
+- 非 Windows 平台的启动分支（代码保留 `darwin` / `linux` 路径，但未实测）；
+- 与其他第三方插件的组合冲突（slot 机制设计上兼容，但未穷举）。
+
+## 5. 代码来源与引用
+
+- 改编自 `dsh-sidebar-context-menu`（MIT, miao-ge）与 `dsh-workspace-menu`
+  （BSD-3-Clause, @0imzero）；复用范围、版权声明与许可证全文见
+  [NOTICE.md](NOTICE.md)。
+- 对接 DSH 内置包时只读取其公开接口、类型与运行时行为，**未复制内置包源代码**。
+- 仓库历史（Git commits）记录了每次变更；`v1.0.0`、`v1.1.0`、`v1.2.0` 是行为分界点。
+
+## 6. 数据与隐私
+
+- 插件在本地运行，**不包含遥测、统计上报或远程请求**。
+- 客户端只读取 DSH 已渲染到内存中的工作区/会话对象（标题、`cwd`、归档/置顶状态），
+  用于生成菜单与复制路径/链接。
+- 宿主路由只接受本机（loopback）请求，且只打开**已存在的绝对目录**。
+- 剪贴板写入仅发生在你点击“复制路径 / 复制链接 / 复制 ID”时。
+
+## 7. 使用建议
+
+1. 在生产环境采用前，阅读 `lib/client.js` 与 `lib/host/*.js`，确认行为符合预期。
+2. 运行 `npm run test`（或受限环境用 `npm run test:local`）。
+3. 保留 `NOTICE.md` 与 `LICENSE`，以满足上游 MIT / BSD-3-Clause 的署名要求。
+4. 若发现 AI 生成代码导致的问题，请提交 issue 或 PR；欢迎人工修正。
+
+## 8. 免责声明
+
+本项目按“现状”提供，不附带任何明示或默示的担保，包括但不限于适销性、特定用途适用性
+与不侵权担保。使用本项目造成的任何直接或间接损失，作者与贡献者不承担责任。完整条款
+以 [LICENSE](LICENSE) 为准。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SideBar 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/NOTICE.en.md

@@ -0,0 +1,98 @@
+# NOTICE / Third-party notices
+
+[简体中文](NOTICE.md) · [English](NOTICE.en.md)
+
+`dsh-sidebar-row-menu` (MIT) was implemented with reference to, and adaptation of,
+two existing DSH plugins. The copyright and license conditions below apply to the
+adapted portions; all remaining code is copyright its contributors.
+
+## dsh-sidebar-context-menu
+
+- Author: miao-ge
+- Version: 0.2.0
+- License: MIT
+- Repository: https://github.com/miao-ge/dsh-sidebar-context-menu
+- Reused:
+  - host: loopback fence, JSON body reader, detached spawn, VS Code launcher
+    detection, `vscode://file` encoding (now split across
+    `lib/host/security.js`, `lib/host/launch.js`, `lib/host/paths.js`,
+    `lib/host/route.js`);
+  - client: fiber lookup, official `Menu` mounting, toast, capture-phase
+    `contextmenu` installation.
+
+## dsh-workspace-menu
+
+- Author: @0imzero
+- Version: 2.0.3
+- License: BSD-3-Clause
+- Reused: the client-service call pattern (`ctx.uiWorkspace` pin / archive /
+  unarchive / fork / openSession) and the `?session=<id>` deep-link construction.
+  Since v1.1 the session actions are official slot entries rather than direct
+  service calls, but the design was informed by this plugin.
+
+## DeepSeek Harness built-in packages
+
+The project interoperates with slots, `Menu` and row-component props by reading the
+public interfaces and types of DSH client packages
+(`@deepseek-ai/dsh-client-ui-workspace`, `@deepseek-ai/dsh-client-ui-renderer`,
+etc., version `0.2.1-rc.5`). **No source code from those packages is copied.**
+Their copyright remains with DeepSeek and is not relicensed by this project's MIT
+license.
+
+## AI assistance
+
+Code and documentation were produced with AI assistance. Scope, verification and
+disclaimers are documented in [AI_USAGE.en.md](AI_USAGE.en.md).
+
+---
+
+### MIT License (dsh-sidebar-context-menu)
+
+Copyright (c) miao-ge
+
+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.
+
+### BSD-3-Clause License (dsh-workspace-menu)
+
+Copyright (c) 2025, @0imzero
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/NOTICE.md

@@ -0,0 +1,92 @@
+# NOTICE / 第三方声明
+
+[简体中文](NOTICE.md) · [English](NOTICE.en.md)
+
+`dsh-sidebar-row-menu`（MIT）在实现过程中参考并改编了两个现有 DSH 插件的代码。
+下列版权与许可条件适用于被改编的部分；其余代码版权归本项目贡献者所有。
+
+## dsh-sidebar-context-menu
+
+- 作者：miao-ge
+- 版本：0.2.0
+- 许可证：MIT
+- 仓库：https://github.com/miao-ge/dsh-sidebar-context-menu
+- 复用范围：
+  - 宿主：loopback 围栏、JSON 请求体读取、detached spawn、VS Code 启动器探测、
+    `vscode://file` 编码（现拆分在 `lib/host/security.js`、`lib/host/launch.js`、
+    `lib/host/paths.js`、`lib/host/route.js`）；
+  - 客户端：fiber 解析、官方 `Menu` 挂载、toast、`contextmenu` 捕获安装方式。
+
+## dsh-workspace-menu
+
+- 作者：@0imzero
+- 版本：2.0.3
+- 许可证：BSD-3-Clause
+- 复用范围：客户端服务调用方式（`ctx.uiWorkspace` 的 pin / archive / unarchive /
+  fork / openSession）与会话深链接 `?session=<id>` 的构造方式。v1.1 起会话动作
+  改为官方 slot 条目，不再直接调用这些服务，但设计仍受其启发。
+
+## DeepSeek Harness 内置包
+
+本项目通过阅读 DSH 客户端内置包（`@deepseek-ai/dsh-client-ui-workspace`、
+`@deepseek-ai/dsh-client-ui-renderer` 等，版本 `0.2.1-rc.5`）的公开接口与类型来对接
+slot、`Menu` 和行组件 props。**没有复制其源代码**；内置包的版权归 DeepSeek 所有，
+其许可不因本项目的 MIT 许可而改变。
+
+## AI 辅助说明
+
+本项目的代码与文档在 AI 辅助下完成，范围、验证方式与免责声明见
+[AI_USAGE.md](AI_USAGE.md)。
+
+---
+
+### MIT License (dsh-sidebar-context-menu)
+
+Copyright (c) miao-ge
+
+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.
+
+### BSD-3-Clause License (dsh-workspace-menu)
+
+Copyright (c) 2025, @0imzero
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.