dsh-plugin-orchd 0.1.0 → 0.1.2

package/README.md

@@ -40,6 +40,14 @@ dsh plugin add dsh-plugin-orchd
 dsh plugin --profile web add github:7bder/dsh-plugin-orchd
 ```
 
+## 截图
+
+![看板：状态条即筛选、搜索、排序、任务列表](assets/screenshot-1.png)
+
+![依赖图：分层 DAG、悬空依赖如实标注、异常提示](assets/screenshot-2.png)
+
+![任务详情：验收标准、可复制的验证命令、依赖与审查时间线](assets/screenshot-3.png)
+
 Desktop 的 `desktop` profile 由应用托管：普通 `dsh plugin --profile desktop ...` 会被 CLI 直接拒（
 `profile "desktop" is managed exclusively by the Electron application`），应用自带终端里不带 `--profile`
 的命令才改得到它。装好后**重启 DSH**——宿主侧模块不热替换：会话 header 角落出现开关，右侧栏出现「orchd 任务」页。

package/client/client.js

@@ -126,7 +126,7 @@ window.__ModuleLoader__.load({
       // 列表与筛选（FR-5）
       search: '搜索 ID / 名称…',
       sortBy: '排序',
-      sortDefault: '活跃优先',
+      sortDefault: '活跃优先 · 按时间',
       sortImportance: '重要度',
       sortDifficulty: '难度',
       sortModule: '模块',
@@ -200,7 +200,7 @@ window.__ModuleLoader__.load({
       ideasTitle: '想法',
       ideasArchived: '归档',
       ideasArchivedUnit: '条',
-      ideasArchivedHint: '归档只计数，不加载全文；已立任务 / 已丢弃的条目都到这里了',
+      ideasArchivedHint: '归档只计数，不加载全文；已立任务 / 已覆盖 / 人工 close 的条目都到这里了',
       ideasArchivedHistorical: '归档保留原文，因此这里的 status 是历史值（可能仍写着 pending）',
       ideasEngineUnsupported: '本项目的 orchd 引擎没有 ideas 子命令（旧版本）：下面这份列表与状态是直接读 IDEAS.md 得到的，没有引擎清单可交叉核对。升级引擎后会自动启用交叉核对。',
       ideasBadgeHint: '在等你裁决的想法数（论证中 + 待补充）',
@@ -211,12 +211,12 @@ window.__ModuleLoader__.load({
       ideasOnlyInMarkdown: '仅存在于 IDEAS.md（引擎清单里没有）',
       ideasOwnerUser: '等你裁决',
       ideasOwnerAgent: '等 agent 拆解',
-      ideasOwnerNone: '已离队',
+      ideasOwnerNone: '无需等待',
       ideasConverted: '已转成的任务',
       ideasConvertedHint: '定义层里 source 指向这条想法的任务',
       ideasConvertedTasks: '个任务',
       ideasStatusUnknown: '未知状态',
-      ideasStatusDropped: '已丢弃',
+      ideasArchiveLegacyDropped: '历史已放弃（dropped）',
       ideasUntasked: '未立任务',
       ideasNoId: '无法对照',
       ideasDetail: '正文',
@@ -224,15 +224,15 @@ window.__ModuleLoader__.load({
       ideasExtra: '未知字段',
       ideasDetailPath: '详档',
       ideasCommands: '你可以执行的命令（id 已填好）',
-      ideasCommandsHint: '本面板只读：不提供 propose / confirm / drop / archive 按钮，只帮你复制命令。这些命令按当前状态给出；在途任务引用期间引擎会拒绝搬走（source_live_reference）。',
-      ideasCommandLegend: 'append = 往这条想法追加一条带时间戳的追记（不动原正文、不改状态，就是「追加记录」里那几行）；confirm / drop / archive = 你对这条想法的裁决（仅用户可执行）。括号里的 <…> 是占位符，换成你自己要写的字。',
+      ideasCommandsHint: '本面板只读：不提供 propose / confirm / close 按钮，只帮你复制命令。这些命令按当前状态给出；在途任务引用期间引擎会拒绝搬走（source_live_reference）。',
+      ideasCommandLegend: 'append = 往这条想法追加一条带时间戳的追记（不动原正文、不改状态，就是「追加记录」里那几行）；confirm / close = 你对这条想法的裁决（仅用户可执行；close 一律归档并留下裁决理由）。括号里的 <…> 是占位符，换成你自己要写的字。',
       ideasPropose: '新建想法（引擎侧的正式通道）',
       ideasProposeHint: '新建时还没有 id，所以标题里要自己声明一个（形如「标题（id: my-idea）」）。',
       iStudy: '论证中',
       iQuestioning: '待补充',
       iPending: '待拆解',
-      iTaskified: '已转任务',
-      iDropped: '已丢弃',
+      iConverted: '已转任务',
+      iCovered: '已覆盖',
       // ── FR-7 依赖图（P2b）──
       graphCounts: '节点 {n} · 边 {e}',
       graphIncludeTerminal: '含终态任务',
@@ -335,7 +335,7 @@ window.__ModuleLoader__.load({
       summaryFromPlugin: 'Source: plugin',
       search: 'Search id / name…',
       sortBy: 'Sort',
-      sortDefault: 'Active first',
+      sortDefault: 'Active first · by time',
       sortImportance: 'Importance',
       sortDifficulty: 'Difficulty',
       sortModule: 'Module',
@@ -404,7 +404,7 @@ window.__ModuleLoader__.load({
       ideasTitle: 'Ideas',
       ideasArchived: 'Archived',
       ideasArchivedUnit: '',
-      ideasArchivedHint: 'Archived entries are counted only; entries that became tasks or were dropped live here',
+      ideasArchivedHint: 'Archived entries are counted only; entries that became tasks, were covered, or were closed live here',
       ideasArchivedHistorical: 'The archive keeps the original text, so these statuses are historical',
       ideasEngineUnsupported: "This project's orchd engine has no ideas subcommand (older build): the list and statuses below are read straight from IDEAS.md, with no engine ledger to cross-check. Cross-checking turns on automatically after an engine upgrade.",
       ideasBadgeHint: 'Ideas waiting on you (studying + needs info)',
@@ -415,12 +415,12 @@ window.__ModuleLoader__.load({
       ideasOnlyInMarkdown: 'Only present in IDEAS.md (missing from the engine list)',
       ideasOwnerUser: 'waiting on you',
       ideasOwnerAgent: 'waiting on an agent',
-      ideasOwnerNone: 'left the queue',
+      ideasOwnerNone: 'no action pending',
       ideasConverted: 'Tasks created from this idea',
       ideasConvertedHint: 'Definition-layer tasks whose source points at this idea',
       ideasConvertedTasks: 'tasks',
       ideasStatusUnknown: 'unknown status',
-      ideasStatusDropped: 'dropped',
+      ideasArchiveLegacyDropped: 'historically dropped',
       ideasUntasked: 'never tasked',
       ideasNoId: 'no id',
       ideasDetail: 'Body',
@@ -428,15 +428,15 @@ window.__ModuleLoader__.load({
       ideasExtra: 'Unrecognised fields',
       ideasDetailPath: 'Detail doc',
       ideasCommands: 'Commands you can run (id already filled in)',
-      ideasCommandsHint: 'This panel is read-only: no propose / confirm / drop / archive buttons — it only copies commands. They match the current status; while in-flight tasks reference the entry the engine refuses to move it (source_live_reference).',
-      ideasCommandLegend: 'append = add one timestamped note to this idea (it never touches the original body or status — these are the lines shown under "Appended notes"); confirm / drop / archive = your decision on this idea (user-only). The <…> parts are placeholders — replace them with your own text.',
+      ideasCommandsHint: 'This panel is read-only: no propose / confirm / close buttons — it only copies commands. They match the current status; while in-flight tasks reference the entry the engine refuses to move it (source_live_reference).',
+      ideasCommandLegend: 'append = add one timestamped note to this idea (it never touches the original body or status — these are the lines shown under "Appended notes"); confirm / close = your decision on this idea (user-only; close always archives the entry with your reason). The <…> parts are placeholders — replace them with your own text.',
       ideasPropose: 'New idea (the engine-side channel)',
       ideasProposeHint: 'A new idea has no id yet, so declare one in the title (e.g. "Title (id: my-idea)").',
       iStudy: 'Studying',
       iQuestioning: 'Needs info',
       iPending: 'Awaiting breakdown',
-      iTaskified: 'Turned into tasks',
-      iDropped: 'Dropped',
+      iConverted: 'Turned into tasks',
+      iCovered: 'Covered',
       graphCounts: '{n} nodes · {e} edges',
       graphIncludeTerminal: 'Include finished tasks',
       graphIncludeTerminalHint: 'Also draw completed / cancelled tasks (by default only active tasks and their direct neighbours are drawn)',
@@ -771,28 +771,14 @@ window.__ModuleLoader__.load({
     function interactionCss() {
       const hover = 'var(--dsw-alias-interactive-bg-hover, rgba(127, 127, 127, 0.12))'
       const active = 'var(--dsw-alias-interactive-bg-active, rgba(127, 127, 127, 0.2))'
-      // 平台品牌强调色（`--dsw-alias-state-business-primary` = DeepSeek 品牌蓝）。
-      // 兜底写 `rgba()` 而**不是 `#rrggbb`**：本仓库 FR-11.3 禁止前端出现裸色值 hex
-      // （lint 套件会抓，实测第 8 轮就被抓到过一次）。兜底保证变量缺失时脉冲依旧醒目。
-      const accent = 'var(--dsw-alias-state-business-primary, rgba(77, 107, 254, 1))'
+
       return [
         // 悬停：禁用态不亮（否则会让人以为能点）
         `[data-orchd-toggle]:hover,[data-orchd-panel] button:hover:not(:disabled){background-color:${hover}!important}`,
         // 按下：比悬停更深一档
         `[data-orchd-toggle]:active,[data-orchd-panel] button:active:not(:disabled){background-color:${active}!important}`,
         // 键盘可达：焦点环（鼠标点击不显示，避免视觉噪音）
-        '[data-orchd-toggle]:focus-visible,[data-orchd-panel] button:focus-visible{outline:2px solid var(--dsw-alias-label-secondary, currentColor);outline-offset:1px}',
-        // 标题脉冲环：点击图标时面板**本来就开着**（`openTab` 只是聚焦，没有任何可见变化），
-        // 用它提示「面板在这儿」。
-        // ⚠ 强度：第一版借的是 hover 那个 12% 的弱色 ⇒ 用户实测「太弱了」。
-        //   现在用**平台品牌强调色**（`--dsw-alias-state-business-primary`，第一方用它的地方很多），
-        //   并且：① 环从 0 扩散到 14px（辐射式「ping」，比静止细环显眼得多）；
-        //         ② 标题文字同时变亮成强调色 ⇒ 文字本身也在闪，不只是外圈。
-        //   仍用 `box-shadow` + `color`：都**不参与布局**，标题不会被挤动；
-        //   且是一次性动画（非状态样式），播完自动回到无环/原色。
-        `@keyframes orchd-title-flash{0%{box-shadow:0 0 0 0 ${accent}}100%{box-shadow:0 0 0 14px transparent}}`,
-        `@keyframes orchd-title-flash-text{0%,35%{color:${accent}}100%{color:inherit}}`,
-        '[data-orchd-title-flash="true"]{border-radius:999px;animation:orchd-title-flash 1s ease-out 1,orchd-title-flash-text 1s ease-out 1}'
+        '[data-orchd-toggle]:focus-visible,[data-orchd-panel] button:focus-visible{outline:2px solid var(--dsw-alias-label-secondary, currentColor);outline-offset:1px}'
       ].join('')
     }
 
