watashi-db 0.0.13 → 0.0.14

package/dist/tools/memo-tools.js

@@ -1,143 +1,57 @@
-import { StoreUserMemoSchema, UpdateUserMemoSchema, } from "../types.js";
-import { insertUserMemo, updateUserMemo, insertUserPlan, updateUserPlan, insertUserIssue, updateUserIssue, getUserIssueById, insertAuditLog, } from "../database/queries.js";
+import { StoreUserMemoSchema, UpdateUserMemoSchema, StoreUserPlanSchema, UpdateUserPlanSchema, CheckUserPlanSchema, StoreUserIssueSchema, UpdateUserIssueSchema, CommentUserIssueSchema, StoreUserTopicSchema, UpdateUserTopicSchema, } from "../types.js";
+import { insertUserMemo, updateUserMemo, insertUserPlan, updateUserPlan, getUserPlanById, insertUserIssue, updateUserIssue, getUserIssueById, insertUserTopic, updateUserTopic, insertAuditLog, } from "../database/queries.js";
 import { buildProvenance } from "../provenance.js";
 import { getDatabase } from "../database/connection.js";
 import { getStoreManager, notifyWrite } from "../store/session-state.js";
 import { getClientPolicy, checkScopeWritePolicy, buildPolicyErrorResponse } from "../policy.js";
 import { applyLint, getLintMode, buildLintBlockResponse } from "../lint.js";
 import { withLintWarnings } from "./helpers.js";
