@hidechae/eztab-mcp 0.5.0 → 0.5.1

package/README.md

@@ -113,8 +113,16 @@ Run standalone for testing: `task mcp` (or `npx tsx mcp/server.ts`).
 - コードは track 0 のもの(`set_chords` は track 0 の列で指定)。`write_measures(track > 0)` ではコード指定と、
   既存小節の拍子を変える `time` を拒否する
 - `get_tab` は全パートを小節ごとに並べて表示する(`track` で1パートに絞れる)
-- `send_to_eztab` は `x-eztab-format-revision: 2` を付けて送る。0.2.0 以前の MCP は複数パートのタブを
-  送り返せない(サーバが 409 で拒否する)。新しい形式のタブ(リビジョン 3 以降)は読めるが編集・送信できない
+- `send_to_eztab` は対応する最新の形式リビジョンをヘッダーに付けて送る(0.5.1では `5`)。
+  対応上限を超える形式のタブは閲覧のみで、編集・送信できない。
+  0.2.0以前のMCPは複数パートのタブを送り返せない(サーバが409で拒否する)。
+
+### 小節メモの保持
+
+0.5.1以降はアプリで入力した小節共通メモ(形式リビジョン5)を保持して編集・送信できます。
+メモ専用の入力ツールはなく、追加・変更・削除はアプリの「小節メモ…」で行います。
+`write_measures` で既存小節を書き換えた場合もメモを残します。小節削除ではその小節のメモも削除し、
+挿入した空小節はメモなしになります。旧MCPはメモのあるタブを編集・送信できません。
 
 These cover the editor's current model: variable string count, per-beat chords,
 keys with mid-piece changes, section markers, per-measure resolution, time

package/dist/server.js

@@ -7,10 +7,11 @@ import { z } from "zod";
 
 // ../src/types/tab.ts
 var TAB_FILE_VERSION = 1;
-var SUPPORTED_FORMAT_REVISION = 4;
+var SUPPORTED_FORMAT_REVISION = 5;
 var MULTI_TRACK_FORMAT_REVISION = 2;
 var HARMONICS_FORMAT_REVISION = 3;
 var TEMPO_CHANGES_FORMAT_REVISION = 4;
+var MEASURE_MEMOS_FORMAT_REVISION = 5;
 var MAX_TRACKS = 4;
 var DEFAULT_MAIN_TRACK_NAME = "Guitar";
 var DEFAULT_TEMPO = 120;
@@ -193,6 +194,15 @@ function makeNoteCell(fret, bend, tie, pm, harmonic) {
     ...harm && harmonic?.harmAt != null ? { harmAt: harmonic.harmAt } : {}
   };
 }
