@winspan/claude-forge 8.53.2 → 8.54.4

package/docs/design/skill-ai-upgrade-spec-20260518-1930.md

@@ -1,297 +0,0 @@
-# AI 辅助 official skill 升级 Spec
-
-## 目标
-
-为 `claude-forge` 新增 `cf skills upgrade` 命令，通过 AI 评估将外部开源 skill 仓库（addyosmani/agent-skills、obra/superpowers）的优质内容合并进 `src/skills/official/*.md`（永久内置 skill），而不是让它们在用户目录独立存在。整个流程默认 dry-run，用户审核 markdown 报告后执行 `--apply`。
-
-## 用户决策（已通过对话确认）
-
-| 决策点 | 确认值 |
-|--------|--------|
-| 候选源目录 | `~/.claude-forge/skill-candidates/<source-name>/` |
-| AI 评估使用 | `config.ai.model` + `config.ai.base_url` |
-| 覆盖目标 | `src/skills/official/*.md`（编译进 dist 的永久内置） |
-| 报告路径 | `~/.claude-forge/skill-upgrade-report.md` |
-| 默认行为 | dry-run（只生成报告） |
-| `--apply` 行为 | 读取报告中 action，备份后覆写源码 |
-| 备份路径 | `~/.claude-forge/backups/skills/<timestamp>/`（已有 FORGE_PATHS.backups('skills')） |
-
-## 数据流图
-
-```
-[cf skills upgrade]
-    │
-    ▼
-[1] pullCandidates()
-    ├─ git clone/pull ~/.claude-forge/skill-candidates/agent-skills/
-    └─ git clone/pull ~/.claude-forge/skill-candidates/superpowers/
-    │
-    ▼
-[2] scanCandidateFiles()
-    └─ 遍历 .md 文件，解析 frontmatter → CandidateSkill[]
-    │
-    ▼
-[3] matchToOfficial()       (per candidate)
-    └─ tag/keyword 模糊匹配 → MatchResult (official id | null)
-    │
-    ▼
-[4] evaluateWithAI()        (有 official 匹配时才调用)
-    └─ ClaudeProvider.complete() → UpgradeDecision (JSON)
-    │
-    ▼
-[5] generateReport()
-    └─ ~/.claude-forge/skill-upgrade-report.md
-    │
-    ▼ (用户审核)
-    │
-[cf skills upgrade --apply]
-    │
-    ▼
-[6] applyDecisions()
-    ├─ git status 工作树检查
-    ├─ backup src/skills/official/ → backups/skills/<ts>/
-    └─ 覆写 src/skills/official/<id>.md
-```
-
-## 模块设计
-
-### Module 1: `src/skills/upgrade-engine.ts`
-
-**职责**：编排全流程，不含 AI prompt 字符串逻辑。
-
-```ts
-export interface CandidateSkill {
-  id: string;
-  source: string;       // 'agent-skills' | 'superpowers'
-  filePath: string;
-  name: string;
-  description: string;
-  keywords: string[];
-  content: string;
-}
-
-export interface MatchResult {
-  officialId: string;
-  score: number;        // 0-100，关键词重叠率
-}
-
-export type UpgradeAction = 'upgrade' | 'merge' | 'skip';
-export interface UpgradeDecision {
-  action: UpgradeAction;
-  confidence: number;       // 0-100
-  reasoning: string;
-  merged_content: string | null;
-}
-
-export interface ReportEntry {
-  officialId: string;
-  candidateId: string;
-  candidateSource: string;
-  action: UpgradeAction | 'error' | 'needs_review';
-  confidence: number;
-  reasoning: string;
-  candidateFilePath: string;
-  merged_content: string | null;
-}
-
-export async function pullCandidates(
-  sources: Array<{ name: string; url: string }>,
-  candidatesDir: string,
-): Promise<CandidateSkill[]>
-
-export function matchToOfficial(
-  candidate: CandidateSkill,
-  officialSkills: OfficialSkill[],
-): MatchResult | null   // null = 无匹配（score < 30）
-
-export async function evaluateWithAI(
-  candidate: CandidateSkill,
-  official: OfficialSkill,
-  aiProvider: ClaudeProvider,
-): Promise<UpgradeDecision>
-
-export async function generateReport(
-  entries: ReportEntry[],
-  outputPath: string,
-  stats: { total: number; matched: number; unmatched: number },
-): Promise<void>
-
-export async function applyDecisions(
-  reportPath: string,
-  officialDir: string,
-  backupBaseDir: string,
-): Promise<{ applied: number; skipped: number; backupPath: string }>
-```
-
-**关键逻辑**：
-- `pullCandidates`：单源失败 try/catch 跳过
-- `matchToOfficial`：keywords + name token overlap，阈值 30 分（满分 100）
-- `evaluateWithAI`：`maxTokens: 1200, timeoutMs: 45000`；JSON 解析失败返回 skip + needs_review
-- `applyDecisions`：apply 前 `git status --porcelain` 检查工作树是否干净，脏的话 abort
-
-### Module 2: `src/skills/upgrade-prompt.ts`
-
-```ts
-export function buildEvaluationPrompt(
-  candidate: CandidateSkill,
-  official: OfficialSkill,
-): { system: string; user: string }
-```
-
-**System prompt 要点**：
-```
-你是 Claude Code skill 内容评估专家。
-评估维度：主题重叠度 / 内容质量 / 互补性
-返回严格 JSON（不含其他文本）：
-{"action":"upgrade|merge|skip","confidence":0-100,"reasoning":"...","merged_content":null或合并后完整md}
-
-决策标准：
-- skip：主题不重叠，或 official 已完整覆盖
-- upgrade：候选覆盖 official 全部要点且质量明显更高（+30% depth/breadth）
-- merge：主题相同但各有独特章节，合并后价值更高
-```
-
-**User prompt**：双 skill 内容各截 2000 字 + JSON 要求。
-
-### Module 3: 候选源拉取
-
-```ts
-const DEFAULT_SOURCES = [
-  { name: 'agent-skills', url: 'https://github.com/addyosmani/agent-skills.git' },
-  { name: 'superpowers',  url: 'https://github.com/obra/superpowers.git' },
-];
-```
-
-**扫描兼容**：
-- agent-skills 格式：`<name>/SKILL.md`（目录格式）
-- superpowers 格式：顶层 `*.md`（平铺）
-- 复用 `SkillRegistry.scan()` 的格式识别逻辑
-
-### Module 4: CLI 子命令
-
-```ts
-skills
-  .command('upgrade')
-  .description('AI-assisted upgrade of official skills (dry-run by default)')
-  .option('--apply', 'Apply decisions from the last report')
-  .option('--rollback <timestamp>', 'Rollback to a backup')
-  .option('--report <path>', 'Custom report path')
-  .action(async (options) => { await upgradeSkills(options); });
-```
-
-## AI 输出契约
-
-```ts
-type UpgradeDecision = {
-  action: 'upgrade' | 'merge' | 'skip';
-  confidence: number;        // 0-100 整数
-  reasoning: string;         // 简短中文 < 200 字
-  merged_content: string | null;
-  // merged_content 规则：
-  //   merge   → 完整合并后 .md（含 frontmatter）
-  //   upgrade → null（直接用候选原文）
-  //   skip    → null
-};
-```
-
-容错：`JSON.parse` 失败 → `action: skip, needs_review: true`，不阻断。
-
-## 报告格式
-
-```markdown
-# Skill Upgrade Report
-
-Generated: 2026-05-18 19:30 | Model: claude-opus-4-7
-
-## Summary
-
-| Metric | Count |
-|--------|-------|
-| Candidates scanned | 37 (23 agent-skills + 14 superpowers) |
-| Matched to official | 12 |
-| Action: upgrade | 5 |
-| Action: merge | 4 |
-| Action: skip | 3 |
-| Unmatched | 25 |
-
-## Per-Skill Decisions
-
-### official-db-schema-design
-- **Action**: upgrade
-- **Confidence**: 85%
-- **Candidate**: `agent-skills/database-design`
-- **Reasoning**: 候选增加"分库分表策略"和"迁移工具对比"...
-
-<!-- upgrade-entry: official-db-schema-design | <candidatePath> | upgrade -->
-```
-
-**机器可读标记**：HTML 注释 `<!-- upgrade-entry: <id> | <path> | <action> -->`；merge 用 `<!-- merged-content-begin -->...<!-- merged-content-end -->` 包裹合并内容。`--apply` 解析这些注释。
-
-## 备份机制
-
-```
-~/.claude-forge/backups/skills/
-  └── 20260518-1930/
-        ├── official-tdd.md
-        └── ... (所有 official .md 快照)
-```
-
-- 只在 `--apply` 触发备份
-- `--rollback <ts>` 还原
-- 复用 `FORGE_PATHS.backups('skills')`
-- 同 ts 已存在则追加 `-2`、`-3`
-
-## 错误处理
-
-| 场景 | 处理 |
-|------|------|
-| git clone/pull 失败 | warn + 跳过该 source |
-| AI JSON 解析失败 | needs_review，继续 |
-| AI API 超时/5xx | retry 2 次失败 → error 标记 |
-| `--apply` 工作树脏 | abort，提示先 commit |
-| 候选无 frontmatter | 用文件名作 id，keywords=[] |
-| 同 ts 备份冲突 | 后缀 -2 -3 |
-
-## 改造范围
-
-| 文件 | 操作 | 行数估计 |
-|------|------|---------|
-| `src/skills/upgrade-engine.ts` | 新增 | ~200 |
-| `src/skills/upgrade-prompt.ts` | 新增 | ~60 |
-| `src/cli/commands/skills.ts` | 加 upgrade 子命令 + 函数 | +80 |
-| `src/core/constants.ts` | 加 `skillCandidates` 路径（可选）| +2 |
-
-**不改动**：dist/、daemon、web 路由、hook、SkillRegistry、official-skills.ts。
-
-## 测试策略
-
-| 测试文件 | 内容 |
-|---------|------|
-| `tests/unit/skills/upgrade-engine.test.ts` | mock ClaudeProvider.complete → 三条路径；applyDecisions dry-run 不写；备份目录创建 |
-| `tests/unit/skills/upgrade-prompt.test.ts` | system/user prompt 含必要字段；JSON 格式要求 |
-| `tests/unit/skills/upgrade-engine-parse.test.ts` | AI 非 JSON → needs_review；合法 JSON 正确解析 |
-
-集成测试可选：本地 mock .md 跑 dry-run 全流程。
-
-## 风险与回滚
-
-| 风险 | 缓解 |
-|------|------|
-| AI 误判覆盖好 skill | 默认 dry-run；apply 强制 backup；--rollback 还原 |
-| 覆写后 build 错 | apply 后提示 `npm run build` 验证 |
-| API 成本 | 仅 score>=30 调 AI；截 2000 字；预估 ~18K tokens / 12 matched |
-| 候选仓库结构变化 | 单源失败不阻断 |
-
-## 实施顺序
-
-1. **upgrade-prompt.ts**（纯函数，无依赖）
-2. **upgrade-engine.ts** — matchToOfficial → evaluateWithAI → pullCandidates → generateReport → applyDecisions
-3. **cli/commands/skills.ts** — 注册 upgrade 子命令
-4. （可选）`FORGE_PATHS.skillCandidates`
-5. 测试：upgrade-prompt → upgrade-engine（mock）→ CLI e2e
-
-## 命名遵循
-
-- 文件：kebab-case
-- 函数：动词开头 camelCase（`pullCandidates` / `matchToOfficial`）
-- 类型：PascalCase（`CandidateSkill` / `UpgradeDecision`）

