mmm-mcp-server 0.1.3 → 0.2.0

package/README.en.md

@@ -11,7 +11,7 @@ A tool that lets you read and write your own maps in Matryoshka Mind Map (a mind
 
 This tool runs entirely on your computer, with no always-on server. It starts only when needed and accesses your own maps with your own login credentials (the developer cannot see your data).
 
-> **For users who installed via `git clone` before September 30, 2026**: Due to a data format migration in the app, older versions will fail when writing to maps. Please replace the registration in Step 5 below with `npx -y mmm-mcp-server` (you do not need to log in again). If you want to keep using your cloned copy, run `git pull && npm install && npm run build` in the `mmm_mcp` folder and restart your AI agent.
+> **For users who installed via `git clone` before September 30, 2026**: Due to a data format migration in the app, older versions will fail when writing to maps. Please replace the registration in Step 5 below with `npx -y mmm-mcp-server@latest` (you do not need to log in again). If you want to keep using your cloned copy, run `git pull && npm install && npm run build` in the `mmm_mcp` folder and restart your AI agent.
 
 > This guide walks you through every step, starting with how to open the terminal (the window where you type commands), so that you can follow along even if you are not used to working with a computer.
 >
@@ -66,7 +66,7 @@ Choose one of the following three options based on how you usually log in to the
 ### If you log in with Google
 
 ```bash
-npx -y -p mmm-mcp-server mmm-login login --method google
+npx -y -p mmm-mcp-server@latest mmm-login login --method google
 ```
 
 Your browser opens automatically; log in with the Google account you usually use.
@@ -74,7 +74,7 @@ Your browser opens automatically; log in with the Google account you usually use
 ### If you log in with Apple
 
 ```bash
-npx -y -p mmm-mcp-server mmm-login login --method apple
+npx -y -p mmm-mcp-server@latest mmm-login login --method apple
 ```
 
 Your browser opens automatically; log in with your Apple ID.
@@ -82,7 +82,7 @@ Your browser opens automatically; log in with your Apple ID.
 ### If you log in with an email address and password
 
 ```bash
-npx -y -p mmm-mcp-server mmm-login login --method email
+npx -y -p mmm-mcp-server@latest mmm-login login --method email
 ```
 
 You will be asked for your email address and password (the password is not shown on screen).
@@ -92,23 +92,23 @@ You will be asked for your email address and password (the password is not shown
 Once you have logged in, you do not need to log in again each time (your credentials are stored only on your computer, in a form that only you can read).
 
 ```bash
-npx -y -p mmm-mcp-server mmm-login status
+npx -y -p mmm-mcp-server@latest mmm-login status
 ```
 
 shows your login status. To log out:
 
 ```bash
-npx -y -p mmm-mcp-server mmm-login logout
+npx -y -p mmm-mcp-server@latest mmm-login logout
 ```
 
 ## 5. Register It with Your AI Agent
 
-Below are the instructions for Claude Desktop and Claude Code, which have been tested. If you use another MCP-compatible client (e.g., Codex), in most cases you only need to register the server launch command (`npx -y mmm-mcp-server`) in that client's MCP server settings. See your client's documentation for the exact steps.
+Below are the instructions for Claude Desktop and Claude Code, which have been tested. If you use another MCP-compatible client (e.g., Codex), in most cases you only need to register the server launch command (`npx -y mmm-mcp-server@latest`) in that client's MCP server settings. See your client's documentation for the exact steps.
 
 ### Claude Code
 
 ```bash
-claude mcp add mmm -- npx -y mmm-mcp-server
+claude mcp add mmm -- npx -y mmm-mcp-server@latest
 ```
 
 ### Claude Desktop
@@ -120,7 +120,7 @@ Open the Claude Desktop configuration file (`claude_desktop_config.json`) and ad
   "mcpServers": {
     "mmm": {
       "command": "npx",
-      "args": ["-y", "mmm-mcp-server"]
+      "args": ["-y", "mmm-mcp-server@latest"]
     }
   }
 }
@@ -164,6 +164,38 @@ The reasons:
 - **Do not mix URLs with text**: A URL in the same element as other text is not treated as a link in the app, so tapping it does nothing.
 - **Chronological order**: Compared with ordering by task name, checking items off in order makes it easier to notice anything you missed.
 
+## Updating to the Latest Version
+
+If your registration in Step 5 uses `mmm-mcp-server@latest`, the latest version is used every time your AI agent starts, so there is nothing to do.
+
+If you registered with `npx -y mmm-mcp-server` (without `@latest`), you may still be running the old version that was downloaded the first time. Update the registration as follows (you do not need to log in again).
+
+### Claude Code
+
+Remove the registration, then register it again.
+
+```bash
+claude mcp remove mmm
+```
+
+```bash
+claude mcp add mmm -- npx -y mmm-mcp-server@latest
+```
+
+If you registered with `--scope user`, add `--scope user` to both commands.
+
+```bash
+claude mcp remove mmm --scope user
+```
+
+```bash
+claude mcp add mmm --scope user -- npx -y mmm-mcp-server@latest
+```
+
+### Claude Desktop
+
+Change `"args"` in `claude_desktop_config.json` to `["-y", "mmm-mcp-server@latest"]`, save it, and restart Claude Desktop.
+
 ## Troubleshooting
 
 | Symptom | Cause / Solution |
@@ -189,7 +221,7 @@ What follows is **just one example of how it can be used**. It is not a standard
 When registering with Claude Code in Step 5, the `mmm` tool is only available in the current folder by default. To use it no matter which folder you start `claude` in, register it with `--scope user`:
 
 ```bash
-claude mcp add mmm --scope user -- npx -y mmm-mcp-server
+claude mcp add mmm --scope user -- npx -y mmm-mcp-server@latest
 ```
 
 **(2) Write the workflow rules in your global CLAUDE.md (`~/.claude/CLAUDE.md`)**

package/README.md

@@ -20,7 +20,7 @@ Desktop・Claude Codeに限らず、MCPに対応したAIエージェントであ
 
 > **2026年9月30日より前に `git clone` で導入した方へ**: アプリ側のデータ形式の
 > 切り替えに伴い、古い版ではマップへの書き込みが失敗するようになります。下の手順5の
-> 登録を `npx -y mmm-mcp-server` に置き換えてください（ログインし直す必要はありません）。
+> 登録を `npx -y mmm-mcp-server@latest` に置き換えてください（ログインし直す必要はありません）。
 > clone したまま使い続ける場合は、`mmm_mcp` フォルダで `git pull && npm install && npm run build`
 > を実行してからAIエージェントを再起動してください。
 
@@ -98,7 +98,7 @@ Matryoshka Mind Mapアプリで普段どのログイン方法を使っている
 ### Googleでログインしている場合
 
 ```bash
-npx -y -p mmm-mcp-server mmm-login login --method google
+npx -y -p mmm-mcp-server@latest mmm-login login --method google
 ```
 
 ブラウザが自動で開くので、いつも使っているGoogleアカウントでログインします。
@@ -106,7 +106,7 @@ npx -y -p mmm-mcp-server mmm-login login --method google
 ### Appleでログインしている場合
 
 ```bash
-npx -y -p mmm-mcp-server mmm-login login --method apple
+npx -y -p mmm-mcp-server@latest mmm-login login --method apple
 ```
 
 こちらもブラウザが自動で開くので、Apple IDでログインします。
@@ -114,7 +114,7 @@ npx -y -p mmm-mcp-server mmm-login login --method apple
 ### メールアドレスとパスワードでログインしている場合
 
 ```bash
-npx -y -p mmm-mcp-server mmm-login login --method email
+npx -y -p mmm-mcp-server@latest mmm-login login --method email
 ```
 
 メールアドレスとパスワードを聞かれるので入力してください（パスワードは
@@ -131,27 +131,27 @@ npx -y -p mmm-mcp-server mmm-login login --method email
 あなたのパソコンの中だけに、あなた以外読めない形で保存されます）。
 
 ```bash
-npx -y -p mmm-mcp-server mmm-login status
+npx -y -p mmm-mcp-server@latest mmm-login status
 ```
 
 でログイン状態を確認できます。ログアウトしたい場合は次のコマンドです。
 
 ```bash
-npx -y -p mmm-mcp-server mmm-login logout
+npx -y -p mmm-mcp-server@latest mmm-login logout
 ```
 
 ## 5. AIエージェントにMatryoshkaを教える
 
 ここでは動作確認済みのClaude Desktop / Claude Codeへの登録方法を示します。
 他のMCP対応クライアント（例: Codexなど）を使っている場合も、多くは同じように
-「サーバーを起動するコマンド」（`npx -y mmm-mcp-server`）をそのクライアントの
+「サーバーを起動するコマンド」（`npx -y mmm-mcp-server@latest`）をそのクライアントの
 MCPサーバー設定に登録するだけで使えるはずです。具体的な登録方法はお使いの
 クライアントのドキュメントを確認してください。
 
 ### Claude Codeを使っている場合
 
 ```bash
-claude mcp add mmm -- npx -y mmm-mcp-server
+claude mcp add mmm -- npx -y mmm-mcp-server@latest
 ```
 
 ### Claude Desktopを使っている場合
@@ -164,7 +164,7 @@ Claude Desktopの設定ファイル（`claude_desktop_config.json`）を開き
   "mcpServers": {
     "mmm": {
       "command": "npx",
-      "args": ["-y", "mmm-mcp-server"]
+      "args": ["-y", "mmm-mcp-server@latest"]
     }
   }
 }
