@autodevjapan/godd-mcp-alpha 1.25.19 → 1.25.21

package/README.md

@@ -53,7 +53,20 @@ If `godd-a install` is unavailable, you can edit `~/.cursor/mcp.json` directly.
 
 After installation, restart Cursor IDE and the GoDD MCP α server will start automatically.
 
-In Cursor chat, simply ask the AI to use a specific tool (e.g., "run dev", "do a review"). The AI will automatically discover and invoke the appropriate GoDD tool.
+**Option 1 — Slash command (recommended):** Type `/` in the Cursor chat input to see GoDD prompts in the dropdown, then select one (e.g., `/dev`, `/review`).
+
+**Option 2 — Natural language in Agent mode:** In Cursor's Agent mode, you can ask the AI in plain language (e.g., "run dev", "do a review") and the AI will automatically detect and call the appropriate GoDD tool.
+
+### Token Efficiency
+
+GoDD MCP delivers prompts **on demand** — only the prompt you call is sent to the AI's context. This is fundamentally different from Cursor Rules, which loads all rules into every conversation from the start.
+
+| Approach | How it works | Token cost per call |
+|---|---|---|
+| **Cursor Rules** | All rules always in context | ~80,000 tokens × every chat |
+| **GoDD MCP** | Only the called prompt, when called | ~2,000–5,000 tokens per call |
+
+Use `/metrics` at any time during a session to see your actual token usage and estimated savings vs. the Cursor Rules baseline.
 
 ### GoDD Prompts
 
@@ -84,6 +97,7 @@ Available GoDD prompts (MCP tools) in Cursor IDE:
 | `diagram` | Auto-update architecture diagrams (maintain living Mermaid docs in sync with code) |
 | `slide` | Generate presentation slides from project docs (Marp Markdown format) |
 | `design` | Generate/update visual designs from codebase (Pencil.dev sync) |
+| `metrics` | Token efficiency report — show prompt tokens delivered this session vs. always-on Cursor Rules baseline |
 
 ### CLI Commands
 
@@ -195,7 +209,20 @@ godd-a init --auto
 
 インストール後、Cursor IDE を再起動すると GoDD MCP α サーバーが自動で起動します。
 
-Cursor のチャットで AI に使いたいツールを指示してください（例：「dev して」「レビューして」）。AI が GoDD のツールを自動的に検出して呼び出します。
+**方法 1 — スラッシュコマンド（推奨）:** Cursor のチャット入力欄で `/` を入力するとドロップダウンに GoDD プロンプトが表示されます。選択して実行してください（例：`/dev`、`/review`）。
+
+**方法 2 — Agent モードでの自然言語指示:** Cursor の Agent モードでは、自然言語で指示するだけで AI が適切な GoDD ツールを自動的に検出して呼び出します（例：「dev して」「レビューして」）。
+
+### トークン効率
+
+GoDD MCP はプロンプトを**オンデマンドで配信**します。呼び出したプロンプトだけが AI のコンテキストに送られます。全ルールを毎会話の開始から常時コンテキストに含める Cursor Rules とは根本的に異なります。
+
+| 方式 | 仕組み | 1回あたりのトークンコスト |
+|---|---|---|
+| **Cursor Rules** | 全ルールを常時コンテキストに含む | ~80,000 tokens × 毎会話 |
+| **GoDD MCP** | 呼び出したプロンプトだけを必要なときに配信 | ~2,000〜5,000 tokens / 呼び出し |
+
+セッション中いつでも `/metrics` を実行すると、実際のトークン使用量と Cursor Rules 方式との節約推定値を確認できます。
 
 ### GoDD プロンプト一覧
 
@@ -226,6 +253,7 @@ Cursor IDE 上で利用できる GoDD プロンプト（MCP ツール）の一
 | `diagram` | アーキテクチャ図の自動更新（コードと同期した Mermaid ドキュメントを維持） |
 | `slide` | プロジェクトドキュメントからプレゼンスライドを生成（Marp Markdown 形式） |
 | `design` | コードベースからビジュアルデザインを生成/更新（Pencil.dev 同期） |
