figmar/apes-sidebar
1
0
Fork 0
Code Issues 1 Pull Requests 1 Actions Packages Projects Releases Wiki Activity
10 Commits 6 Branches 43 Tags
archive/apes-sidebar-v2-scratch-20260904
Commit Graph
9 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
figmar 0b79269b2c fix(apes-sidebar): inject 改空数组（修 DSH entry pending → 恢复模式） 
根因：inject: ['logger'] 声明了 logger 为硬依赖 service，但 DSH host
没有 provider 注册 logger service → entry 永远 pending →
'1 entry did not activate' → 插件树加载失败 → 恢复模式循环。

对比 dsh-better-sidebar：其 inject 是 host 实际提供的 service
（webServer/sessions/webRuntime/tools）。apes-sidebar host half 只用
ctx.logger 做可选链调用（log?.info?.() 在 try/catch 里），logger 是
软便利不是硬依赖——不该出现在 inject 列表里。

修正：inject 改空数组 []，host half 不声明任何硬依赖 service。
同步更新 smoke.spec.ts 断言（inject toEqual([])）+
verify-mount.cjs 检查（inject === []）。

门禁：typecheck rc=0 · build rc=0 · test 29/29
 2026-09-04 21:21:56 +08:00
figmar cfc9d3c884 fix(apes-sidebar): dsh 声明改嵌套格式（修 DSH 拒绝加载） 
根因：package.json 用扁平键 dsh.bundle.patch / dsh.client.inject /
dsh.client.platform，但 DSH loadRecoveryFilteredProfile 只认嵌套
dsh 对象（{ bundle: { patch }, client: { inject, platform } }）。
扁平格式导致 DSH 报 'profile bundle apes-sidebar declares no
dsh.bundle' → 恢复模式循环。

修正为与 dsh-better-sidebar 0.18.0 一致的嵌套格式：
  dsh: {
    bundle: { patch: './cordis.patch.yml' },
    client: { inject: [betterSidebar, locale, sessions], platform: web }
  }

验证：node_modules/apes-sidebar 的 dsh.bundle 字段存在，
格式与 better-sidebar 逐键一致（Object.keys 比对 true）。

门禁：typecheck rc=0 · build rc=0 · test 29/29
 2026-09-04 21:08:09 +08:00
figmar 4e60dde18d chore(apes-sidebar): 挂载验收脚本 scripts/verify-mount.cjs 
模拟 DSH host 的 bundle 解析，验证 apes-sidebar 在 profile node_modules：
- package.json 可解析 (name=apes-sidebar v2.0.0)
- host entry 命名导出 { name, inject:['logger'], apply } 无 default
- invariant surface 可用 (assert)
- client entry 是 __ModuleLoader__ browser bundle（line 1 window）
- peer dsh-better-sidebar 满足 ^0.18.0

用法：node scripts/verify-mount.cjs（或 pnpm verify:mount）
依赖 profile 环境（~/.dsh/profiles/desktop 已装 apes-sidebar），
非单测门禁的一部分——CI 无 DSH profile 时跳过。

验收结果：14/14 通过（apes-sidebar 2.0.0 已挂载进
~/.dsh/profiles/desktop，dsh-better-sidebar 升级 ^0.17.1→0.18.0，
无新增 peer 冲突——所有 warning 为预存 runtime-provided peer）

门禁：typecheck rc=0 · build rc=0 · test 29/29
 2026-09-04 20:54:53 +08:00
figmar a94c43343d docs(apes-sidebar): 修正 client 契约描述 + 记录 __ModuleLoader__ bundle 坑 
- 规则 2 / Layout / Stack 段：client 入口实为命名 export function apply(ctx)
  （tsdown 打包为自包含 bundle，导出 { apply, ... }），非 AGENTS 旧述的
  'CJS closure factory — module.exports = (hostApi) => {}'——hostApi 描述失实，
  实际经 ctx.betterSidebar / ctx.effect 接线
- Gotchas 新增：lib/client.js 第 1 行是 window.__ModuleLoader__.load({...})，
  是 DSH browser 模块加载器格式，Node 侧 require 直接抛 'window is not
  defined'。这坐实 cordis scratch 挂载冒烟无法进单测门禁——client 产物
  按构造是 browser-only，不仅是缺 dsh CLI

门禁：typecheck rc=0 · build rc=0 · test 29/29
 2026-09-04 20:20:09 +08:00
