pmem-ai 0.6.3 → 0.7.0

package/docs/handover-v0.6.4.md

@@ -0,0 +1,285 @@
+# v0.6.4 Handover
+
+This handover focuses on **polish 5 — session 状态丢失根因排查** (v0.6.4 pre-design §4.1).
+Other v0.6.4 polish items (1, 2, 3, 4, 6, 7, 8) are tracked in their own commits
+and are not in scope of this document.
+
+---
+
+## Session 状态丢失根因排查
+
+### 排查方法
+
+**目标症状：** `pmem session end` 在已经 `pmem session start` 后偶发输出
+`No active pmem session found.`（来源：`src/commands/session.ts:78-83`）。
+v0.6.2 pre-design §5.6 列出三个候选根因：
+
+1. WAL 模式写入可见性
+2. `closeDatabase()` 时机错误
+3. 多次 `start` 隐式行为
+
+**核心 CRUD 流程（已审阅，行号锚点）：**
+
+- `src/commands/session.ts:23-51` — `sessionStartCommand`：
+  - L23 `openDatabase(pmemPath)`
+  - L24 `createSchema(db)`
+  - L27 `getActiveSession(db)` 防多次 start
+  - L38 生成 `session-YYYYMMDD-HHmmss` ID
+  - L41 `startSession(db, sessionId, agentName)`
+  - L51 `closeDatabase()`
+- `src/commands/session.ts:70-129` — `sessionEndCommand`：
+  - L74 `getActiveSession(db)`
+  - L77-83 **报错路径**（"No active pmem session found"）
+  - L86 `endSession(db, active.id, ...)`
+- `src/core/db.ts:115-124` — `sessions` 表 schema：
+  - PK 是 `id`（即 `session-YYYYMMDD-HHmmss`）
+  - 关键字段：`ended_at`、`status`
+- `src/core/db.ts:295-312` — session CRUD：
+  - L295-299 `startSession`：`INSERT OR REPLACE INTO sessions (id, agent_name, started_at, status, dirty) VALUES (?, ?, ?, 'active', 0)`
+  - L301-305 `endSession`：`UPDATE sessions SET ended_at, status, task_summary WHERE id = ?`
+  - L307-312 `getActiveSession`：`SELECT ... WHERE ended_at IS NULL ORDER BY started_at DESC LIMIT 1`
+- `src/core/db.ts:8-26` — `openDatabase`：
+  - L14 `pragma('journal_mode = WAL')`
+  - L15 `pragma('foreign_keys = ON')`
+- `src/core/db.ts:28-33` — `closeDatabase`：
+  - 直接 `_db.close()`，better-sqlite3 会自动 checkpoint WAL
+- `src/core/db.ts:233-244` — **关键嫌疑点** `clearAllTables`：
+  - L242 `DELETE FROM sessions;` ← 任何调用方都会清空 sessions 表
+- `src/commands/rebuild.ts:46`（修改前） — `clearAllTables` **唯一调用方**就是 `rebuild --full`
+
+**锁流程审阅结论：** `session.ts` 不使用 `acquireLock`/`releaseLock`
+（grep `src/commands/session.ts` 无任何 lock 调用）。锁竞争与 session 状态丢失**无关**。
+
+### 复现结果
+
+**Scenario A — plain start/end 循环 20 次：**
+
+```bash
+cd /Users/kerye/Codings/pmem/temp/polish-5-test
+rm -rf .pmem
+npx ts-node ../../src/index.ts init polish-5-test
+npx ts-node ../../src/index.ts rebuild
+N_CYCLES=20 /Users/kerye/Codings/pmem/scripts/repro-session-loss.sh
+```
+
+输出（已剪裁）：
+
+```
+Scenario A: 20 plain start/end cycles...
+A start fails : 0
+A end   losses: 0
+RESULT: not reproduced (0 failures across all scenarios)
+```
+
+→ **WAL 候选根因 1 排除。** better-sqlite3 在 `close()` 时自动
+checkpoint WAL，跨进程读取没有可见性问题。在 20 次循环后查看磁盘也没有
+残留的 `.pmem/pmem.db-wal` / `.pmem/pmem.db-shm` 文件。
+
+**候选根因 2（`closeDatabase()` 时机）排除：** better-sqlite3 是同步的，
+`prepare().run()` 返回时已写入 WAL；`closeDatabase()` 永远在 `startSession()` /
+`endSession()` 之后调用（`session.ts:41, 51` 与 `session.ts:86, 129`）。
+
+**候选根因 3（多次 start）排除：** `session.ts:27-32` 已有 idempotent guard：
+第二次 start 会检测到 active session 并提示 "Active session already exists"，
+不会覆盖。两并发 `session start` 进程的实测也只有一个能写入，另一个被 guard
+拦截。
+
+**Scenario B — start → `rebuild --full` → end（v0.6.4 新发现路径）：**
+
+```bash
+npx ts-node ../../src/index.ts session start -a "PreRebuild"
+# sessions 表里有 active session
+npx ts-node ../../src/index.ts rebuild --full
+# clearAllTables 触发 DELETE FROM sessions
+npx ts-node ../../src/index.ts session end -s "post-rebuild"
+```
+
+实测输出（修复前）：
+
+```
+=== Start ===
+Session started: session-20260601-173815
+=== sessions after start ===
+session-20260601-173815|
+
+=== rebuild --full ===
+Full rebuild: cleared all tables.
+
+=== sessions after rebuild --full ===
+(empty)
+
+=== end ===
+No active pmem session found.
+Next: run `pmem session start -a "<agent-name>"` to begin a session.
+```
+
+→ **稳定 100% 复现。**
+
+### 根因定位
+
+**根因：`pmem rebuild --full` 调用的 `clearAllTables()` 会执行
+`DELETE FROM sessions`，把进行中的 active session 一并清空。**
+
+- 代码定位：`src/core/db.ts:233-244` `clearAllTables()`，第 242 行
+  `DELETE FROM sessions;`。
+- 调用点：`src/commands/rebuild.ts:46`（修改前），是 `clearAllTables` 的
+  **唯一**调用方。
+- 触发路径：用户/agent 在 session 进行中接到诊断建议（
+  `src/core/db.ts:20` SQLITE_NOTADB、`src/commands/verify.ts:56`、
+  `src/commands/doctor.ts:90`、`src/commands/ask.ts:54` 都建议
+  `pmem rebuild --full`），运行后 session 立即丢失。
+
+**为什么之前 v0.6.2 候选根因没指向这里：** v0.6.2 排查聚焦在
+session 命令本身的并发/WAL 问题，未把 `rebuild --full` 纳入"间接路径"。
+实际上 session 状态是**运行时状态**而非从 Markdown 卡片派生的索引，
+理应在 "rebuild from cards" 流程中被保留。`clearAllTables` 同时清掉
+`sessions` 是 v0.3 早期 schema 引入时的遗留行为。
+
+### 修复方案
+
+**已修复。** 改动 1 个文件 1 段（5-29 行净增），不动 `session.ts` 和
+`db.ts`，把 `clearAllTables` 的语义包在 rebuild 命令层：rebuild 前快照
+active sessions，clear 后再原样写回。
+
+**修复 diff 摘要（`src/commands/rebuild.ts:45-72`）：**
+
+```typescript
+if (isFull) {
+  // v0.6.4 polish 5: preserve active sessions across `rebuild --full`.
+  // ... (rationale comment)
+  type ActiveSessionRow = {
+    id: string;
+    agent_name: string | null;
+    started_at: string;
+    ended_at: string | null;
+    task_summary: string | null;
+    base_index_hash: string | null;
+    status: string | null;
+    dirty: number;
+  };
+  const activeSessions = db
+    .prepare("SELECT id, agent_name, started_at, ended_at, task_summary, base_index_hash, status, dirty FROM sessions WHERE ended_at IS NULL")
+    .all() as ActiveSessionRow[];
+
+  clearAllTables(db);
+
+  if (activeSessions.length > 0) {
+    const restore = db.prepare(
+      "INSERT INTO sessions (id, agent_name, started_at, ended_at, task_summary, base_index_hash, status, dirty) VALUES (?, ?, ?, ?, ?, ?, ?, ?)"
+    );
+    for (const s of activeSessions) {
+      restore.run(s.id, s.agent_name, s.started_at, s.ended_at, s.task_summary, s.base_index_hash, s.status, s.dirty);
+    }
+    console.log(`Full rebuild: cleared all tables (preserved ${activeSessions.length} active session(s)).`);
+  } else {
+    console.log('Full rebuild: cleared all tables.');
+  }
+}
+```
+
+**为什么改 `rebuild.ts` 而不是 `db.ts`：**
+
+1. 不改 `clearAllTables` 的字面语义（仍然清空所有表），降低对其它潜在
+   调用方的语义冲击。
+2. 修复就近 root cause site（`rebuild --full` 是唯一现实触发路径），
+   不修改 session.ts 也不修改 db.ts，避免引入大改。
+3. 仍然清空 `update_log`、`dirty_flags`：那些是日志/标记，rebuild 后
+   失去关联也不直接破坏 session 生命周期；本次只修复"session end 找不到
+   active session"这条直接 user-facing 报错。
+
+**未在 v0.6.4 修复的次级影响（推迟到 v0.7+）：**
+
+- `update_log` 的 `session_id` 在 rebuild --full 后会指向被清空的旧
+  log 行。`pmem session end` 输出"Actions: 0 update(s), 0 trace(s)"
+  会偏低。属于"已知非阻塞"，不阻塞核心 session 关闭流程。
+- `dirty_flags` 的 `session_id` 同理。
+
+### E2E 验证
+
+**修复后 Scenario B 实测：**
+
+```
+=== Start ===
+Session started: session-20260601-174108
+=== sessions before rebuild --full ===
+session-20260601-174108||active
+=== rebuild --full (should preserve) ===
+Full rebuild: cleared all tables (preserved 1 active session(s)).
+Full rebuild: 0 cards processed, 0 skipped (hash match), 0 updated
+=== sessions after rebuild --full ===
+session-20260601-174108||active
+=== end ===
+Session ended: session-20260601-174108
+  Summary: fix-verify
+  Actions: 0 update(s), 0 trace(s) created
+```
+
+→ 复现路径修复，session end 正常关闭。
+
+**修复后无 active session 时回归：**
+
+```
+=== rebuild --full with no active session ===
+Full rebuild: cleared all tables.
+```
+
+→ 输出与修复前一致，零回归。
+
+**修复后 Scenario A（plain cycles）回归：**
+
+```
+A start fails : 0
+A end   losses: 0
+B end   loss  : 0
+RESULT: not reproduced (0 failures across all scenarios)
+```
+
+**单元测试：** `npm test` 137/137 通过，0 失败。
+
+**`npx tsc --noEmit`：** 0 error。
+
+### 复现脚本
+
+`/Users/kerye/Codings/pmem/scripts/repro-session-loss.sh`
+（v0.6.4 polish 5 新增，包含 Scenario A + Scenario B）。
+
+用法：
+
+```bash
+N_CYCLES=20 ./scripts/repro-session-loss.sh
+PROJECT_DIR=/tmp/foo ./scripts/repro-session-loss.sh
+```
+
+退出码 0 = 跑完（不区分是否复现），需读末尾 `RESULT:` 行判断。
+
+### 决策
+
+- **根因：** `clearAllTables` 一并清空 `sessions` 表 + `rebuild --full`
+  在诊断流程中被频繁建议。
+- **修复：** v0.6.4 polish 5 内修复完成，仅改 `src/commands/rebuild.ts`
+  一处，不改 `session.ts` 也不改 `db.ts`。
+- **范围纪律：** 没有触碰 `clearAllTables` 字面语义，没有引入
+  `--create-if-missing`，没有改 session lifecycle。
+- **推迟到 v0.7+：** `update_log` / `dirty_flags` 中指向被清空 session 的
+  孤立行，留作 v0.7 通用化阶段连带处理。
+
+---
+
+## 文件清单（polish 5 范围）
+
+| 文件 | 改动 |
+|------|------|
+| `src/commands/rebuild.ts` | 在 `--full` 分支前后快照/恢复 active sessions（行 45-72） |
+| `scripts/repro-session-loss.sh` | 新增复现脚本（Scenario A + Scenario B） |
+| `docs/handover-v0.6.4.md` | 本文件 |
+
+未触碰：`src/commands/session.ts`、`src/core/db.ts`、`src/core/fs.ts`。
+
+---
+
+## 审批记录
+
+| 角色 | 决定 | 日期 |
+|------|------|------|
+| 执行人 | 完成 polish 5 根因 + 修复 | 2026-06-02 |
+| CTO | 待审批 | 2026-06-02 |