package/docs/design/task-active-gc-spec-20260518-1745.md

@@ -1,146 +0,0 @@
-# task active GC 修复 Spec
-
-## 目标
-
-通过周期 GC + completeCurrentTask recover fallback，消除因 ESC 中断、Stop hook 未触发、daemon 重启等场景导致的 task 永久滞留 `active` 状态。
-
-## Bug 复现路径
-
-| 场景 | 触发条件 | 为何漏掉 |
-|------|---------|---------|
-| A | 用户 ESC 中断 Claude Code，Stop hook 不触发 | completeCurrentTask 永远不被调用 |
-| B | daemon 重启后用户 ESC，Stop hook 触发但 `currentTasks` Map 为空 | completeCurrentTask 第 78 行：`const current = this.currentTasks.get(sessionId)` — Map 空直接 return |
-| C | 用户切到别的 session 后永不再 prompt 旧 session | shouldStartNewTask 从不被触发，task 无人收尾 |
-
-## 方案对比
-
-| 方案 | 修复场景 | 改动文件数 | 风险 |
-|------|---------|-----------|------|
-| A：周期 GC | A / C（idle 超阈值后兜底） | 3 | idle 阈值设太短可能误杀长任务 |
-| B：completeCurrentTask recover fallback | B | 1 | 仅修场景 B，A/C 仍漏 |
-| C：A + B 组合 | A / B / C 全覆盖 | 3 | 最全面，改动仍可控 |
-| D：新增 `auto_closed` 状态 | A / B / C + UI 语义区分 | 5+ | 改动大，可作后续优化 |
-
-**推荐：方案 C**。
-
-## 详细设计
-
-### 1. storage 新方法：`completeStaleActiveTasks`
-
-**位置**：`src/core/storage/tasks.ts`（TaskOperations 类内）
-
-```ts
-/**
- * 将 idle 超过阈值的 active task 批量转为 completed。
- * 条件：status='active' AND end_time IS NOT NULL
- *       AND (now - end_time) > idleMinutes 分钟。
- * 返回：受影响行数。
- */
-completeStaleActiveTasks(idleMinutes: number): number {
-  const result = this.db.prepare(`
-    UPDATE tasks
-    SET status = 'completed'
-    WHERE status = 'active'
-      AND end_time IS NOT NULL
-      AND (julianday('now') - julianday(end_time)) * 24 * 60 > ?
-  `).run(idleMinutes);
-  return result.changes;
-}
-```
-
-同步在 `SQLiteStorage` facade（`sqlite.ts`）暴露同名代理方法。
-
-注意：`end_time` 由 `linkEventToTask` 持续更新，作为 idle 判定基准合理。没有 `end_time` 的 task（从未 link 过事件）不纳入 GC，避免误杀刚创建的 task。
-
-### 2. TaskSegmenter.completeCurrentTask 加 recover fallback
-
-**位置**：`src/daemon/services/task-segmenter.ts:77`
-
-```ts
-completeCurrentTask(sessionId: string, timestamp: string): void {
-  const current = this.currentTasks.get(sessionId) ?? this.recoverActiveTask(sessionId);
-  if (!current) return;
-  ...
-}
-```
-
-一行改动，与 `processPrompt` / `linkEvent` 模式一致。
-
-### 3. maintenanceInterval 加 GC 调度
-
-**位置**：`src/daemon/index.ts:105-116`
-
-现有 `maintenanceInterval` 是 **24 小时**，仅清理旧 events。需新增独立的**短周期 GC interval**：
-
-```ts
-// ── 5.6. Stale task GC (every 5 minutes) ──────────────────────────
-const STALE_TASK_GC_INTERVAL = 5 * 60 * 1000; // 5 分钟
-const STALE_TASK_IDLE_MINUTES = 10;            // idle 超 10 分钟视为滞留
-
-const staleTaskGcInterval = setInterval(() => {
-  try {
-    const closed = storage.completeStaleActiveTasks(STALE_TASK_IDLE_MINUTES);
-    if (closed > 0) {
-      logger.info(`[Maintenance] Auto-completed ${closed} stale active task(s)`);
-    }
-  } catch (err) {
-    logger.error(`[Maintenance] Stale task GC failed: ${err}`);
-  }
-}, STALE_TASK_GC_INTERVAL);
-```
-
-关闭时需调用 `clearInterval(staleTaskGcInterval)`（在现有 graceful shutdown 段追加）。
-
-## 改造范围
-
-| 文件 | 改动内容 | 估算行数 |
-|------|---------|---------|
-| `src/core/storage/tasks.ts` | 新增 `completeStaleActiveTasks` 方法 | +12 |
-| `src/core/storage/sqlite.ts` | facade 代理方法 | +3 |
-| `src/daemon/services/task-segmenter.ts` | completeCurrentTask recover fallback（1 行） | +1 |
-| `src/daemon/index.ts` | 新增 GC interval + clearInterval | +12 |
-
-共 4 文件，约 28 行净增。
-
-## 配置
-
-| 参数 | 值 | 说明 |
-|------|----|------|
-| `STALE_TASK_IDLE_MINUTES` | 10 | idle 超 10 分钟视为放弃，不可配置（硬编码常量） |
-| `STALE_TASK_GC_INTERVAL` | 5 分钟 | GC 轮询间隔，独立于 24h 维护周期 |
-
-如未来需要可迁移到 `config.yaml` 的 `tasks.stale_gc_minutes` 字段。
-
-## 测试策略
-
-| 测试类型 | 测试用例 | 文件位置 |
-|---------|---------|---------|
-| 单测：`completeStaleActiveTasks` | 空表返回 0 | 新增 `tests/unit/storage/tasks-stale-gc.test.ts` |
-| | 1 idle 超阈值 + 1 未超：只关超的 | 同上 |
-| | `status='completed'` 的 task 不被改动 | 同上 |
-| | `end_time IS NULL` 的 task 不被纳入 | 同上 |
-| 单测：recover fallback | Map 为空时仍能 complete DB 中 active task | 扩展现有 task-segmenter 测试 |
-
-## 风险与回滚
-
-| 风险 | 概率 | 缓解措施 |
-|------|------|---------|
-| 误杀正在进行的长任务 | 低（idle 阈值 10 分钟，linkEvent 持续刷新 end_time） | 阈值可调大；日志可审计 |
-| 旧库一次性批量 GC | 必然发生，且是预期行为 | 无需回滚，这正是修 bug 的目的 |
-| GC interval 异常退出 | 极低（try-catch 包裹） | 日志记录，不影响主流程 |
-
-**回滚**：删除 daemon/index.ts 中的 `staleTaskGcInterval` 代码块即可完全禁用 GC，其他改动无副作用。
-
-## 实施顺序
-
-1. `tasks.ts` — 新增 `completeStaleActiveTasks` + 单测
-2. `sqlite.ts` — facade 代理方法
-3. `task-segmenter.ts` — recover fallback 单行 + 单测
-4. `daemon/index.ts` — GC interval 注册 + clearInterval
-5. 全量测试 `npm test`
-
-## 命名遵循
-
-- `completeStaleActiveTasks`：`complete` 前缀（语义清晰，优于 `write`）
-- `STALE_TASK_GC_INTERVAL` / `STALE_TASK_IDLE_MINUTES`：全大写常量
-- `staleTaskGcInterval`：camelCase 变量，与 `maintenanceInterval` 风格一致

