meguro-mcp 0.2.8 → 0.2.9

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to `meguro-mcp` are recorded here. Versions follow Semantic Versioning.
 
+## 0.2.9 — 2026-08-10
+
+- Keeps the full real-store history-run family in the public STDIO registry while the hosted OAuth
+  surface now teaches and exposes only the practice-world run lane.
+- Adds immutable getting-started v7, product-guide v4, and documentation-index v2 resources with
+  hosted-first control-plane guidance, Gate-policy v2 citations, and one honest STDIO history-lane
+  bridge.
+- Reconciles `usage_read` with the exempt auto-provisioned sample store shown by `stores_list`, while
+  preserving every existing tool name, input schema, and prior documentation byte stream.
+
 ## 0.2.8 — 2026-08-09
 
 - Adds `practice_runs_list` so a cold MCP-only evaluator can discover existing practice attempts

package/README.md

@@ -182,11 +182,11 @@ See [the agency quickstart](../../docs/agency-practice-run-quickstart.md) and [H
 ## Advanced: CI or local STDIO
 
 Use the public STDIO package for CI, local automation, or clients without hosted Streamable HTTP and
-OAuth support. It requires a workspace-bound `meg_sk_…` API key and exposes the full 46-tool local
+OAuth support. It requires a workspace-bound `meg_sk_…` API key and exposes the full 47-tool local
 surface. Pin the exact public version in client configuration so a quickstart stays reproducible:
 
 ```bash
-npx -y meguro-mcp@0.2.8
+npx -y meguro-mcp@0.2.9
 ```
 
 ### Environment
@@ -204,7 +204,7 @@ claude mcp add meguro \
   -e MEGURO_API_BASE_URL=https://api-dev.meguro.io \
   -e MEGURO_API_TOKEN=meg_sk_... \
   -e MEGURO_DASHBOARD_URL=https://... \
-  -- npx -y meguro-mcp@0.2.8
+  -- npx -y meguro-mcp@0.2.9
 ```
 
 ### Register — Cursor (`.cursor/mcp.json`)
@@ -214,7 +214,7 @@ claude mcp add meguro \
   "mcpServers": {
     "meguro": {
       "command": "npx",
-      "args": ["-y", "meguro-mcp@0.2.8"],
+      "args": ["-y", "meguro-mcp@0.2.9"],
       "env": {
         "MEGURO_API_BASE_URL": "https://api-dev.meguro.io",
         "MEGURO_API_TOKEN": "meg_sk_...",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "meguro-mcp",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "private": false,
   "type": "module",
   "description": "Meguro control-plane MCP server: drive worlds, runs, and verdicts from your own AI tools.",

package/src/docs.mjs

@@ -20,9 +20,11 @@ const GETTING_STARTED_LATEST_VERSION = 3;
 const GETTING_STARTED_V4_VERSION = 4;
 const GETTING_STARTED_V5_VERSION = 5;
 const GETTING_STARTED_V6_VERSION = 6;
+const GETTING_STARTED_V7_VERSION = 7;
 const PRODUCT_GUIDE_VERSION = 1;
 const PRODUCT_GUIDE_V2_VERSION = 2;
 const PRODUCT_GUIDE_V3_VERSION = 3;
+const PRODUCT_GUIDE_V4_VERSION = 4;
 const RECEIPT_GUIDE_URI = `meguro://docs/receipt-guide/v${RECEIPT_GUIDE_VERSION}`;
 const RECEIPT_GUIDE_V2_URI = `meguro://docs/receipt-guide/v${RECEIPT_GUIDE_V2_VERSION}`;
 const RECEIPT_GUIDE_V3_URI = `meguro://docs/receipt-guide/v${RECEIPT_GUIDE_V3_VERSION}`;
@@ -38,10 +40,13 @@ const GETTING_STARTED_LATEST_URI = `meguro://docs/getting-started/v${GETTING_STA
 const GETTING_STARTED_V4_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V4_VERSION}`;
 const GETTING_STARTED_V5_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V5_VERSION}`;
 const GETTING_STARTED_V6_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V6_VERSION}`;
+const GETTING_STARTED_V7_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V7_VERSION}`;
 const PRODUCT_GUIDE_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_VERSION}`;
 const PRODUCT_GUIDE_V2_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V2_VERSION}`;
 const PRODUCT_GUIDE_V3_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V3_VERSION}`;