package/docs/project-roadmap.md

@@ -22,6 +22,7 @@ CLI：`pmem`
 | v0.5 | Productization Beta | README、npm package、E2E、错误 UX、发布清单，上线 npm Beta |
 | v0.6 | Agent-native Workflow Polish | 非交互 init、友好错误、空结果引导、Claude Code slash commands |
 | v0.6.1 | Actionable Update Suggestions | `update --suggest` 去重、分级、compact 摘要、verify 语义对齐 |
+| v0.7.0 | Universal Agent Memory | 将 pmem 扩展为面向任何 domain 的通用 Agent 记忆运行时，支持自定义卡片类型 |
 
 ---
 
@@ -266,6 +267,76 @@ v0.6.1 是 v0.6 后的 patch release，现已完成发布。它不新增大型
 
 ---
 
+## v0.6.2 — Real-User Friction Fixes ✅ 已发布
+
+**主题：** 消除重度用户在真实项目中遭遇的 top-3 摩擦点，让 pmem 不成为工具链的阻塞点。
+
+v0.6.2 由首份重度用户反馈（voxo v1.0 项目，25 张卡片 + 27 条 trace + 完整 P0→发布周期）驱动，已完成并上线 npm。不改 memory schema，不做 embedding / MCP / REST / Graph UI / telemetry。
+
+| 功能 | 说明 |
+|------|------|
+| 锁竞争修复 | `acquireLock()` 自动清理 stale lock（60s+）；新增 `pmem verify --fix-locks`；错误信息增强；`pmem doctor` 锁状态检查 |
+| 卡片大小可配置 | 尊重 manifest `card_policy.max_tokens`；`pmem verify --relaxed` 临时翻倍限制；默认值上调（decision 800→1000、task 600→800） |
+| `pmem rename` | `--find/--replace` 默认 dry-run 预览；`--write` 才写入；`--find ""` 拒绝执行 |
+| `pmem recall --since` | 时间过滤（`--since 7d` / `24h` / `1w`）；rebuild 时间契约补全消除 `updated_at` NULL 漏洞 |
+| Exit code 修正 | `update --suggest` / `status` / `distill --suggest` 有结果时 exit 0；exit 1 不再作 workflow signal（**BREAKING**） |
+| `pmem new` 模板生成 | `pmem new <type> "<title>"` 自动生成 YAML frontmatter 骨架；type/title 创建时校验 |
+| `pmem integration install git-hooks` | pre-commit hook 自动跑 `pmem verify --relaxed` |
+
+详细设计：`docs/v0.6.2 pre-design.md`
+
+---
+
+## v0.6.3 — Relationship Auto-Discovery ✅ 已发布
+
+**主题：** 在不引入新依赖、不破坏 Markdown 单一真相源的前提下，让 pmem 能从代码侧自动发现项目内的模块 / 文件依赖关系，喂入图索引。
+
+v0.6.3 是 v0.6 track 的能力扩展版，已完成并上线 npm。`pmem discover` 扫 6 种语言（Node.js / Python / Rust / Go / C/C++ / Java）的 import 语句和包管理文件，把推断出来的边写入 `edges` 表（`source: inferred`），用户可选择性 promote（`--accept-edges`）或 reject（`--reject-edges`）。BUILTIN_MODULES skip-list + AmbiguousRelation severity 分类降低误报。
+
+| 功能 | 说明 |
+|------|------|
+| `pmem discover` | 跨 6 语言双层发现（源码 imports + 包管理 deps） |
+| `pmem discover --dry-run` | 预览不写入 |
+| `pmem discover --lang/--pattern-file/--min-confidence` | 过滤与自定义 pattern |
+| BUILTIN_MODULES 误报防护 | Node.js/Python/Go/Java/Rust/C++ stdlib 静默 drop |
+| `pmem related --format json` | 按 `high_confidence` / `needs_review` 分组；`--source explicit/inferred/all` 过滤 |
+| `pmem update --confirm --accept-edges/--reject-edges` | inferred → explicit 的 promote/demote |
+| manifest `discover.additional_patterns` | 扩展发现 provider |
+
+详细设计：`docs/v0.6.3 pre-design.md`（如有）
+
+---
+
+## v0.6.4 — Polish & Wrap v0.6 Track ✅ 已发布
+
+**主题：** 让 v0.6 track 干净收尾。8 项 polish + 2 项文档同步，**不**进入 v0.7.0 通用化（明确边界）。
+
+v0.6.4 不扩大能力边界，不改 manifest schema，不做通用化、embedding / MCP / REST / Graph UI / telemetry / 远程服务。它只完成 v0.6 期间累积的低风险 polish，让 v0.6 track 以稳定状态结束，并为 v0.7.0 通用化设计让出干净的工作基底。
+
+| 功能 | 说明 |
+|------|------|
+| `pmem rename` 字节级保留 | body 前导空白（紧贴 / 1 空行 / 2 空行 / 标准）逐字节保留；write 用 `content.substring(0, fmEndIndex) + newBody` 重建 |
+| `pmem rename --dry-run` frontmatter 扫描 | 扫 `aliases` / `tags` / `related` / `depends_on` 命中显示 diff 预览；`--write` 仍不动 frontmatter |
+| `pmem integration` version 字段 | install 时把 `pmem_integration_version` 写入实际文件 frontmatter/JSON 顶层；verify 读实际文件而非 manifest |
+| `pmem integration install claude-code` 真写 `.claude/settings.json` | 移除 `.example.json` 命名不一致 |
+| `pmem integration install cursor` | 新增 4 个 `.cursor/commands/pmem-*.md`（Cursor 0.46+ 约定） |
+| `pmem integration install codex` | AGENTS.md 新增 `## Commands` 章节（Codex CLI 不支持 `.codex/commands/`） |
+| `pmem doctor` lock 可读性 | active / stale / no-lock 三态分别输出 owner PID + age + 下一步建议 |
+| `pmem init --guided` 缺字段引导 | 缺 `--description` / `--stage` / `--next` 时输出可补参数提示 + 等价 CLI 命令 |
+| `pmem rebuild --full` session 保护 | snapshot / clearAllTables / restore 移进 doRebuild 事务（**之前在事务外，是 CTO 返工 3 修正的关键 bug**） |
+| `docs/project-roadmap.md` / `CHANGELOG.md` 同步 | 补 v0.6.2 / v0.6.3 / v0.6.4 三条 |
+
+推迟到 v0.7+：
+
+- `pmem session start --create-if-missing`（design 评估在 `docs/session-start-create-design-eval.md`）
+- 通用化（v0.7.0 主目标）
+- `pmem dirty list/resolve/prune`、完整 dirty lifecycle
+
+详细设计：`docs/v0.6.4 pre-design.md`
+根因报告：`docs/handover-v0.6.4.md`（session 状态丢失）
+
+---
+
 ## 版本间迁移路径
 
 ```
@@ -306,10 +377,10 @@ v0.6 → v0.6.1:
 ## 总览
 
 ```