figmar 48e16c73c7 feat(apes-sidebar): Phase 2 — per-tab state（tasks showInactive 持久化） 
- useTasksPrefs：ctx.settings.register('apesSidebar.tasks') namespace，
  uSES 观察 + update 写回，applies:'live' 跨 reload 持久化
- tasks 面板加 showInactive 开关：OFF 时只渲染 running 会话
- filterTasksRows 纯函数导出（hook 需渲染，过滤决策单测锁定）
- locales：tasks.showInactive zh/en
- tests/tabs.spec.ts：+4 个 per-tab state 过滤测试（25→29）
- AGENTS.md：Phase 2 更新（per-tab state 落地，scratch 冒烟 +
  apps·msgs·profile feed 延后——better-sidebar 无对应数据源 + 无 dsh CLI）

门禁：typecheck rc=0 · build rc=0 · test 29/29
 2026-09-04 20:11:06 +08:00
figmar 856d744139 feat(apes-sidebar): Phase 2 — badge 计数 + auto-collapse（visible 门控暂停） 
- apes:tasks badge = running 会话数；apes:agents badge = subagent 数
  （纯 (ctx)=>number|null 函数，0→null 隐藏，host 封顶 99+）
- useSessionList 接受 visible：非活动 tab 切 no-op subscribe，
  停止 live session-list churn 重渲染隐藏面板（better-sidebar
  'live views pause otherwise' 契约 = auto-collapse）
- tests/tabs.spec.ts：新增 5 个 badge 契约测试（6→11），mock
  sessions feed 直测 badge 纯函数
- AGENTS.md：Phase 2 标 partial（per-tab state / scratch 冒烟 /
  apps·messages·profile feed 延后，better-sidebar 0.18.0 无相应 API/数据源）

门禁：typecheck rc=0 · build rc=0（client.js 15.74→20K）· test 25/25
 2026-09-04 20:04:47 +08:00
figmar e4dcd1118e docs(apes-sidebar): AGENTS.md Phase status 同步 — Phase 1 done 2026-09-04 17:47:02 +08:00
figmar f86c1d82e6 feat(apes-sidebar): Phase 1 — 5 个 apes:* tab 真实注册 
- client/index.tsx 改用 dsh-better-sidebar 真实 TabDescriptor/
  TabComponentProps/Context（type-only，擦除不打包）
- 注册 5 个面板：apes:tasks（读 sessions，running/current/subagent
  标记）、apes:agents（subagent 过滤 + 按 parent 分组）、apes:apps /
  apes:messages / apes:profile（占位）
- 全部走 t() i18n，ctx.effect 包裹注册（HMR 安全 disposer）
- betterSidebar 缺失时优雅降级（bare DSH 不破坏 shell）
- context-types.ts 删除被取代的 Phase 0 占位镜像，保留 ApesLocaleService
- package.json devDeps 补 dsh-better-sidebar（dev-only 类型）
- tests/tabs.spec.ts: mock registry 验证 5 个 apes:* id 注册 +
  disposer 撤销 + 缺失降级 + namespace 锁

门禁全绿：typecheck / build / test（20/20）
cordis scratch 真实挂载冒烟留 Phase 2（需真实 DSH host 进程）
 2026-09-04 17:42:57 +08:00
figmar 0e91e99f49 feat(apes-sidebar): Phase 0 工程骨架 — host/client 分裂 + i18n + 不变量面 
从 0 重写的 v2.0.0 DSH 侧边栏插件第一阶段：
- 工程骨架：tsdown 双构建（host ESM + client CJS closure）、vitest、strict TS
- host 半：namespace 插件形状（name/inject/apply，无 default），minimal apply
- client 半：closure factory 注册 5 个 apes:* tab 占位 + zh/en i18n
- 不变量面：assert/semver/peer guard（dsh-better-sidebar >= 0.18.0）
- 依赖策略：dsh-better-sidebar=peerDependency（不打包），cordis=devDependency（仅类型）
- 门禁：pnpm typecheck + build + test 全绿（14 单测通过）
- AGENTS.md 工程约定 + .gitignore（排除 lib/node_modules/maxkb-integration）

模板：dsh-better-sidebar。作用域锁定信息层（tasks/agents/apps/messages/profile），
不含 file/terminal/browser（归 better-sidebar）、不含 team/room（归 background-agents）。
 2026-09-04 17:14:22 +08:00