+const PRODUCT_GUIDE_V4_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V4_VERSION}`;
 export const DOCUMENTATION_INDEX_URI = 'meguro://docs/index/v1';
+export const DOCUMENTATION_INDEX_V2_URI = 'meguro://docs/index/v2';
 
 const DOCUMENTATION_CURRENCY_V1 = deepFreeze({
   indexVersion: 1,
@@ -53,7 +58,17 @@ const DOCUMENTATION_CURRENCY_V1 = deepFreeze({
     'receipt-guide': RECEIPT_GUIDE_V7_URI,
   },
 });
-const CURRENT_DOCUMENTATION_CURRENCY = DOCUMENTATION_CURRENCY_V1;
+const DOCUMENTATION_CURRENCY_V2 = deepFreeze({
+  indexVersion: 2,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V2_URI,
+    'getting-started': GETTING_STARTED_V7_URI,
+    index: DOCUMENTATION_INDEX_V2_URI,
+    'product-guide': PRODUCT_GUIDE_V4_URI,
+    'receipt-guide': RECEIPT_GUIDE_V7_URI,
+  },
+});
+const CURRENT_DOCUMENTATION_CURRENCY = DOCUMENTATION_CURRENCY_V2;
 
 function documentationVersionFromUri(uri) {
   const match = /\/v([1-9][0-9]*)$/u.exec(uri);
@@ -61,12 +76,12 @@ function documentationVersionFromUri(uri) {
   return Number(match[1]);
 }
 
-function documentationIndexText(currency) {
+function documentationIndexText(currency, publishedUri = DOCUMENTATION_INDEX_URI) {
   const rows = Object.entries(currency.currentUriByTopic).sort(([left], [right]) => codepointCompare(left, right));
   return [
     `# Meguro documentation index v${currency.indexVersion}`,
     '',
-    `Published URI: \`${DOCUMENTATION_INDEX_URI}\``,
+    `Published URI: \`${publishedUri}\``,
     '',
     'This immutable index records the current published version of every documentation family at issuance.',
     'Use the `meguro/status` annotations from `resources/list` for live currency; cited versioned resources never change.',
@@ -1248,6 +1263,38 @@ a plan, consent for the human, or reveal a credential that the human has not gra
 ## Question-to-source routing`,
   )
   .replace('Read \`meguro://docs/getting-started/v1\`.', `Read \`${GETTING_STARTED_V6_URI}\`.`);
