npm - @meitouai/mem-note-cli - Versions diffs - 0.0.3 → 0.1.0 - Mend

@meitouai/mem-note-cli 0.0.3 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/bin/conventions.md CHANGED Viewed

@@ -1,346 +1,101 @@
 # mem-note 数据约定
-> 这份文档是 mem-note 数据目录的**真源约定**。所有写入该目录的代理（人、CLI、AI agent、外部脚本）都必须遵守。
+> 本文件由插件管理，`mem-note init` 和插件升级时会覆盖写入，**请勿手动修改**。
+> 这里定义的数据格式是硬约束，CLI 和 AI agent 都必须遵守。
 >
-> AI agent 在任何 mem-note skill 开始时应首先 `Read` 本文件，作为判断的依据。
+> 如何 groom inbox 数据（triage 策略、合并判断、洞察提取等）见 [GROOM_RULES.md](GROOM_RULES.md)，该文件归用户所有，可自由迭代。
-## 1. 核心哲学
-1. **文件即数据库**。所有数据是 markdown 文件，无隐藏索引 / 数据库 / 二进制状态。
-2. **CLI 最小化**。CLI 只覆盖 5 个场景：(a) hook 时 AI 不在场、(b) 人需要快捷入口、(c) 多步易错操作的封装、(d) 跨会话的一致性检查、(e) 初始化。其他所有读写由 AI agent 用原生工具（`Read` / `Write` / `Edit` / `Glob` / `Grep` / `Bash`）完成。
-3. **AI agent 负责智能**。语义判断、矛盾识别、重复检测、groom 决策全部由 skill 里的 AI agent 完成，CLI 不包含任何智能逻辑。
-4. **约定优于配置**。本文档定义的格式是硬约束；漂移由 `mem-note doctor` 发现。
-## 2. 目录布局
+## 目录布局
 ```
 ~/.aibox-mem-note/                   # 数据根（可由 $MEM_NOTE_DATA_DIR 覆盖）
-├── CONVENTIONS.md                   # 本文件（mem-note init 写入；已存在则跳过）
+├── CONVENTIONS.md                   # 本文件（插件管理，自动同步）
+├── GROOM_RULES.md                   # groom 策略（用户所有，可自由修改）
 ├── notes/                           # 永久 note
 │   ├── NOTES.md                     # 根索引
 │   ├── <topic>/
 │   │   ├── NOTES.md                 # 子目录索引（必维护）
-│   │   └── <slug>.md                # 具体 note
-│   ├── skills/                      # 用户自定义 skill（保留子目录，不是 note）
-│   │   └── <skill-name>/
-│   │       ├── SKILL.md             # skill 本体（frontmatter: name, description）
-│   │       └── evals/               # 可选：该 skill 的 eval workspace
-│   └── _archived/                   # 归档的 note
+│   │   └── <slug>.md
+│   ├── skills/                      # 用户自定义 skill（非 note，groom 跳过）
+│   └── _archived/                   # 归档 note（groom 排除）
 │       └── <YYYY-MM-DD>_<slug>.md
-├── inbox/                           # 待 groom 的原始输入池
+├── inbox/                           # 待 groom 的原始输入
 │   ├── <YYYY-MM-DD-HHMMSS>_<slug>.md
-│   └── .processed/                  # 已处理的 entry（merged / discarded）
-├── insights/                        # groom 过程产出的洞察
+│   └── .processed/                  # 已处理的 entry
+├── insights/                        # groom 产出的洞察
 │   └── <id>.md
-├── .context/                        # SessionStart / PreCompact 注入的上下文
-│   └── index.md                     # 由 groom skill 维护
-├── .reports/                        # 操作审计日志（append-only）
-│   └── <YYYY-MM-DD>.md
-└── .snapshots/                      # 可选：groom 前的快照
-    └── <snapshot-id>/
+├── .context/
+│   └── index.md                     # groom 编译的会话注入上下文（< 2KB）
+└── .reports/                        # 审计日志（append-only）
+    ├── <YYYY-MM-DD>.md
+    └── graph.html                   # 知识图谱可视化（groom 生成）
 ```
