friday-mcp-v2 3.0.5 → 3.0.6

package/dist/mcp-server.js

@@ -942,6 +942,20 @@ function resolveRefFromState(snapshotId, ref, mode, sessionId, postId, currentSt
             (c.parentIndex ?? null) === snapBlock.parentIndex
         );
         if (refined.length === 1) return refined[0].index;
+
+        // 5b-2. ordinal（出現順序）で特定
+        if (refined.length > 1) {
+            const sameInSnapshot = snap.blocks.filter(b =>
+                b.fingerprint === snapBlock.fingerprint &&
+                (b.depth || 0) === snapBlock.depth &&
+                (b.parentIndex ?? null) === snapBlock.parentIndex
+            );
+            const ordinal = sameInSnapshot.findIndex(b => b.ref === ref);
+            if (ordinal >= 0 && ordinal < refined.length) {
+                return refined[ordinal].index;
+            }
+        }
+
         throw new Error(
             `ref "${ref}" (type: ${snapBlock.type}) の解決先が ${refined.length > 0 ? refined.length : candidates.length} 件見つかりました。` +
             `一意に特定できません。Re-fetch via get_article_structure.`
@@ -2237,6 +2251,10 @@ const tools = [
                 postId: postIdParam,
                 site: siteParam,
                 target: targetSchema,
+                snapshotId: {
+                    type: "string",
+                    description: "Snapshot ID (from get_article_structure or any write response). Required when using ref/refs in target.",
+                },
             },
             required: ["target"],
         },
@@ -3927,7 +3945,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             }
 
             case "get_block_html": {
-                let { mode, postId: _postId, sessionId: _sessionId, message, client } = await resolveMode(args, name);
+                let { mode, postId: _postId, sessionId: _sessionId, message, client, siteName } = await resolveMode(args, name);
                 if (mode === 'error') {
                     return errorResponse(name, message, args?.site);
                 }
@@ -3935,11 +3953,30 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 if (_resolved.error) return { content: [{ type: "text", text: _resolved.error }], isError: true };
                 if (_resolved.editorConnected) mode = 'editor';
                 const postId = _resolved.postId ?? _postId;
+                const _siteName = siteName || args?.site || 'default';
 
                 let tp;
                 try { tp = normalizeTarget(args?.target); }
                 catch (e) { return { content: [{ type: "text", text: `❌ ${e.message}` }], isError: true }; }
 
+                // ref 解決（snapshotId + ref → index に変換）
+                const resolved = await resolveRefsAndCheckRevision({
+                    snapshotId: args?.snapshotId,
+                    ref: tp._ref,
+                    refs: tp._refs,
+                    expectedRevision: args?.expectedRevision,
+                    mode, client, postId, sessionId: _sessionId, siteName: _siteName,
+                });
+                if (resolved.error) return resolved.error;
+                if (resolved.index !== undefined) {
+                    tp.index = resolved.index;
+                    delete tp._ref;
+                }
+                if (resolved.indices !== undefined) {
+                    tp.indices = resolved.indices;
+                    delete tp._refs;
+                }
+
                 const { target, index, indices, startIndex, endIndex, section, blockType, typeIndex, contains, headingLevel, headingContains } = tp;
 
                 if (mode === 'headless' && target === 'selected') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "friday-mcp-v2",
-  "version": "3.0.5",
+  "version": "3.0.6",
   "description": "WordPress MCP Server for Claude Code - REST API direct communication",
   "type": "module",
   "main": "dist/mcp-server.js",