+| `metrics` | トークン効率レポート — このセッションの配信トークン数と Cursor Rules 常時読み込み方式との比較 |
 
 ### CLI コマンド
 
@@ -337,7 +365,20 @@ godd-a init --auto
 
 После установки перезапустите Cursor IDE — сервер GoDD MCP α запустится автоматически.
 
-В чате Cursor просто попросите AI использовать нужный инструмент (например, «запусти dev», «сделай review»). AI автоматически обнаружит и вызовет соответствующий инструмент GoDD.
+**Способ 1 — Слэш-команда (рекомендуется):** Введите `/` в поле чата Cursor — в выпадающем списке появятся промпты GoDD. Выберите нужный (например, `/dev`, `/review`).
+
+**Способ 2 — Естественный язык в режиме Agent:** В режиме Agent Cursor можно просто попросить AI использовать нужный инструмент (например, «запусти dev», «сделай review») — AI автоматически обнаружит и вызовет соответствующий инструмент GoDD.
+
+### Эффективность токенов
+
+GoDD MCP доставляет промпты **по требованию** — в контекст AI отправляется только вызванный промпт. Это принципиально отличается от Cursor Rules, где все правила загружаются в контекст с самого начала каждого чата.
+
+| Подход | Принцип работы | Стоимость токенов за вызов |
+|---|---|---|
+| **Cursor Rules** | Все правила всегда в контексте | ~80 000 токенов × каждый чат |
+| **GoDD MCP** | Только нужный промпт, только когда нужен | ~2 000–5 000 токенов за вызов |
+
+В любой момент сессии введите `/metrics`, чтобы увидеть фактическое использование токенов и расчётную экономию по сравнению с подходом Cursor Rules.
 
 ### Список промптов GoDD
 
@@ -368,6 +409,7 @@ godd-a init --auto
 | `diagram` | Автообновление архитектурных диаграмм (поддержка актуальных Mermaid-документов) |
 | `slide` | Генерация презентационных слайдов из документации проекта (формат Marp Markdown) |
 | `design` | Генерация/обновление визуального дизайна из кодовой базы (синхронизация с Pencil.dev) |
+| `metrics` | Отчёт об эффективности токенов — токены этой сессии vs. базовый уровень Cursor Rules |
 
 ### Команды CLI
 

package/dist/godd.cjs

@@ -35693,7 +35693,7 @@ function formatConfigIssuesForAI(issues, lang = "ja") {
 }
 
 // src/version.ts