-**特殊目录约定**：
-- `notes/_archived/` **不**参与任何 Glob scanning；AI agent 应显式排除
-- `notes/**/NOTES.md` 不是 note，AI agent 应显式排除
-- `notes/skills/` 是**保留子目录**，里面存的是用户自定义 skill 而不是 note：
-  - groom 不要 triage 它（不当作 inbox 输出目标，不更新 NOTES.md 条目）
-  - 任何 `Glob notes/**/*.md` 应显式排除 `notes/skills/**` 以免混入 SKILL.md
-  - 发现 user skill 时用 `Glob notes/skills/*/SKILL.md`，读 frontmatter 的 `name` + `description` 即可
-- `inbox/.processed/` 是软删除区，不参与 pending 统计
+**排除规则**：`_archived/`、`skills/`、`NOTES.md` 不是 note，Glob 时排除。
-## 3. Frontmatter Schema
+## Frontmatter Schema
-除 `CONVENTIONS.md`、`NOTES.md`、`.context/index.md`、`.reports/*.md`、
-`notes/skills/**/SKILL.md`（遵循 Claude Code skill 自有格式）外，
-所有 `.md` 文件必须有 YAML frontmatter。
-### 3.1 Note (`notes/**/*.md`，除 NOTES.md)
+### Note (`notes/<topic>/<slug>.md`)
 ```yaml
 ---
-type: preference # 必填：preference | fact | lesson | reminder | note
-title: Dark mode preference # 必填：人类可读，用于 NOTES.md 索引展示
-description: > # 必填：一句话摘要，用于 NOTES.md 索引描述
-  Prefers dark mode across all editors, Monokai Pro theme.
-tags: [ui, editor] # 必填（可为空数组）：小写 kebab-case
+type: preference   # 必填：preference | fact | lesson | reminder | note
+title: Dark mode   # 必填：人类可读标题
+description: >     # 必填：一句话摘要
+  Prefers dark mode across all editors.
+tags: [ui, editor]  # 必填（可空数组）：小写 kebab-case
 updated: 2026-04-10 # 必填：ISO 日期
-related: # 可选：相关 note 路径
-  - notes/user/editor-theme.md
-source: # 可选：原始来源 inbox entry 路径
-  - inbox/2026-04-09-142030_dark-mode.md
+related: []         # 可选：相关 note 路径
+source: []          # 可选：来源 inbox entry 路径
 ---
 ```
-### 3.2 Inbox entry (`inbox/**/*.md`)
+### Inbox entry (`inbox/<YYYY-MM-DD-HHMMSS>_<slug>.md`)
 ```yaml
 ---
-type: note # 可选：保存者的初步判断；groom 时可被 AI agent 修改
-tags: [] # 可选：groom 时补充
-created: 2026-04-10-142030 # 必填：ISO 时间戳
-source:
-  terminal # 可选但推荐：去重 key
-  # 取值：terminal | hook:stop | hook:sync | auto-memory:<path>
+created: 2026-04-10-142030 # 必填
+type: note                 # 可选：初步判断
+tags: []                   # 可选
+source: terminal           # 可选：去重 key（terminal | hook:stop | hook:sync | auto-memory:<path>）
 ---
 ```