@@ -223,6 +223,42 @@ AIエージェントに任せると楽な反面、そのままだと読みにく
 - **時系列で並べる** … 作業の名前で並べるより、順に消していく形になるぶん、
   抜けに気づきやすくなります
 
+## 最新版にする
+
+手順5の登録が `mmm-mcp-server@latest` になっていれば、AIエージェントを起動するたびに
+最新版が使われるので、何もする必要はありません。
+
+`@latest` の付いていない `npx -y mmm-mcp-server` で登録した方は、最初に取得した古い版を
+使い続けていることがあります。次のように登録を書き換えてください（ログインし直す必要は
+ありません）。
+
+### Claude Codeを使っている場合
+
+登録を一度消してから、登録し直します。
+
+```bash
+claude mcp remove mmm
+```
+
+```bash
+claude mcp add mmm -- npx -y mmm-mcp-server@latest
+```
+
+`--scope user` で登録していた方は、消すときも登録するときも `--scope user` を付けます。
+
+```bash
+claude mcp remove mmm --scope user
+```
+
+```bash
+claude mcp add mmm --scope user -- npx -y mmm-mcp-server@latest
+```
+
+### Claude Desktopを使っている場合
+
+`claude_desktop_config.json` の `"args"` を `["-y", "mmm-mcp-server@latest"]` に書き換えて保存し、
+Claude Desktopを再起動してください。
+
 ## よくあるトラブル
 
 | 症状 | 原因・対処 |
@@ -257,7 +293,7 @@ AIエージェントに任せると楽な反面、そのままだと読みにく
 するには、`--scope user`を付けて登録します。
 
 ```bash
-claude mcp add mmm --scope user -- npx -y mmm-mcp-server
+claude mcp add mmm --scope user -- npx -y mmm-mcp-server@latest
 ```
 
 **(2) グローバルのCLAUDE.md（`~/.claude/CLAUDE.md`）に運用ルールを書く**

package/dist/src/auth/session.js

@@ -45,7 +45,7 @@ export class AuthSession {
 }
 export class NotSignedInError extends Error {
     constructor() {
-        super("サインインしていません。ターミナルで `npx -y -p mmm-mcp-server mmm-login login --method google` を実行してください(email / apple も選べます。git clone して使っている場合は、そのフォルダで `npm run login -- login --method google`)。");
+        super("サインインしていません。ターミナルで `npx -y -p mmm-mcp-server@latest mmm-login login --method google` を実行してください(email / apple も選べます。git clone して使っている場合は、そのフォルダで `npm run login -- login --method google`)。");
         this.name = "NotSignedInError";
     }
 }

package/dist/src/domain/detailLimit.js

@@ -0,0 +1,18 @@
+/**
+ * 1要素の本文の上限(UTF-16の単位、JavaScriptのlength)。子の一覧は1ドキュメントに
+ * 入るため、巨大な書き込み1回でドキュメントの上限1MiBを超えないようにする。
+ * アプリの lib/domain/detail_limit.dart と同じ値にする。決めごとは docs/paid-plan.md §7。
+ */
+export const MAX_DETAIL_LENGTH = 5000;
+/** 上限を超えたときにClaudeへ返す説明。黙って切らず、分けて書き直してもらう。 */
+export function tooLongDetailMessage(length) {
+    return (`要素の本文が${length}文字あり、1要素の上限(${MAX_DETAIL_LENGTH}文字)を超えています。` +
+        `何も書き込んでいません。複数の要素に分けて書き直してください。`);
+}
+/** [details]のうち上限を超えるものがあれば、何も書かずに済むよう例外を投げる。 */
+export function assertDetailLengths(details) {
+    for (const detail of details) {
+        if (detail.length > MAX_DETAIL_LENGTH)
+            throw new Error(tooLongDetailMessage(detail.length));
+    }
+}

package/dist/src/domain/headerOrder.js