-v0.1 ───→ v0.2 ───→ v0.3 ───→ v0.4 ───→ v0.5 ───→ v0.6 ───→ v0.6.1
-能用      防损坏    强一致    自动化    Beta上线  Agent原生  建议可行动
-10 cmd    14 cmd    16 cmd    18 cmd    产品化    低摩擦     去重分级
-文件模式   文件模式   +SQLite   +集成     +体验     +程序化调用 +摘要
+v0.1 ───→ v0.2 ───→ v0.3 ───→ v0.4 ───→ v0.5 ───→ v0.6 ───→ v0.6.1 ───→ v0.6.2 ───→ v0.6.3 ───→ v0.6.4
+能用      防损坏    强一致    自动化    Beta上线  Agent原生  建议可行动  真实摩擦修复  关系自动发现  收尾
+10 cmd    14 cmd    16 cmd    18 cmd    产品化    低摩擦     去重分级   +锁/重命名    +6语言扫描  +字节级
+文件模式   文件模式   +SQLite   +集成     +体验     +程序化调用 +摘要     +exit code    +误报防护   +事务
 ```
 
 ---
@@ -333,6 +404,60 @@ v0.1 ───→ v0.2 ───→ v0.3 ───→ v0.4 ───→ v0.5 ─
 - **v0.6.1:** ✅ 已发布（Actionable Update Suggestions）
   - 设计决策：`docs/v0.6.1 pre-design.md`
   - 发布状态：`v0.6.1` 已完成 CI 并上线 npm
+- **v0.6.2:** ✅ 已发布（Real-User Friction Fixes）
+  - 设计决策：`docs/v0.6.2 pre-design.md`
+- **v0.6.3:** ✅ 已发布（Relationship Auto-Discovery）
+- **v0.6.4:** ✅ 已发布（Polish & Wrap v0.6 Track）
+  - 设计决策：`docs/v0.6.4 pre-design.md`
+  - 根因报告：`docs/handover-v0.6.4.md`
+- **v0.7.0:** ✅ 已完成（Universal Agent Memory）
+  - 设计决策：`docs/v0.7.0 pre-design.md`
+
+---
+
+## v0.7.0 — Universal Agent Memory ✅ 已完成
+
+**主题：** 将 pmem 从"软件项目专用"扩展为"任意 agent 项目的本地记忆运行时"。支持自定义卡片类型，内置软件、小说、研究 presets，解决通用 recall/status 摩擦点。
+
+| 功能 | 说明 |
+|------|------|
+| Universal Presets | `pmem init --domain software|novel|research` 加载预设卡片类型与目录映射 |
+| Custom card types | 支持 manifest 声明任意卡片类型、目录映射及 token/section 限制，去除 VALID_TYPES 硬编码限制 |
+| Dynamic id_pattern | `{types}` 动态渲染，支持自定义卡片前缀正则校验 |
+| Generic Recall | JSON 增加 `active_foundation` 字段（根据预设 foundational_types 反馈），兼容保留 `active_modules` |
+| Generic Status | 消除对 `src/lib/app/tests` 硬编码扫描；读取 `change_detection.skip_dirs` / `mtime_scan_dirs` 及自定义卡片目录 |
+| Discover Disabled | 针对非软件 presets 默认关闭 `pmem discover`，支持 `discover.enabled: false` 配置与早停 exit 0 |
+| Skills & Ignores | 统一升级 `skills/task.md` 代替 `code-task.md`；去除了 AGENTS / CLAUDE 等模板中的软件术语绑定 |
+
+---
+
+## 当前状态
+
+- **v0.1:** ✅ 完成（10 个命令实现并测试）
+- **v0.2:** ✅ 完成（文件模式可信）
+  - 设计决策：`docs/v0.2 pre-design.md`
+  - 架构规划：`docs/v0.2 pre-roadmap.md`
+- **v0.3:** ✅ 完成（SQLite runtime）
+  - 设计决策：`docs/v0.3 pre-design.md`
+- **v0.4:** ✅ 完成（Agent workflow runtime）
+  - 设计决策：`docs/v0.4 pre-design.md`
+  - handover：`docs/handover-v0.4.md`
+- **v0.5:** ✅ 完成并上线 npm（Productization Beta）
+  - 设计决策：`docs/v0.5 pre-design.md`
+  - 发布清单：`docs/release-checklist-v0.5.md`
+- **v0.6:** ✅ 完成并上线 npm（Agent-native Workflow Polish）
+  - 设计决策：`docs/v0.6 pre-design.md`
+- **v0.6.1:** ✅ 已发布（Actionable Update Suggestions）
+  - 设计决策：`docs/v0.6.1 pre-design.md`
+  - 发布状态：`v0.6.1` 已完成 CI 并上线 npm
+- **v0.6.2:** ✅ 已发布（Real-User Friction Fixes）
+  - 设计决策：`docs/v0.6.2 pre-design.md`
+- **v0.6.3:** ✅ 已发布（Relationship Auto-Discovery）
+- **v0.6.4:** ✅ 已发布（Polish & Wrap v0.6 Track）
+  - 设计决策：`docs/v0.6.4 pre-design.md`
+  - 根因报告：`docs/handover-v0.6.4.md`
+- **v0.7.0:** ✅ 已完成（Universal Agent Memory）
+  - 设计决策：`docs/v0.7.0 pre-design.md`
 
 ---
 

package/docs/release-checklist-v0.7.0.md

@@ -0,0 +1,60 @@
+# pmem v0.7.0 Release Checklist
+
+Use this checklist before tagging or publishing v0.7.0.
+
+## Scope Check
+
+- [ ] Universal Agent Memory (presets, custom card types, and domain neutrality) is complete.
+- [ ] No embedding, MCP/REST, Graph UI, telemetry, or remote service was added.
+- [ ] Presets (software, novel, research) loading, custom directories creation, schema validation, domain-neutral recall / status output, generic ignores and skills, and early exit for discover disabled are complete and verified.
+
+## Version Check
+
+- [ ] `package.json` version is `0.7.0`.
+- [ ] `CHANGELOG.md` has a `0.7.0` section.
+- [ ] `docs/project-roadmap.md` has updated `v0.7.0` to completed status.
+
+## Test Check
+
+Run:
+
+```bash
+npm test
+npm run test:e2e:install
+npm run test:e2e:workflow
+npm run test:e2e:v061-suggest
+npm run test:e2e:v063-discover
+npm run test:e2e:v07-novel
+npm run test:e2e:v07-research
+```
+
+Expected:
+
+- [ ] Unit tests pass (160+).
+- [ ] TypeScript build passes.
+- [ ] All E2E scripts pass.
+
+## Package Check
+
+Run:
+
+```bash
+npm pack --dry-run
+```
+
+Expected:
+
+- [ ] Package name is `pmem-ai`.
+- [ ] Package version is `0.7.0`.
+- [ ] Tarball includes `dist/`.
+- [ ] Tarball includes `skills/pmem/SKILL.md` and `skills/pmem/references/`.
+- [ ] Tarball includes `README.md`, `LICENSE`, `CHANGELOG.md`.
+- [ ] Tarball includes `docs/*.md` including `docs/usage.md`.
+- [ ] Tarball excludes `src/`, `temp/`, `.pmem/`, `node_modules/`.
+- [ ] Tarball excludes compiled test files.
+
+## Publish Decision
+
+- [ ] Confirm npm account and publish permission.
+- [ ] Confirm CI/CD publish job will run on push to main or tag push.
+- [ ] Decide whether to backpublish `v0.6.4` or directly release `v0.7.0`.