-/**
- * UserMemo関連ツール（store / update）を登録
- */
-export function registerUserMemoTools(server) {
-    // watashi_store_user_memo: メモ・作業計画・課題を記録
-    server.tool("watashi_store_user_memo", "Store memo/plan/issue/discussion. Specify kind.", StoreUserMemoSchema.shape, async (params, extra) => {
-        const lint = applyLint(params, getLintMode());
+// ============================================================
+// ヘルパー
+// ============================================================
+function policyGuard(scope) {
+    const policy = getClientPolicy(getStoreManager().getConfig());
+    return checkScopeWritePolicy(policy, scope);
+}
+function lintGuard(params) {
+    const lint = applyLint(params, getLintMode());
+    return lint;
+}
+function jsonResult(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}
+function errorResult(msg) {
+    return { content: [{ type: "text", text: JSON.stringify({ success: false, error: msg }) }], isError: true };
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function stripEmbedding(row) {
+    const { l1_embedding: _, ...rest } = row;
+    return rest;
+}
+function parseTags(tags) {
+    return JSON.parse(tags);
+}
+// ============================================================
+// ツール登録
+// ============================================================
+export function registerUserMemoTools(server, toolPrefix = "watashi_") {
+    // ──────────────────────────────────────────────
+    // UserMemo: store / update
+    // ──────────────────────────────────────────────
+    server.tool(`${toolPrefix}store_user_memo`, "Store a reference memo (knowledge, procedure, external info). Append-only notes.", StoreUserMemoSchema.shape, async (params, extra) => {
+        const lint = lintGuard(params);
         if (lint.blocked)
             return buildLintBlockResponse(lint.warnings);
-        const policy = getClientPolicy(getStoreManager().getConfig());
-        const policyCheck = checkScopeWritePolicy(policy, params.scope ?? "global");
-        if (!policyCheck.allowed)
-            return buildPolicyErrorResponse(policyCheck.reason);
+        const scopeCheck = policyGuard(params.scope ?? "global");
+        if (!scopeCheck.allowed)
+            return buildPolicyErrorResponse(scopeCheck.reason);
         const provenance = buildProvenance(extra.sessionId);
-        const kind = params.kind ?? "memo";
-        // === kind='plan': 作業計画 ===
-        if (kind === "plan") {
-            let l1_embedding = null;
-            try {
-                const { generateUserPlanEmbedding } = await import("../embedding/embed-on-write.js");
-                l1_embedding = await generateUserPlanEmbedding({
-                    title: params.title,
-                    l1_content: params.l1_content,
-                });
-            }
-            catch { /* embedding生成失敗はスキップ */ }
-            const plan = getDatabase().transaction(() => {
-                const p = insertUserPlan({
-                    title: params.title,
-                    l1_content: params.l1_content,
-                    usage_policy: params.usage_policy ?? "auto",
-                    tags: params.tags ?? [],
-                    scope: params.scope ?? "global",
-                    search_summary: params.search_summary,
-                    user_input: params.user_input,
-                    l1_embedding,
-                    source_tool: params.source_tool,
-                    client_name: provenance.client_name,
-                    client_version: provenance.client_version,
-                });
-                insertAuditLog({
-                    operation: "create",
-                    entity_type: "user_plan",
-                    entity_id: p.id,
-                    summary: `UserPlan: ${p.title}`,
-                    provenance,
-                    source_tool: params.source_tool,
-                });
-                return p;
-            })();
-            notifyWrite();
-            return {
-                content: [{
-                        type: "text",
-                        text: JSON.stringify(withLintWarnings({
-                            success: true,
-                            message: `作業計画を記録しました: ${plan.title}`,
-                            plan: {
-                                ...plan,
-                                tags: JSON.parse(plan.tags),
-                                l1_embedding: undefined,
-                            },
-                        }, lint.warnings), null, 2),
-                    }],
-            };
-        }
-        // === kind='issue' or 'discussion': 課題・議論（user_issues テーブルを共用） ===
-        if (kind === "issue" || kind === "discussion") {
-            let l1_embedding = null;
-            try {
-                const { generateUserIssueEmbedding } = await import("../embedding/embed-on-write.js");
-                l1_embedding = await generateUserIssueEmbedding({
-                    title: params.title,
-                    l1_content: params.l1_content,
-                });
-            }
-            catch { /* embedding生成失敗はスキップ */ }
-            const issue = getDatabase().transaction(() => {
-                const i = insertUserIssue({
-                    title: params.title,
-                    l1_content: params.l1_content,
-                    kind,
-                    priority: params.priority ?? "medium",
-                    usage_policy: params.usage_policy ?? "on_request",
-                    tags: params.tags ?? [],
-                    scope: params.scope ?? "global",
-                    search_summary: params.search_summary,
-                    user_input: params.user_input,
-                    l1_embedding,
-                    source_tool: params.source_tool,
-                    client_name: provenance.client_name,
-                    client_version: provenance.client_version,
-                });
-                insertAuditLog({
-                    operation: "create",
-                    entity_type: "user_issue",
-                    entity_id: i.id,
-                    summary: `${kind === "discussion" ? "Discussion" : "UserIssue"}: ${i.title}`,
-                    provenance,
-                    source_tool: params.source_tool,
-                });
-                return i;
-            })();
-            notifyWrite();
-            const kindLabel = kind === "discussion" ? "議論" : "課題";
-            return {
-                content: [{
-                        type: "text",
-                        text: JSON.stringify(withLintWarnings({
-                            success: true,
-                            message: `${kindLabel}を記録しました: ${issue.title}`,
-                            issue: {
-                                ...issue,
-                                tags: JSON.parse(issue.tags),
-                                entries: JSON.parse(issue.entries),
-                                l1_embedding: undefined,
-                            },
-                        }, lint.warnings), null, 2),
-                    }],
-            };
-        }
-        // === kind='memo': メモ（既存動作） ===
         let l1_embedding = null;
         try {
             const { generateUserMemoEmbedding } = await import("../embedding/embed-on-write.js");
-            l1_embedding = await generateUserMemoEmbedding({
-                title: params.title,
-                l1_content: params.l1_content,
-            });
+            l1_embedding = await generateUserMemoEmbedding({ title: params.title, l1_content: params.l1_content });
         }
-        catch { /* embedding生成失敗はスキップ */ }
-        // 2026-02-28 修正: insertUserMemo + auditLog をトランザクションで一括化（並行アクセス安全性）
+        catch { /* skip */ }
         const memo = getDatabase().transaction(() => {
             const m = insertUserMemo({
                 title: params.title,
@@ -153,167 +67,37 @@ export function registerUserMemoTools(server) {
                 client_version: provenance.client_version,
             });
             insertAuditLog({
-                operation: "create",
-                entity_type: "user_memo",
-                entity_id: m.id,
-                summary: `UserMemo: ${m.title}`,
-                provenance,
-                source_tool: params.source_tool,
+                operation: "create", entity_type: "user_memo", entity_id: m.id,
+                summary: `UserMemo: ${m.title}`, provenance, source_tool: params.source_tool,
             });
             return m;
         })();
         notifyWrite();
-        return {
-            content: [{
-                    type: "text",
-                    text: JSON.stringify(withLintWarnings({
-                        success: true,
-                        message: `メモを記録しました: ${memo.title}`,
-                        memo: {
-                            ...memo,
-                            tags: JSON.parse(memo.tags),
-                            l1_embedding: undefined,
-                        },
-                    }, lint.warnings), null, 2),
-                }],
-        };
+        return jsonResult(withLintWarnings({
+            success: true,
+            message: `メモを記録しました: ${memo.title}`,
+            memo: { ...stripEmbedding(memo), tags: parseTags(memo.tags) },
+        }, lint.warnings));
     });
-    // watashi_update_user_memo: メモ・作業計画・課題を更新
-    server.tool("watashi_update_user_memo", "Update memo/plan/issue/discussion by ID.", UpdateUserMemoSchema.shape, async (params, extra) => {
-        const lint = applyLint(params, getLintMode());
+    server.tool(`${toolPrefix}update_user_memo`, "Update a memo (title, content, status, tags, etc.).", UpdateUserMemoSchema.shape, async (params, extra) => {
+        const lint = lintGuard(params);
         if (lint.blocked)
             return buildLintBlockResponse(lint.warnings);
-        const provenance = buildProvenance(extra.sessionId);
-        const kind = params.kind ?? "memo";
-        // === kind='plan': 作業計画更新 ===
-        if (kind === "plan") {
-            const updates = {};
-            if (params.title !== undefined)
-                updates.title = params.title;
-            if (params.l1_content !== undefined)
-                updates.l1_content = params.l1_content;
-            if (params.usage_policy !== undefined)
-                updates.usage_policy = params.usage_policy;
-            if (params.tags !== undefined)
-                updates.tags = params.tags;
-            if (params.scope !== undefined)
-                updates.scope = params.scope;
-            if (params.search_summary !== undefined)
-                updates.search_summary = params.search_summary;
-            if (params.status !== undefined)
-                updates.status = params.status;
-            const plan = getDatabase().transaction(() => {
-                const p = updateUserPlan(params.id, updates);
-                if (!p)
-                    return null;
-                insertAuditLog({
-                    operation: "update",
-                    entity_type: "user_plan",
-                    entity_id: p.id,
-                    summary: `UserPlan更新: ${p.title} (${params.reason})`,
-                    details: JSON.stringify(updates),
-                    provenance,
-                });
-                return p;
-            })();
-            if (!plan) {
-                return {
-                    content: [{
-                            type: "text",
-                            text: JSON.stringify({ success: false, error: `UserPlan ID '${params.id}' が見つかりません` }),
-                        }],
-                    isError: true,
-                };
-            }
-            notifyWrite();
-            return {
-                content: [{
-                        type: "text",
-                        text: JSON.stringify(withLintWarnings({
-                            success: true,
-                            message: `作業計画を更新しました: ${plan.title}`,
-                            plan: {
-                                ...plan,
-                                tags: JSON.parse(plan.tags),
-                                l1_embedding: undefined,
-                            },
-                        }, lint.warnings), null, 2),
-                    }],
-            };
+        // H1: scope ポリシーチェック（既存レコード + 新 scope）
+        const policy = getClientPolicy(getStoreManager().getConfig());
+        const db = getDatabase();
+        const existingMemo = db.prepare("SELECT scope FROM user_memos WHERE id = ?").get(params.id);
+        if (existingMemo) {
+            const oldCheck = checkScopeWritePolicy(policy, existingMemo.scope);
+            if (!oldCheck.allowed)
+                return buildPolicyErrorResponse(oldCheck.reason);
         }
-        // === kind='issue' or 'discussion': 課題・議論更新 ===
-        if (kind === "issue" || kind === "discussion") {
-            const updates = {};
-            if (params.title !== undefined)
-                updates.title = params.title;
-            if (params.l1_content !== undefined)
-                updates.l1_content = params.l1_content;
-            if (params.usage_policy !== undefined)
-                updates.usage_policy = params.usage_policy;
-            if (params.tags !== undefined)
-                updates.tags = params.tags;
-            if (params.scope !== undefined)
-                updates.scope = params.scope;
-            if (params.search_summary !== undefined)
-                updates.search_summary = params.search_summary;
-            if (params.status !== undefined)
-                updates.status = params.status;
-            if (params.priority !== undefined)
-                updates.priority = params.priority;
-            // entries 追記: 既存の entries に新しいコメントを追加
-            if (params.entries && params.entries.length > 0) {
-                const existing = getUserIssueById(params.id);
-                if (existing) {
-                    const existingEntries = JSON.parse(existing.entries);
-                    const now = new Date().toISOString();
-                    for (const entry of params.entries) {
-                        existingEntries.push({ author: entry.author, content: entry.content, created_at: now });
-                    }
-                    updates.entries = JSON.stringify(existingEntries);
-                }
-            }
-            const issue = getDatabase().transaction(() => {
-                const i = updateUserIssue(params.id, updates);
-                if (!i)
-                    return null;
-                insertAuditLog({
-                    operation: "update",
-                    entity_type: "user_issue",
-                    entity_id: i.id,
-                    summary: `${kind === "discussion" ? "Discussion" : "UserIssue"}更新: ${i.title} (${params.reason})`,
-                    details: JSON.stringify(updates),
-                    provenance,
-                });
-                return i;
-            })();
-            if (!issue) {
-                return {
-                    content: [{
-                            type: "text",
-                            text: JSON.stringify({ success: false, error: `UserIssue ID '${params.id}' が見つかりません` }),
-                        }],
-                    isError: true,
-                };
-            }
-            notifyWrite();
-            const kindLabel = kind === "discussion" ? "議論" : "課題";
-            return {
-                content: [{
-                        type: "text",
-                        text: JSON.stringify(withLintWarnings({
-                            success: true,
-                            message: `${kindLabel}を更新しました: ${issue.title}`,
-                            issue: {
-                                ...issue,
-                                tags: JSON.parse(issue.tags),
-                                entries: JSON.parse(issue.entries),
-                                l1_embedding: undefined,
-                            },
-                        }, lint.warnings), null, 2),
-                    }],
-            };
+        if (params.scope !== undefined) {
+            const newCheck = checkScopeWritePolicy(policy, params.scope);
+            if (!newCheck.allowed)
+                return buildPolicyErrorResponse(newCheck.reason);
         }
-        // === kind='memo': メモ更新（既存動作） ===
+        const provenance = buildProvenance(extra.sessionId);
         const updates = {};
         if (params.title !== undefined)
             updates.title = params.title;
@@ -329,45 +113,453 @@ export function registerUserMemoTools(server) {
             updates.search_summary = params.search_summary;
         if (params.status !== undefined)
             updates.status = params.status;
-        // 2026-02-28 修正: updateUserMemo + auditLog をトランザクションで一括化（並行アクセス安全性）
         const memo = getDatabase().transaction(() => {
             const m = updateUserMemo(params.id, updates);
             if (!m)
                 return null;
             insertAuditLog({
-                operation: "update",
-                entity_type: "user_memo",
-                entity_id: m.id,
+                operation: "update", entity_type: "user_memo", entity_id: m.id,
                 summary: `UserMemo更新: ${m.title} (${params.reason})`,
-                details: JSON.stringify(updates),
-                provenance,
+                details: JSON.stringify(updates), provenance,
             });
             return m;
         })();
-        if (!memo) {
-            return {
-                content: [{
-                        type: "text",
-                        text: JSON.stringify({ success: false, error: `UserMemo ID '${params.id}' が見つかりません` }),
-                    }],
-                isError: true,
-            };
+        if (!memo)
+            return errorResult(`UserMemo ID '${params.id}' が見つかりません`);
+        notifyWrite();
+        return jsonResult(withLintWarnings({
+            success: true,
+            message: `メモを更新しました: ${memo.title}`,
+            memo: { ...stripEmbedding(memo), tags: parseTags(memo.tags) },
+        }, lint.warnings));
+    });
+    // ──────────────────────────────────────────────
+    // UserPlan: store / update / check
+    // ──────────────────────────────────────────────
+    server.tool(`${toolPrefix}store_user_plan`, "Store a checklist plan (Markdown checkboxes). Track progress with check_user_plan.", StoreUserPlanSchema.shape, async (params, extra) => {
+        const lint = lintGuard(params);
+        if (lint.blocked)
+            return buildLintBlockResponse(lint.warnings);
+        const scopeCheck = policyGuard(params.scope ?? "global");
+        if (!scopeCheck.allowed)
+            return buildPolicyErrorResponse(scopeCheck.reason);
+        const provenance = buildProvenance(extra.sessionId);
+        let l1_embedding = null;
+        try {
+            const { generateUserPlanEmbedding } = await import("../embedding/embed-on-write.js");
+            l1_embedding = await generateUserPlanEmbedding({ title: params.title, l1_content: params.l1_content });
+        }
+        catch { /* skip */ }
+        const plan = getDatabase().transaction(() => {
+            const p = insertUserPlan({
+                title: params.title,
+                l1_content: params.l1_content,
+                usage_policy: params.usage_policy ?? "auto",
+                tags: params.tags ?? [],
+                scope: params.scope ?? "global",
+                search_summary: params.search_summary,
+                user_input: params.user_input,
+                l1_embedding,
+                source_tool: params.source_tool,
+                client_name: provenance.client_name,
+                client_version: provenance.client_version,
+            });
+            insertAuditLog({
+                operation: "create", entity_type: "user_plan", entity_id: p.id,
+                summary: `UserPlan: ${p.title}`, provenance, source_tool: params.source_tool,
+            });
+            return p;
+        })();
+        notifyWrite();
+        return jsonResult(withLintWarnings({
+            success: true,
+            message: `作業計画を記録しました: ${plan.title}`,
+            plan: { ...stripEmbedding(plan), tags: parseTags(plan.tags) },
+        }, lint.warnings));
+    });
+    server.tool(`${toolPrefix}update_user_plan`, "Update plan metadata (title, status, tags, etc.). Use check_user_plan to check off items.", UpdateUserPlanSchema.shape, async (params, extra) => {
+        const lint = lintGuard(params);
+        if (lint.blocked)
+            return buildLintBlockResponse(lint.warnings);
+        // H1: scope ポリシーチェック
+        const policy = getClientPolicy(getStoreManager().getConfig());
+        const db = getDatabase();
+        const existingPlan = db.prepare("SELECT scope FROM user_plans WHERE id = ?").get(params.id);
+        if (existingPlan) {
+            const oldCheck = checkScopeWritePolicy(policy, existingPlan.scope);
+            if (!oldCheck.allowed)
+                return buildPolicyErrorResponse(oldCheck.reason);
+        }
+        if (params.scope !== undefined) {
+            const newCheck = checkScopeWritePolicy(policy, params.scope);
+            if (!newCheck.allowed)
+                return buildPolicyErrorResponse(newCheck.reason);
+        }
+        const provenance = buildProvenance(extra.sessionId);
+        const updates = {};
+        if (params.title !== undefined)
+            updates.title = params.title;
+        if (params.l1_content !== undefined)
+            updates.l1_content = params.l1_content;
+        if (params.usage_policy !== undefined)
+            updates.usage_policy = params.usage_policy;
+        if (params.tags !== undefined)
+            updates.tags = params.tags;
+        if (params.scope !== undefined)
+            updates.scope = params.scope;
+        if (params.search_summary !== undefined)
+            updates.search_summary = params.search_summary;
+        if (params.status !== undefined)
+            updates.status = params.status;
+        const plan = getDatabase().transaction(() => {
+            const p = updateUserPlan(params.id, updates);
+            if (!p)
+                return null;
+            insertAuditLog({
+                operation: "update", entity_type: "user_plan", entity_id: p.id,
+                summary: `UserPlan更新: ${p.title} (${params.reason})`,
+                details: JSON.stringify(updates), provenance,
+            });
+            return p;
+        })();
+        if (!plan)
+            return errorResult(`UserPlan ID '${params.id}' が見つかりません`);
+        notifyWrite();
+        return jsonResult(withLintWarnings({
+            success: true,
+            message: `作業計画を更新しました: ${plan.title}`,
+            plan: { ...stripEmbedding(plan), tags: parseTags(plan.tags) },
+        }, lint.warnings));
+    });
+    server.tool(`${toolPrefix}check_user_plan`, "Mark a checklist item as done (by index or exact text). Auto-completes plan when all items are checked.", CheckUserPlanSchema.shape, async (params, extra) => {
+        const provenance = buildProvenance(extra.sessionId);
+        const existing = getUserPlanById(params.id);
+        if (!existing)
+            return errorResult(`UserPlan ID '${params.id}' が見つかりません`);
+        // H1: scope ポリシーチェック
+        const policyCheck = policyGuard(existing.scope);
+        if (!policyCheck.allowed)
+            return buildPolicyErrorResponse(policyCheck.reason);
+        const content = existing.l1_content;
+        const lines = content.split("\n");
+        // チェックリスト項目（未チェック）のインデックスを収集
+        const uncheckedItems = [];
+        for (let i = 0; i < lines.length; i++) {
+            if (/^\s*-\s*\[ \]/.test(lines[i])) {
+                const text = lines[i].replace(/^\s*-\s*\[ \]\s*/, "").trim();
+                uncheckedItems.push({ lineIndex: i, text });
+            }
+        }
+        // M3: index（1始まり、未チェック項目の通し番号）または item（完全一致）で特定
+        let targetLineIndex = -1;
+        let matchedText = "";
+        if (params.index !== undefined) {
+            const idx = params.index - 1; // 0始まりに変換
+            if (idx < 0 || idx >= uncheckedItems.length) {
+                return errorResult(`インデックス ${params.index} は範囲外です。未チェック項目は ${uncheckedItems.length} 件あります。`);
+            }
+            targetLineIndex = uncheckedItems[idx].lineIndex;
+            matchedText = uncheckedItems[idx].text;
+        }
+        else if (params.item !== undefined) {
+            const itemText = params.item.trim();
+            const matches = uncheckedItems.filter(u => u.text === itemText);
+            if (matches.length === 0) {
+                return errorResult(`未チェック項目 '${itemText}' が見つかりません。既にチェック済みか、テキストが完全一致しません。`);
+            }
+            if (matches.length > 1) {
+                return errorResult(`'${itemText}' に一致する未チェック項目が ${matches.length} 件あります。index を使って指定してください。`);
+            }
+            targetLineIndex = matches[0].lineIndex;
+            matchedText = matches[0].text;
+        }
+        else {
+            return errorResult("item または index のどちらかを指定してください。");
+        }
+        lines[targetLineIndex] = lines[targetLineIndex].replace("[ ]", "[x]");
+        const newContent = lines.join("\n");
+        // 全項目チェック済みか判定
+        const hasUnchecked = lines.some(l => /^\s*-\s*\[ \]/.test(l));
+        const updates = { l1_content: newContent };
+        if (!hasUnchecked) {
+            updates.status = "completed";
+        }
+        const plan = getDatabase().transaction(() => {
+            const p = updateUserPlan(params.id, updates);
+            if (!p)
+                return null;
+            const autoCompleted = !hasUnchecked;
+            insertAuditLog({
+                operation: "update", entity_type: "user_plan", entity_id: p.id,
+                summary: `UserPlan check: ${matchedText}${autoCompleted ? " (auto-completed)" : ""}`,
+                provenance,
+            });
+            return p;
+        })();
+        if (!plan)
+            return errorResult(`UserPlan ID '${params.id}' の更新に失敗しました`);
+        notifyWrite();
+        const autoCompleted = !hasUnchecked;
+        return jsonResult({
+            success: true,
+            message: autoCompleted
+                ? `✓ ${matchedText} — 全項目完了！計画を completed にしました`
+                : `✓ ${matchedText}`,
+            plan: { ...stripEmbedding(plan), tags: parseTags(plan.tags) },
+        });
+    });
+    // ──────────────────────────────────────────────
+    // UserIssue: store / update / comment
+    // ──────────────────────────────────────────────
+    server.tool(`${toolPrefix}store_user_issue`, "Open an issue or discussion. Lifecycle: open → closed.", StoreUserIssueSchema.shape, async (params, extra) => {
+        const lint = lintGuard(params);
+        if (lint.blocked)
+            return buildLintBlockResponse(lint.warnings);
+        const scopeCheck = policyGuard(params.scope ?? "global");
+        if (!scopeCheck.allowed)
+            return buildPolicyErrorResponse(scopeCheck.reason);
+        const provenance = buildProvenance(extra.sessionId);
+        const kind = params.kind ?? "issue";
+        let l1_embedding = null;
+        try {
+            const { generateUserIssueEmbedding } = await import("../embedding/embed-on-write.js");
+            l1_embedding = await generateUserIssueEmbedding({ title: params.title, l1_content: params.l1_content });
         }
+        catch { /* skip */ }
+        const issue = getDatabase().transaction(() => {
+            const i = insertUserIssue({
+                title: params.title,
+                l1_content: params.l1_content,
+                kind,
+                priority: params.priority ?? "medium",
+                usage_policy: params.usage_policy ?? "on_request",
+                tags: params.tags ?? [],
+                scope: params.scope ?? "global",
+                search_summary: params.search_summary,
+                user_input: params.user_input,
+                l1_embedding,
+                source_tool: params.source_tool,
+                client_name: provenance.client_name,
+                client_version: provenance.client_version,
+            });
+            insertAuditLog({
+                operation: "create", entity_type: "user_issue", entity_id: i.id,
+                summary: `${kind === "discussion" ? "Discussion" : "UserIssue"}: ${i.title}`,
+                provenance, source_tool: params.source_tool,
+            });
+            return i;
+        })();
+        notifyWrite();
+        const kindLabel = kind === "discussion" ? "議論" : "課題";
+        return jsonResult(withLintWarnings({
+            success: true,
+            message: `${kindLabel}を記録しました: ${issue.title}`,
+            issue: { ...stripEmbedding(issue), tags: parseTags(issue.tags) },
+        }, lint.warnings));
+    });
+    server.tool(`${toolPrefix}update_user_issue`, "Update issue metadata (title, status, priority, tags, etc.). Use comment_user_issue to add comments.", UpdateUserIssueSchema.shape, async (params, extra) => {
+        const lint = lintGuard(params);
+        if (lint.blocked)
+            return buildLintBlockResponse(lint.warnings);
+        // H1: scope ポリシーチェック
+        const policy = getClientPolicy(getStoreManager().getConfig());
+        const db = getDatabase();
+        const existingIssue = db.prepare("SELECT scope FROM user_issues WHERE id = ?").get(params.id);
+        if (existingIssue) {
+            const oldCheck = checkScopeWritePolicy(policy, existingIssue.scope);
+            if (!oldCheck.allowed)
+                return buildPolicyErrorResponse(oldCheck.reason);
+        }
+        if (params.scope !== undefined) {
+            const newCheck = checkScopeWritePolicy(policy, params.scope);
+            if (!newCheck.allowed)
+                return buildPolicyErrorResponse(newCheck.reason);
+        }
+        const provenance = buildProvenance(extra.sessionId);
+        const updates = {};
+        if (params.title !== undefined)
+            updates.title = params.title;
+        if (params.l1_content !== undefined)
+            updates.l1_content = params.l1_content;
+        if (params.priority !== undefined)
+            updates.priority = params.priority;
+        if (params.usage_policy !== undefined)
+            updates.usage_policy = params.usage_policy;
+        if (params.tags !== undefined)
+            updates.tags = params.tags;
+        if (params.scope !== undefined)
+            updates.scope = params.scope;
+        if (params.search_summary !== undefined)
+            updates.search_summary = params.search_summary;
+        if (params.status !== undefined)
+            updates.status = params.status;
+        const issue = db.transaction(() => {
+            const i = updateUserIssue(params.id, updates);
+            if (!i)
+                return null;
+            insertAuditLog({
+                operation: "update", entity_type: "user_issue", entity_id: i.id,
+                summary: `UserIssue更新: ${i.title} (${params.reason})`,
+                details: JSON.stringify(updates), provenance,
+            });
+            return i;
+        })();
+        if (!issue)
+            return errorResult(`UserIssue ID '${params.id}' が見つかりません`);
+        notifyWrite();
+        return jsonResult(withLintWarnings({
+            success: true,
+            message: `課題を更新しました: ${issue.title}`,
+            issue: { ...stripEmbedding(issue), tags: parseTags(issue.tags) },
+        }, lint.warnings));
+    });
+    server.tool(`${toolPrefix}comment_user_issue`, "Append a timestamped comment to an issue. Preserves existing content.", CommentUserIssueSchema.shape, async (params, extra) => {
+        // 新M1: lint チェック（秘密情報検出）
+        const lint = lintGuard({ comment: params.comment });
+        if (lint.blocked)
+            return buildLintBlockResponse(lint.warnings);
+        const provenance = buildProvenance(extra.sessionId);
+        const existing = getUserIssueById(params.id);
+        if (!existing)
+            return errorResult(`UserIssue ID '${params.id}' が見つかりません`);
+        // H1: scope ポリシーチェック
+        const policyCheck = policyGuard(existing.scope);
+        if (!policyCheck.allowed)
+            return buildPolicyErrorResponse(policyCheck.reason);
+        const now = new Date().toISOString().slice(0, 10); // yyyy-mm-dd
+        const appendText = `\n\n[${now} 追記] ${params.comment}`;
+        const newContent = existing.l1_content + appendText;
+        // embedding 再生成
+        let l1_embedding = null;
+        try {
+            const { generateUserIssueEmbedding } = await import("../embedding/embed-on-write.js");
+            l1_embedding = await generateUserIssueEmbedding({ title: existing.title, l1_content: newContent });
+        }
+        catch { /* skip */ }
+        const updates = { l1_content: newContent };
+        if (l1_embedding)
+            updates.l1_embedding = l1_embedding;
+        const issue = getDatabase().transaction(() => {
+            const i = updateUserIssue(params.id, updates);
+            if (!i)
+                return null;
+            insertAuditLog({
+                operation: "update", entity_type: "user_issue", entity_id: i.id,
+                summary: `UserIssue comment: ${params.comment.slice(0, 80)}`,
+                provenance,
+            });
+            return i;
+        })();
+        if (!issue)
+            return errorResult(`UserIssue ID '${params.id}' の更新に失敗しました`);
+        notifyWrite();
+        return jsonResult({
+            success: true,
+            message: `コメントを追記しました`,
+            issue: { ...stripEmbedding(issue), tags: parseTags(issue.tags) },
+        });
+    });
+    // ──────────────────────────────────────────────
+    // UserTopic: store / update (変更なし)
+    // ──────────────────────────────────────────────
+    server.tool(`${toolPrefix}store_user_topic`, "Register a conversation topic for tracking across sessions. Store summary + conversation_id + cwd.", StoreUserTopicSchema.shape, async (params, extra) => {
+        const lint = lintGuard(params);
+        if (lint.blocked)
+            return buildLintBlockResponse(lint.warnings);
+        const scopeCheck = policyGuard(params.scope ?? "global");
+        if (!scopeCheck.allowed)
+            return buildPolicyErrorResponse(scopeCheck.reason);
+        const provenance = buildProvenance(extra.sessionId);
+        let l1_embedding = null;
+        try {
+            const { generateUserTopicEmbedding } = await import("../embedding/embed-on-write.js");
+            l1_embedding = await generateUserTopicEmbedding({ title: params.title, summary: params.summary });
+        }
+        catch { /* skip */ }
+        const topic = getDatabase().transaction(() => {
+            const t = insertUserTopic({
+                title: params.title,
+                summary: params.summary,
+                conversation_id: params.conversation_id,
+                cwd: params.cwd,
+                priority: params.priority ?? "medium",
+                tags: params.tags ?? [],
+                scope: params.scope ?? "global",
+                search_summary: params.search_summary,
+                l1_embedding,
+                source_tool: "watashi_store_user_topic",
+                client_name: provenance.client_name,
+                client_version: provenance.client_version,
+            });
+            insertAuditLog({
+                operation: "create", entity_type: "user_topic", entity_id: t.id,
+                summary: `UserTopic: ${t.title}`, provenance, source_tool: "watashi_store_user_topic",
+            });
+            return t;
+        })();
+        notifyWrite();
+        return jsonResult(withLintWarnings({
+            success: true,
+            message: `トピックを登録しました: ${topic.title}`,
+            topic: { ...stripEmbedding(topic), tags: parseTags(topic.tags) },
+        }, lint.warnings));
+    });
+    server.tool(`${toolPrefix}update_user_topic`, "Update a topic (summary, status, priority, etc.).", UpdateUserTopicSchema.shape, async (params, extra) => {
+        const lint = lintGuard(params);
+        if (lint.blocked)
+            return buildLintBlockResponse(lint.warnings);
+        const policy = getClientPolicy(getStoreManager().getConfig());
+        const db = getDatabase();
+        const existing = db.prepare("SELECT scope FROM user_topics WHERE id = ?").get(params.id);
+        if (existing) {
+            const oldScopeCheck = checkScopeWritePolicy(policy, existing.scope);
+            if (!oldScopeCheck.allowed)
+                return buildPolicyErrorResponse(oldScopeCheck.reason);
+        }
+        if (params.scope !== undefined) {
+            const newScopeCheck = checkScopeWritePolicy(policy, params.scope);
+            if (!newScopeCheck.allowed)
+                return buildPolicyErrorResponse(newScopeCheck.reason);
+        }
+        const provenance = buildProvenance(extra.sessionId);
+        const updates = {};
+        if (params.title !== undefined)
+            updates.title = params.title;
+        if (params.summary !== undefined)
+            updates.summary = params.summary;
+        if (params.conversation_id !== undefined)
+            updates.conversation_id = params.conversation_id;
+        if (params.cwd !== undefined)
+            updates.cwd = params.cwd;
+        if (params.priority !== undefined)
+            updates.priority = params.priority;
+        if (params.tags !== undefined)
+            updates.tags = params.tags;
+        if (params.scope !== undefined)
+            updates.scope = params.scope;
+        if (params.search_summary !== undefined)
+            updates.search_summary = params.search_summary;
+        if (params.status !== undefined)
+            updates.status = params.status;
+        const topic = db.transaction(() => {
+            const t = updateUserTopic(params.id, updates);
+            if (!t)
+                return null;
+            insertAuditLog({
+                operation: "update", entity_type: "user_topic", entity_id: t.id,
+                summary: `UserTopic更新: ${t.title} (${params.reason})`,
+                details: JSON.stringify(updates), provenance,
+            });
+            return t;
+        })();
+        if (!topic)
+            return errorResult(`UserTopic ID '${params.id}' が見つかりません`);
         notifyWrite();
-        return {
-            content: [{
-                    type: "text",
-                    text: JSON.stringify(withLintWarnings({
-                        success: true,
-                        message: `メモを更新しました: ${memo.title}`,
-                        memo: {
-                            ...memo,
-                            tags: JSON.parse(memo.tags),
-                            l1_embedding: undefined,
-                        },
-                    }, lint.warnings), null, 2),
-                }],
-        };
+        return jsonResult(withLintWarnings({
+            success: true,
+            message: `トピックを更新しました: ${topic.title}`,
+            topic: { ...stripEmbedding(topic), tags: parseTags(topic.tags) },
+        }, lint.warnings));
     });
 }
 //# sourceMappingURL=memo-tools.js.map