@@ -0,0 +1,40 @@
+/**
+ * 新しいマップを一覧の先頭に置くとき、既存の自分のマップの`order`を
+ * どう書き換えるかを計算する(Firestoreに触れない)。
+ * lib/header_list/header_order.dart の prependedHeaderOrders と同じ考え方。
+ *
+ * 新しいマップを1にし、既存はアプリの一覧と同じ並び(orderの昇順、
+ * 同値はドキュメントidの順)のまま2..n+1に振り直す。値が変わるものだけを返す。
+ * 欠番と重複もこの1回で解消する。
+ */
+export function prependedHeaderOrders(entries) {
+    const sorted = [...entries].sort((a, b) => a.order !== b.order ? a.order - b.order : a.id < b.id ? -1 : a.id > b.id ? 1 : 0);
+    const updates = [];
+    sorted.forEach((entry, position) => {
+        if (entry.order !== position + 2)
+            updates.push({ id: entry.id, order: position + 2 });
+    });
+    return updates;
+}
+/**
+ * create_map の書き込み一式。既存の自分のマップを2..n+1に振り直し、新しいマップを
+ * order 1 で作る。order を持たないマップは一覧に出ないので触らない。
+ * 振り直しは読んだ時点の updateTime を前提条件にする(読んだ後に別の端末で消された
+ * マップを、order だけのドキュメントとして作り直さないため)。
+ */
+export function buildCreateMapWrites(headersPath, existing, headerId, title, isTodo) {
+    const updateTimes = new Map(existing.map((doc) => [doc.id, doc.updateTime]));
+    const shifts = prependedHeaderOrders(existing
+        .filter((doc) => typeof doc.data.order === "number")
+        .map((doc) => ({ id: doc.id, order: doc.data.order })));
+    const headerPath = `${headersPath}/${headerId}`;
+    return [
+        ...shifts.map((s) => ({
+            path: `${headersPath}/${s.id}`,
+            fields: { order: s.order },
+            requireUpdateTime: updateTimes.get(s.id),
+        })),
+        { path: headerPath, fields: { title, order: 1, isTodo, editors: [], viewers: [] } },
+        { path: `${headerPath}/levels/root`, fields: { children: [] } },
+    ];
+}

package/dist/src/domain/levels.js

@@ -3,6 +3,10 @@
 //
 //   levels/{levelId}
 //     children: [ { id, detail, done }, ... ]
+//     schedule: { 子のid: { due?: {at, allDay}, start?: {at, allDay} }, ... }
+//               (日付を持つ子だけ。docs/schedule.md §2)
+//     links:    { 子のid: [ { uid, headerId }, ... ], ... }
+//               (マップ間リンクを持つ子だけ。docs/map-links.md §8)
 //
 // levelIdはマップ最上位が'root'、それ以外はその要素自身のid。配列の並び順が
 // そのまま兄弟順。子を持つ要素だけドキュメントが存在する(無ければ葉)。
@@ -32,12 +36,58 @@ export function childrenOf(data) {
     }
     return result;
 }
-/** levels配下の全ドキュメントを読み、levelId -> children[] のMapにする。 */
-export async function readAllLevelDocs(client, levelsPath) {
-    const docs = await client.listDocuments(levelsPath);
+function toScheduleDate(raw) {
+    if (typeof raw !== "object" || raw === null)
+        return undefined;
+    const obj = raw;
+    if (!(obj.at instanceof Date) || typeof obj.allDay !== "boolean")
+        return undefined;
+    return { at: obj.at, allDay: obj.allDay };
+}
+/** levelsドキュメントの schedule を子のid -> 日付にする。形の崩れたもの・空のものは読み飛ばす。 */
+export function scheduleOf(data) {
+    const result = new Map();
+    const raw = data.schedule;
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw))
+        return result;
+    for (const [id, value] of Object.entries(raw)) {
+        if (typeof value !== "object" || value === null)
+            continue;
+        const obj = value;
+        const entry = {};
+        const due = toScheduleDate(obj.due);
+        const start = toScheduleDate(obj.start);
+        if (due)
+            entry.due = due;
+        if (start)
+            entry.start = start;
+        if (due || start)
+            result.set(id, entry);
+    }
+    return result;
+}
+/** levelsドキュメントの links を子のid -> リンク先にする。形の崩れたもの・空のもの・重複は読み飛ばす。 */
+export function linksOf(data) {
     const result = new Map();
-    for (const doc of docs) {
-        result.set(doc.id, childrenOf(doc.data));
+    const raw = data.links;
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw))
+        return result;
+    for (const [id, value] of Object.entries(raw)) {
+        if (!Array.isArray(value))
+            continue;
+        const targets = [];
+        for (const item of value) {
+            if (typeof item !== "object" || item === null)
+                continue;
+            const obj = item;
+            if (typeof obj.uid !== "string" || typeof obj.headerId !== "string")
+                continue;
+            if (targets.some((t) => t.uid === obj.uid && t.headerId === obj.headerId))
+                continue;
+            targets.push({ uid: obj.uid, headerId: obj.headerId });
+        }
+        if (targets.length > 0)
+            result.set(id, targets);
     }
     return result;
 }

package/dist/src/domain/levelsOps.js

@@ -7,9 +7,21 @@
 //
 // 子を持たなくなった要素の子一覧ドキュメントは消す(アプリのprojectLevelsと
 // 同じ扱い)。rootだけは空配列で残す。