@@ -812,39 +798,8 @@ window.__ModuleLoader__.load({
       }
     }
 
-    /**
-     * 标题脉冲环的订阅点（模块级）。
-     *
-     * `mounted` 由面板组件在挂载/卸载时维护：图标被点时如果面板**本来就开着**，
-     * `openTab` 只会聚焦已有 tab、界面上没有任何变化，用户会以为「点了没反应」——
-     * 这时才在标题上闪一下指路；面板本来是关的，tab 出现本身就是反馈，不必再闪。
-     */
-    const panelState = { mounted: false, listeners: new Set() }
-
-    function flashPanelTitle() {
-      for (const listener of [...panelState.listeners]) {
-        try {
-          listener()
-        } catch (error) {
-          console.error('orchd-tasks: title flash listener failed', error)
-        }
-      }
-    }
-
-    /**
-     * 订阅标题脉冲。返回 `flashId`：每次闪烁 +1，调用方把它当 `key` 用，
-     * 靠**重挂载**让 CSS 动画能重放（同一元素上重复加同一个属性值不会重启动画）。
-     */
-    function useTitleFlash() {
-      const [flashId, setFlashId] = React.useState(0)
-      React.useEffect(() => {
-        const listener = () => setFlashId((value) => value + 1)
-        panelState.listeners.add(listener)
-        return () => panelState.listeners.delete(listener)
-      }, [])
-      return flashId
-    }
-
+    // 标题脉冲环已移除：入口按钮改为「打开 / 关闭」toggle（见 OrchdToggleButton），
+    // 再点有可见反馈（面板收起），不再需要「面板本来开着 ⇒ 点了没反应」的提示。
 
     async function writeClipboard(text) {
       if (navigator.clipboard?.writeText !== undefined) {
@@ -1449,10 +1404,25 @@ window.__ModuleLoader__.load({
       return counts
     }
 
-    /** 默认「活跃优先，其次重要度」（FR-5.4）。 */    function sortRows(rows, by) {
+    /** 默认「活跃优先 → 组内按时间」：活跃按最近动作、终态按合并时间（FR-5.4 修订）。 */    function sortRows(rows, by) {
       const rank = (value) => ({ critical: 4, high: 3, normal: 2, low: 1 })[value] ?? 0
       const diff = (value) => ({ high: 3, medium: 2, low: 1 })[value] ?? 0
       const activeFirst = (status) => (status === 'claimed' || status === 'done' || status === 'in_review' ? 0 : status === 'completed' || status === 'cancelled' ? 2 : 1)
+      // 时间戳来自宿主（`lastActionAt` / `mergedAt`，git 近似；取不到为 null → 排本组最后）
+      const timeOf = (row) => {
+        const raw = row.status === 'completed' || row.status === 'cancelled' ? row.mergedAt : row.lastActionAt
+        if (typeof raw !== 'string' || raw === '') return null
+        const parsed = Date.parse(raw)
+        return Number.isFinite(parsed) ? parsed : null
+      }
+      const byTime = (a, b) => {
+        const ta = timeOf(a)
+        const tb = timeOf(b)
+        if (ta === null && tb === null) return 0
+        if (ta === null) return 1
+        if (tb === null) return -1
+        return tb - ta
+      }
       const copy = [...rows]
       const byId = (a, b) => String(a.id ?? '').localeCompare(String(b.id ?? ''))
       switch (by) {
@@ -1465,7 +1435,7 @@ window.__ModuleLoader__.load({
         case 'status':
           return copy.sort((a, b) => String(a.status ?? '~').localeCompare(String(b.status ?? '~')) || byId(a, b))
         default:
-          return copy.sort((a, b) => activeFirst(a.status) - activeFirst(b.status) || rank(b.importance ?? b.importanceDerived) - rank(a.importance ?? a.importanceDerived) || byId(a, b))
+          return copy.sort((a, b) => activeFirst(a.status) - activeFirst(b.status) || byTime(a, b) || rank(b.importance ?? b.importanceDerived) - rank(a.importance ?? a.importanceDerived) || byId(a, b))
       }
     }
 
@@ -2250,26 +2220,44 @@ window.__ModuleLoader__.load({
 
     // ── FR-13 想法看板 ────────────────────────────────────────────────────
     /**
-     * 想法状态顺序（引擎顺序：study → questioning → pending → taskified → dropped）。
-     * 统计条**固定**展示这 5 个（0 值可点），这样三分区在界面上闭合：
-     *   `全部 = 活跃 + 已转任务 + 已丢弃`（活跃 = 论证中 + 待补充 + 待拆解）。
+     * 想法展示桶顺序（4 个引擎状态 + 派生桶 `converted`）。
+     * 统计条**固定**展示这些（0 值可点），这样三分区在界面上闭合：
+     *   `全部 = 活跃 + 已转任务 + 已覆盖`（活跃 = 论证中 + 待补充 + 待拆解）。
      * 集合以宿主下发的 `activeStatuses` 为准，这里只是同源兜底。
+     *
+     * 引擎 2026-10-23 调整：`taskified` 正名为 `covered`（撞车并入已有任务、待归档），
+     * `dropped` 从活跃台账下线（放弃改走 `idea close --reason`）。`converted` 是
+     * **派生桶**（任务定义层 source/additional_sources 指向该想法），不是引擎状态。
      */
-    const IDEA_STATUSES_UI = ['study', 'questioning', 'pending', 'taskified', 'dropped']
+    const IDEA_STATUSES_UI = ['study', 'questioning', 'pending', 'converted', 'covered']
 
     /**
-     * 想法状态 → i18n 键。
+     * 想法展示桶 → i18n 键。
      *
-     * ⚠ 这 5 个状态是**引擎定义的**（`study` / `questioning` / `pending` / `taskified` / `dropped`），
-     * 不得自造。引擎将来加了新状态时解析层会把 `status` 置 null 并保留原文，
-     * 这里显示「未知状态 + 原文」，不崩、不猜。
+     * ⚠ 前 4 个是**引擎定义的**（`study` / `questioning` / `pending` / `covered`），
+     * 不得自造；`converted` 是本插件按定义层溯源派生的展示桶。引擎将来加了新状态时
+     * 解析层会把 `status` 置 null 并保留原文，这里显示「未知状态 + 原文」，不崩、不猜。
      */
     const IDEA_STATUS_I18N = {
       study: 'iStudy',
       questioning: 'iQuestioning',
       pending: 'iPending',
-      taskified: 'iTaskified',
-      dropped: 'iDropped'
+      converted: 'iConverted',
+      covered: 'iCovered'
+    }
+
+    /** 条目的展示桶：派生桶优先，其次才是引擎字面状态。 */
+    function ideaDisplayStatus(entry) {
+      if (entry === null || entry === undefined) return null
+      if (typeof entry.displayStatus === 'string') return entry.displayStatus
+      if (entry.converted === true) return 'converted'
+      return entry.status ?? null
+    }
+
+    /** 展示桶文案；未知状态显式说「未知」，不猜、不崩。 */
+    function ideaStatusText(entry, t) {
+      const status = ideaDisplayStatus(entry)
+      return status === null ? t('ideasStatusUnknown') : t(IDEA_STATUS_I18N[status] ?? 'ideasStatusUnknown')
     }
 
     /** 想法的「在等谁」文案（FR-13.4：**不得只给状态码**）。 */
@@ -2293,29 +2281,30 @@ window.__ModuleLoader__.load({
     /**
      * 想法列表（FR-13.1/13.3/13.4）。
      *
-     * 与任务列表用**同一套**状态条筛选组件（FR-13.6），只是标签换成 5 个想法状态；
+     * 与任务列表用**同一套**状态条筛选组件（FR-13.6），只是标签换成想法展示桶；
      * 徽章数在调用方（视图切换）显示，这里不重复。
      */
     function IdeasBoard({ data, filters, setFilters, t, onOpen }) {
       const entries = data?.entries ?? []
       const counts = data?.counts?.byStatus ?? {}
-      // ⚠ 统计条只放**活跃层可能出现的状态**（study/questioning/pending）。
-      // 统计条固定展示全部 5 个想法状态（0 值可点），以便三分区在界面上**闭合**：
-      //   全部 = 活跃 + 已转任务 + 已丢弃      （活跃 = 论证中 + 待补充 + 待拆解）
+      // 统计条固定展示全部展示桶（4 个引擎状态 + 派生桶 converted，0 值可点），
+      // 以便三分区在界面上**闭合**：
+      //   全部 = 活跃 + 已转任务 + 已覆盖      （活跃 = 论证中 + 待补充 + 待拆解）
       // 集合由宿主下发（`activeStatuses`），客户端只做兜底。
       const labels = Array.isArray(data?.activeStatuses) && data.activeStatuses.length > 0
         ? data.activeStatuses
         : IDEA_STATUSES_UI
-      // 归档分组：与任务池对照得出（已转任务 / 已丢弃 / 未立任务 / 无 id）
+      // 归档分组：与任务池对照得出（已转任务 / 历史已放弃 / 未立任务 / 无 id）
       const archived = data?.archived ?? {}
       const archivedTotal = data?.archivedCount ?? 0
 
       const filtered = entries.filter((entry) => {
         const mode = filters.mode
+        const display = ideaDisplayStatus(entry)
         if (mode === 'active') {
-          // 想法没有「终态」概念，用「已离队」等价表达：active = 仍在队里
-          if (entry.status === 'taskified' || entry.status === 'dropped') return false
-        } else if (mode !== 'all' && entry.status !== mode) {
+          // 活跃 = 仍待处理：已转任务（converted）与已覆盖（covered）都不算
+          if (display === 'converted' || display === 'covered') return false
+        } else if (mode !== 'all' && display !== mode) {
           return false
         }
         if ((filters.keyword ?? '') !== '') {
@@ -2327,10 +2316,10 @@ window.__ModuleLoader__.load({
 
       const summaryForStrip = {
         total: data?.counts?.total ?? entries.length,
-        // 「活跃」用宿主给的数（已扣除定义层已立任务的条目）；拿不到时退回本地口径
+        // 「活跃」用宿主给的数（已扣除已转任务 / 已覆盖）；拿不到时退回本地口径
         active: typeof data?.active === 'number'
           ? data.active
-          : entries.filter((entry) => entry.status !== 'taskified' && entry.status !== 'dropped').length,
+          : entries.filter((entry) => !['converted', 'covered'].includes(ideaDisplayStatus(entry))).length,
         ...counts,
         source: 'engine'
       }
@@ -2383,8 +2372,8 @@ window.__ModuleLoader__.load({
               archivedTotal === 0
                 ? `${t('ideasArchived')} 0 ${t('ideasArchivedUnit')}`
                 : `${t('ideasArchived')} ${archivedTotal}${t('ideasArchivedUnit')}（${[
-                    `${t('ideasConverted')} ${archived.taskified ?? 0}`,
-                    `${t('ideasStatusDropped')} ${archived.dropped ?? 0}`,
+                    `${t('ideasConverted')} ${archived.converted ?? 0}`,
+                    `${t('ideasArchiveLegacyDropped')} ${archived.legacyDropped ?? 0}`,
                     `${t('ideasUntasked')} ${archived.untasked ?? 0}`,
                     `${t('ideasNoId')} ${archived.noId ?? 0}`
                   ].join(' · ')}）`),
@@ -2448,7 +2437,7 @@ window.__ModuleLoader__.load({
         React.createElement('span', { key: 'm', style: styles.rowMeta }, [
           React.createElement('span', { key: 's', style: { ...styles.statusTag, color: ideaOwnerToken(entry.owner) } }, [
             React.createElement('span', { key: 'dd', style: styles.chipDot }),
-            React.createElement('span', { key: 'l' }, entry.status === null ? t('ideasStatusUnknown') : t(IDEA_STATUS_I18N[entry.status] ?? 'ideasStatusUnknown')),
+            React.createElement('span', { key: 'l' }, ideaStatusText(entry, t)),
             React.createElement('span', { key: 'o' }, ` · ${ideaOwnerText(entry.owner, t)}`)
           ]),
           // 已转任务：由定义层溯源推出（status 只表达摄入/裁决态，不表达「已立任务」），顺带给出任务数量
@@ -2519,7 +2508,7 @@ window.__ModuleLoader__.load({
               style: { ...styles.statusTag, color: ideaOwnerToken(entry.owner) }
             }, [
               React.createElement('span', { key: 'd', style: styles.chipDot }),
-              React.createElement('span', { key: 'l' }, entry.status === null ? t('ideasStatusUnknown') : t(IDEA_STATUS_I18N[entry.status] ?? 'ideasStatusUnknown')),
+              React.createElement('span', { key: 'l' }, ideaStatusText(entry, t)),
               React.createElement('span', { key: 'o' }, ` · ${ideaOwnerText(entry.owner, t)}`)
             ])
           ]),
@@ -2581,11 +2570,13 @@ window.__ModuleLoader__.load({
      *
      * 命令形态来自引擎实测（`orchd idea <c> --help`）：
      *   `append --id <id> --notes …`（按 `- id:` 精确值定位）
-     *   `confirm/drop --title <title>`、`archive --title <title> --reason …`
-     *   —— 后三者的 `--title` 支持「裸 slug」，而裸 slug 与 `- id:` 精确相等，故直接用 id。
+     *   `confirm --title <title>`、`close --title <title> --reason …`
+     *   —— 后两者的 `--title` 支持「裸 slug」，而裸 slug 与 `- id:` 精确相等，故直接用 id。
      *
-     * 按**有效状态**给（`study` 才能 confirm/drop；pending/questioning/taskified 走 archive）。
+     * 引擎 2026-10-23 起人工离场出口统一为 `idea close --reason`（旧 drop / archive 已下线）：
+     * study/questioning/pending/covered 全部走 close；`study` 另给 confirm（升 pending）。
      * 在途任务引用期间引擎会拒绝搬走（`source_live_reference`），这是引擎的守卫，不是错误。
+     * 判定用**字面 status**（`converted` 的条目字面仍是 pending）。
      */
     function ideaCommandsFor(entry) {
       const id = typeof entry.id === 'string' && entry.id !== '' ? entry.id : null
@@ -2593,9 +2584,9 @@ window.__ModuleLoader__.load({
       const commands = [{ key: 'append', text: `python .orchd/__main__.py idea append --id ${id} --notes "<追记内容>"` }]
       if (entry.status === 'study') {
         commands.push({ key: 'confirm', text: `python .orchd/__main__.py idea confirm --title ${id}` })
-        commands.push({ key: 'drop', text: `python .orchd/__main__.py idea drop --title ${id}` })
-      } else if (entry.status === 'questioning' || entry.status === 'pending' || entry.status === 'taskified') {
-        commands.push({ key: 'archive', text: `python .orchd/__main__.py idea archive --title ${id} --reason "<裁决理由>"` })
+        commands.push({ key: 'close', text: `python .orchd/__main__.py idea close --title ${id} --reason "<裁决理由>"` })
+      } else if (entry.status === 'questioning' || entry.status === 'pending' || entry.status === 'covered') {
+        commands.push({ key: 'close', text: `python .orchd/__main__.py idea close --title ${id} --reason "<裁决理由>"` })
       }
       return commands
     }
@@ -2625,13 +2616,6 @@ window.__ModuleLoader__.load({
       // 每会话记忆（FR-12.2）：视图与筛选状态按 sessionId 隔离保存，切走再切回可恢复
       const sessionMemory = React.useRef(new Map())
 
-      // 面板是否已挂载：图标被点时用来判断「面板本来就开着」（这时才需要在标题上闪一下指路）
-      React.useEffect(() => {
-        panelState.mounted = true
-        return () => {
-          panelState.mounted = false
-        }
-      }, [])
 
       // 会话切换时清掉「当前打开的任务/想法」（视图状态按会话隔离）
       React.useEffect(() => {
@@ -3094,21 +3078,17 @@ window.__ModuleLoader__.load({
     /** tab chip 标题（sidebar.right.pane.tab.title，keyed/session）。 */
     function OrchdTasksTitle(props) {
       const t = typeof props?.t === 'function' ? props.t : (key) => key
-      // 点图标时若面板本来就开着，就在标题上闪一下（见 flashPanelTitle 的注释）。
-      // `flashId` 当 `key` 用：每次闪烁重挂载标题，CSS 动画才能重放。
-      const flashId = useTitleFlash()
       return React.createElement('span', { style: { display: 'inline-flex', alignItems: 'center', gap: 6 } }, [
         React.createElement(OrchdIcon, { key: 'i', size: 14 }),
-        React.createElement('span', {
-          key: `t-${flashId}`,
-          'data-orchd-title-flash': flashId > 0 ? 'true' : 'false'
-        }, t('title'))
+        React.createElement('span', null, t('title'))
       ])
     }
 
     /**
      * 会话 header 的开关按钮。
      *
+     * 点击 = 打开 / 关闭（面板正显示时收起右侧栏，否则打开并聚焦本面板）。
+     *
      * 席位是 conversation.session.header.utilities，kind 为 list、scope 为 session。
      * 不要用 conversation.session.header.corner：那是 **single** 席位，右侧栏自带的
      * 「展开」按钮已经占着它；single 在同一优先级下只允许一个占位者，重复注册会抛错
@@ -3120,13 +3100,11 @@ window.__ModuleLoader__.load({
         type: 'button',
         style: styles.iconButton,
         onClick: () => {
-          // 面板**本来就开着**时 openTab 只是聚焦，界面毫无变化 → 在标题上闪一下指路
-          // （面板本来是关的就不闪：tab 出现本身就是反馈）
-          if (panelState.mounted) flashPanelTitle()
+          // 点击只是「打开 / 关闭」：面板正显示时收起，否则打开并聚焦本面板。
           try {
-            props.open?.()
+            props.toggle?.()
           } catch (error) {
-            console.error('orchd-tasks: openTab failed', error)
+            console.error('orchd-tasks: toggle failed', error)
           }
         },
         'aria-label': t('toggleLabel'),
@@ -3220,7 +3198,17 @@ window.__ModuleLoader__.load({
           order: 30,
           locale: NS,
           inject: () => ({
-            open: () => ctx.sidebarRight.openTab(TAB_KIND)
+            // 点击 = 打开 / 关闭：面板正显示时收起，否则打开并聚焦本面板。
+            // 用平台 sidebarRight 的真实状态（isExpanded / active），不靠本地「挂载与否」猜测。
+            toggle: () => {
+              const sidebar = ctx.sidebarRight
+              const active = typeof sidebar?.active === 'function' ? sidebar.active() : undefined
+              if (typeof sidebar?.isExpanded === 'function' && sidebar.isExpanded() && active?.kind === TAB_KIND) {
+                sidebar.toggleExpanded()
+              } else {
+                sidebar.openTab(TAB_KIND)
+              }
+            }
           })
         }, OrchdToggleButton)),
         'orchd-tasks: header toggle'
@@ -3237,7 +3225,7 @@ window.__ModuleLoader__.load({
      * 必须有单测兜底。测试用 `test/client.test.mjs` 的 `vm` + 假 `window.__ModuleLoader__`
      * 加载本文件再取这个对象断言。
      */
-    exports.__testables = { applyFilters, sortRows, countByStatus, TASK_STATUS_I18N, ALL_STATUSES, styles, IDEA_STATUSES_UI, IDEA_STATUS_I18N, ideaCommandsFor, computeThumb, scrollTopForThumbTop, SCROLLBAR_WIDTH, SCROLLBAR_MIN_THUMB, ROW_HEIGHT, IDEA_ROW_HEIGHT, interactionCss, INTERACTION_CSS_TAG, layoutDependencyGraph, graphAnomalyRows, graphNodeLabel, truncateLabel, graphTextUnits, GRAPH_NODE_W, GRAPH_NODE_H, GRAPH_GAP_X, GRAPH_GAP_Y }
+    exports.__testables = { applyFilters, sortRows, countByStatus, TASK_STATUS_I18N, ALL_STATUSES, styles, IDEA_STATUSES_UI, IDEA_STATUS_I18N, ideaCommandsFor, ideaDisplayStatus, ideaStatusText, computeThumb, scrollTopForThumbTop, SCROLLBAR_WIDTH, SCROLLBAR_MIN_THUMB, ROW_HEIGHT, IDEA_ROW_HEIGHT, interactionCss, INTERACTION_CSS_TAG, layoutDependencyGraph, graphAnomalyRows, graphNodeLabel, truncateLabel, graphTextUnits, GRAPH_NODE_W, GRAPH_NODE_H, GRAPH_GAP_X, GRAPH_GAP_Y }
     return module.exports
   }
 })

package/lib/cache.js

@@ -106,6 +106,11 @@ export function createProjectCaches(config) {
     review: createTtlCache({ ttlMs: 60_000, maxEntries: limit * 4 }),
     /** IDEAS 清单（`ideas list`）：变化慢，用 pollTtlMs（FR-13）。 */
     ideas: createTtlCache({ ttlMs: config.pollTtlMs, maxEntries: limit }),
+    /**
+     * git 时间层（FR-5.4 修订）：默认排序要用的「最近动作时间 / 合并时间」。
+     * 走两条只读 git 命令，变化比状态层慢，用 pollTtlMs（与 pool 同档）。
+     */
+    gitTimes: createTtlCache({ ttlMs: config.pollTtlMs, maxEntries: limit }),
     /** IDEAS 正文与归档计数：按文件指纹缓存（FR-13.12：归档不进默认加载路径）。 */
     ideasFiles: createTtlCache({ ttlMs: config.pollTtlMs, maxEntries: limit * 2 }),
     /** 定义层：TTL 视为无限，靠文件指纹失效（见 `definitionFingerprint`）。 */

package/lib/cli-invoke.js

@@ -30,7 +30,10 @@ export function normalizeCliResult(result) {
     reason: result.outcome === 'ok' ? null : (result.reason ?? 'cli-failed'),
     elapsedMs: result.elapsedMs,
     argv: result.argv,
-    stderr: result.stderr ?? null
+    stderr: result.stderr ?? null,
+    // 启动器定位结果（`worktree` 或 `container-root-fallback`）：出问题时能直接看出用了哪一份入口
+    launcher: result.launcher ?? null,
+    launcherSource: result.launcherSource ?? null
   }
 }
 
@@ -98,6 +101,8 @@ export function createCliInvoker(config, runner = runOrchdCli, logger = null) {
     const result = normalizeCliResult(await runner({
       root: ctx.root,
       workDir: ctx.workDir ?? ctx.mainWorktree,
+      // 容器根（`resolveLayout` 给出）：启动器在「工作树那份不存在」时可回退到它下面那一份
+      containerRoot: ctx.containerRoot ?? null,
       python: ctx.python,
       argv,
       timeoutMs,
@@ -121,10 +126,10 @@ export function createCliInvoker(config, runner = runOrchdCli, logger = null) {
      * ⚠ 引擎**只返回 3 个字段**（`title` / `id` / `status`），正文必须另读 `IDEAS.md`。
      */
     ideasList: (ctx) => call(ctx, ['ideas', 'list']),
-    /** 供 `detect()` 使用的形态。`detect` 会传 `workDir`（它自己从 layout 取）。 */
-    detectRunner: async ({ root, python, workDir, command }) => {
+    /** 供 `detect()` 使用的形态。`detect` 会传 `workDir` 与 `containerRoot`（它自己从 layout 取）。 */
+    detectRunner: async ({ root, python, workDir, containerRoot, command }) => {
       const argv = Array.isArray(command) ? command : ['status', '--all']
-      const result = await call({ root, python, workDir }, argv)
+      const result = await call({ root, python, workDir, containerRoot }, argv)
       return {
         timedOut: result.timedOut,
         exitCode: result.exitCode,
@@ -132,7 +137,9 @@ export function createCliInvoker(config, runner = runOrchdCli, logger = null) {
         engineError: result.engineError,
         reason: result.reason,
         elapsedMs: result.elapsedMs,
-        stderr: result.stderr
+        stderr: result.stderr,
+        launcher: result.launcher,
+        launcherSource: result.launcherSource
       }
     }
   }