pmem-ai 0.6.2 → 0.7.0

package/docs/v0.7.0 pre-design.md

@@ -0,0 +1,405 @@
+# v0.7.0 前置设计决策
+
+本文档记录 pmem v0.7.0 开工前的产品与技术决策。v0.7.0 的核心定位：
+
+> **Universal Agent Memory**
+>
+> v0.6 track 已于 v0.6.4 封版。v0.6 的核心循环（Markdown 卡片 → SQLite 索引 → recall/ask/update/verify）在代码层面
+> 已被验证是领域无关的——阻碍非软件项目的是出厂配置和少量硬编码列表，不是架构。
+>
+> v0.7.0 不引入 embedding、MCP/REST、Graph UI、telemetry、远程多用户服务。
+> v0.7.0 只做一件事：**把 pmem 从"软件项目专用"扩展为"任意 agent 项目的本地记忆运行时"**。
+>
+> v0.7.0 要回答的唯一问题：
+> **一个写小说的 agent、做研究的 agent、写剧本的 agent，能否用和 coding agent 完全相同的 `pmem recall` / `pmem ask` / `pmem update` 工作流，在自有 domain 术语下管理项目记忆？**
+
+---
+
+## 一、背景：v0.6 通用化调研
+
+### 1.1 已完成的调研
+
+v0.6.4 开发期间，通过代码层全景扫描 + 真实小说项目 E2E，获得了完整的通用化阻力地图：
+
+| 调研产物 | 内容 | 状态 |
+|----------|------|------|
+| 类型系统硬编码全景 | 6 个真阻塞点 + 14 个 friction 点 | Wave 1 已完成 |
+| 变更检测 + discover 通用化评估 | 7 个 blocker + provider 模型潜力 | Wave 1 已完成 |
+| init/integration/skills 通用化扩展点 | 8 个 const 模板 + 5 种 manifest 探测 | Wave 1 已完成 |
+| 真实小说项目 friction 报告 | 14 条 friction，2 BLOCKER + 6 FRICTION + 3 COSMETIC | Wave 2 已完成 |
+| v0.6 现状报告 | 8 项 P1/P2 未闭环 + roadmap 缺口 | Wave 1 已完成 |
+
+### 1.2 关键结论
+
+**核心循环已通用**。以下组件对自定义卡片类型完全透明：
+
+- `rebuild.ts` 的 `parseCard()`——`type` 字段不做校验（`as unknown as CardFrontmatter` 强制转型）
+- SQLite schema——`cards.type TEXT` 无 CHECK 约束
+- `ask.ts` 的 alias/tag/graph_expansion/keyword_fallback——不依赖 type
+- `consistency.ts` 的 `checkStaleMemory()`——基于 `source_files` 路径比较，不区分文件类型
+- `update --suggest` 的聚合/分级/历史分类——读 `dirty_flags` 表，type-agnostic
+
+**阻碍来自 ~20 行硬编码**。真正绑死"软件项目"语义的代码点是出厂配置值，不是架构约束。
+
+---
+
+## 二、v0.7.0 产品目标
+
+### 2.1 一句话目标
+
+> **任意 agent 项目（软件 / 小说 / 研究 / 剧本 / 课程 / ...）都能用 pmem 管理项目记忆，术语和配置跟随项目 domain，不写代码。**
+
+### 2.2 用户对象
+
+| 用户 | 当前状态 | v0.7.0 目标 |
+|------|---------|------------|
+| Coding agent（现有） | 工作正常 | 零回归 |
+| 写作 agent | `pmem new character` 被拒绝；`recall` 的 `active_modules` 永远是 `[]` | 全工作流可用 |
+| 研究 agent | 无 `source` / `citation` 卡片类型；`discover` 对文献扫描无用 | 可自定义类型 |
+| 新 domain 的 agent | init 模板只有 software 预设；manifest 不可自描述 domain | `init --domain` 加载预设 |
+
+### 2.3 成功标准
+
+1. `pmem init my-project --domain novel` 创建小说项目骨架：`characters/`、`chapters/`、`world/`、`arc/` 四个目录 + 对应卡片类型。
+2. `pmem new character "张三"` 不再报 "Invalid card type"，接受 manifest 声明的任意类型。
+3. `pmem recall --format json` 的输出中**同时包含** `active_modules`（兼容旧 agent）和 `active_foundation`（新字段）。两者内容为项目声明的"基础卡片类型"。在 software domain 中两者内容一致（都是 `module` 类型卡）；在 novel domain 中为 `character`/`chapter` 等。未来版本考虑弃用 `active_modules`。
+4. `pmem ask "张三"` 在小说项目中仍通过 alias 找到 `character.zhangsan`（不退化）。
+5. `pmem status` 的目录级模糊匹配不再对小说项目产生高误报（`chapters/` 下改一章不应触发所有 `source_files` 含 `chapters/*` 的卡）。
+6. 现有 v0.6.x 项目（软件项目）无需任何迁移即可在 v0.7.0 下正常工作。`card_types` / `domain` / `foundational_types` / `type_dirs` 全为**可选字段**，缺省时行为与 v0.6.4 完全一致。
+7. manifest schema 新增字段全部为**可选**，缺省时行为与 v0.6.4 完全一致。不存在"新增字段数量上限"约束——新增字段的唯一硬性要求是：**必须有 v0.6.4 缺省回退，旧项目不迁移即可用**。`schema_version` 不升主版本号（仍 `0.3`）。
+
+### 2.4 范围排除（不做）
+
+以下方向继续不进入 v0.7.0：
+
+| 排除项 | 原因 |
+|--------|------|
+| embedding / semantic search | 引入模型依赖和隐私变量，应在独立版本评估 |
+| `pmem serve` / MCP / REST | 服务化扩大协议面；v0.7.0 专注 CLI 通用化 |
+| Graph UI | 独立产品决策 |
+| telemetry | 隐私策略未定 |
+| 远程同步 / 多用户 | 与本地 CLI runtime 定位不一致 |
+| discover provider 重写 | v0.7.0 只默认禁用 discover（非软件项目），provider 接口化推迟到 v0.7.1+ |
+| `auto_update.*` 字段真正接通 | 推迟（v0.6 期间一直是死配置，不阻塞通用化） |
+| `card_globs` 被 rebuild 消费 | 推迟（rebuild 目前用 `'.pmem/**/*.md'` 硬编码，已实际比 card_globs 更宽松） |
+| init --type-preset wizard（交互式） | v0.7.0 只做非交互的 `--domain` flag + 预设加载；交互式向导推迟 |
+
+---
+
+## 三、类型系统阻力地图
+
+以下是从代码层全景扫描（Wave 1）和真实小说 E2E（Wave 2）中提取的完整阻力清单。
+
+### 3.1 硬编码阻塞点（6 个，v0.7.0 必须修复）
+
+| # | 文件 | 代码 | 严重程度 |
+|---|------|------|----------|
+| 1 | `src/commands/new.ts:6` | `VALID_TYPES = ['decision','module','task','feature','risk','trace']` | **BLOCKING** |
+| 2 | `src/commands/new.ts:8-15` | `TYPE_DIR_MAP` 硬编码 type→目录映射 | **BLOCKING** |
+| 3 | `src/core/manifest.ts:113` | `id_pattern` 正则白名单 10 种 type 前缀 | **BLOCKING** |
+| 4 | `src/commands/distill.ts:198,202` | `WHERE ... AND c.type IN ('module','decision','task','feature')` | **BLOCKING** |
+| 5 | `src/commands/distill.ts:267-281` | `for (const dir of ['modules','features','decisions','tasks'])` | **BLOCKING** |
+| 6 | `src/types.ts:3-16` | `NodeType` 联合类型（TypeScript 编译期，运行时已擦除） | friction |
+
+**修正方案（v0.7.0 MVP）**：
+
+1. `new.ts`: `VALID_TYPES` 从 manifest 读 `schema.card_types`；`TYPE_DIR_MAP` 从 manifest 读 `schema.type_dirs`
+2. `manifest.ts`: `id_pattern` 改为 `'^({types})\\.[a-z0-9._-]+$'`，运行时用 manifest 声明的类型列表渲染
+3. `distill.ts`: `IN (...)` 和 `for (...)` 从 manifest 读 `distill.merge_target_types`
+4. `types.ts`: `NodeType` 从联合类型改为 `string`（保留向后兼容的 type alias）
+
+### 3.2 Friction 点（10 个，v0.7.0 理想修复，可分阶段）
+
+| # | 文件 | 问题 | 修复成本 |
+|---|------|------|----------|
+| 7 | `src/commands/recall.ts:95` | `c.type === 'module'` 过滤 | S（读 manifest `recall.foundational_types`） |
+| 8 | `src/commands/ask.ts:272` | evidence 只挑 `decision/trace` | S（读 manifest `ask.evidence_types`） |
+| 9 | `src/commands/graph.ts:208` | trace 只认 `decision/trace` | S（读 manifest `trace.evidence_types`） |
+| 10 | `src/commands/status.ts:222` | `skipDirs` 硬编码 `node_modules/.git/.pmem/dist/build/.claude` | S（读 manifest `change_detection.skip_dirs`） |
+| 11 | `src/commands/status.ts:242-246` | mtime 扫描硬编码 `src/lib/app/tests` | M（读 manifest `change_detection.mtime_scan_dirs`） |
+| 12 | `src/commands/rebuild.ts:312` | `task → next_step_of` 启发式 | S（读 manifest `edges.derived_rules`） |
+| 13 | `src/commands/migrate.ts:205` | fallback type 写死 `module` | S（读 manifest `card_policy.default_card_type`） |
+| 14 | `src/commands/distill.ts:152` | 兜底 type 写死 `trace` | S（同上） |
+| 15 | `src/commands/init.ts:509-513` | 初始目录列表硬编码 | M（按 domain 预设加载） |
+| 16 | `src/core/manifest.ts:103-105` | `ignore_patterns` 默认值 `node_modules/dist/build` | S（拆 `software_ignore` + `generic_ignore`） |
+
+### 3.3 真正通用的组件（无需修改）
+
+- `rebuild.ts` 的 `parseCard()` / upsert
+- SQLite schema（所有 TEXT 列无 CHECK）
+- `ask.ts` 检索流
+- `consistency.ts` 的 `checkStaleMemory()`
+- `update --suggest` 聚合/分级逻辑
+- `verify.ts`（policy 按 type key 查表，新 type 自动获得默认值）
+
+---
+
+## 四、v0.7.0 详细设计
+
+### 4.1 Manifest schema 新增字段（可选，缺省回退 v0.6.4 行为）
+
+```yaml
+# .pmem/manifest.yml 新增字段（全部可选）
+
+project:
+  name: my-novel
+  domain: novel            # 新增：项目 domain（novel|software|research|screenplay|course|...）
+  language: zh-CN
+
+schema:                    # 新增顶层 key
+  card_types:              # 项目允许的卡片类型
+    - character
+    - chapter
+    - world
+    - arc
+    - decision
+    - trace
+  type_dirs:               # type → .pmem/ 子目录映射
+                            # 内置 preset 中的 type 必须显式列出（避免 ${type}s 歧义，
+                            # 如 world 不能默认成 worlds）。
+                            # 自定义 type（不在任何 preset 中）缺省为 ${type}s。
+    character: characters
+    chapter: chapters
+    world: world
+    arc: arc
+    decision: decisions
+    trace: traces
+  foundational_types:      # recall 中视为"基础卡片"的类型（替代硬编码 module）
+    - character
+    - chapter
+  evidence_types:          # ask/trace 中视为 evidence 的类型
+    - decision
+    - trace
+  default_type: trace      # 兜底卡片类型（替代硬编码 trace）
+
+card_policy:
+  id_pattern: '^({types})\.[a-z0-9._-]+$'  # {types} 由 card_types 渲染
+  max_tokens:
+    character: 1200
+    chapter: 2000
+    world: 1500
+    arc: 1000
+    decision: 1000
+    trace: 1000
+  default_max_tokens: 1000  # 新增：未在 max_tokens 中列出的 type 的兜底值
+
+change_detection:           # 新增顶层 key（拆分自 auto_update）
+  mtime_scan_dirs:          # no-git 降级时的扫描目录
+    - chapters
+    - characters
+    - world
+  skip_dirs:                # 从 status/mark-dirty 中排除的目录
+    - .git
+    - .pmem
+    - drafts
+
+discover:
+  enabled: false            # 新增：非软件项目默认 false
+
+distill:
+  merge_target_types:       # 新增：trace 可合并到的稳定卡片类型
+    - character
+    - chapter
+    - world
+    - arc
+    - decision
+```
+
+**缺省行为**：
+
+当 `schema.card_types` 未定义时，回退到 v0.6.4 `id_pattern` 实际白名单：
+`['project','module','feature','task','decision','trace','risk','assumption','resource','integration']`
+（来源：`src/core/manifest.ts:113`。注意 `integration` 在 id_pattern 但不在 `NodeType`；`constraint`/`person`/`file`/`doc` 在 `NodeType` 但不在 id_pattern——回退以 id_pattern 为准，因为它是运行时真正生效的 gate）。
+当 `schema.type_dirs` 未定义时：内置 preset 中的 type 使用 preset 显式列出的目录；自定义 type（不在任何 preset 中的）回退到 `${type}s` 规则。
+当 `schema.foundational_types` 未定义时，回退到 `['module']`（保持 v0.6.4 行为）。
+当 `discover.enabled` 未定义时，软件项目默认 `true`，非软件项目默认 `false`。
+
+### 4.2 Domain 预设
+
+v0.7.0 内置 3 个 domain 预设，通过 `pmem init --domain <name>` 加载：
+
+| Domain | card_types | foundational_types | type_dirs | discover |
+|--------|-----------|-------------------|-----------|----------|
+| `software`（默认） | project/module/feature/task/decision/risk/trace/person | module | 同 v0.6.4 | enabled |
+| `novel` | character/chapter/world/arc/decision/trace | character/chapter | characters/chapters/world/arc/decisions/traces | disabled |
+| `research` | source/claim/note/experiment/decision/trace | source/claim | sources/claims/notes/experiments/decisions/traces | disabled |
+
+`--domain` 缺省时等同于 `--domain software`（向后兼容 v0.6.x）。
+
+用户可以通过 manifest 手动增删 `card_types`、覆盖任意字段，domain 预设只是 init 时的起点。
+
+### 4.3 init 通用化方案
+
+**CLI 变更**：
+
+```bash
+pmem init my-novel --domain novel --guided \
+  --description "武侠小说" --stage "草稿" --next "完成第一章"
+```
+
+**init 流程变更**：
+
+1. `--domain <name>` 加载内置预设（`src/commands/init.ts` 新增 `DOMAIN_PRESETS` 常量）
+2. 按 `type_dirs` 创建目录（替代当前的 8 个 const 目录）
+3. 写入 manifest 时填入 `schema.card_types` / `schema.type_dirs` / `schema.foundational_types` 等
+4. `source_of_truth.card_globs` 从 `type_dirs` 自动生成
+5. candidates 扫描按 `card_types` 生成候选项
+
+**不改**：`--guided` 的交互流程、`--answers` 文件路径、`AGENTS.md` 生成逻辑。
+
+### 4.4 integration/skills 通用化方案
+
+**integration**：
+
+`pmem integration install` 的文件生成**不区分 domain**。CLA.md / AGENTS.md / slash command 文件 / git-hooks 的内容是通用 agent 工作流指令，已包含 `pmem recall --budget 2000` / `pmem ask` / `pmem update` / `pmem verify`，这些命令在所有 domain 下行为一致。
+
+唯一需要调整的是 CLAUDE.md 模板中的示例术语（"module" → "基础卡片"），改为 domain-neutral 表述。
+
+**skills**：
+
+`skills/` 目录下的 4 个 SKILL.md（recall/ask/update/distill）的内容已领域无关。`skills/code-task.md` 的命名改为 `skills/task.md`，内容改为通用任务描述模板。
+
+### 4.5 迁移策略
+
+**零迁移**。v0.6.x 项目在 v0.7.0 下：
+
+1. `schema.*` 字段全部缺省 → 回退 v0.6.4 硬编码值
+2. `pmem new module "..."` 仍工作（`module` 在 software 预设中）
+3. `pmem recall` 的 `active_modules` 字段保留，同时新增 `active_foundation`（两者内容一致）
+4. `pmem verify` 的 `id_pattern` 正则不变
+5. `schema_version` 不升
+
+**Resolved config（运行时计算，不回写）**：
+PMEM 加载 manifest 时计算一个 resolved config 对象：
+- 若 `schema.card_types` 已定义 → 使用其值
+- 若未定义 → resolved config 取 v0.6.4 `id_pattern` 白名单回退值
+- resolved config 是**内存中的计算结果**，不写回 manifest 文件
+- 旧项目 manifest 在磁盘上保持原样——v0.7.0 不会在 `pmem rebuild` / `pmem status` / 任何读操作时自动向 manifest 注入 `schema.*` 字段
+- 唯一的 manifest 写入路径是 `pmem init`（新项目）和用户手动编辑
+
+**v0.7.0 新项目**：
+- `init --domain novel` 写入 `schema.card_types` 等字段
+- manifest 中这些字段的存在是 v0.7.0 项目与 v0.6.x 项目的唯一区别
+
+**升级路径**：
+- v0.6.x 用户想使用自定义类型，手动编辑 manifest 加 `schema.card_types` + `schema.type_dirs` + 放宽 `id_pattern`（加 `{types}` 占位符），然后 `pmem rebuild`
+- 不需要 `pmem migrate` 命令
+
+---
+
+## 五、实现分阶段
+
+### Phase 1: Core unblock（P0，必须）
+
+| # | 改动 | 文件 | 工作量 |
+|---|------|------|--------|
+| 1 | `NodeType` 放宽为 `string` | `src/types.ts` | S |
+| 2 | `pmem new` 从 manifest 读 `card_types` + `type_dirs` | `src/commands/new.ts` | S |
+| 3 | `id_pattern` 改为 `{types}` 占位符 | `src/core/manifest.ts` | S |
+| 4 | `distill` 从 manifest 读 `merge_target_types` | `src/commands/distill.ts` | S |
+| 5 | manifest 默认值填入 `card_types` / `type_dirs` / `foundational_types` 等新字段（缺省回退 v0.6.4 行为） | `src/core/manifest.ts` | M |
+| 6 | node:test 覆盖：自定义 type 的 new/rebuild/ask/verify 全链路 | `src/core/*.test.ts` | M |
+
+**Phase 1 DoD**：`pmem new character "张三"` 在 `manifest.schema.card_types` 含 `character` 时成功。
+
+### Phase 2: Domain presets（P0）
+
+| # | 改动 | 文件 | 工作量 |
+|---|------|------|--------|
+| 7 | `init --domain` flag + `DOMAIN_PRESETS` 常量（software/novel/research） | `src/commands/init.ts` | M |
+| 8 | init 目录按 `type_dirs` 创建 | `src/commands/init.ts` | S |
+| 9 | `card_globs` 从 `type_dirs` 自动生成 | `src/commands/init.ts` | S |
+
+**Phase 2 DoD**：`pmem init my-novel --domain novel --guided` 创建 `characters/` / `chapters/` / `world/` / `arc/` 四个目录，manifest 含 `card_types: [character, chapter, world, arc, ...]`。
+
+### Phase 3: Friction polish（P1，理想）
+
+| # | 改动 | 文件 | 工作量 |
+|---|------|------|--------|
+| 10 | `recall` JSON 同时输出 `active_modules`（兼容）和 `active_foundation`（新字段），两者内容从 manifest `foundational_types` 读取 | `src/commands/recall.ts` | S |
+| 11 | `status` 的 `skipDirs` / `mtime_scan_dirs` 从 manifest 读 | `src/commands/status.ts` | M |
+| 12 | `ask` / `graph` / `migrate` / `rebuild` 的 type-specific 启发式改为读 manifest | 4 个文件 | S×4 |
+| 13 | `auto_update.ignore_patterns` 拆 `software_ignore` + `generic_ignore` | `src/core/manifest.ts` | S |
+| 14 | `skills/code-task.md` → `skills/task.md` + 通用内容 | `skills/` | S |
+
+**Phase 3 DoD**：小说项目 `recall --format json` 同时输出 `active_modules`（兼容，内容与 `active_foundation` 一致）和 `active_foundation`（含 `character`/`chapter` 类型的卡）。
+
+### Phase 4: discover default-disable（P2）
+
+| # | 改动 | 文件 | 工作量 |
+|---|------|------|--------|
+| 15 | `discover` 命令读 `manifest.discover.enabled`，false 时直接返回 "disabled in this project" | `src/commands/discover.ts` | S |
+| 16 | 非 software domain 的 manifest 默认 `discover.enabled: false` | `src/commands/init.ts` | S |
+
+---
+
+## 六、测试计划
+
+### 单元测试（新增 + 不改旧）
+
+| 场景 | 覆盖 |
+|------|------|
+| `pmem new character "张三"` 在 novel domain 成功 | 新增 |
+| `pmem new character "张三"` 在 software domain 仍拒绝（保持旧行为） | 新增 |
+| `pmem rebuild` 索引 character/world/arc 卡片 | 新增 |
+| `pmem ask "张三"` 通过 alias 找到 character.zhangsan | 新增 |
+| `pmem recall` 在 novel domain 返回 `active_foundation`（非 `active_modules`） | 新增 |
+| `id_pattern` 的 `{types}` 占位符渲染正确 | 新增 |
+| 旧 software project 全部 node:test 不退步 | 回归 |
+
+### E2E
+
+| 场景 | 覆盖 |
+|------|------|
+| `init --domain novel` + `new character` + `rebuild` + `ask` + `recall` + `verify` 全链路 | 新增脚本 `scripts/e2e-v07-novel.sh` |
+| `init --domain research` + 自定义 source/claim 卡片 | 新增脚本 `scripts/e2e-v07-research.sh` |
+| 旧 software project `init --guided` → 完整 v0.6 workflow 不退步 | 复用 `scripts/e2e-real-workflow.sh` |
+| `init --domain novel` 后 `discover` 输出 "disabled" | 新增 |
+| status 在 novel 项目不误报（改 ch01 只触发 exact match 的卡） | 新增 |
+
+### 回归
+
+| 套件 | 要求 |
+|------|------|
+| `npm test`（node:test） | 137 现有 + 新增 ≥ 10 → 全部通过 |
+| 12 个 v0.6 E2E 脚本 | 全绿（旧 software project 不退步） |
+| `npm run build` | 0 error |
+
+---
+
+## 七、schema 兼容性
+
+- `manifest.pmem.schema_version` 保持 `'0.3'`（不升主版本号）
+- 所有新增字段在 manifest 中为**可选**
+- `card_policy.id_pattern` 的新格式 `'^({types})\.[a-z0-9._-]+$'` 在 `{types}` 未渲染时等价于旧正则（回退到 v0.6.4 硬编码列表）
+- 不新增 `pmem migrate` 步骤——v0.6.x `.pmem/` 目录直接被 v0.7.0 读取
+- `pmem.db` 表结构不变
+
+---
+
+## 八、风险与缓解
+
+| 风险 | 缓解 |
+|------|------|
+| `NodeType` 放宽为 `string` 后 TypeScript 不再检查拼写错误 | 在 `manifest.ts` 的 `loadManifest` / `validateManifest` 中增加运行时 card_type 白名单校验（仅当 manifest 声明了 `card_types` 时） |
+| distill 的 `merge_target_types` 配置错误（用户声明了不存在的类型） | distill 在 merge 时检查目标卡是否存在，不存在则跳过 + warning |
+| `id_pattern` 的 `{types}` 占位符中类型名含正则特殊字符（如 `c++`） | `escapeRegExp` 处理 |
+| 太多 domain 预设导致维护负担 | v0.7.0 只内置 3 个（software/novel/research）；后续 domain 由社区提供 manifest 示例 |
+| `active_modules` → `active_foundation` 字段名变更破坏 agent JSON 解析 | `recall --format json` 同时输出 `active_modules`（兼容别名）和 `active_foundation`（新字段），给 agent 迁移窗口期 |
+
+---
+
+## 九、审批记录
+
+| 角色 | 决定 | 日期 |
+|------|------|------|
+| 提交人 | Claude Opus 4.8 | 2026-06-02 |
+| CTO | 待审批 | |
+
+### 设计来源
+
+- 类型系统阻力地图：Wave 1 子任务报告（4 个 sub-agent 并行代码扫描）
+- 小说项目 friction 报告：Wave 2 实测（temp/novel-test/）
+- init/integration/skills 通用化扩展点：Wave 1 子任务报告
+- v0.6 现状报告：Wave 1 子任务报告
+- v0.6.4 pre-design §九（v0.7.0 边界）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmem-ai",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "description": "Project Memory for AI Agents: a local CLI runtime for project context, recall, and memory updates",
   "main": "dist/index.js",
   "bin": {
@@ -8,9 +8,10 @@
   },
   "scripts": {
     "build": "tsc",
+    "pretest": "npm run build",
     "dev": "ts-node src/index.ts",
     "start": "node dist/index.js",
-    "test": "node --require ts-node/register --test src/core/*.test.ts",
+    "test": "node --require ts-node/register --test src/core/*.test.ts src/commands/*.test.ts",
     "test:e2e:install": "bash scripts/e2e-install-smoke.sh",
     "test:e2e:workflow": "bash scripts/e2e-real-workflow.sh",
     "test:e2e:non-git": "bash scripts/e2e-non-git-fallback.sh",
@@ -20,7 +21,10 @@
     "test:e2e:v06-empty": "bash scripts/e2e-v06-empty-guidance.sh",
     "test:e2e:v06-nongit": "bash scripts/e2e-v06-non-git-ux.sh",
     "test:e2e:v06-skills": "bash scripts/e2e-v06-skills.sh",
-    "test:e2e:v061-suggest": "bash scripts/e2e-v061-suggest.sh"
+    "test:e2e:v061-suggest": "bash scripts/e2e-v061-suggest.sh",
+    "test:e2e:v063-discover": "bash scripts/e2e-v063-discover.sh",
+    "test:e2e:v07-novel": "bash scripts/e2e-v07-novel.sh",
+    "test:e2e:v07-research": "bash scripts/e2e-v07-research.sh"
   },
   "keywords": [
     "agent",

package/skills/pmem/SKILL.md

@@ -1,12 +1,12 @@
 ---
 name: pmem
-description: Project memory for AI agents — recall context, ask questions, detect changes, update memory, verify consistency across sessions.
+description: Universal project memory for AI agents — initialize software, novel, or research memory; recall context; ask questions; detect changes; update cards; verify consistency across sessions.
 allowed-tools: Bash(pmem:*)
 ---
 
 # Project Memory with pmem
 
-`pmem` gives coding agents persistent project memory across sessions. It stores memory as Markdown cards under `.pmem/` and builds SQLite indexes for fast recall.
+`pmem` gives agents persistent project memory across sessions. It stores memory as Markdown cards under `.pmem/` and builds SQLite indexes for fast recall. v0.7.0 is domain-neutral: the same workflow works for software projects, novels, research work, and custom card schemas.
 
 ## Quick start
 
@@ -15,12 +15,18 @@ allowed-tools: Bash(pmem:*)
 pmem init my-project --guided --description "A backend service" --stage "Alpha" --next "Set up CI/CD"
 pmem rebuild
 
+# Or initialize a domain preset
+pmem init my-novel --domain novel
+pmem init lit-review --domain research
+
 # Restore context (do this at session start)
-pmem session start -a "Claude"
+pmem session start -a "<agent-name>"
 pmem recall --format compact --budget 2000
 
 # Find relevant memory
 pmem ask "auth module" --format compact
+pmem ask "main character motivation" --format compact
+pmem ask "source claim evidence" --format compact
 ```
 
 ## Core Workflow
@@ -30,7 +36,7 @@ Every session follows this loop:
 ```
 session start → recall (restore context) → ask (find specific memory)
     ↓
-edit code
+edit project files
     ↓
 status (detect changes) → mark-dirty --auto (flag affected cards)
     ↓
@@ -44,9 +50,17 @@ session end → verify (check consistency)
 ### Init & Setup
 
 ```bash
+# Default software preset
+pmem init my-project
+
 # Interactive guided setup (asks 3 questions)
 pmem init my-project --guided
 
+# Domain presets (v0.7.0)
+pmem init my-project --domain software
+pmem init my-novel --domain novel
+pmem init my-research --domain research
+
 # Non-interactive (for scripts and agents)
 pmem init my-project --guided \
   --description "Project description" \
@@ -62,6 +76,36 @@ pmem rebuild --full          # full rebuild, clear all tables
 pmem rebuild --card module.core  # rebuild single card
 ```
 
+### Domain Presets & Custom Schemas (v0.7.0)
+
+Use presets when the project is not a conventional software codebase:
+
+| Preset | Foundational cards | Default discover |
+|--------|--------------------|------------------|
+| `software` | `module` | enabled |
+| `novel` | `character`, `chapter` | disabled |
+| `research` | `source`, `claim` | disabled |
+
+The project manifest can define:
+
+```yaml
+schema:
+  card_types: [character, chapter, world, arc, decision, trace]
+  type_dirs:
+    character: characters
+    chapter: chapters
+  foundational_types: [character, chapter]
+  evidence_types: [decision, trace]
+  creatable_types: [character, chapter, world, arc, decision, trace]
+  default_type: trace
+discover:
+  enabled: false
+```
+
+For `pmem recall --format json`, read `active_foundation`. `active_modules` remains as a backward-compatible alias with the same contents.
+
+Legacy v0.6.x projects do not need migration. When `schema` is absent, pmem falls back to the old software defaults without rewriting the manifest.
+
 ### Context Recovery
 
 ```bash
@@ -77,6 +121,39 @@ pmem related module.core --depth 2
 pmem trace decision.sqlite_runtime
 ```
 
+### Relationship Discovery (v0.6.3+)
+
+```bash
+# Auto-discover software project relationships across 6 languages
+pmem discover --dry-run --format json     # preview without writing
+pmem discover --format json               # discover and write inferred edges
+
+# Filter by language
+pmem discover --lang nodejs,python
+
+# Use custom pattern file
+pmem discover --pattern-file .pmem/discover-patterns.json
+
+# Review and manage inferred edges
+pmem related <id> --format json --source inferred
+pmem update --confirm --accept-edges 1,2,3
+pmem update --confirm --reject-edges 4,5
+```
+
+The discover command scans:
+- **Source file imports** (6 languages: Node.js, Python, Rust, Go, C/C++, Java) - confidence 0.7
+- **Package manager dependencies** (package.json, Cargo.toml, go.mod, etc.) - confidence 0.7-0.85
+
+**False-positive guard**: language builtins (Node.js `fs`/`path`/`crypto`, Python `os`/`sys`/`json`, Go `fmt`/`net`, Java `java.*`/`javax.*`/`jakarta.*`/Spring, C/C++ standard headers) and `@types/*` are silently dropped before any output. They never become edges or ambiguous entries.
+
+**Ambiguous output is signal-first**: each `ambiguous` entry has a `severity` of either:
+- `actionable` — local project file that has no card. Run `pmem new module "Title"` to create one, or `pmem update --confirm --reject-edges <id>` if no card is needed.
+- `informational` — external package / framework / builtin with no card. No action needed.
+
+The compact output lists actionable items first, then collapses informational ones to a count. Parse `summary.actionable` from JSON to drive your review loop.
+
+For `novel` and `research` presets, `discover.enabled` defaults to `false`. Running `pmem discover` exits 0 with a disabled message and does not scan files.
+
 ### Change Detection & Memory Update
 
 ```bash
@@ -90,7 +167,7 @@ pmem mark-dirty -r "Refactored auth module"
 
 # Get memory update suggestions
 pmem update --suggest --format json
-# NOTE: v0.6.2+ exits 0 regardless; check JSON summary.has_actionable for suggestions
+# NOTE: v0.6.2+ exits 0 regardless; check JSON summary.has_actionable or summary.blocking
 
 # Confirm and write changes
 pmem update --confirm -s "Updated auth module" -n "Add token refresh"
@@ -119,7 +196,7 @@ pmem migrate --to 0.3 --backup
 ### Sessions
 
 ```bash
-pmem session start -a "Claude"
+pmem session start -a "<agent-name>"
 pmem session end -s "Completed auth refactor"
 ```
 
@@ -132,6 +209,7 @@ pmem integration install claude-code
 # Install agent skills globally
 pmem install --skills --claude     # → ~/.claude/skills/pmem/
 pmem install --skills --codex      # → ~/.codex/skills/pmem/
+pmem install --skills --gemini     # → ~/.gemini/skills/pmem/
 pmem install --skills --all        # → all detected agents
 
 # Verify integration status
@@ -193,4 +271,6 @@ pmem verify
 * **First-time project setup** — [references/first-init.md](references/first-init.md)
 * **Session workflow in detail** — [references/session-workflow.md](references/session-workflow.md)
 * **Creating memory cards** — [references/memory-cards.md](references/memory-cards.md)
+* **Universal domains and schemas** — [references/universal-domains.md](references/universal-domains.md)
+* **Discovering project relationships** — run `pmem discover --dry-run --format json` to see inferred edges, then use `pmem update --confirm --accept-edges` to promote them
 * **Troubleshooting** — [references/troubleshooting.md](references/troubleshooting.md)

package/skills/pmem/references/first-init.md

@@ -12,6 +12,7 @@ pmem --version
 ```bash
 pmem install --skills --claude    # for Claude Code
 pmem install --skills --codex     # for Codex
+pmem install --skills --gemini    # for Gemini
 pmem install --skills --all       # for all detected agents
 ```
 
@@ -28,6 +29,16 @@ pmem init your-project --guided \
 pmem rebuild
 ```
 
+Domain presets (v0.7.0):
+
+```bash
+pmem init your-project --domain software   # default; modules/features/tasks
+pmem init your-novel --domain novel        # characters/chapters/world/arc
+pmem init your-research --domain research  # sources/claims/notes/experiments
+```
+
+Use `software` for codebases, `novel` for writing projects, and `research` for literature reviews or evidence-driven notes. Novel and research projects disable `pmem discover` by default to avoid code-scanner noise.
+
 Or with a JSON answers file:
 
 ```bash
@@ -77,6 +88,16 @@ echo "export const app = { name: 'my-app' };" > src/index.ts
 pmem rebuild
 ```
 
+For non-software projects, use the preset card types:
+
+```bash
+pmem new character "Main Protagonist"
+pmem new chapter "Opening Scene"
+pmem new source "Smith 2024 Survey"
+pmem new claim "Memory Improves Agent Continuity"
+pmem rebuild
+```
+
 ## Step 5: Verify setup
 
 ```bash