-var VERSION = true ? "1.25.19" : "0.0.0-dev";
+var VERSION = true ? "1.25.21" : "0.0.0-dev";
 
 // src/tools/base.ts
 var PROMPT_DESCRIPTIONS = {
@@ -35721,7 +35721,8 @@ var PROMPT_DESCRIPTIONS = {
     learn: "Save/recall project-specific patterns, conventions, and pitfalls",
     diagram: "Auto-update architecture diagrams (maintain living Mermaid docs in sync with code)",
     slide: "Generate presentation slides from project docs (Marp Markdown format)",
-    design: "Generate/update visual designs from codebase (Pencil.dev sync)"
+    design: "Generate/update visual designs from codebase (Pencil.dev sync)",
+    metrics: "Token efficiency report \u2014 show prompt tokens delivered this session vs. always-on Cursor Rules baseline"
   },
   ja: {
     dev: "\u958B\u767A\uFF08\u6BB5\u968E\u7684\u306B\u8A08\u753B\u2192\u5B9F\u88C5\u2192\u30C6\u30B9\u30C8\u2192\u54C1\u8CEA\u2192\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u3092\u5B9F\u884C\uFF09",
@@ -35747,7 +35748,8 @@ var PROMPT_DESCRIPTIONS = {
     learn: "\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u56FA\u6709\u306E\u30D1\u30BF\u30FC\u30F3\u30FB\u6163\u4F8B\u30FB\u843D\u3068\u3057\u7A74\u3092\u4FDD\u5B58/\u53C2\u7167",
     diagram: "\u30A2\u30FC\u30AD\u30C6\u30AF\u30C1\u30E3\u56F3\u306E\u81EA\u52D5\u66F4\u65B0\uFF08\u30B3\u30FC\u30C9\u3068\u540C\u671F\u3057\u305F Mermaid \u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u3092\u7DAD\u6301\uFF09",
     slide: "\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u304B\u3089\u30D7\u30EC\u30BC\u30F3\u30B9\u30E9\u30A4\u30C9\u3092\u751F\u6210\uFF08Marp Markdown \u5F62\u5F0F\uFF09",
-    design: "\u30B3\u30FC\u30C9\u30D9\u30FC\u30B9\u304B\u3089\u30D3\u30B8\u30E5\u30A2\u30EB\u30C7\u30B6\u30A4\u30F3\u3092\u751F\u6210/\u66F4\u65B0\uFF08Pencil.dev \u540C\u671F\uFF09"
+    design: "\u30B3\u30FC\u30C9\u30D9\u30FC\u30B9\u304B\u3089\u30D3\u30B8\u30E5\u30A2\u30EB\u30C7\u30B6\u30A4\u30F3\u3092\u751F\u6210/\u66F4\u65B0\uFF08Pencil.dev \u540C\u671F\uFF09",
+    metrics: "\u30C8\u30FC\u30AF\u30F3\u52B9\u7387\u30EC\u30DD\u30FC\u30C8 \u2014 \u3053\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u3067\u914D\u4FE1\u3057\u305F\u30D7\u30ED\u30F3\u30D7\u30C8\u30C8\u30FC\u30AF\u30F3\u6570\u3068 Cursor Rules \u5E38\u6642\u8AAD\u307F\u8FBC\u307F\u65B9\u5F0F\u3068\u306E\u6BD4\u8F03"
   },
   ru: {
     dev: "\u0420\u0430\u0437\u0440\u0430\u0431\u043E\u0442\u043A\u0430 (\u043F\u043B\u0430\u043D \u2192 \u0440\u0435\u0430\u043B\u0438\u0437\u0430\u0446\u0438\u044F \u2192 \u0442\u0435\u0441\u0442\u044B \u2192 \u043A\u0430\u0447\u0435\u0441\u0442\u0432\u043E \u2192 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u0430\u0446\u0438\u044F \u043F\u043E\u044D\u0442\u0430\u043F\u043D\u043E)",
@@ -35773,7 +35775,8 @@ var PROMPT_DESCRIPTIONS = {
     learn: "\u0421\u043E\u0445\u0440\u0430\u043D\u0435\u043D\u0438\u0435/\u0432\u044B\u0437\u043E\u0432 \u0441\u043F\u0435\u0446\u0438\u0444\u0438\u0447\u043D\u044B\u0445 \u0434\u043B\u044F \u043F\u0440\u043E\u0435\u043A\u0442\u0430 \u043F\u0430\u0442\u0442\u0435\u0440\u043D\u043E\u0432, \u0441\u043E\u0433\u043B\u0430\u0448\u0435\u043D\u0438\u0439 \u0438 \u043F\u043E\u0434\u0432\u043E\u0434\u043D\u044B\u0445 \u043A\u0430\u043C\u043D\u0435\u0439",
     diagram: "\u0410\u0432\u0442\u043E\u043E\u0431\u043D\u043E\u0432\u043B\u0435\u043D\u0438\u0435 \u0430\u0440\u0445\u0438\u0442\u0435\u043A\u0442\u0443\u0440\u043D\u044B\u0445 \u0434\u0438\u0430\u0433\u0440\u0430\u043C\u043C (\u043F\u043E\u0434\u0434\u0435\u0440\u0436\u043A\u0430 \u0430\u043A\u0442\u0443\u0430\u043B\u044C\u043D\u044B\u0445 Mermaid-\u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u043E\u0432)",
     slide: "\u0413\u0435\u043D\u0435\u0440\u0430\u0446\u0438\u044F \u0441\u043B\u0430\u0439\u0434\u043E\u0432 \u0438\u0437 \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u043E\u0432 \u043F\u0440\u043E\u0435\u043A\u0442\u0430 (\u0444\u043E\u0440\u043C\u0430\u0442 Marp Markdown)",
-    design: "\u0413\u0435\u043D\u0435\u0440\u0430\u0446\u0438\u044F/\u043E\u0431\u043D\u043E\u0432\u043B\u0435\u043D\u0438\u0435 \u0432\u0438\u0437\u0443\u0430\u043B\u044C\u043D\u043E\u0433\u043E \u0434\u0438\u0437\u0430\u0439\u043D\u0430 \u0438\u0437 \u043A\u043E\u0434\u043E\u0432\u043E\u0439 \u0431\u0430\u0437\u044B (\u0441\u0438\u043D\u0445\u0440\u043E\u043D\u0438\u0437\u0430\u0446\u0438\u044F Pencil.dev)"
+    design: "\u0413\u0435\u043D\u0435\u0440\u0430\u0446\u0438\u044F/\u043E\u0431\u043D\u043E\u0432\u043B\u0435\u043D\u0438\u0435 \u0432\u0438\u0437\u0443\u0430\u043B\u044C\u043D\u043E\u0433\u043E \u0434\u0438\u0437\u0430\u0439\u043D\u0430 \u0438\u0437 \u043A\u043E\u0434\u043E\u0432\u043E\u0439 \u0431\u0430\u0437\u044B (\u0441\u0438\u043D\u0445\u0440\u043E\u043D\u0438\u0437\u0430\u0446\u0438\u044F Pencil.dev)",
+    metrics: "\u041E\u0442\u0447\u0451\u0442 \u043E\u0431 \u044D\u0444\u0444\u0435\u043A\u0442\u0438\u0432\u043D\u043E\u0441\u0442\u0438 \u0442\u043E\u043A\u0435\u043D\u043E\u0432 \u2014 \u0442\u043E\u043A\u0435\u043D\u044B \u043F\u0440\u043E\u043C\u043F\u0442\u043E\u0432 \u0432 \u044D\u0442\u043E\u0439 \u0441\u0435\u0441\u0441\u0438\u0438 vs. \u0431\u0430\u0437\u043E\u0432\u044B\u0439 \u0443\u0440\u043E\u0432\u0435\u043D\u044C Cursor Rules"
   }
 };
 var TOOL_ARG_META = {
@@ -35814,7 +35817,8 @@ var TOOL_ARG_META = {
   design: [
     { name: "target", required: false },
     { name: "output", required: false }
-  ]
+  ],
+  metrics: []
 };
 var TOOL_ARG_DESCRIPTIONS = {
   en: {
@@ -35922,7 +35926,8 @@ var PUBLIC_PROMPT_ORDER = [
   "learn",
   "diagram",
   "slide",
-  "design"
+  "design",
+  "metrics"
 ];
 var COMPOSITE_PROMPTS = {
   dev: { slugs: ["common", "dev"] },
@@ -39988,10 +39993,13 @@ async function validateLicense(registryUrl, licenseKey) {
 
 // src/metrics/prompt-metrics.ts
 var ESTIMATED_CHARS_PER_TOKEN = 3.5;
+var CURSOR_RULES_BASELINE_CHARS = 28e4;
 var PromptMetrics = class {
   calls = [];
   totalChars = 0;
   commonSize = null;
+  commonSkippedCount = 0;
+  commonSkippedChars = 0;
   recordCommonSize(chars) {
     this.commonSize = chars;
   }
@@ -40007,6 +40015,13 @@ var PromptMetrics = class {
     };
     this.calls.push(metric);
     this.totalChars += contentChars;
+    if (!commonIncluded && !NEEDS_COMMON_SLUGS.has(slug)) {
+      const savedChars = this.commonSize ?? 0;
+      if (savedChars > 0) {
+        this.commonSkippedCount++;
+        this.commonSkippedChars += savedChars;
+      }
+    }
     const estimatedTokens = Math.round(contentChars / ESTIMATED_CHARS_PER_TOKEN);
     const parts = [
       `${slug}: ${contentChars.toLocaleString()} chars (~${estimatedTokens.toLocaleString()} tokens)`,
@@ -40032,6 +40047,99 @@ var PromptMetrics = class {
   getCallHistory() {
     return this.calls;
   }
+  /**
+   * Generate a human-readable token efficiency report in the given language.
+   * Compares actual session usage against the Cursor Rules always-on baseline.
+   */
+  generateReport(lang = "en") {
+    const sessionTokens = Math.round(this.totalChars / ESTIMATED_CHARS_PER_TOKEN);
+    const baselineTokens = Math.round(CURSOR_RULES_BASELINE_CHARS / ESTIMATED_CHARS_PER_TOKEN);
+    const baselinePerCall = Math.round(baselineTokens / Math.max(this.calls.length, 1));
+    const baselineTotalIfAlwaysOn = baselinePerCall * Math.max(this.calls.length, 1);
+    const savedTokens = Math.max(0, baselineTotalIfAlwaysOn - sessionTokens);
+    const savedPct = baselineTotalIfAlwaysOn > 0 ? Math.round(savedTokens / baselineTotalIfAlwaysOn * 100) : 0;
+    const commonSkippedTokens = Math.round(this.commonSkippedChars / ESTIMATED_CHARS_PER_TOKEN);
+    const callLines = this.calls.map((c) => {
+      const t = Math.round(c.chars / ESTIMATED_CHARS_PER_TOKEN);
+      return `  ${c.slug.padEnd(12)} ~${t.toLocaleString()} tokens  [${c.slugsLoaded.join(", ")}]`;
+    }).join("\n") || (lang === "ja" ? "  \uFF08\u307E\u3060\u547C\u3073\u51FA\u3057\u306A\u3057\uFF09" : lang === "ru" ? "  (\u0432\u044B\u0437\u043E\u0432\u043E\u0432 \u0435\u0449\u0451 \u043D\u0435 \u0431\u044B\u043B\u043E)" : "  (no calls yet)");
+    if (lang === "ja") {
+      return [
+        `\u{1F4CA} ${brand.displayName} \u2014 \u30C8\u30FC\u30AF\u30F3\u52B9\u7387\u30EC\u30DD\u30FC\u30C8`,
+        ``,
+        `## \u3053\u306E\u30BB\u30C3\u30B7\u30E7\u30F3`,
+        `  \u547C\u3073\u51FA\u3057\u56DE\u6570:         ${this.calls.length} \u56DE`,
+        `  \u914D\u4FE1\u30C8\u30FC\u30AF\u30F3\u5408\u8A08:     ~${sessionTokens.toLocaleString()} tokens`,
+        ``,
+        `## Cursor Rules \u65B9\u5F0F\u3068\u306E\u6BD4\u8F03\uFF08\u5168\u30D7\u30ED\u30F3\u30D7\u30C8\u5E38\u6642\u8AAD\u307F\u8FBC\u307F\u60F3\u5B9A\uFF09`,
+        `  Cursor Rules \u63A8\u5B9A\u30B3\u30B9\u30C8: ~${baselineTotalIfAlwaysOn.toLocaleString()} tokens`,
+        `  GoDD \u5B9F\u969B\u306E\u30B3\u30B9\u30C8:       ~${sessionTokens.toLocaleString()} tokens`,
+        `  \u7BC0\u7D04\u63A8\u5B9A:                ~${savedTokens.toLocaleString()} tokens (${savedPct}%)`,
+        ``,
+        `## \u6700\u9069\u5316\u306E\u5185\u8A33`,
+        `  common \u30B9\u30AD\u30C3\u30D7\u56DE\u6570: ${this.commonSkippedCount} \u56DE (~${commonSkippedTokens.toLocaleString()} tokens \u7BC0\u7D04)`,
+        `  \u203B commit/push \u306A\u3069\u8EFD\u91CF\u30C4\u30FC\u30EB\u306F\u5171\u901A\u30DE\u30A4\u30F3\u30C9\u30BB\u30C3\u30C8\u3092\u8AAD\u307F\u8FBC\u307E\u306A\u3044\u8A2D\u8A08`,
+        ``,
+        `## \u547C\u3073\u51FA\u3057\u5C65\u6B74`,
+        callLines,
+        ``,
+        `---`,
+        `GoDD MCP \u306F\u30AA\u30F3\u30C7\u30DE\u30F3\u30C9\u914D\u4FE1\u306E\u305F\u3081\u3001\u4F7F\u3063\u305F\u30D7\u30ED\u30F3\u30D7\u30C8\u3060\u3051\u3092\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u306B\u9001\u308A\u307E\u3059\u3002`,
+        `Cursor Rules \u306F\u5168\u30EB\u30FC\u30EB\u3092\u6BCE\u4F1A\u8A71\u306E\u958B\u59CB\u6642\u304B\u3089\u5E38\u6642\u30B3\u30F3\u30C6\u30AD\u30B9\u30C8\u306B\u542B\u3081\u307E\u3059\u3002`,
+        `\u203B \u30C8\u30FC\u30AF\u30F3\u6570\u306F\u6587\u5B57\u6570 \xF7 3.5 \u3067\u63A8\u5B9A\u3002\u5B9F\u969B\u306E\u5024\u306F\u4F7F\u7528\u30E2\u30C7\u30EB\u306B\u3088\u308A\u7570\u306A\u308A\u307E\u3059\u3002`
+      ].join("\n");
+    }
+    if (lang === "ru") {
+      return [
+        `\u{1F4CA} ${brand.displayName} \u2014 \u041E\u0442\u0447\u0451\u0442 \u044D\u0444\u0444\u0435\u043A\u0442\u0438\u0432\u043D\u043E\u0441\u0442\u0438 \u0442\u043E\u043A\u0435\u043D\u043E\u0432`,
+        ``,
+        `## \u042D\u0442\u0430 \u0441\u0435\u0441\u0441\u0438\u044F`,
+        `  \u041A\u043E\u043B\u0438\u0447\u0435\u0441\u0442\u0432\u043E \u0432\u044B\u0437\u043E\u0432\u043E\u0432:   ${this.calls.length}`,
+        `  \u0414\u043E\u0441\u0442\u0430\u0432\u043B\u0435\u043D\u043E \u0442\u043E\u043A\u0435\u043D\u043E\u0432:   ~${sessionTokens.toLocaleString()} tokens`,
+        ``,
+        `## \u0421\u0440\u0430\u0432\u043D\u0435\u043D\u0438\u0435 \u0441 Cursor Rules (\u0432\u0441\u0435 \u043F\u0440\u043E\u043C\u043F\u0442\u044B \u0432\u0441\u0435\u0433\u0434\u0430 \u0437\u0430\u0433\u0440\u0443\u0436\u0435\u043D\u044B)`,
+        `  \u0420\u0430\u0441\u0447\u0451\u0442\u043D\u044B\u0435 \u0437\u0430\u0442\u0440\u0430\u0442\u044B Cursor Rules: ~${baselineTotalIfAlwaysOn.toLocaleString()} tokens`,
+        `  \u0424\u0430\u043A\u0442\u0438\u0447\u0435\u0441\u043A\u0438\u0435 \u0437\u0430\u0442\u0440\u0430\u0442\u044B GoDD:       ~${sessionTokens.toLocaleString()} tokens`,
+        `  \u0420\u0430\u0441\u0447\u0451\u0442\u043D\u0430\u044F \u044D\u043A\u043E\u043D\u043E\u043C\u0438\u044F:             ~${savedTokens.toLocaleString()} tokens (${savedPct}%)`,
+        ``,
+        `## \u0414\u0435\u0442\u0430\u043B\u0438\u0437\u0430\u0446\u0438\u044F \u043E\u043F\u0442\u0438\u043C\u0438\u0437\u0430\u0446\u0438\u0438`,
+        `  \u041F\u0440\u043E\u043F\u0443\u0441\u043A\u043E\u0432 common: ${this.commonSkippedCount} (~${commonSkippedTokens.toLocaleString()} tokens \u0441\u044D\u043A\u043E\u043D\u043E\u043C\u043B\u0435\u043D\u043E)`,
+        `  \u203B \u041B\u0451\u0433\u043A\u0438\u0435 \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u044B (commit, push) \u043D\u0435 \u0437\u0430\u0433\u0440\u0443\u0436\u0430\u044E\u0442 \u043E\u0431\u0449\u0438\u0439 mindset`,
+        ``,
+        `## \u0418\u0441\u0442\u043E\u0440\u0438\u044F \u0432\u044B\u0437\u043E\u0432\u043E\u0432`,
+        callLines,
+        ``,
+        `---`,
+        `GoDD MCP \u0434\u043E\u0441\u0442\u0430\u0432\u043B\u044F\u0435\u0442 \u0442\u043E\u043B\u044C\u043A\u043E \u043D\u0443\u0436\u043D\u044B\u0435 \u043F\u0440\u043E\u043C\u043F\u0442\u044B \u043F\u043E \u0437\u0430\u043F\u0440\u043E\u0441\u0443.`,
+        `Cursor Rules \u0432\u043A\u043B\u044E\u0447\u0430\u0435\u0442 \u0432\u0441\u0435 \u043F\u0440\u0430\u0432\u0438\u043B\u0430 \u0432 \u043A\u043E\u043D\u0442\u0435\u043A\u0441\u0442 \u0441 \u043D\u0430\u0447\u0430\u043B\u0430 \u043A\u0430\u0436\u0434\u043E\u0433\u043E \u0447\u0430\u0442\u0430.`,
+        `\u203B \u041A\u043E\u043B\u0438\u0447\u0435\u0441\u0442\u0432\u043E \u0442\u043E\u043A\u0435\u043D\u043E\u0432 \u0440\u0430\u0441\u0441\u0447\u0438\u0442\u044B\u0432\u0430\u0435\u0442\u0441\u044F \u043A\u0430\u043A \u043A\u043E\u043B-\u0432\u043E \u0441\u0438\u043C\u0432\u043E\u043B\u043E\u0432 \xF7 3,5. \u0420\u0435\u0430\u043B\u044C\u043D\u044B\u0435 \u0437\u043D\u0430\u0447\u0435\u043D\u0438\u044F \u0437\u0430\u0432\u0438\u0441\u044F\u0442 \u043E\u0442 \u043C\u043E\u0434\u0435\u043B\u0438.`
+      ].join("\n");
+    }
+    return [
+      `\u{1F4CA} ${brand.displayName} \u2014 Token Efficiency Report`,
+      ``,
+      `## This Session`,
+      `  Calls made:           ${this.calls.length}`,
+      `  Tokens delivered:     ~${sessionTokens.toLocaleString()} tokens`,
+      ``,
+      `## Comparison vs. Cursor Rules (all prompts always loaded)`,
+      `  Cursor Rules estimate:  ~${baselineTotalIfAlwaysOn.toLocaleString()} tokens`,
+      `  GoDD actual:            ~${sessionTokens.toLocaleString()} tokens`,
+      `  Estimated savings:      ~${savedTokens.toLocaleString()} tokens (${savedPct}%)`,
+      ``,
+      `## Optimization breakdown`,
+      `  common skipped: ${this.commonSkippedCount}x (~${commonSkippedTokens.toLocaleString()} tokens saved)`,
+      `  \u203B Lightweight tools (commit, push) skip the heavy common mindset by design`,
+      ``,
+      `## Call history`,
+      callLines,
+      ``,
+      `---`,
+      `GoDD MCP delivers only the prompts you call, on demand.`,
+      `Cursor Rules loads all rules into context from the start of every chat.`,
+      `\u203B Token counts are estimated at chars \xF7 3.5. Actual values vary by model.`
+    ].join("\n");
+  }
 };
 
 // src/index.ts
@@ -40269,6 +40377,10 @@ function startServer() {
     const slug = toolName.replace(brand.toolPrefix, "");
     const rawArgs = request.params.arguments;
     const localArgs = rawArgs ? Object.fromEntries(Object.entries(rawArgs).map(([k, v]) => [k, String(v)])) : void 0;
+    if (slug === "metrics") {
+      const report = metrics.generateReport(displayLang);
+      return { content: [{ type: "text", text: report }] };
+    }
     const result = await resolveMcpSlugContent(slug, "tool", {
       localArgs,
       registryClient,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autodevjapan/godd-mcp-alpha",
-  "version": "1.25.19",
+  "version": "1.25.21",
   "type": "module",
   "description": "GoDD MCP α Server — AI Prompt Delivery System for Cursor IDE",
   "license": "UNLICENSED",