-- `type` / `tags` **可为空**。inbox 的语义是"未分类的原始输入"，分类是 groom 的职责。
-- `source`：`mem-note save --source X` 会拒绝 source 已存在的导入（去重）。
-- 顶层 `inbox/*.md` 保持原始输入语义；当条目被移动到 `inbox/.processed/` 后，
-  处理后的副本**可以**追加一个 `processed` 对象记录处理结果，例如：
-```yaml
-processed:
-  status: user-ignored
-  at: 2026-04-11-090807
-  reason: Ignored by user from the mem-note inbox UI.
-```
-### 3.3 Insight (`insights/*.md`)
+### Insight (`insights/<id>.md`)
 ```yaml
 ---
-id: insight-v1K2p7 # 必填：短 nanoid
-kind: clarification # 必填：clarification | pattern | skill-candidate | contradiction | <custom>
-status: open # 必填：open | resolved | dismissed
+id: insight-v1K2p7                   # 必填：短 nanoid
+kind: clarification                  # 必填：clarification | pattern | skill-candidate | contradiction
+status: open                         # 必填：open | resolved | dismissed
 title: Testing framework contradiction
 created: 2026-04-10
-related:
-  - notes/user/testing-jest.md
-  - notes/user/testing-vitest.md
----
-<自由 markdown 正文：evidence、reasoning、建议行动>
-```
-### 3.4 Archived note (`notes/_archived/**/*.md`)
-与原 note frontmatter 相同，追加一个 `archived` 字段：
-```yaml
----
-type: fact
-title: Old deployment tool
----
-archived: 2026-04-10 # 归档日期
+related: []
 ---
 ```
-## 4. 文件命名
+### Archived note (`notes/_archived/<YYYY-MM-DD>_<slug>.md`)
-| 类型          | 路径模板                                                                                                   | 示例                                      |
-| ------------- | ---------------------------------------------------------------------------------------------------------- | ----------------------------------------- |
-| Note          | `notes/<topic>/<slug>.md`                                                                                  | `notes/user/dark-mode.md`                 |
-| Inbox entry   | `inbox/<YYYY-MM-DD-HHMMSS>_<slug>.md` (collisions within the same second get a `-<n>` suffix before `.md`) | `inbox/2026-04-10-142030_dark-mode.md`    |
-| Archived note | `notes/_archived/<YYYY-MM-DD>_<original-slug>.md`                                                          | `notes/_archived/2026-04-10_dark-mode.md` |
-| Insight       | `insights/<id>.md`                                                                                         | `insights/insight-v1K2p7.md`              |
+同 note frontmatter，追加 `archived: 2026-04-10`。
-**slug 约定**：小写 kebab-case，只含 `[a-z0-9-]`，最长 60 字符。`mem-note save` 自动从内容前若干字生成。
+## 文件命名
-## 5. NOTES.md 索引规则
+Slug：小写 kebab-case，只含 `[a-z0-9-]`，最长 60 字符。
-每个 `notes/` 子目录（包括 `notes/` 本身）必须维护一份 `NOTES.md` 作为该目录的人类可读索引。
+## NOTES.md 索引
-### 5.1 格式
+每个 `notes/` 子目录维护 `NOTES.md`：
 ```markdown
 # notes/user
-User-scope preferences, facts, and lessons.
 ## Notes
 - [Dark mode preference](dark-mode.md) — Prefers dark mode, Monokai Pro theme.
-- [Deploy lesson](deploy-lesson.md) — Always run DB migrations before deploying.
 ## Subdirectories
 - [editor/](editor/NOTES.md) — Editor-specific preferences
 ```