-import { childrenOf } from "./levels.js";
+//
+// 期日・着手日(schedule)は children と同じドキュメントにあり、同じ1件の書き込みで
+// 丸ごと書き直す。子を別の親へ移すときは日付も移し、消すときは外す。書くときは
+// children に無いidを取り除く(古い版が取り残した分の掃除。docs/schedule.md §4)。
+//
+// マップ間リンク(links)も同じドキュメントにあり、日付と同じ扱いにする
+// (docs/map-links.md §8)。ただしリンクを足す・外すツールは無い。移すときに運び、消すときに外す。
+// header の linkCounts(リンク先ごとの件数の要約)は別ドキュメントなので、
+// [withLinkSummary]で、変わるときだけ同じコミットへ足す。
+import { buildTreeFromLevels, childrenOf, linksOf, scheduleOf, } from "./levels.js";
 export function levelsSnapshotFromDocs(docs) {
-    return new Map(docs.map((d) => [d.id, { children: childrenOf(d.data), updateTime: d.updateTime }]));
+    return new Map(docs.map((d) => [
+        d.id,
+        { children: childrenOf(d.data), schedule: scheduleOf(d.data), links: linksOf(d.data), updateTime: d.updateTime },
+    ]));
 }
 /**
  * levels全件を読む。levels/rootが無いマップは空のマップとして扱う
@@ -72,11 +84,27 @@ export function subtreeIdsInLevels(snapshot, rootId) {
     walk(rootId);
     return result;
 }
+/** list_elements 用。rootから辿れる要素の木に、各要素の期日・着手日を添える。 */
+export function elementTreeOf(snapshot) {
+    const tree = buildTreeFromLevels(new Map([...snapshot].map(([id, level]) => [id, level.children])));
+    const attach = (nodes) => {
+        for (const node of nodes) {
+            const schedule = snapshot.get(node.parentId ?? "root")?.schedule.get(node.id);
+            if (schedule)
+                node.schedule = schedule;
+            attach(node.children);
+        }
+    };
+    attach(tree);
+    return tree;
+}
 /** 編集中の子一覧。触ったものだけを複製して持ち、最後に差分を書き込みにする。 */
 class LevelsDraft {
     levelsPath;
     snapshot;
     edited = new Map();
+    editedSchedule = new Map();
+    editedLinks = new Map();
     removed = new Set();
     constructor(levelsPath, snapshot) {
         this.levelsPath = levelsPath;
@@ -87,15 +115,58 @@ class LevelsDraft {
         if (!list) {
             list = (this.snapshot.get(levelId)?.children ?? []).map((c) => ({ ...c }));
             this.edited.set(levelId, list);
+            this.editedSchedule.set(levelId, new Map(this.snapshot.get(levelId)?.schedule));
+            this.editedLinks.set(levelId, new Map(this.snapshot.get(levelId)?.links));
             this.removed.delete(levelId);
         }
         return list;
     }
+    /** [levelId]の子の日付。触ると、その子一覧も書き込みの対象になる。 */
+    schedule(levelId) {
+        this.children(levelId);
+        return this.editedSchedule.get(levelId);
+    }
+    /** [levelId]の子のマップ間リンク。触ると、その子一覧も書き込みの対象になる。 */
+    links(levelId) {
+        this.children(levelId);
+        return this.editedLinks.get(levelId);
+    }
     /** 子一覧ドキュメントごと消す(配下ごと削除される要素の分)。 */
     remove(levelId) {
         this.edited.delete(levelId);
+        this.editedSchedule.delete(levelId);
+        this.editedLinks.delete(levelId);
         this.removed.add(levelId);
     }
+    /**
+     * 書き込む schedule。children に無いidは除く。元も今も日付が無ければ
+     * undefined を返し、schedule のフィールドに触れない(日付を使わないマップの
+     * 書き込みを今までと同じに保つ)。
+     */
+    scheduleToWrite(levelId, children) {
+        const ids = new Set(children.map((c) => c.id));
+        const result = {};
+        for (const [id, entry] of this.editedSchedule.get(levelId) ?? []) {
+            if (ids.has(id))
+                result[id] = entry;
+        }
+        const hadSchedule = (this.snapshot.get(levelId)?.schedule.size ?? 0) > 0;
+        return hadSchedule || Object.keys(result).length > 0 ? result : undefined;
+    }
+    /**
+     * 書き込む links。children に無いidは除く。元も今もリンクが無ければ undefined を返し、
+     * links のフィールドに触れない(リンクを使わないマップの書き込みを今までと同じに保つ)。
+     */
+    linksToWrite(levelId, children) {
+        const ids = new Set(children.map((c) => c.id));
+        const result = {};
+        for (const [id, targets] of this.editedLinks.get(levelId) ?? []) {
+            if (ids.has(id))
+                result[id] = targets;
+        }
+        const hadLinks = (this.snapshot.get(levelId)?.links.size ?? 0) > 0;
+        return hadLinks || Object.keys(result).length > 0 ? result : undefined;
+    }
     toWrites() {
         const writes = [];
         const pathOf = (levelId) => `${this.levelsPath}/${levelId}`;
@@ -113,9 +184,16 @@ class LevelsDraft {
                 }
                 continue;
             }
+            const schedule = this.scheduleToWrite(levelId, children);
+            const links = this.linksToWrite(levelId, children);
+            const fields = {
+                children,
+                ...(schedule ? { schedule } : {}),
+                ...(links ? { links } : {}),
+            };
             writes.push(original
-                ? { path: pathOf(levelId), fields: { children }, requireUpdateTime: original.updateTime }
-                : { path: pathOf(levelId), fields: { children }, requireMissing: true });
+                ? { path: pathOf(levelId), fields, requireUpdateTime: original.updateTime }
+                : { path: pathOf(levelId), fields, requireMissing: true });
         }
         return writes;
     }
@@ -135,6 +213,33 @@ export function buildLevelsPatchWrites(levelsPath, snapshot, updates) {
     }
     return { writes: draft.toWrites(), found };
 }