+var MAX_MEASURE_MEMO_LENGTH = 1e3;
+function normalizeMeasureMemo(raw) {
+  if (typeof raw !== "string") return void 0;
+  const memo = raw.replace(/\r\n?|\n/g, "\n");
+  if (memo.length > MAX_MEASURE_MEMO_LENGTH) {
+    throw new Error(`Measure memo exceeds ${MAX_MEASURE_MEMO_LENGTH} characters`);
+  }
+  return memo.trim() ? memo : void 0;
+}
 var CHORD_REST = "rest";
 var CHORD_REST_LABEL = "N.C.";
 function chordDisplay(label) {
@@ -268,7 +278,15 @@ function normalizeDocument(data) {
     );
     const rawChords = Array.isArray(m.chords) ? m.chords : typeof m.chord === "string" && m.chord ? [m.chord] : [];
     const chords = normalizeChords(rawChords, subdivisions);
-    return { beats, beatUnit, subdivisions, cells, chords };
+    const memo = normalizeMeasureMemo(m.memo);
+    return {
+      beats,
+      beatUnit,
+      subdivisions,
+      cells,
+      chords,
+      ...memo !== void 0 ? { memo } : {}
+    };
   });
   if (!Array.isArray(data.keys) || data.keys.length === 0) {
     data.keys = [{ measure: 0, tonic: "C", mode: "major" }];
@@ -459,8 +477,9 @@ function newUid() {
   return newTabId();
 }
 function storedMeasure(m) {
-  const { uid: _uid, beatWidthOverride: _w, ...rest } = m;
-  return rest;
+  const { uid: _uid, beatWidthOverride: _w, memo, ...rest } = m;
+  const normalizedMemo = normalizeMeasureMemo(memo);
+  return normalizedMemo === void 0 ? rest : { ...rest, memo: normalizedMemo };
 }
 function openWorkspace(doc) {
   if (doc.workspace) return doc;
@@ -553,6 +572,9 @@ function closeWorkspace(doc) {
     required = Math.max(required, HARMONICS_FORMAT_REVISION);
   }
   if (tempoChanges) required = Math.max(required, TEMPO_CHANGES_FORMAT_REVISION);
+  if (out.measures.some((m) => m.memo !== void 0)) {
+    required = Math.max(required, MEASURE_MEMOS_FORMAT_REVISION);
+  }
   const revision = formatRevision != null && formatRevision > SUPPORTED_FORMAT_REVISION ? formatRevision : required;
   if (revision > 1) out.formatRevision = revision;
   return out;
@@ -562,6 +584,20 @@ function reconcileTracks(prev, next) {
   const ws = doc.workspace;
   const measures = assignUids(prev, doc.measures);
   if (measures !== doc.measures) doc = { ...doc, measures };
+  if (ws.active === 0 && prev) {
+    const oldMemos = new Map(mainMeasures(prev).map((m) => [m.uid, m.memo]));
+    let restored = null;
+    measures.forEach((m, i) => {
+      const memo = oldMemos.get(m.uid);
+      if (memo !== void 0 && !("memo" in m)) {
+        restored ??= [...measures];
+        restored[i] = { ...m, memo };
+      }
+    });
+    if (restored) {
+      doc = { ...doc, measures: restored };
+    }
+  }
   let changed = false;
   const parked = ws.parked.map((body) => {
     if (!body) return body;
@@ -985,7 +1021,7 @@ var state = {
   source: null
 };
 var server = new McpServer(
-  { name: "eztab", version: "0.5.0" },
+  { name: "eztab", version: "0.5.1" },
   {
     instructions: "All indices are 0-based: measure 0 is the first measure, string 0 is the top (highest) string, and column 0 is the first column. Notes and chords share the same column grid. Subdivisions are per beat and can differ within a measure (e.g. [2,2,3,2] mixes a triplet beat into straight eighths), so columns per measure = the sum of its per-beat subdivisions; get_tab's ruler shows the column indices. add_measures `at` is a 0-based insert position too. No need to ask the user about indexing. Exception: write_measures uses guitar string numbers (1 = top line), matching the labels get_tab prints. To write whole measures (e.g. transcribing a score or an image), prefer write_measures over set_cells \u2014 it takes one string per beat and does the column arithmetic for you. For transcribing from an image, follow the import_tab_from_image prompt. To deliver a result to the EZTab app, call send_to_eztab; to fix an existing tab, list_tabs \u2192 open_tab \u2192 edit \u2192 send_to_eztab. A tab can hold up to 4 tracks (parts, e.g. guitar + bass); track 0 is the main track. Tools that edit notes take an optional 0-based `track` (default 0). Measures and time signatures are shared by all tracks (adding/removing a measure affects every track); subdivisions are per track; chords belong to track 0 and use its columns."
   }
@@ -1278,7 +1314,7 @@ server.tool(
         }
       }
       if (!existing) doc.measures.push(built);
-      else doc.measures[i] = built;
+      else doc.measures[i] = a.track ? built : { ...built, memo: existing.memo };
       lo = Math.min(lo, i);
       hi = Math.max(hi, i);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hidechae/eztab-mcp",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "MCP server for EZTab \u2014 lets an AI agent build and edit guitar/bass tablature.",
   "type": "module",
   "bin": {