package/docs/design/tasks-list-filter-pagination-spec-20260518-0930.md

@@ -1,208 +0,0 @@
-# Tasks 列表筛选 + 分页 — 设计 Spec
-
-**日期**: 2026-05-18
-**状态**: Draft（待用户 review）
-
----
-
-## 工作流路径
-
-**hybrid-feature-with-safety**
-
-**理由**：`src/web/routes/` 有 19 个路由文件，`tests/unit/web/` 仅 6 个测试文件，覆盖率约 **32%**（低于 50% 阈值）。实现阶段每个后端改动文件均需配套新增/扩展测试用例。前端为单 HTML 文件无组件测试，route + storage 层必须达到 80% 分支覆盖。
-
----
-
-## 1. 目标 + 成功标准
-
-让 `GET /api/tasks` 支持完整服务端筛选与分页；前端 tasks 视图新增筛选栏 + 分页组件，URL 同步状态。
-
-### 验收用例
-
-| # | 场景 | 期望 |
-|---|------|------|
-| A1 | `GET /api/tasks?limit=10&offset=0` | `{ items: [...10], total, has_more }` |
-| A2 | `GET /api/tasks?project=/path/foo` | 仅返回该 project_path 的 tasks |
-| A3 | `?project=a&project=b` | 两个项目 OR 关系 |
-| A4 | `?from=2026-01-01T00:00:00Z&to=2026-01-31T23:59:59Z` | start_time 范围过滤 |
-| A5 | `?search=重构` | title LIKE `%重构%` |
-| A6 | `?limit=201` | clamp 到 200 |
-| A7 | 前端选「24h」+ 搜索「build」 | URL: `?range=24h&search=build&page=1`，刷新保留 |
-| A8 | 点「下一页」 | offset 递增，total 不变 |
-
-**非目标**：FTS5 全文检索、status 多选、修改 `/api/tasks/:taskId` 详情接口。
-
----
-
-## 2. 后端设计
-
-### 2.1 Route 层 `src/web/routes/tasks.ts`
-
-**已有**：`limit`（默认 20）、`session`
-**待加**：`offset`、`project`（多值）、`from`、`to`、`search`，返回结构升级
-
-```
-QueryParams (Zod):
-  limit:   number, default 50, max 200, min 1
-  offset:  number, default 0, min 0
-  project: string | string[]    // 多值
-  from/to: ISO 8601 string, optional
-  search:  string, optional, maxLength 100
-  session: string, optional     // 保留
-```
-
-返回从 `Task[]` 升级为 `{ items, total, has_more }`。**破坏性变更**：内部 dashboard 无外部消费者，可接受。
-
-### 2.2 Storage 层 `src/core/storage/tasks.ts`
-
-**关键挑战**：`tasks` 表无 `project_path` 字段，需 JOIN `sessions` 表。
-
-```sql
--- 数据查询
-SELECT t.*, s.project_path
-FROM tasks t
-JOIN sessions s ON t.session_id = s.session_id
-WHERE
-  [t.session_id = ?]
-  [AND s.project_path IN (?, ?)]
-  [AND t.start_time >= ?]
-  [AND t.start_time <= ?]
-  [AND t.title LIKE ?]
-ORDER BY t.start_time DESC
-LIMIT ? OFFSET ?;
-
--- 总数查询：复用相同 WHERE，不带 LIMIT/OFFSET
-SELECT COUNT(*) FROM tasks t JOIN sessions s ON t.session_id = s.session_id WHERE [...];
-```
-
-`TaskRecord` 新增可选字段 `project_path?: string`。
-
-### 2.3 索引评估
-
-| 查询 | 现有 | 是否够 |
-|------|------|--------|
-| `ORDER BY start_time DESC` | `idx_tasks_start_time` | ✅ |
-| `WHERE session_id = ?` | `idx_tasks_session` | ✅ |
-| `WHERE s.project_path IN (...)` | `idx_sessions_project` | ✅ |
-| `WHERE t.title LIKE '%xxx%'` | 无 | ❌ 全表扫描，但数据量 <10k，可接受 |
-| `WHERE start_time BETWEEN ?` | `idx_tasks_start_time` | ✅ 范围扫描 |
-
-**新增**：`CREATE INDEX idx_tasks_start_time_session ON tasks(start_time DESC, session_id)`。
-**不引入 FTS5**（复杂度不值）。
-
-### 2.4 新 Endpoint `GET /api/tasks/projects`
-
-前端项目下拉需要"所有项目"列表：
-
-```sql
-SELECT DISTINCT s.project_path FROM sessions s JOIN tasks t ON t.session_id = s.session_id;
-```
-
----
-
-## 3. 前端设计
-
-### ⚠️ 重要发现
-
-调研显示前端是**原生 HTML + Vanilla JS**（`src/web/static/index.html` 单文件），不是 CLAUDE.md 描述的 React/Vite。当前页面切换通过 `nav(pageName)` + `id="page-xxx"` div 控制。
-
-> **请用户确认**：(a) spec 按 Vanilla JS 实施（与现状一致）；(b) 顺手迁移到 React（额外大改）；(c) CLAUDE.md 该改技术栈描述
-
-### 3.2 新增 `#page-tasks` 视图
-
-Sidebar 加 "Tasks" 导航项。
-
-```
-page-tasks
-├── .toolbar
-│   ├── #tasks-project-filter   (多选 select)
-│   ├── #tasks-range-filter     (1h/24h/7d/自定义)
-│   ├── #tasks-date-from/to     (datetime-local，自定义时显示)
-│   └── #tasks-search           (300ms 防抖)
-├── <table id="tasks-table">    时间 / 标题 / 项目 / 状态 / 事件数
-└── .pagination-bar
-    ├── "共 N 条，第 X-Y"
-    ├── 每页 [20/50/100]
-    └── [上一页] [下一页]
-```
-
-### 3.3 URL 状态同步
-
-`URLSearchParams` + `history.pushState`：
-
-| URL | 控件 |
-|-----|------|
-| `project` | 多选下拉（可重复） |
-| `range` | 1h/24h/7d/custom |
-| `from`/`to` | 自定义时间 |
-| `search` | 搜索框 |
-| `page` | offset = (page-1) * limit |
-| `size` | 20/50/100 |
-
-### 3.4 防抖
-
-搜索框 `oninput` → setTimeout 300ms → `loadTasks()`，每次键入重置。
-
----
-
-## 4. 改动文件清单
-
-| 文件 | 改动 | 行数 |
-|------|------|------|
-| `src/core/storage/tasks.ts` | 扩展 filter + COUNT + project_path | +40 |
-| `src/core/storage/schema.sql` | 加复合索引 | +2 |
-| `src/web/routes/tasks.ts` | Zod 解析 + 多参数 + 返回结构 + `/projects` 子路由 | +50 |
-| `src/web/static/index.html` | `#page-tasks` 视图 + JS 函数 + URL 同步 + 防抖 | +200 |
-| `tests/unit/web/routes-tasks.test.ts` | 扩展参数组合用例 | +80 |
-
----
-
-## 5. 风险点
-
-| 风险 | 缓解 |
-|------|------|
-| tasks 无 project_path，需 JOIN sessions | `TaskRecord` 加可选 `project_path?` |
-| 项目下拉数据来源 | 新增 `/api/tasks/projects` |
-| project_path 太长（绝对路径） | 截断显示最后 2 段，title 属性放完整 |
-| 返回结构破坏性变更 | 搜 index.html 所有 `/api/tasks` 调用点同步更新 |
-| LIKE 性能 | <10k 行可接受，不引入 FTS5 |
-| 前端无组件测试 | 仅 route 集成测试，前端 E2E 手工 |
-
----
-
-## 6. 测试策略
-
-### 单元测试 `tests/unit/web/routes-tasks.test.ts`
-
-- `project` 单值/多值（OR）
-- `from`/`to` 边界
-- `search` LIKE 匹配（SQLite ASCII 不区分大小写）
-- `limit` clamp
-- `offset` 分页 + `has_more` 准确
-- 返回结构 schema
-- `GET /api/tasks/projects` 去重
-
-### 集成测试
-
-新建 `tests/integration/tasks-filter.test.ts`，真实 SQLite 验证 JOIN + COUNT。
-
-### 前端 E2E
-
-按 A1-A8 在 dashboard 手工验证 + 截图。
-
----
-
-## 7. 执行步骤（自底向上）
-
-1. `schema.sql` — 加索引 `idx_tasks_start_time_session`
-2. `storage/tasks.ts` — 扩 filter / JOIN / COUNT / project_path
-3. Storage 单元测试
-4. `routes/tasks.ts` — Zod + 多参数 + 返回结构 + `/projects`
-5. Route 单元测试
-6. `index.html` — `#page-tasks` 视图 + JS + URL 同步 + 防抖
-7. `npm test` + `npx tsc --noEmit`
-8. 按 A1-A8 手工验收
-
----
-
-**Hybrid-feature-with-safety 工作流**：先 safety-net（扩展 routes-tasks 现有测试，锁定旧 `Task[]` 返回行为）→ design → implement → test → review

package/docs/implementation/daemon-skill-sync-changelog-20260518-2000.md

@@ -1,22 +0,0 @@
-# daemon skill 自动同步 Changelog
-
-**Date**: 2026-05-18 20:00
-**Status**: 完成
-
-## 背景
-类比 v8.51.1 hook-sync：npm 升级 dist/skills/official/ 但不会自动同步
-~/.claude/skills/ 本地副本，SkillRegistry 优先级 user > official 加载
-旧副本，导致 skill 残缺/功能错乱。
-
-## 改动
-- 新建 src/daemon/skill-sync.ts: syncSkills() sha256 比对自动同步
-- daemon/index.ts 启动时调用（紧挨 syncHooks）
-- 失败 logger.warn 不阻断
-
-## 测试
-- 5 case 单测全过
-- 现有测试不退化
-- tsc 0 errors
-
-## 已知问题
-- linkEventToTask pre-existing（sqlite-refactor-harness.test.ts）