+/** set_schedule 用。見つからなかったidはfoundに入らない。同じ要素への指定は後が勝つ。 */
+export function buildLevelsScheduleWrites(levelsPath, snapshot, updates) {
+    const index = indexOf(snapshot);
+    const draft = new LevelsDraft(levelsPath, snapshot);
+    const found = new Set();
+    for (const { elementId, due, start } of updates) {
+        const loc = index.get(elementId);
+        if (!loc)
+            continue;
+        const schedule = draft.schedule(loc.levelId);
+        const next = { ...schedule.get(elementId) };
+        if (due === null)
+            delete next.due;
+        else if (due !== undefined)
+            next.due = due;
+        if (start === null)
+            delete next.start;
+        else if (start !== undefined)
+            next.start = start;
+        if (next.due || next.start)
+            schedule.set(elementId, next);
+        else
+            schedule.delete(elementId);
+        found.add(elementId);
+    }
+    return { writes: draft.toWrites(), found };
+}
 /**
  * auto_structure_thought / import_markdown_context 用。[forest]の最上位を
  * [targetParentId](nullなら最上位)の子の末尾へ足し、forest内で子を持つ
@@ -148,7 +253,10 @@ export function buildLevelsAppendWrites(levelsPath, snapshot, forest, targetPare
         done: isTodo ? node.done : false,
     });
     for (const node of forest) {
-        draft.children(node.parentId ?? targetParentId ?? "root").push(entryOf(node));
+        const levelId = node.parentId ?? targetParentId ?? "root";
+        draft.children(levelId).push(entryOf(node));
+        if (node.schedule)
+            draft.schedule(levelId).set(node.id, node.schedule);
     }
     return draft.toWrites();
 }
@@ -172,7 +280,20 @@ export function buildLevelsMoveWrites(levelsPath, snapshot, elementId, newParent
     const draft = new LevelsDraft(levelsPath, snapshot);
     const from = draft.children(loc.levelId);
     const [entry] = from.splice(from.findIndex((c) => c.id === elementId), 1);
-    const to = draft.children(newParentId ?? "root");
+    // 日付も一緒に移す(同じ親の中の並べ替えなら、外して同じ所へ戻すだけ)
+    const fromSchedule = draft.schedule(loc.levelId);
+    const dates = fromSchedule.get(elementId);
+    fromSchedule.delete(elementId);
+    // リンクも一緒に移す
+    const fromLinks = draft.links(loc.levelId);
+    const linkTargets = fromLinks.get(elementId);
+    fromLinks.delete(elementId);
+    const toLevelId = newParentId ?? "root";
+    const to = draft.children(toLevelId);
+    if (dates)
+        draft.schedule(toLevelId).set(elementId, dates);
+    if (linkTargets)
+        draft.links(toLevelId).set(elementId, linkTargets);
     const insertAt = afterId === null
         ? 0
         : (() => {
@@ -200,8 +321,66 @@ export function buildLevelsDeleteWrites(levelsPath, snapshot, elementIds) {
             continue;
         const list = draft.children(loc.levelId);
         list.splice(list.findIndex((c) => c.id === id), 1);
+        draft.schedule(loc.levelId).delete(id);
+        draft.links(loc.levelId).delete(id);
     }
     for (const id of deletedIds)
         draft.remove(id);
     return { writes: draft.toWrites(), deletedIds };
 }
+/**
+ * header の linkCounts に書く要約: リンク先のキー(`uid:headerId`)-> そのマップへリンクして
+ * いる要素の数。いま子一覧にある要素のリンクだけを数え、1つの要素が同じマップへ
+ * 複数張っていても1つと数える(アプリの linkCountsOf と同じ)。
+ */
+export function linkCountsOfSnapshot(snapshot) {
+    const counts = {};
+    for (const level of snapshot.values()) {
+        const ids = new Set(level.children.map((c) => c.id));
+        for (const [id, targets] of level.links) {
+            if (!ids.has(id))
+                continue;
+            for (const key of new Set(targets.map((t) => `${t.uid}:${t.headerId}`))) {
+                counts[key] = (counts[key] ?? 0) + 1;
+            }
+        }
+    }
+    return counts;
+}
+/** [writes]を[snapshot]へ適用した後の状態(書き込みを組み立て直さず、要約の比較に使う)。 */
+function applyWritesToSnapshot(levelsPath, snapshot, writes) {
+    const after = new Map(snapshot);
+    const prefix = `${levelsPath}/`;
+    for (const write of writes) {
+        if (!write.path.startsWith(prefix))
+            continue;
+        const levelId = write.path.slice(prefix.length);
+        if (write.delete) {
+            after.delete(levelId);
+            continue;
+        }
+        if (!write.fields)
+            continue;
+        const before = after.get(levelId);
+        after.set(levelId, {
+            children: write.fields.children !== undefined ? childrenOf(write.fields) : (before?.children ?? []),
+            schedule: before?.schedule ?? new Map(),
+            // links を書いていなければ、書き込み前のまま残る
+            links: write.fields.links !== undefined ? linksOf(write.fields) : (before?.links ?? new Map()),
+            updateTime: before?.updateTime,
+        });
+    }
+    return after;
+}
+/**
+ * [writes]でリンクの要約(linkCounts)が変わるときだけ、header への書き込みを足して返す
+ * (変わらなければ[writes]のまま)。levels と同じコミットで書く。header は別ドキュメントなので、
+ * levels の「同じドキュメントへ2件書かない」には触れない。
+ */
+export function withLinkSummary(headerPath, levelsPath, snapshot, writes) {
+    const before = linkCountsOfSnapshot(snapshot);
+    const after = linkCountsOfSnapshot(applyWritesToSnapshot(levelsPath, snapshot, writes));
+    const keys = new Set([...Object.keys(before), ...Object.keys(after)]);
+    const changed = [...keys].some((k) => before[k] !== after[k]);
+    return changed ? [...writes, { path: headerPath, fields: { linkCounts: after } }] : writes;
+}

package/dist/src/domain/mapResolver.js

@@ -30,6 +30,10 @@ export async function resolveMap(client, session, mapId) {
     }
     throw new MapNotFoundError(mapId);
 }
