codewiki-plus 5.2.2__tar.gz → 5.4.0__tar.gz

{codewiki_plus-5.2.2/codewiki_plus.egg-info → codewiki_plus-5.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codewiki-plus
-Version: 5.2.2
+Version: 5.4.0
 Summary: Transform codebases into comprehensive documentation using AI-powered analysis
 Author: CodeWiki Contributors
 License: MIT
@@ -93,6 +93,15 @@ Requires-Dist: ruff>=0.1.0; extra == "dev"
 
 ## 中文
 
+### 专栏文章
+
+「迎风追日 / WanderingBug」公众号发布的本项目系列技术专栏，欢迎阅读：
+
+- [专栏开篇词：从代码文档到 AI 知识引擎](https://mp.weixin.qq.com/s/WpjiDAs62_81mytBWUsDQw)（2026-07-26）
+- [第 2 篇：双层 Prompt 架构同时服务人和模型](https://mp.weixin.qq.com/s/1lNjR_SsrU5Fw2NKnkxnMA)（2026-08-01）
+- [第 3 篇：零依赖检索设计](https://mp.weixin.qq.com/s/T7r-ojyWC-YOpM_U5BNbEw)（2026-08-06）
+- [第 4 篇：知识写入方式全景](https://mp.weixin.qq.com/s/V90mghqB5wttKd25eXA-Pw)（2026-08-09）
+
 ### 这个项目是什么？
 
 CodeWiki-Plus 是 [FSoft-AI4Code/CodeWiki](https://github.com/FSoft-AI4Code/CodeWiki) 的增强分支，核心改动是**让 CodeWiki 无需配置任何大模型 API，直接由 AI IDE（CodeBuddy、Cursor、Claude Desktop 等）自身的模型驱动 Wiki 文档生成**，并在此基础上构建了完整的知识管理引擎。
@@ -103,7 +112,7 @@ CodeWiki-Plus 是 [FSoft-AI4Code/CodeWiki](https://github.com/FSoft-AI4Code/Code
 
 实际上，CodeWiki 的核心工具链——AST 解析、依赖图、Mermaid 校验——完全不需要 LLM。真正需要 LLM 智能的 4 个环节（模块聚类、文档撰写、子模块递归、总览合成），恰好是 AI IDE 的 Agent 最擅长做的事情。
 
-因此，我们将 CodeWiki 的 MCP Server 从"黑盒式一键生成"拆分为**28 个细粒度工具**，让它退化为纯工具链服务器。AI IDE 的 Agent 通过 MCP 协议调用这些工具，用自己的推理能力完成全部文档生成工作：
+因此，我们将 CodeWiki 的 MCP Server 从"黑盒式一键生成"拆分为**40 个细粒度工具**，让它退化为纯工具链服务器。AI IDE 的 Agent 通过 MCP 协议调用这些工具，用自己的推理能力完成全部文档生成工作：
 
 ```
 改造前：
@@ -119,15 +128,16 @@ CodeWiki-Plus 是 [FSoft-AI4Code/CodeWiki](https://github.com/FSoft-AI4Code/Code
 | 能力维度 | 原版 CodeWiki | CodeWiki-Plus |
 |----------|--------------|---------------|
 | LLM 配置 | 必须自行配置 API Key | 零配置，IDE 自身模型驱动 |
-| 生成模式 | 黑盒一键生成 | 28 个细粒度工具，Agent 全程可控 |
+| 生成模式 | 黑盒一键生成 | 40 个细粒度工具，Agent 全程可控 |
 | 文档质量 | 通用描述 | Evidence-Based 断言（代码引用 + 置信度） |
 | 生成效率 | 所有组件同等处理 | 代码路由分类，boilerplate 仅保留签名 |
 | 上下文精度 | 模块内组件 | BFS 1-hop 调用图扩展 + 约束索引表 |
 | 增量更新 | 文件级 Git diff | 方法级 content_hash 精确检测 |
 | 知识管理 | 无 | 结构化 Wiki + 笔记飞轮 + 外部文档管理 |
+| 任务记忆 | 无 | 跨会话任务上下文 + 任务记忆暂存确认 |
 | 搜索能力 | 无 | BM25 + wikilink 图谱多跳 + 渐进式阅读 |
 | 跨服务分析 | 无 | Monorepo 子服务检测 + 跨服务调用追踪 |
-| 质量保障 | 无 | 16 项 lint 检查 + health score + 问题追踪 |
+| 质量保障 | 无 | 18 项 lint 检查 + health score + 问题追踪 |
 
 ### 前置条件
 
@@ -175,7 +185,7 @@ codewiki --version
 }
 ```
 
-配置完成后，CodeBuddy 的 MCP 工具列表中应出现 `codewiki` 相关的 28 个工具。
+配置完成后，CodeBuddy 的 MCP 工具列表中应出现 `codewiki` 相关的 40 个工具。
 
 **第 3 步：在 Agent 模式中输入提示词**
 
@@ -230,6 +240,9 @@ repowiki/
 │   ├── pitfall-xxx.md           #   踩坑记录
 │   ├── workaround-xxx.md        #   临时方案
 │   └── ...
+├── tasks/                       # 任务记忆（跨会话长线工作上下文）
+│   ├── .index.json              #   任务索引
+│   └── <task_id>/               #   task.md + memories.md + pending-memories.json
 ├── .meta/
 │   ├── project.json             #   项目映射（repo_path/output_dir/cache_db 路径）
 │   ├── symbol_map.json          #   符号→源文件映射（SQLite 主存储的 JSON 兼容副本）
@@ -244,7 +257,7 @@ repowiki/
 
 ### MCP 工具速查
 
-所有工具均不需要 LLM 配置，由 IDE Agent 通过 MCP 协议调用。MCP Server 内置 **instructions**（能力概览与工作流指南）、**14 个工作流 Prompt**（覆盖初始化、生成、增量、搜索、质检、跨服务、团队记忆融合等全流程）和 **6 个 Resource**（wiki-catalog / module-tree / index-status 等）。
+所有工具均不需要 LLM 配置，由 IDE Agent 通过 MCP 协议调用。MCP Server 内置 **instructions**（能力概览与工作流指南）、**19 个工作流 Prompt**（覆盖初始化、生成、增量、搜索、质检、跨服务、团队记忆融合、任务记忆等全流程）和 **6 个 Resource**（wiki-catalog / module-tree / index-status 等）。
 
 **代码分析（6 个）：**
 
@@ -268,7 +281,7 @@ repowiki/
 | `get_prompt` | 获取各阶段的提示词模板（含 16 种 prompt_type） |
 | `close_session` | 关闭会话释放资源，构建 BM25 索引 + wikilink 图谱，写入生成元数据 |
 
-**知识管理（7 个）：**
+**知识管理（10 个）：**
 
 | 工具 | 用途 |
 |------|------|
@@ -276,15 +289,18 @@ repowiki/
 | `ingest_note` | 将开发笔记归档到 notes/，支持 8 种类型 + aliases + source_ref；默认写入为 candidate 状态 |
 | `confirm_note` | 将 candidate 笔记升级为 confirmed（正式领域知识） |
 | `reject_note` | 否决 candidate 笔记，后续 query_wiki 不再返回 |
+| `batch_set_status` | 批量流转笔记状态（确认/否决多条笔记一次完成） |
 | `ingest_source` | 导入第三方文档到 `raw/sources/`，注册到 `source_registry.json` |
 | `retract_source` | 撤回已导入的外部文档（flag_stale / remove_refs 两种模式） |
 | `batch_ingest` | 批量导入：一次调用处理多个笔记/文档 |
+| `init_wiki` | 初始化 Wiki 工作区目录结构与项目级 schema.yaml |
+| `wiki_stats` | Wiki 知识库统计（页面数、笔记状态分布、覆盖率概览） |
 
 **质量保障（2 个）：**
 
 | 工具 | 用途 |
 |------|------|
-| `lint_wiki` | 文档-代码一致性检查：**16 项检查**（含 unsupported_claims 无证据断言检测） |
+| `lint_wiki` | 文档-代码一致性检查：**18 项检查**（含 unsupported_claims 无证据断言检测、low_adoption 低采纳检测） |
 | `flag_issue` | 标记 Wiki 质量问题，驱动 health score 计算 |
 
 **跨服务分析（1 个）：**
@@ -300,6 +316,23 @@ repowiki/
 | `capture_conversation` | 采集对话转录到 repowiki/raw/，仅落盘不蒸馏，支持 session 覆盖去重 |
 | `distill_conversation` | 蒸馏 raw 对话为 Wiki 笔记：Mode C prepare → Agent 提取 → submit 入库（status=draft），需 confirm_note 确认 |
 
+**任务管理（12 个）：**
+
+| 工具 | 用途 |
+|------|------|
+| `create_task` | 创建长线任务（task_id 由标题 slugify 生成，不可变、不允许重名） |
+| `list_tasks` | 列出任务，支持 status 过滤（active / completed） |
+| `get_task` | 查看单个任务详情 |
+| `get_task_context` | 拉取任务描述 + 记忆 + 关联笔记，作为继续工作的上下文；返回 pending_raw_count 提示补蒸馏 |
+| `set_session_task` | 将当前会话绑定到任务，后续采集/蒸馏自动携带 task_id |
+| `add_task_memory` | 手动向任务追加进度记忆 |
+| `stage_task_memories` | 暂存候选任务记忆（待确认） |
+| `list_pending_memories` | 列出待确认的任务记忆 |
+| `confirm_task_memories` | 确认暂存记忆，落盘到任务 memories.md |
+| `reject_task_memories` | 否决暂存记忆 |
+| `complete_task` | 完成任务 |
+| `delete_task` | 删除任务（级联删除任务目录与绑定，但不删已打 task_id 标签的笔记） |
+
 > 另有 2 个遗留工具（`generate_docs`、`get_module_tree`）保留向后兼容，需先通过 `codewiki config set` 配置 LLM API。
 
 ### 文档生成质量增强
@@ -417,6 +450,49 @@ LLM 发现跨功能约束
 - 自动采集 Hook 只落 raw，永不自动蒸馏；蒸馏须显式调用 `distill_conversation`。
 - `repowiki/raw/` 是暂存区，不进 `query_wiki` 检索；蒸馏完成后由工具自动清理（除非 `keep_raw`）。
 - 触发形态为 **both**：手动命令（主）+ IDE Hook（可选）。
+- 自动采集/任务引导 Hook 接线支持 **CodeBuddy（`.codebuddy/`）、Qoder（`.qoder/`）、Claude Code（`.claude/`）**，启用时运行 `codewiki install-hooks --repo-path <repo>` 自动检测项目根目录存在哪些 IDE 配置目录，检测到哪些就为哪些接线（拷贝 hook 脚本与 distill-worker subagent、幂等合并 settings.json、写入 AGENTS.md 引导段）；采集脚本对事件载荷做了通用化处理。
+
+**隐私语义（T2 团队遥测）：** `query_wiki` 的检索命中与 `capture_conversation` 的采纳记录会以 `user_id`（优先 `CODEWIKI_USER` 环境变量，回退 `git config user.name` / 系统登录名）署名写入 `repowiki/.meta/telemetry/<user_id>.jsonl` 并随仓库共享——此前这是 gitignore 的本机私有数据。`user_id` 不做鉴权（信任模型与 confirm 闸门一致：能提交即团队可信成员），仅作命名空间；不愿以 git 真名署名的成员可用 `CODEWIKI_USER` 设置花名，或在 `schema.yaml` 中设 `conventions.telemetry.enabled: false` 退回纯本机模式（写入 `repowiki/.meta/telemetry-local/`，已 gitignore，聚合逻辑不变）。
+
+### 任务记忆（Task Memory）
+
+任务记忆解决"长线工作跨会话断片"的问题：一个任务往往持续数天、横跨多个会话，Agent 每次重启都要从零了解"上次做到哪了"。任务记忆与 Wiki 笔记互补——**Wiki 笔记沉淀跨任务的通用经验，任务记忆保存任务范围内的进度知识**（本次做了什么、下一步、待办）。
+
+**工作流：**
+
+```
+会话开始：
+  list_tasks(status="active") → 选择关联已有任务或新建
+  → set_session_task 绑定会话（后续采集自动携带 task_id）
+  → get_task_context 拉取任务描述 + 记忆 + 关联笔记
+  → 若 pending_raw_count > 0：委托「蒸馏 worker」subagent 后台补蒸馏，不阻塞开始工作
+
+会话过程中：
+  distill_conversation 双轨产出：
+    notes    → 通用知识笔记（走 confirm_note 评审）
+    memories → 任务进度记忆（先暂存 pending）
+  → confirm_task_memories 确认后落盘 memories.md
+```
+
+**存储结构：**
+
+```
+repowiki/
+├── tasks/
+│   ├── .index.json           # 任务索引
+│   └── <task_id>/
+│       ├── task.md           # 任务描述
+│       ├── memories.md       # 已确认的任务记忆（追加式原子写）
+│       └── pending-memories.json  # 待确认记忆暂存
+└── .meta/
+    └── task_bindings/        # 会话 ↔ 任务绑定
+```
+
+**关键约束：**
+
+- task_id 由标题 slugify 生成且不可变；同名任务被拒绝；无重命名（删除后重建）。
+- 任务记忆先暂存、经 `confirm_task_memories` 确认后才落盘，与笔记评审闸门对齐。
+- 可选的 IDE SessionStart Hook（默认关闭）在会话开始时自动提示关联任务。
 
 ### 渐进式阅读协议
 
@@ -510,7 +586,7 @@ CodeWiki-Plus 采用 **SQLite 主存储 + JSON 兼容副本** 的双层架构：
 
 #### 文档健康检查
 
-`lint_wiki` 提供 **16 项检查**，覆盖结构完整性和内容质量：
+`lint_wiki` 提供 **18 项检查**，覆盖结构完整性和内容质量：
 
 | 检查项 | 说明 |
 |--------|------|
@@ -529,7 +605,10 @@ CodeWiki-Plus 采用 **SQLite 主存储 + JSON 兼容副本** 的双层架构：
 | `isolated_components` | 零依赖零被依赖的孤立组件 |
 | `stale_notes` | 超过 90 天且 60 天内未被检索的已确认笔记 |
 | `note_clusters` | 同模块同类型笔记 ≥3 条，建议合并 |
+| `low_adoption` | 高频召回（≥5 次）但零采纳的 stable 笔记——内容相关但不够 actionable，建议按「步骤/命令/预期结果」重写 |
 | `okf_conformance` | OKF v0.2 合规审计：缺失 type/frontmatter、旧版状态词、verified 格式错误、stale_after 过期、缺 okf_version |
+| `scenario_capacity` | L2 场景块数量达到/超过容量上限（error/warning 分级），需先 MERGE 腾位再新增 |
+| `scenario_orphan` | 无来源标注（metadata.source_notes）且长期未被检索的孤儿场景块，可能冗余或过时 |
 
 `lint_wiki` 返回 **health_score**（0-100），计算方式为 `100 - Σ(error×10 + warning×3 + info×1)`。
 
@@ -579,7 +658,7 @@ CodeWiki-Plus 采用 **SQLite 主存储 + JSON 兼容副本** 的双层架构：
 
 #### 工作流 Prompt
 
-MCP Server 内置 **14 个工作流 Prompt**，在 AI IDE 中通过 Prompt 面板直接触发，Agent 自动编排多工具调用：
+MCP Server 内置 **19 个工作流 Prompt**，在 AI IDE 中通过 Prompt 面板直接触发，Agent 自动编排多工具调用：
 
 | Prompt 名称 | 面向场景 | 核心步骤 |
 |-------------|----------|----------|
@@ -593,10 +672,11 @@ MCP Server 内置 **14 个工作流 Prompt**，在 AI IDE 中通过 Prompt 面
 | `architecture-review` | 架构审查与热点分析 | 依赖图分析 → 核心层/服务层/应用层识别 → Top 5 热点 → 耦合风险 → 入口点 |
 | `extract-knowledge` | 外部文档知识提取 | ingest_source 导入 → extraction_scan 候选提取 → 实体/概念页面生成 → wikilink 图谱 |
 | `search-wiki` | 知识库搜索策略指引 | query_wiki（BM25）→ 图谱多跳扩展 → 渐进式阅读（overview → directory → detail） |
-| `quality-check` | Wiki 质量全面检查 | lint_wiki（16 项检查）→ health_score → flag_issue 标记 → 修复建议 |
+| `quality-check` | Wiki 质量全面检查 | lint_wiki（18 项检查）→ health_score → flag_issue 标记 → 修复建议 |
 | `ingest-note` | 经验知识归档 | ingest_note（8 种类型）→ candidate 状态 → confirm/reject 流转 → BM25 索引 |
 | `team-memory-hook` | 对话自动采集管理 | 检查状态 → 启用（注册 SessionEnd 事件）/ 关闭 → 验证 |
 | `distill-conversations` | 对话蒸馏提取经验 | prepare 取 transcript → Agent 提取知识 → submit 去重入库 → confirm/reject 评审 |
+| `task-workflow` | 任务记忆完整工作流 | 会话开始关联任务 → 补蒸馏 → get_task_context → 工作中沉淀 memories → confirm 落盘 |
 
 ### 使用场景示例
 
@@ -650,7 +730,7 @@ Agent 调用 `confirm_note(note_file="pitfall-redis-connection-pool.md")`，升
 检查一下 Wiki 文档的健康状况。
 ```
 
-Agent 调用 `lint_wiki`，返回 16 项诊断报告和 health_score。
+Agent 调用 `lint_wiki`，返回 18 项诊断报告和 health_score。
 
 **场景 8：跨服务调用分析**
 
@@ -660,6 +740,14 @@ Agent 调用 `lint_wiki`，返回 16 项诊断报告和 health_score。
 
 Agent 调用 `analyze_repo`（自动检测子服务）→ `query_cross_service(filter_type="all")`。
 
+**场景 9：跨会话延续长线任务**
+
+```
+继续上次的"支付重构"任务。
+```
+
+Agent 调用 `list_tasks` 找到任务 → `set_session_task` 绑定会话 → `get_task_context` 恢复上下文（做了什么、下一步），若有未蒸馏对话委托「蒸馏 worker」subagent 后台补蒸馏（不阻塞），然后无缝继续工作。
+
 ### 支持的其他 AI IDE
 
 除 CodeBuddy 外，任何支持 MCP stdio 协议的 AI IDE 均可使用：
@@ -700,7 +788,7 @@ Python、Java、JavaScript、TypeScript、C、C++、C#、Kotlin、Go、PHP
 - [Tencent/WeKnora](https://github.com/Tencent/WeKnora) — 外部文档管理、文档健康检查、自适应分块思路
 - [CodingHub](https://github.com/mambo-wang/CodingHub) — MCP Server 最佳实践（instructions / prompts / resources）
 
-我们在上游基础上将 MCP Server 从黑盒模式拆分为 **28 个细粒度工具**，并新增结构化 Wiki、Evidence-Based 断言、代码路由分类、知识飞轮、渐进式阅读、方法级增量检测、monorepo 跨服务分析、团队记忆融合等能力。
+我们在上游基础上将 MCP Server 从黑盒模式拆分为 **40 个细粒度工具**，并新增结构化 Wiki、Evidence-Based 断言、代码路由分类、知识飞轮、渐进式阅读、方法级增量检测、monorepo 跨服务分析、团队记忆融合、任务记忆等能力。
 
 上游论文：[CodeWiki: Evaluating AI's Ability to Generate Holistic Documentation for Large-Scale Codebases](https://arxiv.org/abs/2510.24428)
 
@@ -732,7 +820,7 @@ The original CodeWiki is an excellent repository-level documentation framework.
 
 In practice, CodeWiki's core toolchain—Tree-sitter AST parsing, dependency graph construction, topological sorting, and Mermaid validation—does not need an LLM at all. The 4 stages that do require LLM intelligence (module clustering, document writing, sub-module recursion, and overview synthesis) are exactly what AI IDE Agents excel at.
 
-We refactored CodeWiki's MCP Server from a "one-click black box" into **28 fine-grained tools**, turning it into a pure toolchain server. The AI IDE's Agent calls these tools via MCP and uses its own reasoning to complete all documentation work:
+We refactored CodeWiki's MCP Server from a "one-click black box" into **40 fine-grained tools**, turning it into a pure toolchain server. The AI IDE's Agent calls these tools via MCP and uses its own reasoning to complete all documentation work:
 
 ```
 Before:
@@ -748,15 +836,16 @@ After:
 | Dimension | Upstream CodeWiki | CodeWiki-Plus |
 |-----------|------------------|---------------|
 | LLM config | Must configure API key | Zero-config, IDE model driven |
-| Generation mode | Black-box one-click | 28 fine-grained tools, full Agent control |
+| Generation mode | Black-box one-click | 40 fine-grained tools, full Agent control |
 | Doc quality | Generic descriptions | Evidence-Based assertions (code quotes + confidence) |
 | Generation efficiency | All components equal | Code routing: boilerplate gets signature-only |
 | Context precision | Intra-module components | BFS 1-hop call graph + constraint index table |
 | Incremental update | File-level Git diff | Method-level content_hash detection |
 | Knowledge management | None | Structured Wiki + note flywheel + external docs |
+| Task memory | None | Cross-session task context + pending-confirm task memories |
 | Search | None | BM25 + wikilink graph multi-hop + progressive reading |
 | Cross-service | None | Monorepo sub-service detection + call tracing |
-| Quality assurance | None | 16 lint checks + health score + issue tracking |
+| Quality assurance | None | 17 lint checks + health score + issue tracking |
 
 ### Prerequisites
 
@@ -827,7 +916,7 @@ Stage 5: Call close_session to free resources, build search index
 
 ### MCP Tools
 
-All tools require zero LLM config. The IDE Agent invokes them via MCP. The server includes built-in **instructions**, **14 Workflow Prompts** (covering init, generation, incremental update, search, quality check, cross-service analysis, team memory fusion), and **6 Resources**.
+All tools require zero LLM config. The IDE Agent invokes them via MCP. The server includes built-in **instructions**, **19 Workflow Prompts** (covering init, generation, incremental update, search, quality check, cross-service analysis, team memory fusion, task memory), and **6 Resources**.
 
 **Code Analysis (6):**
 
@@ -851,7 +940,7 @@ All tools require zero LLM config. The IDE Agent invokes them via MCP. The serve
 | `get_prompt` | Retrieve prompt templates (23 prompt_types) |
 | `close_session` | Close session, build BM25 index + wikilink graph, write metadata |
 
-**Knowledge Management (7):**
+**Knowledge Management (10):**
 
 | Tool | Purpose |
 |------|---------|
@@ -859,15 +948,18 @@ All tools require zero LLM config. The IDE Agent invokes them via MCP. The serve
 | `ingest_note` | File structured notes (8 types) with aliases + source_ref; default candidate status |
 | `confirm_note` | Promote candidate note to confirmed knowledge |
 | `reject_note` | Reject candidate note, exclude from future searches |
+| `batch_set_status` | Batch transition note statuses (confirm/reject multiple at once) |
 | `ingest_source` | Import third-party docs into `raw/sources/` |
 | `retract_source` | Retract imported docs (flag_stale / remove_refs) |
 | `batch_ingest` | Batch import multiple notes/sources in one call |
+| `init_wiki` | Initialize Wiki workspace directories and project-level schema.yaml |
+| `wiki_stats` | Wiki statistics (page counts, note status distribution, coverage overview) |
 
 **Quality Assurance (2):**
 
 | Tool | Purpose |
 |------|---------|
-| `lint_wiki` | Doc-code consistency: **16 checks** (incl. unsupported_claims evidence detection) |
+| `lint_wiki` | Doc-code consistency: **18 checks** (incl. unsupported_claims evidence detection, low_adoption utility check, and L2 scenario hygiene) |
 | `flag_issue` | Flag quality issues, drives health score |
 
 **Cross-Service Analysis (1):**
@@ -883,6 +975,23 @@ All tools require zero LLM config. The IDE Agent invokes them via MCP. The serve
 | `capture_conversation` | Capture conversation transcripts to repowiki/raw/ (persistence only, no distillation); session-level supersede dedup |
 | `distill_conversation` | Distill raw conversations into Wiki notes: Mode C prepare → Agent extracts → submit (status=draft); requires confirm_note |
 
+**Task Management (12):**
+
+| Tool | Purpose |
+|------|---------|
+| `create_task` | Create a long-running task (task_id slugified from title, immutable, no duplicates) |
+| `list_tasks` | List tasks with status filtering (active / completed) |
+| `get_task` | Inspect a single task |
+| `get_task_context` | Fetch task description + memories + related notes as working context; reports pending_raw_count for catch-up distillation |
+| `set_session_task` | Bind the current session to a task; subsequent captures/distillations carry task_id automatically |
+| `add_task_memory` | Manually append a progress memory to a task |
+| `stage_task_memories` | Stage candidate task memories (pending confirmation) |
+| `list_pending_memories` | List pending task memories |
+| `confirm_task_memories` | Confirm staged memories, persist to the task's memories.md |
+| `reject_task_memories` | Reject staged memories |
+| `complete_task` | Mark a task complete |
+| `delete_task` | Delete a task (cascades task dir and bindings, but keeps tagged notes) |
+
 > 2 legacy tools (`generate_docs`, `get_module_tree`) retained for backward compatibility.
 
 ### Documentation Quality Enhancements
@@ -955,6 +1064,46 @@ Inspired by Team-Agent-Memory's "extract retrievable experience from conversatio
 - The automatic capture hook only writes raw; it never distills. Distillation must be invoked explicitly via `distill_conversation`.
 - `repowiki/raw/` is a staging area excluded from `query_wiki`; it is cleaned up after distillation automatically (unless `keep_raw`).
 - Trigger form is **both**: manual command (primary) + IDE hook (optional).
+- The capture / task-guidance hooks are wired for **CodeBuddy (`.codebuddy/`), Qoder (`.qoder/`) and Claude Code (`.claude/`)**. To enable, run `codewiki install-hooks --repo-path <repo>`: it auto-detects which IDE config dirs exist in the project root and wires each one found (copies the hook scripts and the distill-worker subagent, idempotently merges `settings.json` hook registrations, and upserts the AGENTS.md task-guidance section). The capture script parses generic event payloads.
+
+**Privacy semantics (T2 team telemetry):** `query_wiki` retrieval hits and `capture_conversation` adoption records are written to `repowiki/.meta/telemetry/<user_id>.jsonl` (committed to the repo) under a `user_id` resolved from the `CODEWIKI_USER` env var, falling back to `git config user.name` / the OS login name — this data used to be a gitignored local file. The `user_id` is not an auth mechanism (trust model equals the confirm gate: anyone who can commit is a trusted teammate), it is a namespace only. Members who prefer not to sign telemetry with their git name can set a pseudonym via `CODEWIKI_USER`, or set `conventions.telemetry.enabled: false` in `schema.yaml` to fall back to local-only mode (written to `repowiki/.meta/telemetry-local/`, gitignored; aggregation is unchanged).
+
+### Task Memory
+
+Task Memory solves the "cross-session amnesia" problem for long-running work: a task often spans days and multiple sessions, and the Agent normally restarts from zero. Task Memory complements Wiki notes — **Wiki notes capture cross-task general knowledge, while task memories hold task-scoped progress** (what was done, what's next, todos).
+
+**Workflow:**
+
+```
+Session start:
+  list_tasks(status="active") → pick an existing task or create one
+  → set_session_task binds the session (captures carry task_id automatically)
+  → get_task_context restores description + memories + related notes
+  → if pending_raw_count > 0: catch-up distillation before working
+
+During the session:
+  distill_conversation produces two tracks:
+    notes    → general knowledge notes (confirm_note review)
+    memories → task progress memories (staged as pending first)
+  → confirm_task_memories persists them to memories.md
+```
+
+**Storage layout:**
+
+```
+repowiki/
+├── tasks/
+│   ├── .index.json                # task index
+│   └── <task_id>/                 # task.md + memories.md + pending-memories.json
+└── .meta/
+    └── task_bindings/             # session ↔ task bindings
+```
+
+**Key constraints:**
+
+- task_id is slugified from the title and immutable; duplicate titles are rejected; no rename (delete and recreate).
+- Task memories are staged first and only persisted after `confirm_task_memories`, aligned with the note review gate.
+- An optional IDE SessionStart hook (off by default) can prompt task association at session start.
 
 ### Progressive Reading Protocol
 
@@ -969,7 +1118,7 @@ Inspired by Team-Agent-Memory's "extract retrievable experience from conversatio
 
 ### Workflow Prompts
 
-The MCP server includes **14 built-in workflow prompts** that can be triggered from the AI IDE's prompt panel. The Agent automatically orchestrates multi-tool calls:
+The MCP server includes **19 built-in workflow prompts** that can be triggered from the AI IDE's prompt panel. The Agent automatically orchestrates multi-tool calls:
 
 | Prompt | Scenario | Core Steps |
 |--------|----------|------------|
@@ -983,10 +1132,11 @@ The MCP server includes **14 built-in workflow prompts** that can be triggered f
 | `architecture-review` | Architecture review & hotspot analysis | Dependency graph → layer identification → Top 5 hotspots → coupling risks → entry points |
 | `extract-knowledge` | External document knowledge extraction | ingest_source → extraction_scan → entity/concept pages → wikilink graph |
 | `search-wiki` | Knowledge base search strategy | query_wiki (BM25) → graph multi-hop expansion → progressive reading |
-| `quality-check` | Comprehensive Wiki quality check | lint_wiki (16 checks) → health_score → flag_issue → fix suggestions |
+| `quality-check` | Comprehensive Wiki quality check | lint_wiki (18 checks) → health_score → flag_issue → fix suggestions |
 | `ingest-note` | Experience knowledge archiving | ingest_note (8 types) → candidate status → confirm/reject → BM25 index |
 | `team-memory-hook` | Conversation capture hook management | Check status → enable (register SessionEnd event) / disable → verify |
 | `distill-conversations` | Conversation distillation | prepare fetch transcripts → Agent extracts → submit ingest → confirm/reject review |
+| `task-workflow` | Full task memory workflow | Associate task at session start → catch-up distillation → get_task_context → accumulate memories → confirm |
 
 ### Supported Languages