@hidechae/eztab-mcp 0.5.0 → 0.5.2

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.2では `6`)。
+  対応上限を超える形式のタブは閲覧のみで、編集・送信できない。
+  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
@@ -138,3 +146,5 @@ Claude Desktop では入力欄の「＋」→ eztab → `import_tab_from_image`
 EZTab のモデルに無い記譜(スライド・ハンマリング・プリング → タイ/スラー、
 ハーモニクス・ビブラート・装飾音 → 主音のみ等)の寄せ方は手順書
 ([prompts.ts](prompts.ts))に書いてあり、書き起こし後に簡略化した箇所を報告させる。
+
+0.5.2以降は曲全体のMarkdownメモ（形式リビジョン6）を既存の編集・送信操作で保持します。曲メモの入力・表示はwebアプリで行います。

package/dist/server.js

@@ -7,10 +7,12 @@ import { z } from "zod";
 
 // ../src/types/tab.ts
 var TAB_FILE_VERSION = 1;
-var SUPPORTED_FORMAT_REVISION = 4;
+var SUPPORTED_FORMAT_REVISION = 6;
+var SONG_MEMO_FORMAT_REVISION = 6;
 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 +195,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) {
@@ -242,10 +253,24 @@ function normalizeChords(raw, subdivisions) {
   }
   return out;
 }
+var MAX_SONG_MEMO_LENGTH = 1e4;
+var DocumentValidationError = class extends Error {
+};
+function normalizeSongMemo(raw) {
+  if (typeof raw !== "string") return void 0;
+  const memo = raw.replace(/\r\n?/g, "\n");
+  if (memo.length > MAX_SONG_MEMO_LENGTH) {
+    throw new DocumentValidationError(`\u66F2\u30E1\u30E2\u306F${MAX_SONG_MEMO_LENGTH}\u6587\u5B57\u4EE5\u5185\u306B\u3057\u3066\u304F\u3060\u3055\u3044\u3002`);
+  }
+  return memo.trim() ? memo : void 0;
+}
 function normalizeDocument(data) {
   if (!data || !Array.isArray(data.tuning) || !Array.isArray(data.measures)) {
     throw new Error("Not a valid EZTab document");
   }
+  const memo = normalizeSongMemo(data.memo);
+  if (memo === void 0) delete data.memo;
+  else data.memo = memo;
   data.measures = data.measures.map((m) => {
     let beats = m.beats;
     let rawSubs = m.subdivisions;
@@ -268,7 +293,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 memo2 = normalizeMeasureMemo(m.memo);
+    return {
+      beats,
+      beatUnit,
+      subdivisions,
+      cells,
+      chords,
+      ...memo2 !== void 0 ? { memo: memo2 } : {}
+    };
   });
   if (!Array.isArray(data.keys) || data.keys.length === 0) {
     data.keys = [{ measure: 0, tonic: "C", mode: "major" }];
@@ -459,8 +492,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;
@@ -517,7 +551,7 @@ function mainMeasures(doc) {
 }
 function closeWorkspace(doc) {
   const ws = doc.workspace;
-  if (!ws) return doc;
+  if (!ws) return closeWorkspace(openWorkspace(doc));
   const bodies = trackBodies(doc);
   const main = bodies[0];
   const {
@@ -527,6 +561,7 @@ function closeWorkspace(doc) {
     tracks: _tr,
     formatRevision,
     tempoChanges: rawTempoChanges,
+    memo: rawMemo,
     ...rest
   } = doc;
   const tempoChanges = normalizeTempoChanges(doc.tempo, rawTempoChanges, main.measures.length);
@@ -535,6 +570,8 @@ function closeWorkspace(doc) {
     tuning: [...main.tuning],
     measures: main.measures.map(storedMeasure)
   };
+  const memo = normalizeSongMemo(rawMemo);
+  if (memo !== void 0) out.memo = memo;
   const extras = bodies.slice(1).map(
     (b, i) => ({
       ...ws.metas[i + 1],
@@ -548,11 +585,15 @@ function closeWorkspace(doc) {
   if (extras.length > 0) out.tracks = extras;
   if (tempoChanges) out.tempoChanges = tempoChanges;
   let required = 1;
+  if (memo !== void 0) required = SONG_MEMO_FORMAT_REVISION;
   if (extras.length > 0) required = Math.max(required, MULTI_TRACK_FORMAT_REVISION);
   if (bodies.some((b) => measuresHaveHarmonics(b.measures))) {
     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 +603,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 +1040,7 @@ var state = {
   source: null
 };
 var server = new McpServer(
-  { name: "eztab", version: "0.5.0" },
+  { name: "eztab", version: "0.5.2" },
   {
     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 +1333,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,7 +1,7 @@
 {
   "name": "@hidechae/eztab-mcp",
-  "version": "0.5.0",
-  "description": "MCP server for EZTab \u2014 lets an AI agent build and edit guitar/bass tablature.",
+  "version": "0.5.2",
+  "description": "MCP server for EZTab — lets an AI agent build and edit guitar/bass tablature.",
   "type": "module",
   "bin": {
     "eztab-mcp": "dist/server.js"