-### 5.2 维护契约
-**任何创建、重命名、归档 note 的代理都必须同步更新对应目录的 `NOTES.md`**：
-- 创建新 note → `## Notes` 追加 `- [<title>](<file>.md) — <description>`
-- 更新 note 的 title 或 description → 更新对应行
-- 归档 note → 从 `## Notes` 删除该行
-- 创建子目录 → `## Subdirectories` 追加条目
-- 删除空子目录 → 从 `## Subdirectories` 删除条目
-`<title>` 和 `<description>` 直接来自 note 的 frontmatter 同名字段。
-### 5.3 为什么不自动维护
-- NOTES.md 就地可读（人 / AI agent / git diff 都一目了然）
-- 避免"CLI 自动维护 + AI agent 手动维护"的 race
-- `mem-note doctor` 负责定期检查漂移，不靠运行时
-## 6. `.context/index.md` 约定
-`.context/index.md` 是 **groom skill 编译**出的"本会话 AI agent 应记住的核心信息"。
-SessionStart 和 PreCompact hook 都会注入它。
-### 6.1 结构
-```markdown
-# Context — 2026-04-10
-## Preferences
-- Dark mode, Monokai Pro, JetBrains Mono
-- Functional style, named exports, files under 200 lines
-## Active Reminders
-- API design review deadline: April 15
-- Tuesday 10am standup — prepare notes
-## Key Facts
-- Uses PostgreSQL 15 with PgBouncer
-- Tests: Jest (unit) + Playwright (e2e), 80% coverage
-- Planning REST → GraphQL migration (Apollo Server) in Q3
-```
-### 6.2 约束
-- `## Active Reminders` 是**必须**段落（可以为空）。groom skill 必须在每次
-  编译时扫描所有 `type: reminder` 的 note 重新生成这一段 —— 因为 PreCompact
-  hook 依赖它。
-- 整体文件大小建议 **< 2KB**。SessionStart 和 PreCompact 每次都注入，太大
-  会吃掉宝贵的 session context。
-- 由 groom skill 的最后一步 `Write` 生成，**不**由 CLI 维护。
-## 7. Inbox / Archive 生命周期
-```
-mem-note save
-    │
-    ▼
-inbox/<ts>_<slug>.md  ────── groom skill reads ──┐
-                                                 │
-                            ┌────────────────────┤
-                            │                    │
-                          merge                discard
-                            │                    │
-                            ▼                    ▼
-        notes/<topic>/<slug>.md           inbox/.processed/<original>.md
-        (+ update NOTES.md)                  (软删除)
-mem-note archive notes/<topic>/<slug>.md
-    │
-    ▼
-notes/_archived/<date>_<slug>.md  (+ remove from topic's NOTES.md)
-```
-`.processed/` 保留所有历史 inbox entry，便于回溯；不再在 listing 中出现。
-## 8. AI agent 的工具使用优先级
-AI agent 在 skill 会话中处理数据时，**优先使用原生文件工具**。
-CLI 只在下表标注的少数场景调用。
-| 操作                     | 首选                                                                     | 不要用                             |
-| ------------------------ | ------------------------------------------------------------------------ | ---------------------------------- |
-| 列出所有 note            | `Glob notes/**/*.md`（记得排除 `_archived/**`、`skills/**`、`NOTES.md`） | ❌ `mem-note list-notes`（不存在） |
-| 发现用户 skill           | `Glob notes/skills/*/SKILL.md` + 读 frontmatter                          | ❌ 任何 CLI                        |
-| 读一个 note              | `Read notes/path/foo.md`                                                 | ❌ CLI                             |
-| 读某目录的索引视图       | `Read notes/<topic>/NOTES.md`                                            | ❌ CLI                             |
-| 写 / 更新 note           | `Write` / `Edit` + 记得同步 `NOTES.md`                                   | ❌ CLI                             |
-| 搜索 note 内容           | `Grep "query" notes/**/*.md`                                             | ❌ CLI                             |
-| 处理 inbox entry         | `Bash mv inbox/x.md inbox/.processed/`                                   | ❌ CLI                             |
-| 写 insight               | `Write insights/<id>.md`                                                 | ❌ CLI                             |
-| 编译 `.context/index.md` | `Write .context/index.md`                                                | ❌ CLI                             |
-| **归档 note**            | ✅ `mem-note archive <path>`（封装多步操作）                             | `mv` + 手动更新 NOTES.md（易漏）   |
-| **检查一致性**           | ✅ `mem-note doctor`（每次 groom 末尾）                                  | 手动检查（不现实）                 |
-| 追加 audit log           | `Bash` 追加 `.reports/<date>.md` 或最后一次 `Write`                      | —                                  |
-## 9. CLI 命令清单（5 个）
-| #   | 命令                      | 职责                                                   | 典型调用方                         |
-| --- | ------------------------- | ------------------------------------------------------ | ---------------------------------- |
-| 1   | `mem-note init`           | 幂等创建目录 + 写入 `CONVENTIONS.md`（已存在则跳过）   | 人（首次安装）                     |
-| 2   | `mem-note save <content>` | 存一条 inbox entry。支持 `--type`、`--source`、stdin   | 人 / hook / 外部脚本               |
-| 3   | `mem-note archive <path>` | 封装 "加日期前缀 + mv 到 `_archived/` + 更新 NOTES.md" | 人 / AI agent                      |
-| 4   | `mem-note doctor`         | 检查 frontmatter schema、NOTES.md 漂移、归档命名一致性 | 人 / AI agent（每次 groom 结束时） |
-| 5   | `mem-note quick-context`  | 输出 `.context/index.md` 内容（封装路径解析）          | hook (SessionStart / PreCompact)   |
-其他一切都是 AI agent / 人用原生工具直接做。
-## 10. Groom Skill 默认工作流
-作为参考，groom skill 按以下顺序处理：
-1. `Read CONVENTIONS.md` —— 加载约定（若当前会话已加载可跳过）
-2. `Read notes/NOTES.md` + 感兴趣子目录的 `NOTES.md` —— 拿目录视图
-3. `Glob inbox/*.md` —— 列 pending inbox entries
-4. `Read` 每个 inbox entry
-5. 对每条 entry 决策 **create** / **merge** / **discard**：
-   - **create**：`Write notes/<topic>/<slug>.md` + `Edit notes/<topic>/NOTES.md`
-   - **merge**：`Edit notes/<topic>/existing.md` 合入新信息 + 更新 NOTES.md 的 description
-   - **discard**：无动作
-6. 所有情况都 `Bash mv inbox/<entry> inbox/.processed/`
-7. 如有冲突 / 过期 note，`mem-note archive <path>` 归档
-8. 如发现矛盾 / 模式，`Write insights/<id>.md`
-9. 重新编译 `.context/index.md`：`Write .context/index.md` 包含 Preferences / **Active Reminders** / Key Facts
-10. `Bash mem-note doctor` 检查一致性；有警告则修正
-11. `Bash` 追加一段 audit 到 `.reports/<YYYY-MM-DD>.md`
-## 11. Git 集成（可选但推荐）
-`mem-note init` 会检测 git 是否可用，可用则在数据根执行 `git init`、写入
-`.gitignore`、并做一次初始 commit。之后：
-- `mem-note save` / `mem-note archive` 每次成功写入后自 commit，message 形如
-  `save: <slug>` / `archive: <slug>`。
-- 插件的 Stop hook (`session-commit.js`) 在每次 Claude Code 会话结束时兜底
-  commit 剩余未提交的改动，message 形如 `session: <ISO timestamp>`，
-  用于捕获 skill 通过 `Write`/`Edit`/`Bash mv` 直接做的写入。
-git 不可用时 mem-note 完全回退：所有功能照常工作，只是没有版本历史。
-**`.gitignore` 默认内容**：忽略 `.snapshots/` 和 OS 垃圾（`.DS_Store` 等）。
-其余所有内容（包括 `notes/`、`inbox/`、`inbox/.processed/`、`insights/`、
-`.context/index.md`、`.reports/`、`notes/skills/`）都进入 git。
-**为什么 `.processed/` 也 track**：虽然和 git 历史有重合，但它保留了"已处理
-inbox entry"的语义维度，方便后续 groom 或人类直接 `Read` 回溯；grep 友好。
-## 12. FAQ
-**Q: 为什么 inbox entry 的 frontmatter 可以为空？**
-A: inbox 是原始输入池。人 / hook / 外部脚本 save 时不应该被分类 schema 绑架。分类是 groom 的职责。
-**Q: 为什么 `archive` 有 CLI 但 `create-note` 没有？**
-A: archive 涉及"加日期前缀 + mv + 更新 NOTES.md"多步操作，手动容易漏；create 只是一次 `Write` + 一次 `Edit NOTES.md`，原生工具更透明。
-**Q: AI agent 怎么在会话里搜 note？**
-A: 用 `Grep "query" notes/**/*.md` 或 `Grep --glob '!**/NOTES.md' --glob '!**/_archived/**' "query" notes/`。
-**Q: 人想在 terminal 快速搜 note？**
-A: 用 ripgrep：`rg -i "query" ~/.aibox-mem-note/notes/`。懒的话 shell rc 加：
-```sh
-alias mns='rg -i ~/.aibox-mem-note/notes/'
-```
-**Q: 插件升级时 `CONVENTIONS.md` 会被覆盖吗？**
-A: 不会。`mem-note init` 检测到已存在的 `CONVENTIONS.md` 会跳过写入。如果 schema 升级需要迁移，由 `mem-note doctor --migrate` 处理（未来扩展）。
-**Q: `doctor` 检查哪些东西？**
-A:
-1. 每个 note 的 frontmatter 是否有必填字段（`type`、`title`、`description`、`tags`、`updated`）
-2. 每个 note 是否在对应目录的 `NOTES.md` 里有对应条目
-3. 每个 `NOTES.md` 条目是否指向存在的文件
-4. `notes/_archived/` 下的文件名是否符合 `<YYYY-MM-DD>_<slug>.md` 格式
-5. Inbox entry 的 `created` 字段是否存在
-6. `.context/index.md` 是否存在 `## Active Reminders` 段落
-**Q: 多个 AI agent 会话并发写怎么办？**
-A: 不支持真正的并发（没有锁）。groom 是单会话操作，假设没有并发 writer。
-**Q: 归档后能恢复吗？**
-A: 能。`Bash mv notes/_archived/<date>_<slug>.md notes/<topic>/<slug>.md` + `Edit NOTES.md`。没有专门 CLI 命令，因为是罕见操作。
+**维护契约**：创建 / 重命名 / 归档 note 时必须同步更新对应 `NOTES.md`。`title` 和 `description` 来自 note frontmatter。

