dsh-plugin-github-issues 0.5.0 → 0.7.0

package/README.md

@@ -8,7 +8,7 @@ English | [中文](docs/README.zh.md)
 [![license](https://img.shields.io/npm/l/dsh-plugin-github-issues.svg)](LICENSE)
 
 Adds a GitHub Issues work surface to [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness):
-browse issues from your repositories and Projects v2 boards, read their details, and hand one to the
+browse issues from your repositories, read their details, and hand one to the
 agent. A handoff opens a new Session in the matching Workspace and stages the issue as an
 attachment-style card inside the composer; sending turns that card into the issue's task prompt.
 Handed-over issues show which Sessions own them, can be entered, and can be unlinked; one issue may be
@@ -54,19 +54,14 @@ tarball (`dsh-plugin-github-issues.tgz`), installable by path.
 - DSH Desktop with a Web GUI (developed and verified against `0.2.1-rc.3`).
 - A [`gh`](https://cli.github.com/) CLI logged in for the GitHub host you use:
   `gh auth login`. The token stays in the OS keychain and is never written into this package's config.
-- Projects v2 support additionally needs the `read:project` scope, once:
-
-  ```sh
-  gh auth refresh -h github.com -s read:project
-  ```
-
-  Without it the panel still works; the project picker explains what is missing.
+- The panel is repository-scoped: pick an organization and a repository (a default is selected for
+  you), then narrow by milestone, assignee and state.
 
 ## What you get
 
 | Surface | Where | What |
 |---|---|---|
-| GitHub panel | left rail icon → main panel | organization → project/repository → **milestone** → assignee → state cascade (remembered across restarts) in one fixed toolbar; only the list scrolls, search sits above it, and the detail pane scrolls independently (body, milestone progress, labels, priority, assignees, linked/mentioned PRs with checks and review state) |
+| GitHub panel | left rail icon → main panel | organization → repository → **milestone** → assignee → state cascade (remembered across restarts) in one fixed toolbar; a default organization/repository is selected for you, the milestone dropdown lists only that repository's milestones, and only the list scrolls (search stays above it, the detail pane scrolls independently with the **full issue body rendered as sanitized GitHub-flavored Markdown**, milestone progress, labels, priority, assignees, linked/mentioned PRs and checks) |
 | Issues right column | right sidebar tab | the same filtered issue list beside the Conversation, for drag-and-drop handoff |
 | Composer card | inside the input box | the staged issue: `[GitHub] owner/repo#number ×`. Type extra instructions or nothing; send converts the card into the issue prompt |
 | Linked chip | composer dock under the input | the Session's linked issue: state dot (green open / red closed) + `owner/repo#number`; click for a detail popover, remove to unlink |
@@ -76,9 +71,9 @@ tarball (`dsh-plugin-github-issues.tgz`), installable by path.
 ## Use
 
 1. Click the **GitHub** icon in the left rail.
-2. Pick an organization, a Projects v2 board or a repository, then a milestone (when the scope is a
-   repository) and an assignee/state filter. The selection is remembered in the profile's UI state
-   (not in the plugin config).
+2. Pick an organization and a repository (the first one is selected automatically), then a milestone,
+   assignee and state. The selection is remembered in the profile's UI state (not in the plugin
+   config).
 3. Click a row for the detail pane. `owner/repo#number` opens GitHub in the browser.
 4. Hand an issue over:
    - **One-click** in the detail: **Hand to agent** / **New session for this issue** opens a new
@@ -117,11 +112,14 @@ Settings → GitHub → Prompt template. Variables: `{{repo}}`, `{{number}}`, `{
 ## Limitations
 
 - Read-only: no comments, label/assignee/state writes.
-- Projects v2 needs `read:project`; priority falls back project field → organization Issue Field →
-  `P0`–`P4` labels. The milestone filter is disabled on a board because Projects v2 item filters have
-  no milestone equivalent.
-- Milestone choices come from the selected repository's full milestone list; in an all-repositories
-  scope they are accumulated from the issues already loaded.
+- The list uses the repository's exact `issues` connection, so state, assignee and milestone filters
+  are applied by GitHub (and the total is authoritative); milestone filtering sends the milestone
+  number through `filterBy.milestoneNumber`.
+- The detail body is the complete issue body, rendered with Markdown (headings, lists, code blocks,
+  tables, links, images) and sanitized before display; it is not an excerpt and it is not capped to a
+  small fixed-height box.
+- Milestone choices come from the selected repository's full milestone list (open and closed).
+- Priority falls back organization Issue Field → `P0`–`P4` labels when no project field is present.
 - The list polls every 60–120 s while visible; use **Refresh** for an immediate update.
 - The detail pane first asks for the body only and lazily loads cross-referenced PRs, so the slow
   timeline never blocks the pane.

package/docs/README.zh.md

@@ -6,7 +6,7 @@
 [![npm](https://img.shields.io/npm/v/dsh-plugin-github-issues.svg)](https://www.npmjs.com/package/dsh-plugin-github-issues)
 
 给 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 增加一个 GitHub Issue 工作区：
-按组织 / Projects v2 项目 / 仓库浏览 Issue，查看详情，并把 Issue 交给 Agent。交办会在匹配的
+按组织 / 仓库浏览 Issue，查看详情，并把 Issue 交给 Agent。交办会在匹配的
 Workspace 里新开一个 Session，并在输入框内以"附件卡片"的形式暂存这个 Issue；点击发送时卡片会
 转成 Issue 的提示词。已交办的 Issue 会显示处理它的 Session，可以进入，也可以解除关联；同一个
 Issue 可以关联多个 Session。
@@ -50,19 +50,13 @@ dsh plugin --profile <name> add /path/to/dsh-plugin-github-issues
 
 - DSH Desktop（Web GUI；开发与验证于 `0.2.1-rc.3`）。
 - 已登录的 `gh` CLI：`gh auth login`。token 留在系统钥匙串，不会写进插件配置。
-- 需要 Projects v2 时一次性补权限：
-
-  ```sh
-  gh auth refresh -h github.com -s read:project
-  ```
-
-  没有该权限时面板照常工作，项目选择器会说明缺什么。
+- 面板以仓库为范围：先选组织、再选仓库（会自动选中默认项），然后按里程碑、assignee、状态收窄。
 
 ## 功能
 
 | 界面 | 位置 | 内容 |
 |---|---|---|
-| GitHub 面板 | 左侧栏图标 → 主面板 | 组织 → 项目/仓库 → **里程碑** → assignee → 状态 级联筛选（记住上次选择）固定在一行；只有列表滚动，搜索在列表上方固定；详情栏独立滚动（正文、Milestone 进度、标签、优先级、assignee、关联/提及 PR 的 checks 与 review） |
+| GitHub 面板 | 左侧栏图标 → 主面板 | 组织 → 仓库 → **里程碑** → assignee → 状态 级联筛选（记住上次选择）固定在一行；组织和仓库会自动选中默认项，里程碑下拉只列当前仓库的里程碑；只有列表滚动，搜索在列表上方固定；详情栏独立滚动（**完整正文按 GitHub 风格 Markdown 渲染并做安全过滤**、Milestone 进度、标签、优先级、assignee、关联/提及 PR 的 checks 与 review） |
 | Issues 右栏 | 右侧栏页签 | 与对话同屏的同一份筛选列表，用于拖拽交办 |
 | 输入框卡片 | 输入框内部 | 暂存的 Issue：`[GitHub] owner/repo#number ×`。可以补充自己的文字，也可以不写；发送时卡片转成提示词 |
 | 已关联 chip | 输入框下方 dock | 当前 Session 关联的 Issue：状态圆点（open 绿 / closed 红）+ `owner/repo#number`；点击看详情，× 解除关联 |
@@ -72,8 +66,8 @@ dsh plugin --profile <name> add /path/to/dsh-plugin-github-issues
 ## 使用
 
 1. 点击左侧栏 **GitHub** 图标。
-2. 选择组织、Projects v2 板或仓库，再选里程碑（仓库范围时）和 assignee/状态。选择会记在 profile
-   的 UI 状态里（不在插件配置中）。
+2. 选择组织和仓库（默认自动选中第一个），再选里程碑、assignee 和状态。选择会记在 profile 的
+   UI 状态里（不在插件配置中）。
 3. 点一行查看详情；点 `owner/repo#number` 在浏览器打开 GitHub。
 4. 交办：
    - 详情里点「交给 Agent」/「再开一个 Session」：在匹配的 Workspace 新开 Session，输入框内出现
@@ -106,9 +100,11 @@ dsh plugin --profile <name> add /path/to/dsh-plugin-github-issues
 ## 限制
 
 - 只读：不发评论、不改标签/指派/状态。
-- Projects v2 需要 `read:project`；优先级回退顺序：项目字段 → 组织 Issue Field → `P0`–`P4` 标签。
-  Projects v2 的条目筛选没有里程碑等价物，因此选中项目板时里程碑筛选会禁用。
-- 里程碑的可选项：选中仓库时取该仓库的完整里程碑列表；全部仓库范围时从已加载的 Issue 中累积。
+- 列表使用仓库的 `issues` 连接，状态、assignee、里程碑都由 GitHub 服务端过滤（总数也是权威的）；
+  里程碑通过 `filterBy.milestoneNumber` 按编号过滤。
+- 详情展示完整正文（不是摘要、也不再限制在固定高度的小框里），按 Markdown 渲染并过滤危险 HTML。
+- 里程碑的可选项来自当前仓库的完整里程碑列表（含已关闭）。
+- 优先级回退顺序：组织 Issue Field → `P0`–`P4` 标签（不再读取 Projects v2 项目字段）。
 - 列表可见时每 60–120 秒轮询一次；需要立刻更新点「刷新」。
 - 详情先请求正文，交叉引用 PR 懒加载，慢的 timeline 不阻塞面板。
 - "发送时卡片转提示词"依赖 composer 的 DOM（原生发送按钮 / 回车），DSH 升级后需要重新核对。