+const REAL_STORE_HISTORY_LANE_BRIDGE = 'Meguro\'s separate real-store history lane still exists in the public STDIO distribution for internal and CI use; hosted OAuth MCP does not expose or teach that lane.';
+const GETTING_STARTED_V7_TEXT = GETTING_STARTED_V6_TEXT
+  .replace('# Getting started with Meguro v6', '# Getting started with Meguro v7')
+  .replace(`Published URI: \`${GETTING_STARTED_V6_URI}\``, `Published URI: \`${GETTING_STARTED_V7_URI}\``)
+  .replaceAll('meguro://docs/gate-policy/v1', 'meguro://docs/gate-policy/v2')
+  .replace(
+    `The local \`meguro-mcp\` server is the Meguro control plane: it discovers stores and drives run
+lifecycle. The practice store's returned Shopify-shaped Admin endpoint is the data plane used by the
+commerce agent under evaluation. A practice store's storefront MCP endpoint is neither of those and
+cannot replace the local control plane or the Shopify-shaped Admin endpoint.`,
+    `Hosted OAuth MCP is the recommended control plane for interactive agents. The public STDIO
+distribution is the CI and internal fallback. The practice store's returned Shopify-shaped Admin
+endpoint is the data plane used by the commerce agent under evaluation; its storefront MCP endpoint
+is neither control plane nor a substitute for the Shopify-shaped Admin endpoint.
+
+${REAL_STORE_HISTORY_LANE_BRIDGE}`,
+  );
+const PRODUCT_GUIDE_V4_TEXT = PRODUCT_GUIDE_V3_TEXT
+  .replace('# Meguro product guide v3', '# Meguro product guide v4')
+  .replace(`Published URI: \`${PRODUCT_GUIDE_V3_URI}\``, `Published URI: \`${PRODUCT_GUIDE_V4_URI}\``)
+  .replaceAll('meguro://docs/gate-policy/v1', 'meguro://docs/gate-policy/v2')
+  .replace(`Read \`${GETTING_STARTED_V6_URI}\`.`, `Read \`${GETTING_STARTED_V7_URI}\`.`)
+  .replace(
+    '- **Public STDIO MCP** is the local and CI fallback.',
+    `- **Public STDIO MCP** is the CI and internal fallback.
+
+${REAL_STORE_HISTORY_LANE_BRIDGE}`,
+  )
+  .replace(
+    '| What runs exist or what happened? | Call \`runs_list\` and the relevant status, report, or impact tool. |',
+    '| What practice runs exist or what happened? | Call \`practice_runs_list\` and the relevant \`practice_run_status\`, \`practice_run_report\`, or \`practice_run_impact\` tool. |',
+  );
 const RECEIPT_GUIDE_V6_TEXT = simulationVocabularyText(
   RECEIPT_GUIDE_V5_TEXT
     .replace('# Meguro receipt guide v5', '# Meguro receipt guide v6')
@@ -1415,6 +1462,15 @@ const CATALOG = buildDocumentationCatalog([
     description: `World-first discovery sequence for Shopify Admin GraphQL ${ADMIN_API_SUPPORTED_VERSIONS.join(' and ')} with default ${ADMIN_API_DEFAULT_VERSION}.`,
     text: GETTING_STARTED_V6_TEXT,
   },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V7_VERSION,
+    uri: GETTING_STARTED_V7_URI,
+    name: 'Getting started with Meguro v7',
+    title: 'Getting started with Meguro v7',
+    description: `Hosted-first practice-store sequence for Shopify Admin GraphQL ${ADMIN_API_SUPPORTED_VERSIONS.join(' and ')} with default ${ADMIN_API_DEFAULT_VERSION}.`,
+    text: GETTING_STARTED_V7_TEXT,
+  },
   {
     topic: 'product-guide',
     version: PRODUCT_GUIDE_VERSION,
@@ -1443,6 +1499,15 @@ const CATALOG = buildDocumentationCatalog([
     description: 'World-first product concepts, evidence boundaries, surface responsibilities, and question-to-source routing.',
     text: PRODUCT_GUIDE_V3_TEXT,
   },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V4_VERSION,
+    uri: PRODUCT_GUIDE_V4_URI,
+    name: 'Meguro product guide v4',
+    title: 'Meguro product guide v4',
+    description: 'Hosted-first product concepts, practice-run vocabulary, evidence boundaries, and question-to-source routing.',
+    text: PRODUCT_GUIDE_V4_TEXT,
+  },
   {
     topic: 'index',
     version: DOCUMENTATION_CURRENCY_V1.indexVersion,
@@ -1452,6 +1517,15 @@ const CATALOG = buildDocumentationCatalog([
     description: 'Immutable current-version pointers for every published Meguro documentation family.',
     text: documentationIndexText(DOCUMENTATION_CURRENCY_V1),
   },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V2.indexVersion,
+    uri: DOCUMENTATION_INDEX_V2_URI,
+    name: 'Meguro documentation index v2',
+    title: 'Meguro documentation index v2',
+    description: 'Immutable current-version pointers for every published Meguro documentation family after the hosted run-lane separation.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V2, DOCUMENTATION_INDEX_V2_URI),
+  },
   {
     topic: 'receipt-guide',
     version: RECEIPT_GUIDE_VERSION,

package/src/server.mjs

@@ -14,7 +14,7 @@ import {
 } from './protocol.mjs';
 import { createTools, redactSecrets } from './tools.mjs';
 
-const SERVER_INFO = { name: 'meguro', version: '0.2.8' };
+const SERVER_INFO = { name: 'meguro', version: '0.2.9' };
 const PROTOCOL_VERSION = '2025-03-26';
 
 const tools = createTools({

package/src/tools.mjs

@@ -1055,6 +1055,11 @@ function usageProjection(value) {
     },
     limits: {
       activeStores,
+      activeStoreAccounting: {
+        basis: 'metered-active-stores',
+        exemptionMarker: 'auto-provisioned-sample-store',
+        note: 'activeStores counts metered stores. A stores_list row marked auto-provisioned-sample-store is an exempt sample store and is not counted here.',
+      },
       activeStoreLimit,
       activeWorkspaces,
       activeWorkspaceLimit,