package/bin/groom-rules.md ADDED Viewed

@@ -0,0 +1,43 @@
+# Groom Rules
+> 本文件归用户所有，插件升级不会覆盖（仅首次 init 时写入种子版本）。
+> 你可以自由修改以调教 AI agent 的 groom 行为。
+## Triage 策略
+对每条 inbox entry，决策 **create** / **merge** / **discard**：
+- **create**：全新知识，与现有 notes 无重叠
+- **merge**：补充已有 note 的信息
+- **discard**：噪声、调试碎片、已被捕获的重复内容
+拿不准时优先 **create** — 后续 groom 可以再合并去重。
+## 并行 Triage
+可为每条 inbox entry 派发一个 sub-agent（便宜模型即可），并行处理：
+- 每个 sub-agent `Read` 一条 entry + notes 索引快照，输出结构化决策
+- 主 agent 收集结果后顺序执行写入（避免 NOTES.md 冲突）
+## 合并判断
+- 语义重叠 > 50% 即应 merge 而非 create
+- merge 时保留原 note 的结构，追加新信息，bump `updated`
+## Discard 标准
+- 纯 tool 输出、命令行日志、无实质内容的对话片段
+- 与已有 note 完全重复（无新信息）
+- 临时性调试上下文（除非包含可复用的 lesson）
+## 洞察提取
+发现以下情况时写入 `insights/`：
+- 两条 note 之间存在矛盾
+- ≥ 3 条 note 呈现同一模式
+- 某个重复操作适合抽成 skill
+## .context/index.md 编译
+groom 结束时重新编译，< 2KB，必须包含 `## Active Reminders`（可为空）。
+扫描所有 `type: reminder` 的 note 生成该段落。