+/** マップの header ドキュメントのパス。 */
+export function headerPathOf(map) {
+    return `users/${map.ownerUid}/headers/${map.headerId}`;
+}
 /** マップの中身(階層ごとの子一覧を配列で持つコレクション)のパス。 */
 export function levelsPathOf(map) {
     return `users/${map.ownerUid}/headers/${map.headerId}/levels`;

package/dist/src/domain/markdownParser.js

@@ -1,7 +1,24 @@
 import { newDocId } from "./idGen.js";
+import { parseScheduleDate } from "./scheduleText.js";
 const LIST_PATTERN = /^(\s*)(?:[-*+]|\d+\.)\s+(.+)$/;
 const CHECKBOX_PATTERN = /^\[([ xX])\]\s*(.*)$/;
 const HEADING_PATTERN = /^(#{1,6})\s+(.*)$/;
+// Obsidian Tasks の書き方(docs/schedule.md §7)。時刻付きは日付のあとに続ける。
+const SCHEDULE_PATTERN = /\s*(📅|🛫)\s*(\d{4}-\d{2}-\d{2}(?: \d{2}:\d{2})?)/gu;
+/** 要素の1行目から 📅・🛫 の日付を取り出す。読めない日付は本文に残す。 */
+function extractSchedule(detail) {
+    const schedule = {};
+    const rest = detail.replace(SCHEDULE_PATTERN, (whole, mark, text) => {
+        try {
+            schedule[mark === "📅" ? "due" : "start"] = parseScheduleDate(text);
+            return "";
+        }
+        catch {
+            return whole;
+        }
+    });
+    return schedule.due || schedule.start ? { detail: rest.trim(), schedule } : { detail };
+}
 /**
  * Markdownテキストを解析して取り込める形の[MarkdownNode]の並びにする。
  *
@@ -48,15 +65,17 @@ export function parseMarkdownForImport(markdownText, { headingsAsNodes }) {
                 done = checkboxMatch[1].toLowerCase() === "x";
                 detail = checkboxMatch[2] ?? "";
             }
+            const extracted = extractSchedule(detail);
             currentNode = {
                 id: newDocId(),
-                detail,
+                detail: extracted.detail,
                 rawIndent: indent,
                 done,
                 parentId: null,
                 prevId: null,
                 nextId: null,
                 childId: null,
+                ...(extracted.schedule ? { schedule: extracted.schedule } : {}),
             };
             nodes.push(currentNode);
             continue;

package/dist/src/domain/scheduleText.js

@@ -0,0 +1,29 @@
+const PATTERN = /^(\d{4})-(\d{2})-(\d{2})(?: (\d{2}):(\d{2}))?$/;
+const pad = (n) => String(n).padStart(2, "0");
+export function formatScheduleDate(date) {
+    const d = date.at;
+    if (date.allDay) {
+        return `${d.getUTCFullYear()}-${pad(d.getUTCMonth() + 1)}-${pad(d.getUTCDate())}`;
+    }
+    return (`${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ` +
+        `${pad(d.getHours())}:${pad(d.getMinutes())}`);
+}
+export function parseScheduleDate(text) {
+    const m = PATTERN.exec(text.trim());
+    const invalid = () => new Error(`日付「${text}」を読めません。終日なら "YYYY-MM-DD"、時刻付きなら "YYYY-MM-DD HH:mm" で指定してください。`);
+    if (!m)
+        throw invalid();
+    const [y, mo, d] = [Number(m[1]), Number(m[2]), Number(m[3])];
+    const hasTime = m[4] !== undefined;
+    const [h, mi] = hasTime ? [Number(m[4]), Number(m[5])] : [0, 0];
+    if (h > 23 || mi > 59)
+        throw invalid();
+    const at = hasTime ? new Date(y, mo - 1, d, h, mi) : new Date(Date.UTC(y, mo - 1, d));
+    // 2/30 のような存在しない日付は、Date が翌月へ繰り越すので突き合わせて弾く
+    const [cy, cm, cd] = hasTime
+        ? [at.getFullYear(), at.getMonth() + 1, at.getDate()]
+        : [at.getUTCFullYear(), at.getUTCMonth() + 1, at.getUTCDate()];
+    if (cy !== y || cm !== mo || cd !== d)
+        throw invalid();
+    return { at, allDay: !hasTime };
+}

package/dist/src/firestore/valueCodec.js

@@ -15,6 +15,9 @@ export function encodeValue(value) {
     if (typeof value === "string") {
         return { stringValue: value };
     }
+    if (value instanceof Date) {
+        return { timestampValue: value.toISOString() };
+    }
     if (Array.isArray(value)) {
         return { arrayValue: { values: value.map(encodeValue) } };
     }
@@ -36,6 +39,9 @@ export function decodeValue(value) {
         return value.doubleValue;
     if ("stringValue" in value)
         return value.stringValue;
+    // RFC 3339。ナノ秒まで来ることがあるが、Dateはミリ秒までしか持たない
+    if ("timestampValue" in value)
+        return new Date(value.timestampValue);
     if ("arrayValue" in value) {
         return (value.arrayValue.values ?? []).map(decodeValue);
     }

package/dist/src/server.js

@@ -10,9 +10,10 @@ import { registerImportMarkdownContext } from "./tools/importMarkdownContext.js"
 import { registerEditElement } from "./tools/editElement.js";
 import { registerDeleteElements } from "./tools/deleteElements.js";
 import { registerMoveElement } from "./tools/moveElement.js";
+import { registerSetSchedule } from "./tools/setSchedule.js";
 const server = new McpServer({
     name: "matryoshka-mindmap",
-    version: "0.1.3",
+    version: "0.2.0",
 }, {
     instructions: "このサーバーはリアルタイム同期を行わない。各ツールは呼び出された瞬間の" +
         "Firestoreの状態を返すだけで、アプリ側でユーザーが直接行った変更は" +
@@ -29,5 +30,6 @@ registerImportMarkdownContext(server);
 registerEditElement(server);
 registerDeleteElements(server);
 registerMoveElement(server);
+registerSetSchedule(server);
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/dist/src/tools/autoStructureThought.js

@@ -1,13 +1,18 @@
 import { z } from "zod";
 import { getContext } from "../mcpContext.js";
+import { assertDetailLengths } from "../domain/detailLimit.js";
 import { ancestorDetailsInLevels, buildLevelsAppendWrites, locateInLevels, readLevelsSnapshot } from "../domain/levelsOps.js";
 import { resolveMap, levelsPathOf, formatPath, assertCanEditMap, } from "../domain/mapResolver.js";
 import { buildForestFromTree } from "../domain/appendForest.js";
 const treeNodeSchema = z.lazy(() => z.object({
-    detail: z.string().min(1).describe("要素の本文"),
+    detail: z.string().min(1).describe("要素の本文(1要素5000文字まで)"),
     done: z.boolean().optional().describe("TODOマップのときのチェック状態(省略時false)"),
     children: z.array(treeNodeSchema).optional().describe("この要素の内側に入れ子にする子要素"),
 }));
+/** [nodes]とその配下すべての本文。 */
+function allDetails(nodes) {
+    return nodes.flatMap((node) => [node.detail, ...allDetails(node.children ?? [])]);
+}
 export function registerAutoStructureThought(server) {
     server.tool("auto_structure_thought", "会話中にClaudeが考えた階層構造を、既存のマップに追加する。深さは3階層固定ではなく任意。" +
         "構造化のロジック(何をどう分解するか)はClaude側の判断で行い、このツールはFirestoreへの" +
@@ -21,6 +26,7 @@ export function registerAutoStructureThought(server) {
             .describe("この要素の内側(子)として追加する。マップの最上位に追加する場合はnullまたは省略"),
         nodes: z.array(treeNodeSchema).min(1).describe("追加する階層構造(ルートの配列)"),
     }, async ({ mapId, parentElementId, nodes }) => {
+        assertDetailLengths(allDetails(nodes));
         const { client, session } = getContext();
         const map = await resolveMap(client, session, mapId);
         assertCanEditMap(map, session);

package/dist/src/tools/createMap.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { getContext } from "../mcpContext.js";
 import { newDocId } from "../domain/idGen.js";
+import { buildCreateMapWrites } from "../domain/headerOrder.js";
 export function registerCreateMap(server) {
     server.tool("create_map", "新しいマインドマップ(マップ)を1つ作成する。" +
         "list_mapsで確認して該当するマップが無いときだけ呼ぶこと。" +
@@ -10,19 +11,12 @@ export function registerCreateMap(server) {
         isTodo: z.boolean().describe("TODOマップ(要素にチェックボックスを付ける)にするかどうか"),
     }, async ({ title, isTodo }) => {
         const { client, session } = getContext();
-        const existing = await client.listDocuments(`users/${session.uid}/headers`);
-        const maxOrder = existing.reduce((max, doc) => Math.max(max, Number(doc.data.order ?? 0)), 0);
-        // 自前でIDを採番し、header本体と空のlevels/rootを1回のcommitWritesに
-        // まとめて作る(アプリの新規作成 header_add_model.dart と揃える)。
+        const headersPath = `users/${session.uid}/headers`;
+        // 振り直しは読んだ時点の updateTime を前提条件にするので、読んでから書くまでに
+        // ほかの端末で見出しが変わると失敗する。そのときは読み取りからやり直す。
+        // id はやり直しても同じものを使う(失敗した commit は何も書いていない)。
         const headerId = newDocId();
-        const headerPath = `users/${session.uid}/headers/${headerId}`;
-        await client.commitWrites([
-            {
-                path: headerPath,
-                fields: { title, order: maxOrder + 1, isTodo, editors: [], viewers: [] },
-            },
-            { path: `${headerPath}/levels/root`, fields: { children: [] } },
-        ]);
+        await client.runOptimistic(async () => buildCreateMapWrites(headersPath, await client.listDocuments(headersPath), headerId, title, isTodo));
         return {
             content: [
                 {

package/dist/src/tools/deleteElements.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { getContext } from "../mcpContext.js";
-import { ancestorDetailsInLevels, buildLevelsDeleteWrites, locateInLevels, subtreeIdsInLevels, readLevelsSnapshot } from "../domain/levelsOps.js";
-import { resolveMap, levelsPathOf, formatPath, assertCanEditMap, } from "../domain/mapResolver.js";
+import { ancestorDetailsInLevels, buildLevelsDeleteWrites, locateInLevels, subtreeIdsInLevels, readLevelsSnapshot, withLinkSummary, } from "../domain/levelsOps.js";
+import { resolveMap, levelsPathOf, headerPathOf, formatPath, assertCanEditMap, } from "../domain/mapResolver.js";
 export function registerDeleteElements(server) {
     server.tool("delete_elements", "既存マップから要素を削除する。指定した要素とその配下(子孫)を丸ごと削除する。" +
         "削除は取り返しがつかないため、まずconfirmedを省略(またはfalse)で呼び、" +
@@ -66,7 +66,8 @@ export function registerDeleteElements(server) {
             }
             const { writes, deletedIds } = buildLevelsDeleteWrites(levelsPath, snapshot, elementIds);
             levelsTotal = deletedIds.size;
-            return writes;
+            // リンクの要約(header の linkCounts)が変わるときだけ、同じコミットで書き直す
+            return withLinkSummary(headerPathOf(map), levelsPath, snapshot, writes);
         });
         return {
             content: [

package/dist/src/tools/editElement.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { getContext } from "../mcpContext.js";
+import { assertDetailLengths } from "../domain/detailLimit.js";
 import { ancestorDetailsInLevels, buildLevelsPatchWrites, readLevelsSnapshot } from "../domain/levelsOps.js";
 import { resolveMap, levelsPathOf, formatPath, assertCanEditMap, } from "../domain/mapResolver.js";
 export function registerEditElement(server) {
@@ -7,8 +8,9 @@ export function registerEditElement(server) {
         "import_markdown_contextを、チェック状態の変更はupdate_task_statusを使うこと。", {
         mapId: z.string().describe("list_mapsで得たマップのID"),
         elementId: z.string().describe("list_elementsで得た要素のID"),
-        detail: z.string().min(1).describe("書き換え後の本文"),
+        detail: z.string().min(1).describe("書き換え後の本文(1要素5000文字まで)"),
     }, async ({ mapId, elementId, detail }) => {
+        assertDetailLengths([detail]);
         const { client, session } = getContext();
         const map = await resolveMap(client, session, mapId);
         assertCanEditMap(map, session);
@@ -22,7 +24,10 @@ export function registerEditElement(server) {
             if (!found.has(elementId)) {
                 throw new Error(`elementId(${elementId})がこのマップに見つかりません。list_elementsで確認してください。`);
             }
-            levelsPathResult = formatPath(map.header.title, ancestorDetailsInLevels(snapshot, elementId));
+            // snapshotは書き込み前なので、末尾(この要素自身)だけ書き換え後の本文にする。
+            const chain = ancestorDetailsInLevels(snapshot, elementId);
+            chain[chain.length - 1] = detail;
+            levelsPathResult = formatPath(map.header.title, chain);
             return writes;
         });
         return {

package/dist/src/tools/importMarkdownContext.js

@@ -3,6 +3,7 @@ import { getContext } from "../mcpContext.js";
 import { ancestorDetailsInLevels, buildLevelsAppendWrites, locateInLevels, readLevelsSnapshot } from "../domain/levelsOps.js";
 import { resolveMap, levelsPathOf, formatPath, assertCanEditMap, } from "../domain/mapResolver.js";
 import { parseMarkdownForImport } from "../domain/markdownParser.js";
+import { assertDetailLengths } from "../domain/detailLimit.js";
 export function registerImportMarkdownContext(server) {
     server.tool("import_markdown_context", "任意の深さのMarkdown(インデントで階層を表現したリスト、見出しは`#`)を組み立てて、" +
         "既存のマップに流し込む。見出しも1つの要素として取り込む。" +
@@ -10,7 +11,7 @@ export function registerImportMarkdownContext(server) {
         "チェック状態も反映されない(アプリ本体の挙動と同じ)。" +
         "対象は既存マップのみ(新規作成が必要ならcreate_mapを先に呼ぶ)。", {
         mapId: z.string().describe("list_mapsで得たマップのID"),
-        markdown: z.string().min(1).describe("取り込むMarkdownテキスト"),
+        markdown: z.string().min(1).describe("取り込むMarkdownテキスト(1要素5000文字まで。超える要素があれば何も書かない)。要素の1行目に「📅 2026-10-15」(期日)・「🛫 2026-10-12」(着手日)と書くと日付として取り込む。時刻付きは「📅 2026-10-15 09:00」(このPCの現地時刻)"),
         parentElementId: z
             .string()
             .nullable()
@@ -26,6 +27,7 @@ export function registerImportMarkdownContext(server) {
         if (parsed.nodes.length === 0) {
             throw new Error("Markdownからリスト項目・見出しが見つかりませんでした。");
         }
+        assertDetailLengths(parsed.nodes.map((node) => node.detail));
         let levelsPathResult = "";
         await client.runOptimistic(async () => {
             const snapshot = await readLevelsSnapshot(client, levelsPath);

package/dist/src/tools/listElements.js

@@ -1,13 +1,17 @@
 import { z } from "zod";
 import { getContext } from "../mcpContext.js";
 import { resolveMap, levelsPathOf } from "../domain/mapResolver.js";
-import { buildTreeFromLevels, readAllLevelDocs, } from "../domain/levels.js";
+import { elementTreeOf, readLevelsSnapshot } from "../domain/levelsOps.js";
+import { formatScheduleDate } from "../domain/scheduleText.js";
 // ElementNodeの`done`を`checked`という名前で公開する(仕様書の用語に合わせる)。
 function toChecked(nodes) {
     return nodes.map((n) => ({
         id: n.id,
         detail: n.detail,
         checked: n.done,
+        // 日付は付いているときだけ返す(docs/schedule.md §3 MCP)
+        ...(n.schedule?.due ? { due: formatScheduleDate(n.schedule.due) } : {}),
+        ...(n.schedule?.start ? { start: formatScheduleDate(n.schedule.start) } : {}),
         children: toChecked(n.children),
     }));
 }
@@ -37,21 +41,24 @@ class AiReadDeniedError extends Error {
     }
 }
 export function registerListElements(server) {
-    server.tool("list_elements", "指定したマップ内の全要素と親子関係、チェック状態(checked)を返す。" +
+    server.tool("list_elements", "指定したマップ内の全要素と親子関係、チェック状態(checked)、期日(due)・着手日(start)を返す。" +
+        "dueとstartは付いている要素にだけあり、終日なら\"YYYY-MM-DD\"、時刻付きなら" +
+        "\"YYYY-MM-DD HH:mm\"(このPCの現地時刻)。" +
         "checkedは各要素にFirestoreへ実際に保存されている生の値であり、" +
         "「祖先がチェック済みなら配下も完了とみなす」という加工は行っていない。" +
         "そう解釈したい場合は、返ってきたツリーを見てこちら(呼び出す側)で判断すること。" +
-        "マップの中身には秘匿情報が含まれ得るため、初めて読むマップでは呼び出し前に" +
-        "ユーザー本人の許可が必要。confirmed: trueを付けずに呼ぶと、このツールは" +
-        "実データを返す代わりに確認を促すメッセージだけを返すので、その指示に従って" +
-        "ユーザーに直接確認してからconfirmed: trueで呼び直すこと。" +
+        "呼ぶ前にユーザーへ確認しないこと。まずconfirmedを付けずに呼ぶ。" +
+        "アプリでAIからの読み取りを「常に許可」にしたマップは、そのまま実データを返す。" +
+        "それ以外のマップは、実データの代わりに確認を促すメッセージだけを返すので、" +
+        "そのときに限りユーザーに直接確認してからconfirmed: trueで呼び直すこと。" +
         "アプリ側での直接の編集はこのツールを呼ぶまで反映されないため、" +
         "ユーザーから進捗や状態を尋ねられたときは記憶に頼らず必ず呼び直すこと。", {
         mapId: z.string().describe("list_mapsで得たマップのID"),
         confirmed: z
             .boolean()
             .optional()
-            .describe("ユーザー本人に直接「中身を確認してよいか」と尋ね、同意を得てからtrueを付けて呼ぶこと。" +
+            .describe("最初は付けない。確認を促すメッセージが返ったときだけ、ユーザー本人に直接" +
+            "「中身を確認してよいか」と尋ね、同意を得てからtrueを付けて呼び直す。" +
             "確認前にtrueを付けてはならない。"),
     }, async ({ mapId, confirmed }) => {
         const { client, session } = getContext();
@@ -78,8 +85,7 @@ export function registerListElements(server) {
             }
         }
         // levels/rootが無いマップは空のマップとして返す(アプリで開いてもrootは作られない)。
-        const levelsById = await readAllLevelDocs(client, levelsPathOf(map));
-        const tree = buildTreeFromLevels(levelsById);
+        const tree = elementTreeOf(await readLevelsSnapshot(client, levelsPathOf(map)));
         return {
             content: [
                 {

package/dist/src/tools/moveElement.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { getContext } from "../mcpContext.js";
-import { ancestorDetailsInLevels, buildLevelsMoveWrites, locateInLevels, readLevelsSnapshot } from "../domain/levelsOps.js";
-import { resolveMap, levelsPathOf, formatPath, assertCanEditMap, } from "../domain/mapResolver.js";
+import { ancestorDetailsInLevels, buildLevelsMoveWrites, locateInLevels, readLevelsSnapshot, withLinkSummary, } from "../domain/levelsOps.js";
+import { resolveMap, levelsPathOf, headerPathOf, formatPath, assertCanEditMap, } from "../domain/mapResolver.js";
 export function registerMoveElement(server) {
     server.tool("move_element", "既存マップの要素1件(配下ごと)を、同じマップ内の別の場所へ移動する。" +
         "階層をまたいだ移動(昇格・降格)も、同じ階層内の並べ替えも、これ1つで行える。", {
@@ -34,7 +34,8 @@ export function registerMoveElement(server) {
             }
             const writes = buildLevelsMoveWrites(levelsPath, snapshot, elementId, newParentElementId, afterElementId);
             levelsPathResult = formatPath(map.header.title, ancestorDetailsInLevels(snapshot, newParentElementId));
-            return writes;
+            // リンクの要約(header の linkCounts)が変わるときだけ、同じコミットで書き直す
+            return withLinkSummary(headerPathOf(map), levelsPath, snapshot, writes);
         });
         return {
             content: [{ type: "text", text: JSON.stringify({ path: levelsPathResult }, null, 2) }],

package/dist/src/tools/setSchedule.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { getContext } from "../mcpContext.js";
+import { ancestorDetailsInLevels, buildLevelsScheduleWrites, readLevelsSnapshot, } from "../domain/levelsOps.js";
+import { resolveMap, levelsPathOf, formatPath, assertCanEditMap } from "../domain/mapResolver.js";
+import { parseScheduleDate } from "../domain/scheduleText.js";
+const dateSchema = z
+    .string()
+    .nullable()
+    .optional()
+    .describe("終日なら\"YYYY-MM-DD\"、時刻付きなら\"YYYY-MM-DD HH:mm\"(このPCの現地時刻)。" +
+    "nullで外す。省略するとその日付には触れない");
+export function registerSetSchedule(server) {
+    server.tool("set_schedule", "要素の期日(due)と着手日(start)を付ける・外す。1件でも複数件でもよい。" +
+        "親の日付を子に引き継ぐことはしない(親と子の日付は独立している)。" +
+        "今の日付はlist_elementsで確認できる。", {
+        mapId: z.string().describe("list_mapsで得たマップのID"),
+        updates: z
+            .array(z.object({
+            elementId: z.string().describe("list_elementsで得た要素のID"),
+            due: dateSchema,
+            start: dateSchema,
+        }))
+            .min(1),
+    }, async ({ mapId, updates }) => {
+        // 日付の書き方の誤りは、何も読まないうちに返す
+        const parsed = updates.map((u) => ({
+            elementId: u.elementId,
+            due: u.due == null ? u.due : parseScheduleDate(u.due),
+            start: u.start == null ? u.start : parseScheduleDate(u.start),
+        }));
+        const { client, session } = getContext();
+        const map = await resolveMap(client, session, mapId);
+        assertCanEditMap(map, session);
+        const levelsPath = levelsPathOf(map);
+        let results = [];
+        await client.runOptimistic(async () => {
+            const snapshot = await readLevelsSnapshot(client, levelsPath);
+            const { writes, found } = buildLevelsScheduleWrites(levelsPath, snapshot, parsed);
+            results = updates.map((u) => ({
+                elementId: u.elementId,
+                path: found.has(u.elementId)
+                    ? formatPath(map.header.title, ancestorDetailsInLevels(snapshot, u.elementId))
+                    : null,
+                ...(u.due !== undefined ? { due: u.due } : {}),
+                ...(u.start !== undefined ? { start: u.start } : {}),
+                found: found.has(u.elementId),
+            }));
+            return writes;
+        });
+        return {
+            content: [{ type: "text", text: JSON.stringify({ results }, null, 2) }],
+        };
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mmm-mcp-server",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "mcpName": "io.github.nhorie-canal/mmm-mcp-server",
   "description": "Matryoshka Mind Map の自分のデータをClaudeから直接読み書きするMCPサーバー",
   "license": "MIT",