package/bin/mem-note.mjs CHANGED Viewed

@@ -7084,13 +7084,7 @@ var require_gray_matter = __commonJS({
 import { homedir } from "node:os";
 import { basename as basename3, dirname as dirname3, join as join22, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
-import {
-  access as access2,
-  copyFile,
-  readFile as readFile4,
-  readdir as readdir3,
-  writeFile as writeFile22
-} from "node:fs/promises";
+import { access as access2, copyFile, readFile as readFile4, readdir as readdir3 } from "node:fs/promises";
 // apps/mem-note-cli/node_modules/commander/esm.mjs
 var import_index = __toESM(require_commander(), 1);
@@ -7172,6 +7166,10 @@ var DataDir = class {
   conventionsPath() {
     return join(this.root, "CONVENTIONS.md");
   }
+  /** `<root>/GROOM_RULES.md` — user-owned groom strategy, seeded by init, never overwritten. */
+  groomRulesPath() {
+    return join(this.root, "GROOM_RULES.md");
+  }
   /** The absolute root path. */
   get rootDir() {
     return this.root;
@@ -7731,19 +7729,33 @@ function printInstallGuidance() {
 function resolveDataRoot() {
   return process.env["MEM_NOTE_DATA_DIR"] ?? join22(homedir(), ".aibox-mem-note");
 }
-async function getDataDir() {
-  const dd = new DataDir(resolveDataRoot());
-  await dd.ensureInitialized();
-  return dd;
+function resolveResourceDir() {
+  try {
+    return dirname3(fileURLToPath(import.meta.url));
+  } catch {
+    return __dirname;
+  }
 }
-function resolveConventionsResource() {
-  let here;
+async function syncResources(dd) {
+  const resDir = resolveResourceDir();
+  try {
+    await copyFile(resolve(resDir, "conventions.md"), dd.conventionsPath());
+  } catch {
+  }
   try {
-    here = dirname3(fileURLToPath(import.meta.url));
+    await access2(dd.groomRulesPath());
   } catch {
-    here = __dirname;
+    try {
+      await copyFile(resolve(resDir, "groom-rules.md"), dd.groomRulesPath());
+    } catch {
+    }
   }
-  return resolve(here, "conventions.md");
+}
+async function getDataDir() {
+  const dd = new DataDir(resolveDataRoot());
+  await dd.ensureInitialized();
+  await syncResources(dd);
+  return dd;
 }
 async function readStdin() {
   if (process.stdin.isTTY)
@@ -7757,28 +7769,9 @@ async function readStdin() {
 var program2 = new Command();
 program2.name("mem-note").description("AI-enhanced personal knowledge base \u2014 minimal CLI surface").version("0.2.0");
 program2.command("init").description(
-  "Create the data directory tree and write CONVENTIONS.md (idempotent \u2014 does not overwrite an existing CONVENTIONS.md)"
+  "Create data directory, sync plugin resources, and initialize git (idempotent)"
 ).action(async () => {
   const dd = await getDataDir();
-  const conventionsDest = dd.conventionsPath();
-  let conventionsExisted = false;
-  try {
-    await access2(conventionsDest);
-    conventionsExisted = true;
-  } catch {
-  }
-  if (!conventionsExisted) {
-    const source = resolveConventionsResource();
-    try {
-      await copyFile(source, conventionsDest);
-    } catch (err) {
-      const fallback = "# mem-note CONVENTIONS\n\nFull conventions document missing from this installation. See apps/mem-note-cli/src/conventions.md in the source repo.\n";
-      await writeFile22(conventionsDest, fallback, "utf-8");
-      console.warn(
-        `[mem-note init] Warning: could not read ${source}: ${String(err)}`
-      );
-    }
-  }
   let gitStatus = "skipped-no-git";
   if (await isGitAvailable()) {
     if (await isGitRepo(dd.rootDir)) {
@@ -7794,12 +7787,14 @@ program2.command("init").description(
     JSON.stringify({
       ok: true,
       root: dd.rootDir,
-      conventions: conventionsExisted ? "already-present" : conventionsDest,
       git: gitStatus
     })
   );
 });
-program2.command("save").description("Save a new inbox entry. Accepts content as argument or stdin.").argument("[content]", "Content to save (omit to read from stdin)").option("--type <type>", "Preliminary type hint (optional; groom may rewrite)").option(
+program2.command("save").description("Save a new inbox entry. Accepts content as argument or stdin.").argument("[content]", "Content to save (omit to read from stdin)").option(
+  "--type <type>",
+  "Preliminary type hint (optional; groom may rewrite)"
+).option(
   "--tags <tags>",
   "Comma-separated tags (optional)",
   (val) => val.split(",").map((t) => t.trim()).filter(Boolean)
@@ -7918,9 +7913,7 @@ async function walkNotes(dir) {
   }
   return results;
 }
-program2.command("ui-exec", { hidden: true }).description(
-  "Internal-only UI bridge command"
-).action(async () => {
+program2.command("ui-exec", { hidden: true }).description("Internal-only UI bridge command").action(async () => {
   const raw = await readStdin();
   if (!raw) {
     process.stderr.write("ui-exec: no input received on stdin\n");
@@ -7959,7 +7952,9 @@ program2.command("ui-exec", { hidden: true }).description(
       }
       case "list-inbox": {
         const inboxDir = dd.inboxDir();
-        const entries = await readdir3(inboxDir, { withFileTypes: true }).catch(() => []);
+        const entries = await readdir3(inboxDir, {
+          withFileTypes: true
+        }).catch(() => []);
         const items = await Promise.all(
           entries.filter((e) => e.isFile() && e.name.endsWith(".md")).map(async (e) => {
             const absPath = join22(inboxDir, e.name);
@@ -7990,10 +7985,31 @@ program2.command("ui-exec", { hidden: true }).description(
         const date = typeof input["date"] === "string" ? input["date"] : (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
         let content = "";
         try {
-          content = await readFile4(join22(dd.reportsDir(), `${date}.md`), "utf-8");
+          content = await readFile4(
+            join22(dd.reportsDir(), `${date}.md`),
+            "utf-8"
+          );
         } catch {
         }
-        process.stdout.write(JSON.stringify({ ok: true, data: { content, date } }));
+        process.stdout.write(
+          JSON.stringify({ ok: true, data: { content, date } })
+        );
+        break;
+      }
+      case "get-graph-path": {
+        const graphPath = join22(dd.reportsDir(), "graph.html");
+        let exists = false;
+        try {
+          await access2(graphPath);
+          exists = true;
+        } catch {
+        }
+        process.stdout.write(
+          JSON.stringify({
+            ok: true,
+            data: { path: exists ? graphPath : null }
+          })
+        );
         break;
       }
       case "process-inbox": {
@@ -8002,7 +8018,9 @@ program2.command("ui-exec", { hidden: true }).description(
         const reason = typeof input["reason"] === "string" ? input["reason"] : void 0;
         const filename = basename3(rawFilename);
         if (!filename || !filename.endsWith(".md") || filename !== rawFilename) {
-          process.stderr.write("ui-exec: process-inbox requires a plain .md filename\n");
+          process.stderr.write(
+            "ui-exec: process-inbox requires a plain .md filename\n"
+          );
           process.exit(1);
         }
         if (rawStatus !== "processed" && rawStatus !== "user-ignored") {

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@meitouai/mem-note-cli",
-  "version": "0.0.3",
+  "version": "0.1.0",
   "description": "Personal knowledge base CLI for use with the mem-note Claude Code plugin.",
   "license": "MIT",
   "type": "module",
@@ -9,7 +9,8 @@
   },
   "files": [
     "bin/mem-note.mjs",
-    "bin/conventions.md"
+    "bin/conventions.md",
+    "bin/groom-rules.md"
   ],
   "engines": {
     "node": ">=20"