meguro-mcp 0.2.10 → 0.2.13

package/src/docs.mjs

@@ -12,9 +12,23 @@ const RECEIPT_GUIDE_V4_VERSION = 4;
 const RECEIPT_GUIDE_LATEST_VERSION = 5;
 const RECEIPT_GUIDE_V6_VERSION = 6;
 const RECEIPT_GUIDE_V7_VERSION = 7;
+const RECEIPT_GUIDE_V8_VERSION = 8;
+const RECEIPT_GUIDE_V9_VERSION = 9;
+const RECEIPT_GUIDE_V10_VERSION = 10;
+const RECEIPT_GUIDE_V11_VERSION = 11;
+const RECEIPT_GUIDE_V12_VERSION = 12;
+const RECEIPT_GUIDE_V13_VERSION = 13;
+const RECEIPT_GUIDE_V14_VERSION = 14;
+const RECEIPT_GUIDE_V15_VERSION = 15;
+const RECEIPT_GUIDE_V16_VERSION = 16;
+const RECEIPT_GUIDE_V17_VERSION = 17;
+const RECEIPT_GUIDE_V18_VERSION = 18;
 const GATE_POLICY_VERSION = 1;
 const GATE_POLICY_V2_VERSION = 2;
 const GATE_POLICY_V3_VERSION = 3;
+const GATE_POLICY_V4_VERSION = 4;
+const GATE_POLICY_V5_VERSION = 5;
+const GATE_POLICY_V6_VERSION = 6;
 const GETTING_STARTED_VERSION = 1;
 const GETTING_STARTED_V2_VERSION = 2;
 const GETTING_STARTED_LATEST_VERSION = 3;
@@ -23,11 +37,73 @@ const GETTING_STARTED_V5_VERSION = 5;
 const GETTING_STARTED_V6_VERSION = 6;
 const GETTING_STARTED_V7_VERSION = 7;
 const GETTING_STARTED_V8_VERSION = 8;
+const GETTING_STARTED_V9_VERSION = 9;
+const GETTING_STARTED_V10_VERSION = 10;
+const GETTING_STARTED_V11_VERSION = 11;
+const GETTING_STARTED_V12_VERSION = 12;
+const GETTING_STARTED_V13_VERSION = 13;
+const GETTING_STARTED_V14_VERSION = 14;
+const GETTING_STARTED_V15_VERSION = 15;
+const GETTING_STARTED_V16_VERSION = 16;
+const GETTING_STARTED_V17_VERSION = 17;
+const GETTING_STARTED_V18_VERSION = 18;
+const GETTING_STARTED_V19_VERSION = 19;
+const GETTING_STARTED_V20_VERSION = 20;
+const GETTING_STARTED_V21_VERSION = 21;
+const GETTING_STARTED_V22_VERSION = 22;
+const GETTING_STARTED_V23_VERSION = 23;
+const GETTING_STARTED_V24_VERSION = 24;
+const GETTING_STARTED_V25_VERSION = 25;
+const GETTING_STARTED_V26_VERSION = 26;
+const GETTING_STARTED_V27_VERSION = 27;
+const GETTING_STARTED_V28_VERSION = 28;
+const GETTING_STARTED_V29_VERSION = 29;
+const GETTING_STARTED_V30_VERSION = 30;
+const GETTING_STARTED_V31_VERSION = 31;
+const GETTING_STARTED_V32_VERSION = 32;
+const GETTING_STARTED_V33_VERSION = 33;
+const GETTING_STARTED_V34_VERSION = 34;
+const GETTING_STARTED_V35_VERSION = 35;
+const GETTING_STARTED_V36_VERSION = 36;
+const GETTING_STARTED_V37_VERSION = 37;
+const GETTING_STARTED_V38_VERSION = 38;
+const GETTING_STARTED_V39_VERSION = 39;
 const PRODUCT_GUIDE_VERSION = 1;
 const PRODUCT_GUIDE_V2_VERSION = 2;
 const PRODUCT_GUIDE_V3_VERSION = 3;
 const PRODUCT_GUIDE_V4_VERSION = 4;
 const PRODUCT_GUIDE_V5_VERSION = 5;
+const PRODUCT_GUIDE_V6_VERSION = 6;
+const PRODUCT_GUIDE_V7_VERSION = 7;
+const PRODUCT_GUIDE_V8_VERSION = 8;
+const PRODUCT_GUIDE_V9_VERSION = 9;
+const PRODUCT_GUIDE_V10_VERSION = 10;
+const PRODUCT_GUIDE_V11_VERSION = 11;
+const PRODUCT_GUIDE_V12_VERSION = 12;
+const PRODUCT_GUIDE_V13_VERSION = 13;
+const PRODUCT_GUIDE_V14_VERSION = 14;
+const PRODUCT_GUIDE_V15_VERSION = 15;
+const PRODUCT_GUIDE_V16_VERSION = 16;
+const PRODUCT_GUIDE_V17_VERSION = 17;
+const PRODUCT_GUIDE_V18_VERSION = 18;
+const PRODUCT_GUIDE_V19_VERSION = 19;
+const PRODUCT_GUIDE_V20_VERSION = 20;
+const PRODUCT_GUIDE_V21_VERSION = 21;
+const PRODUCT_GUIDE_V22_VERSION = 22;
+const PRODUCT_GUIDE_V23_VERSION = 23;
+const PRODUCT_GUIDE_V24_VERSION = 24;
+const PRODUCT_GUIDE_V25_VERSION = 25;
+const PRODUCT_GUIDE_V26_VERSION = 26;
+const PRODUCT_GUIDE_V27_VERSION = 27;
+const PRODUCT_GUIDE_V28_VERSION = 28;
+const PRODUCT_GUIDE_V29_VERSION = 29;
+const PRODUCT_GUIDE_V30_VERSION = 30;
+const PRODUCT_GUIDE_V31_VERSION = 31;
+const PRODUCT_GUIDE_V32_VERSION = 32;
+const PRODUCT_GUIDE_V33_VERSION = 33;
+const PRODUCT_GUIDE_V34_VERSION = 34;
+const PRODUCT_GUIDE_V35_VERSION = 35;
+const PRODUCT_GUIDE_V36_VERSION = 36;
 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}`;
@@ -35,9 +111,23 @@ const RECEIPT_GUIDE_V4_URI = `meguro://docs/receipt-guide/v${RECEIPT_GUIDE_V4_VE
 const RECEIPT_GUIDE_LATEST_URI = `meguro://docs/receipt-guide/v${RECEIPT_GUIDE_LATEST_VERSION}`;
 const RECEIPT_GUIDE_V6_URI = `meguro://docs/receipt-guide/v${RECEIPT_GUIDE_V6_VERSION}`;
 const RECEIPT_GUIDE_V7_URI = `meguro://docs/receipt-guide/v${RECEIPT_GUIDE_V7_VERSION}`;
+const RECEIPT_GUIDE_V8_URI = `meguro://docs/receipt-guide/v${RECEIPT_GUIDE_V8_VERSION}`;
+const RECEIPT_GUIDE_V9_URI = `meguro://docs/receipt-guide/v${RECEIPT_GUIDE_V9_VERSION}`;
+const RECEIPT_GUIDE_V10_URI = `meguro://docs/receipt-guide/v${RECEIPT_GUIDE_V10_VERSION}`;
+const RECEIPT_GUIDE_V11_URI = `meguro://docs/receipt-guide/v${RECEIPT_GUIDE_V11_VERSION}`;
+const RECEIPT_GUIDE_V12_URI = `meguro://docs/receipt-guide/v${RECEIPT_GUIDE_V12_VERSION}`;
+const RECEIPT_GUIDE_V13_URI = `meguro://docs/receipt-guide/v${RECEIPT_GUIDE_V13_VERSION}`;
+const RECEIPT_GUIDE_V14_URI = `meguro://docs/receipt-guide/v${RECEIPT_GUIDE_V14_VERSION}`;
+const RECEIPT_GUIDE_V15_URI = `meguro://docs/receipt-guide/v${RECEIPT_GUIDE_V15_VERSION}`;
+const RECEIPT_GUIDE_V16_URI = `meguro://docs/receipt-guide/v${RECEIPT_GUIDE_V16_VERSION}`;
+const RECEIPT_GUIDE_V17_URI = `meguro://docs/receipt-guide/v${RECEIPT_GUIDE_V17_VERSION}`;
+const RECEIPT_GUIDE_V18_URI = `meguro://docs/receipt-guide/v${RECEIPT_GUIDE_V18_VERSION}`;
 const GATE_POLICY_URI = `meguro://docs/gate-policy/v${GATE_POLICY_VERSION}`;
 const GATE_POLICY_V2_URI = `meguro://docs/gate-policy/v${GATE_POLICY_V2_VERSION}`;
 const GATE_POLICY_V3_URI = `meguro://docs/gate-policy/v${GATE_POLICY_V3_VERSION}`;
+const GATE_POLICY_V4_URI = `meguro://docs/gate-policy/v${GATE_POLICY_V4_VERSION}`;
+const GATE_POLICY_V5_URI = `meguro://docs/gate-policy/v${GATE_POLICY_V5_VERSION}`;
+const GATE_POLICY_V6_URI = `meguro://docs/gate-policy/v${GATE_POLICY_V6_VERSION}`;
 const GETTING_STARTED_URI = `meguro://docs/getting-started/v${GETTING_STARTED_VERSION}`;
 const GETTING_STARTED_V2_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V2_VERSION}`;
 const GETTING_STARTED_LATEST_URI = `meguro://docs/getting-started/v${GETTING_STARTED_LATEST_VERSION}`;
@@ -46,15 +136,110 @@ const GETTING_STARTED_V5_URI = `meguro://docs/getting-started/v${GETTING_STARTED
 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 GETTING_STARTED_V8_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V8_VERSION}`;
+const GETTING_STARTED_V9_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V9_VERSION}`;
+const GETTING_STARTED_V10_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V10_VERSION}`;
+const GETTING_STARTED_V11_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V11_VERSION}`;
+const GETTING_STARTED_V12_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V12_VERSION}`;
+const GETTING_STARTED_V13_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V13_VERSION}`;
+const GETTING_STARTED_V14_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V14_VERSION}`;
+const GETTING_STARTED_V15_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V15_VERSION}`;
+const GETTING_STARTED_V16_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V16_VERSION}`;
+const GETTING_STARTED_V17_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V17_VERSION}`;
+const GETTING_STARTED_V18_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V18_VERSION}`;
+const GETTING_STARTED_V19_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V19_VERSION}`;
+const GETTING_STARTED_V20_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V20_VERSION}`;
+const GETTING_STARTED_V21_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V21_VERSION}`;
+const GETTING_STARTED_V22_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V22_VERSION}`;
+const GETTING_STARTED_V23_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V23_VERSION}`;
+const GETTING_STARTED_V24_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V24_VERSION}`;
+const GETTING_STARTED_V25_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V25_VERSION}`;
+const GETTING_STARTED_V26_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V26_VERSION}`;
+const GETTING_STARTED_V27_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V27_VERSION}`;
+const GETTING_STARTED_V28_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V28_VERSION}`;
+const GETTING_STARTED_V29_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V29_VERSION}`;
+const GETTING_STARTED_V30_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V30_VERSION}`;
+const GETTING_STARTED_V31_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V31_VERSION}`;
+const GETTING_STARTED_V32_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V32_VERSION}`;
+const GETTING_STARTED_V33_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V33_VERSION}`;
+const GETTING_STARTED_V34_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V34_VERSION}`;
+const GETTING_STARTED_V35_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V35_VERSION}`;
+const GETTING_STARTED_V36_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V36_VERSION}`;
+const GETTING_STARTED_V37_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V37_VERSION}`;
+const GETTING_STARTED_V38_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V38_VERSION}`;
+const GETTING_STARTED_V39_URI = `meguro://docs/getting-started/v${GETTING_STARTED_V39_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}`;
 const PRODUCT_GUIDE_V5_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V5_VERSION}`;
+const PRODUCT_GUIDE_V6_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V6_VERSION}`;
+const PRODUCT_GUIDE_V7_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V7_VERSION}`;
+const PRODUCT_GUIDE_V8_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V8_VERSION}`;
+const PRODUCT_GUIDE_V9_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V9_VERSION}`;
+const PRODUCT_GUIDE_V10_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V10_VERSION}`;
+const PRODUCT_GUIDE_V11_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V11_VERSION}`;
+const PRODUCT_GUIDE_V12_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V12_VERSION}`;
+const PRODUCT_GUIDE_V13_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V13_VERSION}`;
+const PRODUCT_GUIDE_V14_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V14_VERSION}`;
+const PRODUCT_GUIDE_V15_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V15_VERSION}`;
+const PRODUCT_GUIDE_V16_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V16_VERSION}`;
+const PRODUCT_GUIDE_V17_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V17_VERSION}`;
+const PRODUCT_GUIDE_V18_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V18_VERSION}`;
+const PRODUCT_GUIDE_V19_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V19_VERSION}`;
+const PRODUCT_GUIDE_V20_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V20_VERSION}`;
+const PRODUCT_GUIDE_V21_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V21_VERSION}`;
+const PRODUCT_GUIDE_V22_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V22_VERSION}`;
+const PRODUCT_GUIDE_V23_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V23_VERSION}`;
+const PRODUCT_GUIDE_V24_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V24_VERSION}`;
+const PRODUCT_GUIDE_V25_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V25_VERSION}`;
+const PRODUCT_GUIDE_V26_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V26_VERSION}`;
+const PRODUCT_GUIDE_V27_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V27_VERSION}`;
+const PRODUCT_GUIDE_V28_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V28_VERSION}`;
+const PRODUCT_GUIDE_V29_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V29_VERSION}`;
+const PRODUCT_GUIDE_V30_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V30_VERSION}`;
+const PRODUCT_GUIDE_V31_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V31_VERSION}`;
+const PRODUCT_GUIDE_V32_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V32_VERSION}`;
+const PRODUCT_GUIDE_V33_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V33_VERSION}`;
+const PRODUCT_GUIDE_V34_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V34_VERSION}`;
+const PRODUCT_GUIDE_V35_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V35_VERSION}`;
+const PRODUCT_GUIDE_V36_URI = `meguro://docs/product-guide/v${PRODUCT_GUIDE_V36_VERSION}`;
 export const DOCUMENTATION_INDEX_URI = 'meguro://docs/index/v1';
 export const DOCUMENTATION_INDEX_V2_URI = 'meguro://docs/index/v2';
 export const DOCUMENTATION_INDEX_V3_URI = 'meguro://docs/index/v3';
 export const DOCUMENTATION_INDEX_V4_URI = 'meguro://docs/index/v4';
+export const DOCUMENTATION_INDEX_V5_URI = 'meguro://docs/index/v5';
+export const DOCUMENTATION_INDEX_V6_URI = 'meguro://docs/index/v6';
+export const DOCUMENTATION_INDEX_V7_URI = 'meguro://docs/index/v7';
+export const DOCUMENTATION_INDEX_V8_URI = 'meguro://docs/index/v8';
+export const DOCUMENTATION_INDEX_V9_URI = 'meguro://docs/index/v9';
+export const DOCUMENTATION_INDEX_V10_URI = 'meguro://docs/index/v10';
+export const DOCUMENTATION_INDEX_V11_URI = 'meguro://docs/index/v11';
+export const DOCUMENTATION_INDEX_V12_URI = 'meguro://docs/index/v12';
+export const DOCUMENTATION_INDEX_V13_URI = 'meguro://docs/index/v13';
+export const DOCUMENTATION_INDEX_V14_URI = 'meguro://docs/index/v14';
+export const DOCUMENTATION_INDEX_V15_URI = 'meguro://docs/index/v15';
+export const DOCUMENTATION_INDEX_V16_URI = 'meguro://docs/index/v16';
+export const DOCUMENTATION_INDEX_V17_URI = 'meguro://docs/index/v17';
+export const DOCUMENTATION_INDEX_V18_URI = 'meguro://docs/index/v18';
+export const DOCUMENTATION_INDEX_V19_URI = 'meguro://docs/index/v19';
+export const DOCUMENTATION_INDEX_V20_URI = 'meguro://docs/index/v20';
+export const DOCUMENTATION_INDEX_V21_URI = 'meguro://docs/index/v21';
+export const DOCUMENTATION_INDEX_V22_URI = 'meguro://docs/index/v22';
+export const DOCUMENTATION_INDEX_V23_URI = 'meguro://docs/index/v23';
+export const DOCUMENTATION_INDEX_V24_URI = 'meguro://docs/index/v24';
+export const DOCUMENTATION_INDEX_V25_URI = 'meguro://docs/index/v25';
+export const DOCUMENTATION_INDEX_V26_URI = 'meguro://docs/index/v26';
+export const DOCUMENTATION_INDEX_V27_URI = 'meguro://docs/index/v27';
+export const DOCUMENTATION_INDEX_V28_URI = 'meguro://docs/index/v28';
+export const DOCUMENTATION_INDEX_V29_URI = 'meguro://docs/index/v29';
+export const DOCUMENTATION_INDEX_V30_URI = 'meguro://docs/index/v30';
+export const DOCUMENTATION_INDEX_V31_URI = 'meguro://docs/index/v31';
+export const DOCUMENTATION_INDEX_V32_URI = 'meguro://docs/index/v32';
+export const DOCUMENTATION_INDEX_V33_URI = 'meguro://docs/index/v33';
+export const DOCUMENTATION_INDEX_V34_URI = 'meguro://docs/index/v34';
+export const DOCUMENTATION_INDEX_V35_URI = 'meguro://docs/index/v35';
+export const DOCUMENTATION_INDEX_V36_URI = 'meguro://docs/index/v36';
+export const DOCUMENTATION_INDEX_V37_URI = 'meguro://docs/index/v37';
 
 const DOCUMENTATION_CURRENCY_V1 = deepFreeze({
   indexVersion: 1,
@@ -96,7 +281,357 @@ const DOCUMENTATION_CURRENCY_V4 = deepFreeze({
     'receipt-guide': RECEIPT_GUIDE_V7_URI,
   },
 });
-const CURRENT_DOCUMENTATION_CURRENCY = DOCUMENTATION_CURRENCY_V4;
+const DOCUMENTATION_CURRENCY_V5 = deepFreeze({
+  indexVersion: 5,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V3_URI,
+    'getting-started': GETTING_STARTED_V9_URI,
+    index: DOCUMENTATION_INDEX_V5_URI,
+    'product-guide': PRODUCT_GUIDE_V6_URI,
+    'receipt-guide': RECEIPT_GUIDE_V8_URI,
+  },
+});
+const DOCUMENTATION_CURRENCY_V6 = deepFreeze({
+  indexVersion: 6,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V3_URI,
+    'getting-started': GETTING_STARTED_V10_URI,
+    index: DOCUMENTATION_INDEX_V6_URI,
+    'product-guide': PRODUCT_GUIDE_V7_URI,
+    'receipt-guide': RECEIPT_GUIDE_V9_URI,
+  },
+});
+const DOCUMENTATION_CURRENCY_V7 = deepFreeze({
+  indexVersion: 7,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V3_URI,
+    'getting-started': GETTING_STARTED_V11_URI,
+    index: DOCUMENTATION_INDEX_V7_URI,
+    'product-guide': PRODUCT_GUIDE_V8_URI,
+    'receipt-guide': RECEIPT_GUIDE_V9_URI,
+  },
+});
+const DOCUMENTATION_CURRENCY_V8 = deepFreeze({
+  indexVersion: 8,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V3_URI,
+    'getting-started': GETTING_STARTED_V12_URI,
+    index: DOCUMENTATION_INDEX_V8_URI,
+    'product-guide': PRODUCT_GUIDE_V9_URI,
+    'receipt-guide': RECEIPT_GUIDE_V9_URI,
+  },
+});
+const DOCUMENTATION_CURRENCY_V9 = deepFreeze({
+  indexVersion: 9,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V3_URI,
+    'getting-started': GETTING_STARTED_V13_URI,
+    index: DOCUMENTATION_INDEX_V9_URI,
+    'product-guide': PRODUCT_GUIDE_V10_URI,
+    'receipt-guide': RECEIPT_GUIDE_V9_URI,
+  },
+});
+const DOCUMENTATION_CURRENCY_V10 = deepFreeze({
+  indexVersion: 10,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V3_URI,
+    'getting-started': GETTING_STARTED_V14_URI,
+    index: DOCUMENTATION_INDEX_V10_URI,
+    'product-guide': PRODUCT_GUIDE_V11_URI,
+    'receipt-guide': RECEIPT_GUIDE_V9_URI,
+  },
+});
+const DOCUMENTATION_CURRENCY_V11 = deepFreeze({
+  indexVersion: 11,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V3_URI,
+    'getting-started': GETTING_STARTED_V15_URI,
+    index: DOCUMENTATION_INDEX_V11_URI,
+    'product-guide': PRODUCT_GUIDE_V12_URI,
+    'receipt-guide': RECEIPT_GUIDE_V9_URI,
+  },
+});
+const DOCUMENTATION_CURRENCY_V12 = deepFreeze({
+  indexVersion: 12,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V3_URI,
+    'getting-started': GETTING_STARTED_V16_URI,
+    index: DOCUMENTATION_INDEX_V12_URI,
+    'product-guide': PRODUCT_GUIDE_V13_URI,
+    'receipt-guide': RECEIPT_GUIDE_V10_URI,
+  },
+});
+const DOCUMENTATION_CURRENCY_V13 = deepFreeze({
+  indexVersion: 13,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V3_URI,
+    'getting-started': GETTING_STARTED_V17_URI,
+    index: DOCUMENTATION_INDEX_V13_URI,
+    'product-guide': PRODUCT_GUIDE_V14_URI,
+    'receipt-guide': RECEIPT_GUIDE_V10_URI,
+  },
+});
+const DOCUMENTATION_CURRENCY_V14 = deepFreeze({
+  indexVersion: 14,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V3_URI,
+    'getting-started': GETTING_STARTED_V18_URI,
+    index: DOCUMENTATION_INDEX_V14_URI,
+    'product-guide': PRODUCT_GUIDE_V15_URI,
+    'receipt-guide': RECEIPT_GUIDE_V10_URI,
+  },
+});
+const DOCUMENTATION_CURRENCY_V15 = deepFreeze({
+  indexVersion: 15,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V3_URI,
+    'getting-started': GETTING_STARTED_V19_URI,
+    index: DOCUMENTATION_INDEX_V15_URI,
+    'product-guide': PRODUCT_GUIDE_V16_URI,
+    'receipt-guide': RECEIPT_GUIDE_V10_URI,
+  },
+});
+const DOCUMENTATION_CURRENCY_V16 = deepFreeze({
+  indexVersion: 16,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V3_URI,
+    'getting-started': GETTING_STARTED_V20_URI,
+    index: DOCUMENTATION_INDEX_V16_URI,
+    'product-guide': PRODUCT_GUIDE_V17_URI,
+    'receipt-guide': RECEIPT_GUIDE_V10_URI,
+  },
+});
+const DOCUMENTATION_CURRENCY_V17 = deepFreeze({
+  indexVersion: 17,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V3_URI,
+    'getting-started': GETTING_STARTED_V21_URI,
+    index: DOCUMENTATION_INDEX_V17_URI,
+    'product-guide': PRODUCT_GUIDE_V18_URI,
+    'receipt-guide': RECEIPT_GUIDE_V10_URI,
+  },
+});
+const DOCUMENTATION_CURRENCY_V18 = deepFreeze({
+  indexVersion: 18,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V3_URI,
+    'getting-started': GETTING_STARTED_V22_URI,
+    index: DOCUMENTATION_INDEX_V18_URI,
+    'product-guide': PRODUCT_GUIDE_V19_URI,
+    'receipt-guide': RECEIPT_GUIDE_V11_URI,
+  },
+});
+const DOCUMENTATION_CURRENCY_V19 = deepFreeze({
+  indexVersion: 19,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V3_URI,
+    'getting-started': GETTING_STARTED_V23_URI,
+    index: DOCUMENTATION_INDEX_V19_URI,
+    'product-guide': PRODUCT_GUIDE_V20_URI,
+    'receipt-guide': RECEIPT_GUIDE_V11_URI,
+  },
+});
+const DOCUMENTATION_CURRENCY_V20 = deepFreeze({
+  indexVersion: 20,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V3_URI,
+    'getting-started': GETTING_STARTED_V24_URI,
+    index: DOCUMENTATION_INDEX_V20_URI,
+    'product-guide': PRODUCT_GUIDE_V21_URI,
+    'receipt-guide': RECEIPT_GUIDE_V12_URI,
+  },
+});
+const DOCUMENTATION_CURRENCY_V21 = deepFreeze({
+  indexVersion: 21,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V3_URI,
+    'getting-started': GETTING_STARTED_V25_URI,
+    index: DOCUMENTATION_INDEX_V21_URI,
+    'product-guide': PRODUCT_GUIDE_V22_URI,
+    'receipt-guide': RECEIPT_GUIDE_V13_URI,
+  },
+});
+const DOCUMENTATION_CURRENCY_V22 = deepFreeze({
+  indexVersion: 22,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V3_URI,
+    'getting-started': GETTING_STARTED_V26_URI,
+    index: DOCUMENTATION_INDEX_V22_URI,
+    'product-guide': PRODUCT_GUIDE_V23_URI,
+    'receipt-guide': RECEIPT_GUIDE_V13_URI,
+  },
+});
+const DOCUMENTATION_CURRENCY_V23 = deepFreeze({
+  indexVersion: 23,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V4_URI,
+    'getting-started': GETTING_STARTED_V27_URI,
+    index: DOCUMENTATION_INDEX_V23_URI,
+    'product-guide': PRODUCT_GUIDE_V24_URI,
+    'receipt-guide': RECEIPT_GUIDE_V14_URI,
+  },
+});
+const DOCUMENTATION_CURRENCY_V24 = deepFreeze({
+  indexVersion: 24,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V4_URI,
+    'getting-started': GETTING_STARTED_V28_URI,
+    index: DOCUMENTATION_INDEX_V24_URI,
+    'product-guide': PRODUCT_GUIDE_V25_URI,
+    'receipt-guide': RECEIPT_GUIDE_V14_URI,
+  },
+});
+const DOCUMENTATION_CURRENCY_V25 = deepFreeze({
+  indexVersion: 25,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V4_URI,
+    'getting-started': GETTING_STARTED_V29_URI,
+    index: DOCUMENTATION_INDEX_V25_URI,
+    'product-guide': PRODUCT_GUIDE_V26_URI,
+    'receipt-guide': RECEIPT_GUIDE_V14_URI,
+  },
+});
+const DOCUMENTATION_CURRENCY_V26 = deepFreeze({
+  indexVersion: 26,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V4_URI,
+    'getting-started': GETTING_STARTED_V30_URI,
+    index: DOCUMENTATION_INDEX_V26_URI,
+    'product-guide': PRODUCT_GUIDE_V27_URI,
+    'receipt-guide': RECEIPT_GUIDE_V14_URI,
+  },
+});
+// MEG-880: one new current generation carrying the admitted-recipe facts. Prior generations keep
+// their exact bytes; guidance is never edited in place.
+const DOCUMENTATION_CURRENCY_V27 = deepFreeze({
+  indexVersion: 27,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V4_URI,
+    'getting-started': GETTING_STARTED_V31_URI,
+    index: DOCUMENTATION_INDEX_V27_URI,
+    'product-guide': PRODUCT_GUIDE_V28_URI,
+    'receipt-guide': RECEIPT_GUIDE_V14_URI,
+  },
+});
+// MEG-907: one new current generation carrying the ruled "When not to use Meguro" boundary.
+// Prior generations keep their exact bytes; the section is minted, never edited in place.
+const DOCUMENTATION_CURRENCY_V28 = deepFreeze({
+  indexVersion: 28,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V4_URI,
+    'getting-started': GETTING_STARTED_V32_URI,
+    index: DOCUMENTATION_INDEX_V28_URI,
+    'product-guide': PRODUCT_GUIDE_V29_URI,
+    'receipt-guide': RECEIPT_GUIDE_V14_URI,
+  },
+});
+// MEG-1034: one new current generation publishing the v1 served/internal-only/deferred vertical
+// boundary. Prior generations keep their exact bytes; the boundary is minted, never edited in place.
+const DOCUMENTATION_CURRENCY_V29 = deepFreeze({
+  indexVersion: 29,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V4_URI,
+    'getting-started': GETTING_STARTED_V33_URI,
+    index: DOCUMENTATION_INDEX_V29_URI,
+    'product-guide': PRODUCT_GUIDE_V30_URI,
+    'receipt-guide': RECEIPT_GUIDE_V15_URI,
+  },
+});
+// MEG-1058: one new current generation publishing the template delivery tier — templates_list is
+// the compact catalog and template_get is the authoritative detail hop. Prior generations keep
+// their exact bytes; the new sequence is minted, never edited in place.
+const DOCUMENTATION_CURRENCY_V30 = deepFreeze({
+  indexVersion: 30,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V4_URI,
+    'getting-started': GETTING_STARTED_V34_URI,
+    index: DOCUMENTATION_INDEX_V30_URI,
+    'product-guide': PRODUCT_GUIDE_V31_URI,
+    'receipt-guide': RECEIPT_GUIDE_V15_URI,
+  },
+});
+// MEG-1065: the public run-receipt Markdown representation is already immutable at issuance;
+// publish that in-band contract as one new current generation without rewriting prior guidance.
+const DOCUMENTATION_CURRENCY_V31 = deepFreeze({
+  indexVersion: 31,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V4_URI,
+    'getting-started': GETTING_STARTED_V34_URI,
+    index: DOCUMENTATION_INDEX_V31_URI,
+    'product-guide': PRODUCT_GUIDE_V31_URI,
+    'receipt-guide': RECEIPT_GUIDE_V16_URI,
+  },
+});
+// MEG-967: the winback operating cost is published under its corrected name.
+const DOCUMENTATION_CURRENCY_V32 = deepFreeze({
+  indexVersion: 32,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V4_URI,
+    'getting-started': GETTING_STARTED_V34_URI,
+    index: DOCUMENTATION_INDEX_V32_URI,
+    'product-guide': PRODUCT_GUIDE_V31_URI,
+    'receipt-guide': RECEIPT_GUIDE_V17_URI,
+  },
+});
+// MEG-1074: publish canonical MCP request forms without rewriting historical guidance.
+const DOCUMENTATION_CURRENCY_V33 = deepFreeze({
+  indexVersion: 33,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V4_URI,
+    'getting-started': GETTING_STARTED_V35_URI,
+    index: DOCUMENTATION_INDEX_V33_URI,
+    'product-guide': PRODUCT_GUIDE_V32_URI,
+    'receipt-guide': RECEIPT_GUIDE_V17_URI,
+  },
+});
+// MEG-1107: mint one internally consistent current generation. The prior product guide and Gate
+// policy each carried stale current-version pointers; every prior resource keeps its exact bytes.
+const DOCUMENTATION_CURRENCY_V34 = deepFreeze({
+  indexVersion: 34,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V5_URI,
+    'getting-started': GETTING_STARTED_V36_URI,
+    index: DOCUMENTATION_INDEX_V34_URI,
+    'product-guide': PRODUCT_GUIDE_V33_URI,
+    'receipt-guide': RECEIPT_GUIDE_V17_URI,
+  },
+});
+// MEG-1129: publish a coherent successor after correcting only Getting Started's canonical
+// discovery-first ordinals. Product Guide and index advance together so all current pointers agree.
+const DOCUMENTATION_CURRENCY_V35 = deepFreeze({
+  indexVersion: 35,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V5_URI,
+    'getting-started': GETTING_STARTED_V37_URI,
+    index: DOCUMENTATION_INDEX_V35_URI,
+    'product-guide': PRODUCT_GUIDE_V34_URI,
+    'receipt-guide': RECEIPT_GUIDE_V17_URI,
+  },
+});
+// MEG-1204: publish one truthful generation. The Gate check is renamed for the only fact it
+// decides on, the mutable Gate-absence claim leaves every current document, and the receipt guide's
+// generated list is republished as an honest field index. Every prior resource keeps its bytes.
+const DOCUMENTATION_CURRENCY_V36 = deepFreeze({
+  indexVersion: 36,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V6_URI,
+    'getting-started': GETTING_STARTED_V38_URI,
+    index: DOCUMENTATION_INDEX_V36_URI,
+    'product-guide': PRODUCT_GUIDE_V35_URI,
+    'receipt-guide': RECEIPT_GUIDE_V18_URI,
+  },
+});
+const DOCUMENTATION_CURRENCY_V37 = deepFreeze({
+  indexVersion: 37,
+  currentUriByTopic: {
+    'gate-policy': GATE_POLICY_V6_URI,
+    'getting-started': GETTING_STARTED_V39_URI,
+    index: DOCUMENTATION_INDEX_V37_URI,
+    'product-guide': PRODUCT_GUIDE_V36_URI,
+    'receipt-guide': RECEIPT_GUIDE_V18_URI,
+  },
+});
+const CURRENT_DOCUMENTATION_CURRENCY = DOCUMENTATION_CURRENCY_V37;
 
 function documentationVersionFromUri(uri) {
   const match = /\/v([1-9][0-9]*)$/u.exec(uri);
@@ -125,7 +660,30 @@ const CURRENT_PRODUCT_GUIDE_URI = CURRENT_DOCUMENTATION_CURRENCY.currentUriByTop
 const CURRENT_RECEIPT_GUIDE_URI = CURRENT_DOCUMENTATION_CURRENCY.currentUriByTopic['receipt-guide'];
 const CURRENT_GATE_POLICY_URI = CURRENT_DOCUMENTATION_CURRENCY.currentUriByTopic['gate-policy'];
 const CURRENT_INDEX_URI = CURRENT_DOCUMENTATION_CURRENCY.currentUriByTopic.index;
-export const MCP_INITIALIZE_INSTRUCTIONS = `Start with \`${CURRENT_GETTING_STARTED_URI}\` or call \`docs_read({ topic: "getting-started", version: ${documentationVersionFromUri(CURRENT_GETTING_STARTED_URI)} })\`; for general Meguro questions, read \`${CURRENT_PRODUCT_GUIDE_URI}\` or call \`docs_read({ topic: "product-guide", version: ${documentationVersionFromUri(CURRENT_PRODUCT_GUIDE_URI)} })\`; distinguish the documentation resource version in each \`meguro://docs/.../vN\` URI, the runtime Gate policy contract \`meguro.release-gate-policy.v1\` version 1, and the requested Shopify Admin API version from ${ADMIN_API_SUPPORTED_VERSIONS.map((version) => `\`${version}\``).join(' or ')} with default \`${ADMIN_API_DEFAULT_VERSION}\`.`;
+const MCP_ZERO_PRIOR_KNOWLEDGE_INTRO = `Meguro is a rehearsal and technical-evaluation environment for commerce agents. A practice store is an isolated commerce model that never touches a live store. Store time is its simulated clock. A run is a bounded evaluation that advances Store time. A receipt is the record of the calls, changes, and evidence Meguro captured. This connection lets you discover or create a practice store, run an evaluation, and inspect its receipt. These are rehearsal results, not forecasts, certifications, or proof of live performance.`;
+const MCP_INITIALIZE_DOCUMENTATION_INSTRUCTIONS = `${MCP_ZERO_PRIOR_KNOWLEDGE_INTRO} Start with \`${CURRENT_GETTING_STARTED_URI}\` or call \`docs_read({ topic: "getting-started", version: ${documentationVersionFromUri(CURRENT_GETTING_STARTED_URI)} })\`; for general Meguro questions, read \`${CURRENT_PRODUCT_GUIDE_URI}\` or call \`docs_read({ topic: "product-guide", version: ${documentationVersionFromUri(CURRENT_PRODUCT_GUIDE_URI)} })\`. Every receipt carries automatic Recorded API behavior under the Default run policy; Configured Receipt Gate is a separate optional configured policy. Distinguish the documentation resource version in each \`meguro://docs/.../vN\` URI, the runtime Gate policy contract \`meguro.release-gate-policy.v1\` version 1, and the requested Shopify Admin API version from ${ADMIN_API_SUPPORTED_VERSIONS.map((version) => `\`${version}\``).join(' or ')} with default \`${ADMIN_API_DEFAULT_VERSION}\`.`;
+
+function configuredDashboardOrigin(dashboardUrl) {
+  const configured = String(dashboardUrl ?? '').trim();
+  if (!configured) return null;
+  try {
+    const parsed = new URL(configured);
+    if (!['http:', 'https:'].includes(parsed.protocol) || parsed.username || parsed.password) return null;
+    return parsed.origin;
+  } catch {
+    return null;
+  }
+}
+
+export function mcpInitializeInstructions(dashboardUrl) {
+  const origin = configuredDashboardOrigin(dashboardUrl);
+  if (!origin) return MCP_INITIALIZE_DOCUMENTATION_INSTRUCTIONS;
+  const accountEntry = `${origin}/`;
+  const authorizationManagement = `${origin}/#settings?section=connection`;
+  return `${MCP_INITIALIZE_DOCUMENTATION_INSTRUCTIONS} Human setup: open \`${accountEntry}\` to sign in or create an account, then approve browser consent. Meguro's server grant and the MCP client's local connection/token state are separate. Open \`${authorizationManagement}\` to revoke server refresh access or reconnect; reconnecting creates a fresh grant, and Console cannot erase client-local state.`;
+}
+
+export const MCP_INITIALIZE_INSTRUCTIONS = mcpInitializeInstructions();
 export const PRODUCT_GUIDE_SHA256 = 'e5450c1b4181cec4d6ed0a498dbff1cb25d2e223ff2228928aecbbce9674f074';
 
 function deepFreeze(value) {
@@ -725,6 +1283,135 @@ const RECEIPT_FIELDS_V7 = deepFreeze({
   ]),
 });
 
+const RECEIPT_FIELDS_V8 = deepFreeze({
+  ...RECEIPT_FIELDS_V7,
+  'meguro.shared-receipt.v2': stableFields([
+    ...RECEIPT_FIELDS_V7['meguro.shared-receipt.v2'],
+    'resultSemantics',
+  ]),
+  'meguro.run-result-semantics.v1': stableFields([
+    'evidenceAssertions.basis',
+    'evidenceAssertions.coverage.failed',
+    'evidenceAssertions.coverage.notExercised',
+    'evidenceAssertions.coverage.passed',
+    'evidenceAssertions.coverage.total',
+    'evidenceAssertions.coverage.unavailable',
+    'evidenceAssertions.namedFailures[].detail',
+    'evidenceAssertions.namedFailures[].family',
+    'evidenceAssertions.namedFailures[].id',
+    'evidenceAssertions.namedFailures[].label',
+    'evidenceAssertions.semanticDomain',
+    'evidenceAssertions.status',
+    'interpretation',
+    'legacyFieldGuidance.fields[]',
+    'legacyFieldGuidance.instruction',
+    'lifecycle.meaning',
+    'lifecycle.semanticDomain',
+    'lifecycle.sourceStatus',
+    'lifecycle.status',
+    'modeledScenarioOutcome.availability',
+    'modeledScenarioOutcome.evidenceBoundary',
+    'modeledScenarioOutcome.reason',
+    'modeledScenarioOutcome.semanticDomain',
+    'modeledScenarioOutcome.statement',
+    'modeledScenarioOutcome.status',
+    'modeledScenarioOutcome.value.basis',
+    'modeledScenarioOutcome.value.netContributionCents',
+    'modeledScenarioOutcome.value.netRevenueCents',
+    'modeledScenarioOutcome.disclosure',
+    'schemaVersion',
+    'technicalPolicyVerdict.basis',
+    'technicalPolicyVerdict.policyName',
+    'technicalPolicyVerdict.replaceableDefault',
+    'technicalPolicyVerdict.semanticDomain',
+    'technicalPolicyVerdict.status',
+  ]),
+});
+
+const RECEIPT_FIELDS_V9 = deepFreeze({
+  ...RECEIPT_FIELDS_V8,
+  'meguro.shared-receipt.v2': stableFields([
+    ...RECEIPT_FIELDS_V8['meguro.shared-receipt.v2'],
+    'expectedRefusals.assertions[].assertionKey',
+    'expectedRefusals.assertions[].callSequences[]',
+    'expectedRefusals.assertions[].correctionObserved',
+    'expectedRefusals.assertions[].detail',
+    'expectedRefusals.assertions[].operationName',
+    'expectedRefusals.assertions[].status',
+    'expectedRefusals.handledRejectedCallSequences[]',
+    'expectedRefusals.schemaVersion',
+    'expectedRefusals.summary.failed',
+    'expectedRefusals.summary.matched',
+    'expectedRefusals.summary.total',
+  ]),
+});
+
+const RECEIPT_FIELDS_V10 = deepFreeze({
+  ...RECEIPT_FIELDS_V9,
+  'meguro.shared-receipt.v2': stableFields([
+    ...RECEIPT_FIELDS_V9['meguro.shared-receipt.v2'],
+    'counts.acceptedMutationCalls',
+    'counts.appliedCommerceActions',
+    'counts.idempotentReplays',
+    'counts.rejectedMutationCalls',
+  ]),
+  'meguro.hosted-impact-report.v1': stableFields([
+    ...RECEIPT_FIELDS_V9['meguro.hosted-impact-report.v1'],
+    'footprint.acceptedMutationCalls',
+    'footprint.appliedCommerceActions',
+    'footprint.idempotentReplays',
+    'footprint.rejectedMutationCalls',
+  ]),
+});
+
+const RECEIPT_FIELDS_V11 = deepFreeze({
+  ...RECEIPT_FIELDS_V10,
+  'meguro.shared-receipt.v2': stableFields([
+    ...RECEIPT_FIELDS_V10['meguro.shared-receipt.v2'],
+    'changes[].delta',
+    'changes[].entityType',
+    'changes[].epistemic',
+    'changes[].source',
+    'changes[].unit',
+  ]),
+});
+
+const TEMPLATE_EVENT_RESOLUTION_FIELDS = Object.freeze([
+  'eventResolution.classification',
+  'eventResolution.evaluationHorizonDays',
+  'eventResolution.eventWindow.basis',
+  'eventResolution.eventWindow.endDay',
+  'eventResolution.eventWindow.key',
+  'eventResolution.eventWindow.label',
+  'eventResolution.eventWindow.startDay',
+  'eventResolution.measuredHorizon.basis',
+  'eventResolution.measuredHorizon.measuredDays',
+  'eventResolution.measuredHorizon.plannedDays',
+  'eventResolution.measuredHorizon.ranToPlannedEnd',
+  'eventResolution.measuredHorizon.worldDays.fromDay',
+  'eventResolution.measuredHorizon.worldDays.plannedToDay',
+  'eventResolution.measuredHorizon.worldDays.toDay',
+  'eventResolution.reason',
+  'eventResolution.schemaVersion',
+  'eventResolution.source.templateKey',
+  'eventResolution.source.templateLabel',
+  'eventResolution.source.templateRevision',
+  'eventResolution.status',
+]);
+
+const RECEIPT_FIELDS_V13 = deepFreeze({
+  ...RECEIPT_FIELDS_V11,
+  'meguro.shared-receipt.v2': stableFields([
+    ...RECEIPT_FIELDS_V11['meguro.shared-receipt.v2'],
+    ...TEMPLATE_EVENT_RESOLUTION_FIELDS,
+  ]),
+  'meguro.hosted-impact-report.v1': stableFields([
+    ...RECEIPT_FIELDS_V11['meguro.hosted-impact-report.v1']
+      .filter((field) => !field.startsWith('eventResolution.events[]')),
+    ...TEMPLATE_EVENT_RESOLUTION_FIELDS,
+  ]),
+});
+
 const FIELD_MEANINGS = Object.freeze({
   schemaVersion: 'Selects the immutable wire contract used to interpret the remaining fields.',
   evidenceContext: 'Carries the declared subject, attempt history, and world provenance without verifying a customer-declared build identity.',
@@ -976,6 +1663,20 @@ export const GATE_POLICY_V3_CHECKS = deepFreeze(GATE_POLICY_V1_CHECKS.map((check
   flip: absoluteGateVerdictFactText(check.flip),
 })));
 
+// MEG-1204: the first check's only policy input, citation, threshold, and flip basis is
+// `facts.summary.failed`. Naming it for blocked writes and errors claimed two evidence kinds the
+// policy never reads; `facts.rows[].rejectedCalls` corroborates a failing row without deciding it.
+// Documentation versions 1 through 5 keep their original bytes under the earlier name.
+export const GATE_POLICY_V6_CHECKS = deepFreeze(GATE_POLICY_V3_CHECKS.map((check) => (
+  check.name === 'blocked-write and error evidence'
+    ? {
+      ...check,
+      name: 'failing receipt evidence',
+      flip: 'a no-go flips only when later immutable receipt evidence establishes no failing receipt row, making facts.summary.failed = 0',
+    }
+    : { ...check }
+)));
+
 const GATE_POLICY_TEXT = `# Meguro Gate policy v1
 
 Published URI: \`${GATE_POLICY_URI}\`
@@ -1343,29 +2044,40 @@ ${REAL_STORE_HISTORY_LANE_BRIDGE}`,
     '| 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 CURRENT_VERSION_LABELS_TEXT = `## Three different version labels
+function versionLabelsText(currency) {
+  const indexUri = currency.currentUriByTopic.index;
+  const gatePolicyUri = currency.currentUriByTopic['gate-policy'];
+  return `## Three different version labels
 
 - **Documentation resource version:** the trailing \`vN\` in an immutable \`meguro://docs/.../vN\`
-  URI identifies that document's bytes. Read \`${CURRENT_INDEX_URI}\` for the current resource URI in
+  URI identifies that document's bytes. Read \`${indexUri}\` for the current resource URI in
   every documentation family.
 - **Runtime Gate policy contract version:** \`meguro.release-gate-policy.v1\`, version \`1\`, identifies
   the policy evaluated against receipt facts. The current explanatory documentation for that contract
-  is \`${CURRENT_GATE_POLICY_URI}\`; its documentation resource version is a separate number.
+  is \`${gatePolicyUri}\`; its documentation resource version is a separate number.
 - **Requested Shopify Admin API version:** the version segment in an Admin request selects one of
   ${ADMIN_API_SUPPORTED_VERSIONS.map((version) => `\`${version}\``).join(' or ')}. The current default is
   \`${ADMIN_API_DEFAULT_VERSION}\`; a caller may still request a supported non-default version, and the
   resulting plan and evidence retain that requested value.`;
-const CURRENT_DEEPER_DOCUMENTATION_TEXT = `## Deeper in-band documentation
-
-- Receipt interpretation: read \`${CURRENT_RECEIPT_GUIDE_URI}\` or call
-  \`docs_read({ topic: "receipt-guide", version: ${documentationVersionFromUri(CURRENT_RECEIPT_GUIDE_URI)} })\`.
-- Gate policy: read \`${CURRENT_GATE_POLICY_URI}\` or call
-  \`docs_read({ topic: "gate-policy", version: ${documentationVersionFromUri(CURRENT_GATE_POLICY_URI)} })\`.
-- Current-document pointers: read \`${CURRENT_INDEX_URI}\` or call
-  \`docs_read({ topic: "index", version: ${documentationVersionFromUri(CURRENT_INDEX_URI)} })\`.
+}
+function deeperDocumentationText(currency) {
+  const receiptGuideUri = currency.currentUriByTopic['receipt-guide'];
+  const gatePolicyUri = currency.currentUriByTopic['gate-policy'];
+  const indexUri = currency.currentUriByTopic.index;
+  return `## Deeper in-band documentation
+
+- Receipt interpretation: read \`${receiptGuideUri}\` or call
+  \`docs_read({ topic: "receipt-guide", version: ${documentationVersionFromUri(receiptGuideUri)} })\`.
+- Gate policy: read \`${gatePolicyUri}\` or call
+  \`docs_read({ topic: "gate-policy", version: ${documentationVersionFromUri(gatePolicyUri)} })\`.
+- Current-document pointers: read \`${indexUri}\` or call
+  \`docs_read({ topic: "index", version: ${documentationVersionFromUri(indexUri)} })\`.
 
 All published documentation resources are immutable. Cite the exact URI, version, and SHA-256
 digest returned by Meguro.`;
+}
+const DOCUMENTATION_V4_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V4);
+const DOCUMENTATION_V4_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V4);
 const GETTING_STARTED_V7_DEEPER_DOCUMENTATION_TEXT = `## Deeper in-band documentation
 
 - Receipt interpretation: read \`${RECEIPT_GUIDE_URI}\` or
@@ -1404,8 +2116,8 @@ is absent when an effect-level action is declared.`;
 const GETTING_STARTED_V8_TEXT = GETTING_STARTED_V7_TEXT
   .replace('# Getting started with Meguro v7', '# Getting started with Meguro v8')
   .replace(`Published URI: \`${GETTING_STARTED_V7_URI}\``, `Published URI: \`${GETTING_STARTED_V8_URI}\``)
-  .replace(GETTING_STARTED_V7_DEEPER_DOCUMENTATION_TEXT, CURRENT_DEEPER_DOCUMENTATION_TEXT)
-  .replace('## Control and data planes', `${CURRENT_VERSION_LABELS_TEXT}\n\n## Control and data planes`)
+  .replace(GETTING_STARTED_V7_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V4_DEEPER_DOCUMENTATION_TEXT)
+  .replace('## Control and data planes', `${DOCUMENTATION_V4_VERSION_LABELS_TEXT}\n\n## Control and data planes`)
   .replace('## Deeper in-band documentation', `${CIMD_TROUBLESHOOTING_TEXT}\n\n## Deeper in-band documentation`);
 const PRODUCT_GUIDE_V5_TEXT = PRODUCT_GUIDE_V4_TEXT
   .replace('# Meguro product guide v4', '# Meguro product guide v5')
@@ -1413,16 +2125,886 @@ const PRODUCT_GUIDE_V5_TEXT = PRODUCT_GUIDE_V4_TEXT
   .replace(
     `read
   \`${RECEIPT_GUIDE_URI}\` or \`${RECEIPT_GUIDE_V2_URI}\`.`,
-    `read \`${CURRENT_RECEIPT_GUIDE_URI}\`.`,
+    `read \`${DOCUMENTATION_CURRENCY_V4.currentUriByTopic['receipt-guide']}\`.`,
   )
-  .replaceAll(RECEIPT_GUIDE_URI, CURRENT_RECEIPT_GUIDE_URI)
-  .replaceAll(RECEIPT_GUIDE_V2_URI, CURRENT_RECEIPT_GUIDE_URI)
-  .replaceAll(GATE_POLICY_V2_URI, CURRENT_GATE_POLICY_URI)
-  .replaceAll(GETTING_STARTED_V7_URI, CURRENT_GETTING_STARTED_URI)
+  .replaceAll(RECEIPT_GUIDE_URI, DOCUMENTATION_CURRENCY_V4.currentUriByTopic['receipt-guide'])
+  .replaceAll(RECEIPT_GUIDE_V2_URI, DOCUMENTATION_CURRENCY_V4.currentUriByTopic['receipt-guide'])
+  .replaceAll(GATE_POLICY_V2_URI, DOCUMENTATION_CURRENCY_V4.currentUriByTopic['gate-policy'])
+  .replaceAll(GETTING_STARTED_V7_URI, DOCUMENTATION_CURRENCY_V4.currentUriByTopic['getting-started'])
   .replace(
     '## Stable concepts versus changing facts',
-    `${CURRENT_VERSION_LABELS_TEXT}\n\n${ASSERTION_FAMILY_EXERCISE_TEXT}\n\n${CHANNEL_ABSTRACTION_TEXT}\n\n## Stable concepts versus changing facts`,
+    `${DOCUMENTATION_V4_VERSION_LABELS_TEXT}\n\n${ASSERTION_FAMILY_EXERCISE_TEXT}\n\n${CHANNEL_ABSTRACTION_TEXT}\n\n## Stable concepts versus changing facts`,
+  );
+const RUN_RESULT_DIMENSIONS_GUIDANCE_TEXT = `## Four independent run-result dimensions
+
+Read \`resultSemantics\` as four independent answers. There is no overall run status, and one
+dimension never changes the meaning of another:
+
+1. \`lifecycle\` says whether the run prepared, ran, completed, failed, or expired.
+2. \`evidenceAssertions\` reports the bounded named assertions that passed, failed, or were not
+   available; read \`coverage\` and \`namedFailures\` for the exact scope.
+3. \`technicalPolicyVerdict\` reports the replaceable technical policy applied to the recorded
+   evidence. It is not the modeled economic result or a release decision.
+4. \`modeledScenarioOutcome\` reports the treated-minus-untreated comparison inside Meguro's
+   declared practice-world assumptions. Present its supplied \`statement\` unchanged—for example,
+   “Modeled scenario outcome: net contribution was +$327.60 versus the untreated reference world.”
+
+Never describe \`modeledScenarioOutcome\` as EARNED, COST, successful, passed, or failed. It is not
+a compatibility, Gate, release-safety, live-market, merchant-result, or future-performance claim.
+Unknown or unavailable dimensions stay explicit; do not infer them from another dimension.
+
+The older \`summary.status\`, \`defaultVerdict.status\`, \`verdict\`, and
+\`measurement.headline\` fields remain only for wire compatibility. Do not use those legacy fields
+as an overall result or as current language for an agent, customer, or generated headline.`;
+const EXPECTED_REFUSAL_GUIDANCE_TEXT = `## Expected-refusal assertions
+
+An expected refusal changes classification only when the authenticated run owner records an exact
+assertion plan before the relevant call. Each declaration binds the run, store, attempt, raw
+call-sequence boundary, exact mutation operation, optional target or request fingerprint,
+allowlisted rejection reason, responsible layer, and attempt budget. Documentation prose,
+operation naming, a generic error class, or a later explanation never declares intent.
+
+Read the server-emitted \`expectedRefusals.assertions[]\` result; do not infer a second result in a
+client or renderer. A \`matched\` refusal remains a rejected call in the raw ledger, footprint, and
+timeline, while \`handledRejectedCallSequences[]\` records why the technical default and Gate do not
+count it as an unhandled rejection. \`unexpectedly-accepted\`, \`wrong-reason\`, \`wrong-layer\`,
+\`missing\`, \`excess-attempts\`, and \`invalid-late-declaration\` fail the assertion. An undeclared
+rejection keeps its existing unhandled behavior.`;
+const DOCUMENTATION_V5_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V5);
+const DOCUMENTATION_V5_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V5);
+const GETTING_STARTED_V9_TEXT = GETTING_STARTED_V8_TEXT
+  .replace('# Getting started with Meguro v8', '# Getting started with Meguro v9')
+  .replace(`Published URI: \`${GETTING_STARTED_V8_URI}\``, `Published URI: \`${GETTING_STARTED_V9_URI}\``)
+  .replace(DOCUMENTATION_V4_VERSION_LABELS_TEXT, DOCUMENTATION_V5_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V4_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V5_DEEPER_DOCUMENTATION_TEXT)
+  .replace('## Deeper in-band documentation', `${RUN_RESULT_DIMENSIONS_GUIDANCE_TEXT}\n\n## Deeper in-band documentation`);
+const PRODUCT_GUIDE_V6_TEXT = PRODUCT_GUIDE_V5_TEXT
+  .replace('# Meguro product guide v5', '# Meguro product guide v6')
+  .replace(`Published URI: \`${PRODUCT_GUIDE_V5_URI}\``, `Published URI: \`${PRODUCT_GUIDE_V6_URI}\``)
+  .replace(DOCUMENTATION_V4_VERSION_LABELS_TEXT, DOCUMENTATION_V5_VERSION_LABELS_TEXT)
+  .replaceAll(RECEIPT_GUIDE_V7_URI, RECEIPT_GUIDE_V8_URI)
+  .replaceAll(GETTING_STARTED_V8_URI, GETTING_STARTED_V9_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V4_URI, DOCUMENTATION_INDEX_V5_URI)
+  .replace('## Stable concepts versus changing facts', `${RUN_RESULT_DIMENSIONS_GUIDANCE_TEXT}\n\n## Stable concepts versus changing facts`);
+const DOCUMENTATION_V6_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V6);
+const DOCUMENTATION_V6_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V6);
+const GETTING_STARTED_V10_TEXT = GETTING_STARTED_V9_TEXT
+  .replace('# Getting started with Meguro v9', '# Getting started with Meguro v10')
+  .replace(`Published URI: \`${GETTING_STARTED_V9_URI}\``, `Published URI: \`${GETTING_STARTED_V10_URI}\``)
+  .replace(DOCUMENTATION_V5_VERSION_LABELS_TEXT, DOCUMENTATION_V6_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V5_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V6_DEEPER_DOCUMENTATION_TEXT)
+  .replace('## Deeper in-band documentation', `${EXPECTED_REFUSAL_GUIDANCE_TEXT}\n\n## Deeper in-band documentation`);
+const PRODUCT_GUIDE_V7_TEXT = PRODUCT_GUIDE_V6_TEXT
+  .replace('# Meguro product guide v6', '# Meguro product guide v7')
+  .replace(`Published URI: \`${PRODUCT_GUIDE_V6_URI}\``, `Published URI: \`${PRODUCT_GUIDE_V7_URI}\``)
+  .replace(DOCUMENTATION_V5_VERSION_LABELS_TEXT, DOCUMENTATION_V6_VERSION_LABELS_TEXT)
+  .replaceAll(RECEIPT_GUIDE_V8_URI, RECEIPT_GUIDE_V9_URI)
+  .replaceAll(GETTING_STARTED_V9_URI, GETTING_STARTED_V10_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V5_URI, DOCUMENTATION_INDEX_V6_URI)
+  .replace('## Stable concepts versus changing facts', `${EXPECTED_REFUSAL_GUIDANCE_TEXT}\n\n## Stable concepts versus changing facts`);
+const PER_STORE_HISTORY_GUIDANCE_TEXT = `## Begin with live store facts
+
+Each practice store's history span is a live per-store fact. Before choosing a run, call
+\`stores_list({})\` and read \`stores[].historySpan.days\` on the selected row. For the exact Store Passport,
+call \`store_passport({ storeId })\` and read \`historySpan.historyDays\`. A finished receipt carries
+the run's starting provenance at \`worldProvenance.warmupSpan.days\`. Use the exact live value for
+the selected store; never infer history from a template name, store label, tier, or another store.
+
+An ordinary newly created practice store from \`store_create\` currently begins with zero history.
+Zero history is a planning fact, not a defect: choose a scenario that does not require pre-existing
+events, or select a store whose live provenance reports enough history for the intended evaluation.
+The server-owned seeded sample is a distinct provisioning lane and currently reports 90 days. That
+is today's sample fact, not a universal promise: never assume a future sample has 90 days; read its
+live provenance.
+
+A tier \`historyDays\` value does not authorize nonzero warmup for an ordinary store. Ordinary-store
+warmup remains unchanged and requires a separate founder-signed amendment.
+
+When a run drives or schedules Store time, the selected store moves through Store days; between runs,
+its Store time stays frozen. The receipt is the store's memory of that run: recorded API behavior,
+accepted and rejected changes, and the bounded evidence earned inside the declared world.
+
+Practice results do not prove live-market demand, future revenue, production performance, or live
+Shopify acceptance. Live-platform claims require the relevant real-platform or Shopify Exam evidence;
+never infer them from practice compatibility or modeled outcomes.`;
+const DOCUMENTATION_V7_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V7);
+const DOCUMENTATION_V7_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V7);
+const GETTING_STARTED_V11_TEXT = GETTING_STARTED_V10_TEXT
+  .replace('# Getting started with Meguro v10', '# Getting started with Meguro v11')
+  .replace(`Published URI: \`${GETTING_STARTED_V10_URI}\``, `Published URI: \`${GETTING_STARTED_V11_URI}\``)
+  .replace(DOCUMENTATION_V6_VERSION_LABELS_TEXT, DOCUMENTATION_V7_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V6_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V7_DEEPER_DOCUMENTATION_TEXT)
+  .replace(/## Begin with the world\n\n[\s\S]*?\n\n## Identities/u, `${PER_STORE_HISTORY_GUIDANCE_TEXT}\n\n## Identities`)
+  .replace(
+    `2. Call \`stores_list()\`; reuse an owned practice store or call
+   \`store_create({ templateKey })\` with a key returned by \`templates_list\`.`,
+    `2. Call \`stores_list()\`; reuse an owned practice store or call
+   \`store_create({ templateKey })\` with a key returned by \`templates_list\`. Before choosing a run,
+   read \`stores[].historySpan.days\` on the selected row; when you need the exact passport value, call
+   \`store_passport({ storeId })\` and read \`historySpan.historyDays\`.`,
+  );
+const ADMIN_RECIPE_DISCOVERY_GUIDANCE_TEXT = `## Discover Admin recipes before lookup
+
+Call \`admin_recipes_list({})\` to enumerate every canonical Admin recipe before choosing one. Each row
+contains a stable \`id\`, operation name, purpose, confirmation requirement, and authored aliases and
+keywords. Then call \`admin_schema({ lookup: "recipe", name: "<id>" })\` with the selected stable id.
+
+If \`admin_schema\` returns a recipe miss, follow its bounded \`teaching.nextCall\` exactly. The teaching
+payload contains only canonical recipe ids and authored aliases or keywords; it never guesses a semantic
+match or runs \`admin_probe\`.`;
+const DOCUMENTATION_V8_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V8);
+const DOCUMENTATION_V8_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V8);
+const GETTING_STARTED_V12_TEXT = GETTING_STARTED_V11_TEXT
+  .replace('# Getting started with Meguro v11', '# Getting started with Meguro v12')
+  .replace(`Published URI: \`${GETTING_STARTED_V11_URI}\``, `Published URI: \`${GETTING_STARTED_V12_URI}\``)
+  .replace(DOCUMENTATION_V7_VERSION_LABELS_TEXT, DOCUMENTATION_V8_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V7_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V8_DEEPER_DOCUMENTATION_TEXT)
+  .replace('## Identities', `${ADMIN_RECIPE_DISCOVERY_GUIDANCE_TEXT}\n\n## Identities`);
+const PRODUCT_GUIDE_V8_TEXT = PRODUCT_GUIDE_V7_TEXT
+  .replace('# Meguro product guide v7', '# Meguro product guide v8')
+  .replace(`Published URI: \`${PRODUCT_GUIDE_V7_URI}\``, `Published URI: \`${PRODUCT_GUIDE_V8_URI}\``)
+  .replace(DOCUMENTATION_V6_VERSION_LABELS_TEXT, DOCUMENTATION_V7_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V10_URI, GETTING_STARTED_V11_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V6_URI, DOCUMENTATION_INDEX_V7_URI)
+  .replace(/## Begin with the world\n\n[\s\S]*?\n\n## Core nouns/u, `${PER_STORE_HISTORY_GUIDANCE_TEXT}\n\n## Core nouns`)
+  .replace(
+    '| What stores exist? | Call \`stores_list\`. |',
+    `| What stores exist? | Call \`stores_list\`. |
+| How much history does this store have? | Before selecting a run, read \`stores[].historySpan.days\` from \`stores_list\`, or call \`store_passport({ storeId })\` and read \`historySpan.historyDays\`; use receipt \`worldProvenance.warmupSpan.days\` for the run's recorded starting provenance. |`,
+  );
+const PRODUCT_GUIDE_V9_TEXT = PRODUCT_GUIDE_V8_TEXT
+  .replace('# Meguro product guide v8', '# Meguro product guide v9')
+  .replace(`Published URI: \`${PRODUCT_GUIDE_V8_URI}\``, `Published URI: \`${PRODUCT_GUIDE_V9_URI}\``)
+  .replace(DOCUMENTATION_V7_VERSION_LABELS_TEXT, DOCUMENTATION_V8_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V11_URI, GETTING_STARTED_V12_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V7_URI, DOCUMENTATION_INDEX_V8_URI)
+  .replace('## Core nouns', `${ADMIN_RECIPE_DISCOVERY_GUIDANCE_TEXT}\n\n## Core nouns`);
+const ADMIN_EXECUTION_PREFLIGHT_GUIDANCE_TEXT = `## Execute Admin calls without teaching rejections
+
+Call \`get_connection_details({ storeId })\` and follow its structured
+\`adminExecutionGuide\`. Authentication has two separate lanes:
+
+- Hosted OAuth authenticates hosted MCP/control-plane calls. The public STDIO package uses its
+  workspace-bound account API key for the same control plane.
+- Shopify-shaped Admin data-plane calls use the returned Admin URL and the returned per-store token
+  as the \`X-Shopify-Access-Token\` header value. Examples use
+  \`<SHOPIFY_ADMIN_ACCESS_TOKEN>\`; never place the returned value in docs, model/chat logs, or errors.
+  An OAuth bearer is not an Admin data-plane credential.
+
+The guide derives the current run state and cursors from the selected store. Follow its executable
+sequence: discover/create/select a store; start or confirm a \`running\` run; use
+\`admin_recipes_list\` and \`admin_schema\` to perform the exact required read/preflight; submit one
+bounded mutation; independently read back; then finish and inspect the run and receipt. A missing,
+provisioning, or terminal run is not write-ready; follow \`validNextCalls\` instead of sending a
+mutation.
+
+For recipe and mutation lookups, read \`match.executionRequirements\`. It publishes a stable
+\`reasonCode\`, \`requiredState\`, and \`validNextCalls\`. Only
+\`inventoryAdjustQuantities\` requires the facade's prior per-location available-quantity read and
+places that observation in \`input.changes[].changeFromQuantity\`; a stale value continues to return
+\`COMPARE_QUANTITY_STALE\` and must be followed by a fresh read. Do not infer that read-before-write
+rule for unrelated mutations. Apply the published \`readBeforeWrite.bindings\` for the returned inventory
+item ID, location ID, and available quantity before using the mutation example.
+
+For Admin GraphQL \`${ADMIN_API_SUPPORTED_VERSIONS.join(' and ')}\`, only
+\`inventoryAdjustQuantities\` and \`refundCreate\` require
+\`@idempotent(key: String!)\`. Place \`@idempotent(key: $idempotencyKey)\` exactly once on the single
+supported mutation root field. The resolved key must be a non-empty string no larger than 256 bytes.
+Use the authority-derived example when present; unrelated roots must not receive this directive.
+Malformed GraphQL and stale-cursor/concurrency responses retain their existing specific behavior.`;
+const DOCUMENTATION_V9_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V9);
+const DOCUMENTATION_V9_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V9);
+const GETTING_STARTED_V13_TEXT = GETTING_STARTED_V12_TEXT
+  .replace('# Getting started with Meguro v12', '# Getting started with Meguro v13')
+  .replace(`Published URI: \`${GETTING_STARTED_V12_URI}\``, `Published URI: \`${GETTING_STARTED_V13_URI}\``)
+  .replace(DOCUMENTATION_V8_VERSION_LABELS_TEXT, DOCUMENTATION_V9_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V8_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V9_DEEPER_DOCUMENTATION_TEXT)
+  .replace('## Identities', `${ADMIN_EXECUTION_PREFLIGHT_GUIDANCE_TEXT}\n\n## Identities`);
+const PRODUCT_GUIDE_V10_TEXT = PRODUCT_GUIDE_V9_TEXT
+  .replace('# Meguro product guide v9', '# Meguro product guide v10')
+  .replace(`Published URI: \`${PRODUCT_GUIDE_V9_URI}\``, `Published URI: \`${PRODUCT_GUIDE_V10_URI}\``)
+  .replace(DOCUMENTATION_V8_VERSION_LABELS_TEXT, DOCUMENTATION_V9_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V12_URI, GETTING_STARTED_V13_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V8_URI, DOCUMENTATION_INDEX_V9_URI)
+  .replace('## Core nouns', `${ADMIN_EXECUTION_PREFLIGHT_GUIDANCE_TEXT}\n\n## Core nouns`);
+// MEG-889: the superseded sentence, and the one newly minted current documents carry instead.
+// Prior documents keep the bytes they published; the correction only moves forward.
+const STALE_COMPARE_QUANTITY_SUPERSEDED_TEXT = 'a stale value continues to return\n`COMPARE_QUANTITY_STALE` and must be followed by a fresh read.';
+const STALE_CHANGE_FROM_QUANTITY_TEXT = 'a stale value returns\n`CHANGE_FROM_QUANTITY_STALE` and must be followed by a fresh read. That refusal is\nattributed to your request, not to a modeled store rule, so predeclare it with the exact\n`readBeforeWrite.staleCursorExpectedRefusal` facts rather than restating a reason or a layer.';
+
+const PRACTICE_RUN_LIFECYCLE_GUIDANCE_TEXT = `## Practice-run state, evidence, and terminal confirmation
+
+Every \`practice_run_start\` and \`practice_run_status\` response carries one machine-readable
+\`lifecycleContract\`; \`practice_run_advance\` follows that same authority. Accepted writes are
+attempt-local and disposable. Their actions are retained in the immutable receipt and Impact
+evidence, while the ordinary practice store returns to its scenario baseline after conclusion.
+Terminal reads remain available for inspection, and terminal writes are refused.
+
+An ordinary conclusion is metered exactly once. The server-owned auto-provisioned sample run
+is exempt under its explicit provisioned-sample classification; do not infer that exemption for an
+ordinary store or run.
+
+Before each advance, call \`practice_run_status\` and copy both current cursors. A preterminal
+advance behaves normally. If the requested target reaches or crosses \`endDay\`, Meguro refuses
+without moving Store time and returns the current Store day, requested target, \`endDay\`, the
+consequence (conclude the attempt and close its write lane), and an exact retry. Retry that exact
+shape with \`confirmConclusion: true\` only when you intend to conclude. The confirmed request is
+idempotent: the run concludes, the terminal lock is written, and ordinary metering settles exactly
+once.`;
+const DOCUMENTATION_V10_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V10);
+const DOCUMENTATION_V10_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V10);
+const GETTING_STARTED_V14_TEXT = GETTING_STARTED_V13_TEXT
+  .replace('# Getting started with Meguro v13', '# Getting started with Meguro v14')
+  .replace(`Published URI: \`${GETTING_STARTED_V13_URI}\``, `Published URI: \`${GETTING_STARTED_V14_URI}\``)
+  .replace(DOCUMENTATION_V9_VERSION_LABELS_TEXT, DOCUMENTATION_V10_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V9_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V10_DEEPER_DOCUMENTATION_TEXT)
+  .replace('## Identities', `${PRACTICE_RUN_LIFECYCLE_GUIDANCE_TEXT}\n\n## Identities`);
+const PRODUCT_GUIDE_V11_TEXT = PRODUCT_GUIDE_V10_TEXT
+  .replace('# Meguro product guide v10', '# Meguro product guide v11')
+  .replace(`Published URI: \`${PRODUCT_GUIDE_V10_URI}\``, `Published URI: \`${PRODUCT_GUIDE_V11_URI}\``)
+  .replace(DOCUMENTATION_V9_VERSION_LABELS_TEXT, DOCUMENTATION_V10_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V13_URI, GETTING_STARTED_V14_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V9_URI, DOCUMENTATION_INDEX_V10_URI)
+  .replace('## Core nouns', `${PRACTICE_RUN_LIFECYCLE_GUIDANCE_TEXT}\n\n## Core nouns`);
+const HOSTED_OAUTH_AUTHORITY_LIFECYCLE_GUIDANCE_TEXT = `## Hosted OAuth: one lifecycle, two authorities
+
+A hosted connection has two independent authorities. Meguro stores the server grant and refresh
+family; the MCP client separately stores its local connection and token cache. The account-entry and
+authorization-management URLs supplied by \`initialize\` come from the configured Console origin.
+Meguro cannot erase client-local state, and a client cannot revoke a server grant merely by deleting
+its local connection.
+
+1. **First connect.** The human opens the supplied account entry, signs in or creates an account,
+   and approves browser consent. Each approval creates a fresh random server grant.
+2. **Normal expiry.** The client refreshes its access token while that server grant remains active.
+3. **Missing scope.** Reconnect or reauthorize. Fresh consent creates a new grant with the requested
+   scopes; an existing grant's scopes never mutate.
+4. **Console Revoke.** Revoking the grant stops refresh immediately. An already-issued access token
+   may remain valid for up to 15 minutes.
+5. **Client Disconnect/Remove.** Removing the connection clears client-local configuration and token
+   state. That does not revoke the server grant; inspect or revoke it separately in Console.
+6. **Reconnect/Re-add.** Browser consent runs again and creates a fresh grant. Older grants may
+   remain active until they are revoked separately.
+7. **Claude Code \`401 invalid_token\`.** Remove the stored Meguro server entry and re-add it; the
+   affected client can retain an expired token, so logout/login is not sufficient recovery.`;
+const DOCUMENTATION_V11_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V11);
+const DOCUMENTATION_V11_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V11);
+const GETTING_STARTED_V15_TEXT = GETTING_STARTED_V14_TEXT
+  .replace('# Getting started with Meguro v14', '# Getting started with Meguro v15')
+  .replace(`Published URI: \`${GETTING_STARTED_V14_URI}\``, `Published URI: \`${GETTING_STARTED_V15_URI}\``)
+  .replace(DOCUMENTATION_V10_VERSION_LABELS_TEXT, DOCUMENTATION_V11_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V10_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V11_DEEPER_DOCUMENTATION_TEXT)
+  .replace(CIMD_TROUBLESHOOTING_TEXT, HOSTED_OAUTH_AUTHORITY_LIFECYCLE_GUIDANCE_TEXT);
+const PRODUCT_GUIDE_V12_TEXT = PRODUCT_GUIDE_V11_TEXT
+  .replace('# Meguro product guide v11', '# Meguro product guide v12')
+  .replace(`Published URI: \`${PRODUCT_GUIDE_V11_URI}\``, `Published URI: \`${PRODUCT_GUIDE_V12_URI}\``)
+  .replace(DOCUMENTATION_V10_VERSION_LABELS_TEXT, DOCUMENTATION_V11_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V14_URI, GETTING_STARTED_V15_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V10_URI, DOCUMENTATION_INDEX_V11_URI)
+  .replace('## Core nouns', `${HOSTED_OAUTH_AUTHORITY_LIFECYCLE_GUIDANCE_TEXT}\n\n## Core nouns`);
+const RETURN_RESOLUTION_EVIDENCE_GUIDANCE_TEXT = `## Return resolution and evidence accounting
+
+Return approval records policy approval only; it has no refund or store-credit economics.
+Return-linked cash is an explicit idempotent \`returnRefund(returnRefundInput:)\` resolution. Ordinary
+order cash and store credit are \`refundCreate(input:)\` resolutions; \`RefundInput.note\` is opaque
+customer text and never selects or changes a Return. The two financial resolutions are
+mutually exclusive for one return.
+
+Receipt and Impact footprints keep four distinct counts. \`acceptedMutationCalls\` counts accepted
+mutation invocations, including safe idempotent replays. \`rejectedMutationCalls\` counts refused
+mutation invocations. \`idempotentReplays\` is the accepted-call subset that reused an existing result.
+\`appliedCommerceActions\` counts modeled commerce actions actually applied, so it excludes refused
+calls and replays. Read the resolution-specific change or effect line for the exact dollar economics.`;
+const DOCUMENTATION_V12_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V12);
+const DOCUMENTATION_V12_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V12);
+const GETTING_STARTED_V16_TEXT = GETTING_STARTED_V15_TEXT
+  .replace('# Getting started with Meguro v15', '# Getting started with Meguro v16')
+  .replace('Published URI: `' + GETTING_STARTED_V15_URI + '`', 'Published URI: `' + GETTING_STARTED_V16_URI + '`')
+  .replace(DOCUMENTATION_V11_VERSION_LABELS_TEXT, DOCUMENTATION_V12_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V11_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V12_DEEPER_DOCUMENTATION_TEXT)
+  .replace('## Identities', `${RETURN_RESOLUTION_EVIDENCE_GUIDANCE_TEXT}\n\n## Identities`);
+const PRODUCT_GUIDE_V13_TEXT = PRODUCT_GUIDE_V12_TEXT
+  .replace('# Meguro product guide v12', '# Meguro product guide v13')
+  .replace('Published URI: `' + PRODUCT_GUIDE_V12_URI + '`', 'Published URI: `' + PRODUCT_GUIDE_V13_URI + '`')
+  .replace(DOCUMENTATION_V11_VERSION_LABELS_TEXT, DOCUMENTATION_V12_VERSION_LABELS_TEXT)
+  .replaceAll(RECEIPT_GUIDE_V9_URI, RECEIPT_GUIDE_V10_URI)
+  .replaceAll(GETTING_STARTED_V15_URI, GETTING_STARTED_V16_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V11_URI, DOCUMENTATION_INDEX_V12_URI)
+  .replace('## Core nouns', `${RETURN_RESOLUTION_EVIDENCE_GUIDANCE_TEXT}\n\n## Core nouns`);
+const SUPERSEDED_IDEMPOTENCY_REQUIREMENTS_TEXT = `For Admin GraphQL \`${ADMIN_API_SUPPORTED_VERSIONS.join(' and ')}\`, only
+\`inventoryAdjustQuantities\` and \`refundCreate\` require
+\`@idempotent(key: String!)\`. Place \`@idempotent(key: $idempotencyKey)\` exactly once on the single
+supported mutation root field. The resolved key must be a non-empty string no larger than 256 bytes.
+Use the authority-derived example when present; unrelated roots must not receive this directive.`;
+const CURRENT_IDEMPOTENCY_REQUIREMENTS_TEXT = `For Admin GraphQL \`${ADMIN_API_SUPPORTED_VERSIONS.join(' and ')}\`, the authoritative set is:
+\`inventoryAdjustQuantities\`, \`refundCreate\`, and the store-credit \`returnRefund\` branch require
+\`@idempotent(key: String!)\`. Place \`@idempotent(key: $idempotencyKey)\` exactly once on the single
+supported mutation root field. The resolved key must be a non-empty string no larger than 256 bytes.
+Use the authority-derived example when present; unrelated roots and non-store-credit
+\`returnRefund\` branches must not receive this directive.`;
+const DOCUMENTATION_V13_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V13);
+const DOCUMENTATION_V13_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V13);
+const GETTING_STARTED_V17_TEXT = GETTING_STARTED_V16_TEXT
+  .replace('# Getting started with Meguro v16', '# Getting started with Meguro v17')
+  .replace('Published URI: `' + GETTING_STARTED_V16_URI + '`', 'Published URI: `' + GETTING_STARTED_V17_URI + '`')
+  .replace(DOCUMENTATION_V12_VERSION_LABELS_TEXT, DOCUMENTATION_V13_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V12_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V13_DEEPER_DOCUMENTATION_TEXT)
+  .replace(SUPERSEDED_IDEMPOTENCY_REQUIREMENTS_TEXT, CURRENT_IDEMPOTENCY_REQUIREMENTS_TEXT);
+const PRODUCT_GUIDE_V14_TEXT = PRODUCT_GUIDE_V13_TEXT
+  .replace('# Meguro product guide v13', '# Meguro product guide v14')
+  .replace('Published URI: `' + PRODUCT_GUIDE_V13_URI + '`', 'Published URI: `' + PRODUCT_GUIDE_V14_URI + '`')
+  .replace(DOCUMENTATION_V12_VERSION_LABELS_TEXT, DOCUMENTATION_V13_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V16_URI, GETTING_STARTED_V17_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V12_URI, DOCUMENTATION_INDEX_V13_URI)
+  .replace(SUPERSEDED_IDEMPOTENCY_REQUIREMENTS_TEXT, CURRENT_IDEMPOTENCY_REQUIREMENTS_TEXT);
+const ZERO_PRIOR_KNOWLEDGE_GUIDANCE_TEXT = `## Start here: what Meguro means
+
+Meguro is a rehearsal and technical-evaluation environment for commerce agents. It lets an agent
+rehearse decisions against modeled commerce behavior without touching a live store.
+
+- A **practice store** is an isolated simulation of a commerce store. Its state and changes remain
+  inside Meguro.
+- **Store time** is that simulation's clock. It advances only through the bounded evaluation flow;
+  it is not wall-clock time on a live store.
+- A **run** is one bounded evaluation of an agent against a selected practice store.
+- A **receipt** is the immutable record produced by a run: the calls, accepted and rejected changes,
+  and evidence Meguro recorded.
+
+Meguro's result is rehearsal evidence. It is not a forecast, certification, or proof of live-market,
+production, or Shopify performance.`;
+const DOCUMENTATION_V14_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V14);
+const DOCUMENTATION_V14_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V14);
+const GETTING_STARTED_V18_TEXT = GETTING_STARTED_V17_TEXT
+  .replace('# Getting started with Meguro v17', '# Getting started with Meguro v18')
+  .replace('Published URI: `' + GETTING_STARTED_V17_URI + '`', 'Published URI: `' + GETTING_STARTED_V18_URI + '`')
+  .replace(
+    `# Getting started with Meguro v18\n\nPublished URI: \`${GETTING_STARTED_V18_URI}\``,
+    `# Getting started with Meguro v18\n\n${ZERO_PRIOR_KNOWLEDGE_GUIDANCE_TEXT}\n\nPublished URI: \`${GETTING_STARTED_V18_URI}\``,
+  )
+  .replace(DOCUMENTATION_V13_VERSION_LABELS_TEXT, DOCUMENTATION_V14_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V13_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V14_DEEPER_DOCUMENTATION_TEXT);
+const PRODUCT_GUIDE_V15_TEXT = PRODUCT_GUIDE_V14_TEXT
+  .replace('# Meguro product guide v14', '# Meguro product guide v15')
+  .replace('Published URI: `' + PRODUCT_GUIDE_V14_URI + '`', 'Published URI: `' + PRODUCT_GUIDE_V15_URI + '`')
+  .replace(
+    `# Meguro product guide v15\n\nPublished URI: \`${PRODUCT_GUIDE_V15_URI}\``,
+    `# Meguro product guide v15\n\n${ZERO_PRIOR_KNOWLEDGE_GUIDANCE_TEXT}\n\nPublished URI: \`${PRODUCT_GUIDE_V15_URI}\``,
+  )
+  .replace(DOCUMENTATION_V13_VERSION_LABELS_TEXT, DOCUMENTATION_V14_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V17_URI, GETTING_STARTED_V18_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V13_URI, DOCUMENTATION_INDEX_V14_URI);
+const ORDINARY_STORE_HISTORY_DEFAULT_GUIDANCE_TEXT = PER_STORE_HISTORY_GUIDANCE_TEXT
+  .replace(
+    `An ordinary newly created practice store from \`store_create\` currently begins with zero history.
+Zero history is a planning fact, not a defect: choose a scenario that does not require pre-existing
+events, or select a store whose live provenance reports enough history for the intended evaluation.
+The server-owned seeded sample is a distinct provisioning lane and currently reports 90 days. That
+is today's sample fact, not a universal promise: never assume a future sample has 90 days; read its
+live provenance.`,
+    `An ordinary newly created practice store from \`store_create\` receives 120 days of queryable
+history by server default. The direct HTTP creation API may supply an explicit \`warmupDays\` value;
+that explicit value overrides the default and remains bounded by the store span. \`store_create\`
+does not expose that override. The server-owned seeded sample is a distinct provisioning lane and
+currently reports its explicit 90-day span. That is today's sample fact, not a universal promise:
+never assume a future sample has 90 days; read its live provenance.`,
+  )
+  .replace(
+    `A tier \`historyDays\` value does not authorize nonzero warmup for an ordinary store. Ordinary-store
+warmup remains unchanged and requires a separate founder-signed amendment.`,
+    `A tier \`historyDays\` value is not the creation authority. Ordinary-store warmup comes from the
+single server-owned creation default or an explicit direct-API override.`,
+  );
+const DOCUMENTATION_V15_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V15);
+const DOCUMENTATION_V15_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V15);
+const GETTING_STARTED_V19_TEXT = GETTING_STARTED_V18_TEXT
+  .replace('# Getting started with Meguro v18', '# Getting started with Meguro v19')
+  .replace('Published URI: `' + GETTING_STARTED_V18_URI + '`', 'Published URI: `' + GETTING_STARTED_V19_URI + '`')
+  .replace(DOCUMENTATION_V14_VERSION_LABELS_TEXT, DOCUMENTATION_V15_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V14_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V15_DEEPER_DOCUMENTATION_TEXT)
+  .replace(PER_STORE_HISTORY_GUIDANCE_TEXT, ORDINARY_STORE_HISTORY_DEFAULT_GUIDANCE_TEXT);
+const PRODUCT_GUIDE_V16_TEXT = PRODUCT_GUIDE_V15_TEXT
+  .replace('# Meguro product guide v15', '# Meguro product guide v16')
+  .replace('Published URI: `' + PRODUCT_GUIDE_V15_URI + '`', 'Published URI: `' + PRODUCT_GUIDE_V16_URI + '`')
+  .replace(DOCUMENTATION_V14_VERSION_LABELS_TEXT, DOCUMENTATION_V15_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V18_URI, GETTING_STARTED_V19_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V14_URI, DOCUMENTATION_INDEX_V15_URI)
+  .replace(PER_STORE_HISTORY_GUIDANCE_TEXT, ORDINARY_STORE_HISTORY_DEFAULT_GUIDANCE_TEXT);
+const SAMPLE_ONBOARDING_TRUTH_TEXT = `An ordinary conclusion is metered exactly once. The live seeded sample is a free onboarding run on
+an ordinary, fully interrogable practice store. Its account-owned onboarding grant waives the active-
+store slot and names the one free attempt; after that attempt is consumed, every run on the sample
+store meters normally.
+
+Hide removes the sample store only from the Console fleet. Connected agents can still discover,
+query, and use that same store through MCP. The account's sample claim, the original run coordinate,
+and its receipt remain permanent; hiding, showing, or retrying provisioning cannot create another
+free store or run.`;
+const DOCUMENTATION_V16_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V16);
+const DOCUMENTATION_V16_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V16);
+const GETTING_STARTED_V20_TEXT = GETTING_STARTED_V19_TEXT
+  .replace('# Getting started with Meguro v19', '# Getting started with Meguro v20')
+  .replace('Published URI: `' + GETTING_STARTED_V19_URI + '`', 'Published URI: `' + GETTING_STARTED_V20_URI + '`')
+  .replace(DOCUMENTATION_V15_VERSION_LABELS_TEXT, DOCUMENTATION_V16_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V15_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V16_DEEPER_DOCUMENTATION_TEXT)
+  .replace(
+    `An ordinary conclusion is metered exactly once. The server-owned auto-provisioned sample run
+is exempt under its explicit provisioned-sample classification; do not infer that exemption for an
+ordinary store or run.`,
+    SAMPLE_ONBOARDING_TRUTH_TEXT,
+  );
+const PRODUCT_GUIDE_V17_TEXT = PRODUCT_GUIDE_V16_TEXT
+  .replace('# Meguro product guide v16', '# Meguro product guide v17')
+  .replace('Published URI: `' + PRODUCT_GUIDE_V16_URI + '`', 'Published URI: `' + PRODUCT_GUIDE_V17_URI + '`')
+  .replace(DOCUMENTATION_V15_VERSION_LABELS_TEXT, DOCUMENTATION_V16_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V19_URI, GETTING_STARTED_V20_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V15_URI, DOCUMENTATION_INDEX_V16_URI)
+  .replace(
+    `An ordinary conclusion is metered exactly once. The server-owned auto-provisioned sample run
+is exempt under its explicit provisioned-sample classification; do not infer that exemption for an
+ordinary store or run.`,
+    SAMPLE_ONBOARDING_TRUTH_TEXT,
+  );
+const SHARED_SAMPLE_HISTORY_GUIDANCE_TEXT = ORDINARY_STORE_HISTORY_DEFAULT_GUIDANCE_TEXT
+  .replace(
+    `The server-owned seeded sample is a distinct provisioning lane and
+currently reports its explicit 90-day span. That is today's sample fact, not a universal promise:
+never assume a future sample has 90 days; read its live provenance.`,
+    `The live seeded sample is an ordinary practice store using the same shared store machinery.
+Its server-owned configuration explicitly supplies 90 days of queryable history instead of the
+ordinary 120-day default. These are different inputs to the same machinery, not different
+provisioning lanes. That explicit 90-day span is today's sample fact, not a universal promise:
+never assume a future sample has 90 days; read its live provenance.`,
+  );
+const DOCUMENTATION_V17_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V17);
+const DOCUMENTATION_V17_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V17);
+const GETTING_STARTED_V21_TEXT = GETTING_STARTED_V20_TEXT
+  .replace('# Getting started with Meguro v20', '# Getting started with Meguro v21')
+  .replace('Published URI: `' + GETTING_STARTED_V20_URI + '`', 'Published URI: `' + GETTING_STARTED_V21_URI + '`')
+  .replace(DOCUMENTATION_V16_VERSION_LABELS_TEXT, DOCUMENTATION_V17_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V16_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V17_DEEPER_DOCUMENTATION_TEXT)
+  .replace(ORDINARY_STORE_HISTORY_DEFAULT_GUIDANCE_TEXT, SHARED_SAMPLE_HISTORY_GUIDANCE_TEXT);
+const PRODUCT_GUIDE_V18_TEXT = PRODUCT_GUIDE_V17_TEXT
+  .replace('# Meguro product guide v17', '# Meguro product guide v18')
+  .replace('Published URI: `' + PRODUCT_GUIDE_V17_URI + '`', 'Published URI: `' + PRODUCT_GUIDE_V18_URI + '`')
+  .replace(DOCUMENTATION_V16_VERSION_LABELS_TEXT, DOCUMENTATION_V17_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V20_URI, GETTING_STARTED_V21_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V16_URI, DOCUMENTATION_INDEX_V17_URI)
+  .replace(ORDINARY_STORE_HISTORY_DEFAULT_GUIDANCE_TEXT, SHARED_SAMPLE_HISTORY_GUIDANCE_TEXT);
+const COMPATIBILITY_AND_FINAL_GATE_GUIDANCE_TEXT = `## Compatibility scope and final receipt Gate
+
+\`Query.node\` and \`Query.nodes\` are polymorphic modeled-limit roots, not blanket Shopify Node
+compatibility claims. Read their \`nodeScope\` from the exact-version \`admin_schema\` compatibility
+manifest before selecting a fragment. Only \`nodeScope.supportedObjectTypes\` has the closed target-
+artifact, Meguro SDL, resolver, stable-identity, and executable-fixture proof. Every other Shopify
+Node implementor remains outside that claim even when Shopify declares it as Node; do not infer
+support from the root coordinate, type name, or target API alone.
+
+The receipt's top-level \`gate\` is the one server-owned customer-facing promotion status. A failed
+named \`resultSemantics.evidenceAssertions\` assertion or
+\`rejectionAttribution.requiresReview = true\` prevents \`gate.status = passing\`. A matched expected
+refusal and a proven handled correction remain visible as raw rejected calls without becoming
+unhandled failures. \`resultSemantics.technicalPolicyVerdict\` remains independent and may pass while
+evidence fails. Consume the exact supplied \`gate\` in Console, MCP, public/private receipt, download,
+or generated copy; never derive another status from calls or legacy fields.`;
+const DOCUMENTATION_V18_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V18);
+const DOCUMENTATION_V18_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V18);
+const GETTING_STARTED_V22_TEXT = GETTING_STARTED_V21_TEXT
+  .replace('# Getting started with Meguro v21', '# Getting started with Meguro v22')
+  .replace('Published URI: `' + GETTING_STARTED_V21_URI + '`', 'Published URI: `' + GETTING_STARTED_V22_URI + '`')
+  .replace(DOCUMENTATION_V17_VERSION_LABELS_TEXT, DOCUMENTATION_V18_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V17_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V18_DEEPER_DOCUMENTATION_TEXT)
+  .replaceAll(RECEIPT_GUIDE_V10_URI, RECEIPT_GUIDE_V11_URI)
+  .replace('## Deeper in-band documentation', `${COMPATIBILITY_AND_FINAL_GATE_GUIDANCE_TEXT}\n\n## Deeper in-band documentation`);
+const PRODUCT_GUIDE_V19_TEXT = PRODUCT_GUIDE_V18_TEXT
+  .replace('# Meguro product guide v18', '# Meguro product guide v19')
+  .replace('Published URI: `' + PRODUCT_GUIDE_V18_URI + '`', 'Published URI: `' + PRODUCT_GUIDE_V19_URI + '`')
+  .replace(DOCUMENTATION_V17_VERSION_LABELS_TEXT, DOCUMENTATION_V18_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V21_URI, GETTING_STARTED_V22_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V17_URI, DOCUMENTATION_INDEX_V18_URI)
+  .replaceAll(RECEIPT_GUIDE_V10_URI, RECEIPT_GUIDE_V11_URI)
+  .replace('## Stable concepts versus changing facts', `${COMPATIBILITY_AND_FINAL_GATE_GUIDANCE_TEXT}\n\n## Stable concepts versus changing facts`);
+const ONBOARDING_EVALUATION_GRANT_GUIDANCE_TEXT = `## One user-chosen onboarding evaluation
+
+Each fresh account has one account-owned onboarding evaluation grant. While it is available,
+\`templates_list\` and the Console project the same server-owned \`starterPlans\` for every practice-
+store template. Choose the store and template you want to evaluate; the first accepted start binds
+the grant atomically to that store, template revision, deterministic root evaluation, and the
+template's pinned ideal horizon. The sample is not privileged by its route, name, seed, or shape: it
+uses the grant only when you choose it.
+
+Use each selected plan's exact \`practiceRunStart.clock\`. Ordinary immutable receipt segments remain
+bounded by the current plan's per-attempt limit. When the ideal horizon is longer, continue the same
+root with \`continueFromAttemptId\`; every authorized segment carries the same
+\`onboardingEvaluation\` fact and consumes no monthly simulation-run credit. The sample POST remains
+an idempotent first-segment walkthrough; continue a longer bound sample through the ordinary run
+API rather than POSTing another sample.
+
+The grant is spent once for the whole root chain. Identical retries converge on one root. Hiding,
+showing, deleting, recreating, choosing another store, or changing sample identity cannot restore or
+move it. A legacy account with the old consumption marker remains consumed. After the pinned ideal
+horizon, every new segment or run follows ordinary tier canvas, continuation, and monthly allowance
+rules. Read the returned plan and authorization facts; never infer entitlement or caps in a client.`;
+const DOCUMENTATION_V19_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V19);
+const DOCUMENTATION_V19_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V19);
+const GETTING_STARTED_V23_TEXT = GETTING_STARTED_V22_TEXT
+  .replace('# Getting started with Meguro v22', '# Getting started with Meguro v23')
+  .replace('Published URI: `' + GETTING_STARTED_V22_URI + '`', 'Published URI: `' + GETTING_STARTED_V23_URI + '`')
+  .replace(DOCUMENTATION_V18_VERSION_LABELS_TEXT, DOCUMENTATION_V19_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V18_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V19_DEEPER_DOCUMENTATION_TEXT)
+  .replace('## Deeper in-band documentation', `${ONBOARDING_EVALUATION_GRANT_GUIDANCE_TEXT}\n\n## Deeper in-band documentation`);
+const PRODUCT_GUIDE_V20_TEXT = PRODUCT_GUIDE_V19_TEXT
+  .replace('# Meguro product guide v19', '# Meguro product guide v20')
+  .replace('Published URI: `' + PRODUCT_GUIDE_V19_URI + '`', 'Published URI: `' + PRODUCT_GUIDE_V20_URI + '`')
+  .replace(DOCUMENTATION_V18_VERSION_LABELS_TEXT, DOCUMENTATION_V19_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V22_URI, GETTING_STARTED_V23_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V18_URI, DOCUMENTATION_INDEX_V19_URI)
+  .replace('## Stable concepts versus changing facts', `${ONBOARDING_EVALUATION_GRANT_GUIDANCE_TEXT}\n\n## Stable concepts versus changing facts`);
+const DOCUMENTATION_V20_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V20);
+const DOCUMENTATION_V20_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V20);
+const GETTING_STARTED_V24_TEXT = GETTING_STARTED_V23_TEXT
+  .replace('# Getting started with Meguro v23', '# Getting started with Meguro v24')
+  .replace('Published URI: `' + GETTING_STARTED_V23_URI + '`', 'Published URI: `' + GETTING_STARTED_V24_URI + '`')
+  .replace(DOCUMENTATION_V19_VERSION_LABELS_TEXT, DOCUMENTATION_V20_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V19_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V20_DEEPER_DOCUMENTATION_TEXT);
+const PRODUCT_GUIDE_V21_TEXT = PRODUCT_GUIDE_V20_TEXT
+  .replace('# Meguro product guide v20', '# Meguro product guide v21')
+  .replace('Published URI: `' + PRODUCT_GUIDE_V20_URI + '`', 'Published URI: `' + PRODUCT_GUIDE_V21_URI + '`')
+  .replace(DOCUMENTATION_V19_VERSION_LABELS_TEXT, DOCUMENTATION_V20_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V23_URI, GETTING_STARTED_V24_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V19_URI, DOCUMENTATION_INDEX_V20_URI)
+  .replaceAll(RECEIPT_GUIDE_V11_URI, RECEIPT_GUIDE_V12_URI);
+const TEMPLATE_EVENT_RESOLUTION_GUIDANCE_TEXT = `## Creation-pinned template event resolution
+
+New hosted run and impact receipts carry one \`eventResolution\` derived from the template
+evaluation context copied into the practice store at creation. \`source\` names that immutable
+template key, label, and revision; it is not a lookup against the current template catalog.
+
+For a discrete event, \`status = resolved\` only when the exact measured world-day horizon spans the
+complete pinned \`eventWindow\`. Coverage ending before, starting after, or including only part of
+that window is \`not-resolved\`. A continuously modeled response is \`not-applicable\` because it has
+no discrete event window. A historical or custom store without pinned context is \`unavailable\`;
+clients must not infer or fabricate context from current template metadata. Preserve the supplied
+reason and measured horizon beside the status. Historical issued receipt bytes do not change.`;
+const DOCUMENTATION_V21_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V21);
+const DOCUMENTATION_V21_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V21);
+const GETTING_STARTED_V25_TEXT = GETTING_STARTED_V24_TEXT
+  .replace('# Getting started with Meguro v24', '# Getting started with Meguro v25')
+  .replace('Published URI: `' + GETTING_STARTED_V24_URI + '`', 'Published URI: `' + GETTING_STARTED_V25_URI + '`')
+  .replace(DOCUMENTATION_V20_VERSION_LABELS_TEXT, DOCUMENTATION_V21_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V20_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V21_DEEPER_DOCUMENTATION_TEXT)
+  .replace('## Deeper in-band documentation', `${TEMPLATE_EVENT_RESOLUTION_GUIDANCE_TEXT}\n\n## Deeper in-band documentation`);
+const PRODUCT_GUIDE_V22_TEXT = PRODUCT_GUIDE_V21_TEXT
+  .replace('# Meguro product guide v21', '# Meguro product guide v22')
+  .replace('Published URI: `' + PRODUCT_GUIDE_V21_URI + '`', 'Published URI: `' + PRODUCT_GUIDE_V22_URI + '`')
+  .replace(DOCUMENTATION_V20_VERSION_LABELS_TEXT, DOCUMENTATION_V21_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V24_URI, GETTING_STARTED_V25_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V20_URI, DOCUMENTATION_INDEX_V21_URI)
+  .replaceAll(RECEIPT_GUIDE_V12_URI, RECEIPT_GUIDE_V13_URI)
+  .replace('## Stable concepts versus changing facts', `${TEMPLATE_EVENT_RESOLUTION_GUIDANCE_TEXT}\n\n## Stable concepts versus changing facts`);
+const ADVANCE_CURSOR_GUIDANCE_TEXT = `## One server-owned advance cursor
+
+Every practice-run start and status response carries \`practiceRun.advanceCursor\` with exactly
+\`expectedDay\` and \`expectedCallSeq\`. Copy that object unchanged into the next
+\`practice_run_advance\` call or HTTP advance body. Do not choose between \`currentDay\` and
+\`watermarkDay\`, and do not combine call-sequence fields from separate reads.
+
+Start, accepted-call status, zero-call status, advance, checkpoint, terminal confirmation,
+refusal recovery, checkpoint reopen, and completed status all return the same server-owned shape.
+A stale cursor fails closed and moves no Store time; the refusal returns a fresh \`advanceCursor\`
+for one exact retry. The frozen scalar response fields and legacy flat \`expectedDay\` plus
+\`expectedCallSeq\` request fields remain available together for compatibility.`;
+const DOCUMENTATION_V22_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V22);
+const DOCUMENTATION_V22_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V22);
+const GETTING_STARTED_V26_TEXT = GETTING_STARTED_V25_TEXT
+  .replace('# Getting started with Meguro v25', '# Getting started with Meguro v26')
+  .replace('Published URI: `' + GETTING_STARTED_V25_URI + '`', 'Published URI: `' + GETTING_STARTED_V26_URI + '`')
+  .replace(DOCUMENTATION_V21_VERSION_LABELS_TEXT, DOCUMENTATION_V22_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V21_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V22_DEEPER_DOCUMENTATION_TEXT)
+  .replace(
+    'practice_run_advance({ attemptId, days, expectedDay, expectedCallSeq })',
+    'practice_run_advance({ attemptId, days, advanceCursor })',
+  )
+  .replace(
+    'Before each advance, call `practice_run_status` and copy both current cursors.',
+    'Before each advance, call `practice_run_status` and copy `practiceRun.advanceCursor` unchanged.',
+  )
+  .replace('## Deeper in-band documentation', `${ADVANCE_CURSOR_GUIDANCE_TEXT}\n\n## Deeper in-band documentation`);
+const PRODUCT_GUIDE_V23_TEXT = PRODUCT_GUIDE_V22_TEXT
+  .replace('# Meguro product guide v22', '# Meguro product guide v23')
+  .replace('Published URI: `' + PRODUCT_GUIDE_V22_URI + '`', 'Published URI: `' + PRODUCT_GUIDE_V23_URI + '`')
+  .replace(DOCUMENTATION_V21_VERSION_LABELS_TEXT, DOCUMENTATION_V22_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V25_URI, GETTING_STARTED_V26_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V21_URI, DOCUMENTATION_INDEX_V22_URI)
+  .replace(
+    'Before each advance, call `practice_run_status` and copy both current cursors.',
+    'Before each advance, call `practice_run_status` and copy `practiceRun.advanceCursor` unchanged.',
+  )
+  .replace('## Stable concepts versus changing facts', `${ADVANCE_CURSOR_GUIDANCE_TEXT}\n\n## Stable concepts versus changing facts`);
+const MUTABLE_GATE_ABSENCE_TEXT = `No configured Receipt Gate exists. The receipt's recorded API behavior remains available.`;
+// MEG-1204: a documentation resource cannot know whether the reading account or practice store
+// currently has a configured Gate. The current generation states the standing rule and routes the
+// live question to the Gate tools; versions carrying the mutable sentence keep their exact bytes.
+const STATE_NEUTRAL_GATE_PRESENCE_TEXT = `A configured Receipt Gate is optional per account and practice store, and this document cannot
+report whether one exists for you. Discover the current state through the Gate tools. Its absence
+never removes the receipt's automatic Recorded API behavior.`;
+const RECEIPT_PRODUCT_TERMINOLOGY_GUIDANCE_TEXT = `## Automatic receipt facts and optional configured policy
+
+Every concluded receipt carries **Recorded API behavior** automatically, whether or not a
+**Configured Receipt Gate** exists. Customer-facing Recorded API behavior is rendered from the
+receipt's existing fact-phrase authority. **Default run policy** names the provenance of that
+automatic interpretation; it is not a separately configured product.
+
+**Configured Receipt Gate** is the optional configured policy over selected receipt facts exposed
+by the frozen \`gate_configure\`, \`gate_evaluate\`, and \`gate_verdict\` tool names.
+${MUTABLE_GATE_ABSENCE_TEXT}
+
+These customer terms do not rename machine fields or values. Preserve \`gate\`, \`gate.status\`,
+\`technicalPolicyVerdict\`, \`defaultVerdict\`, policy ids and versions, schema names, routes, tool
+names, and raw JSON exactly as supplied.`;
+const DOCUMENTATION_V23_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V23);
+const DOCUMENTATION_V23_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V23);
+const GETTING_STARTED_V27_TEXT = GETTING_STARTED_V26_TEXT
+  .replace('# Getting started with Meguro v26', '# Getting started with Meguro v27')
+  .replace('Published URI: `' + GETTING_STARTED_V26_URI + '`', 'Published URI: `' + GETTING_STARTED_V27_URI + '`')
+  .replace(DOCUMENTATION_V22_VERSION_LABELS_TEXT, DOCUMENTATION_V23_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V22_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V23_DEEPER_DOCUMENTATION_TEXT)
+  .replace('## Deeper in-band documentation', `${RECEIPT_PRODUCT_TERMINOLOGY_GUIDANCE_TEXT}\n\n## Deeper in-band documentation`);
+const PRODUCT_GUIDE_V24_TEXT = PRODUCT_GUIDE_V23_TEXT
+  .replace('# Meguro product guide v23', '# Meguro product guide v24')
+  .replace('Published URI: `' + PRODUCT_GUIDE_V23_URI + '`', 'Published URI: `' + PRODUCT_GUIDE_V24_URI + '`')
+  .replace(DOCUMENTATION_V22_VERSION_LABELS_TEXT, DOCUMENTATION_V23_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V26_URI, GETTING_STARTED_V27_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V22_URI, DOCUMENTATION_INDEX_V23_URI)
+  .replaceAll(RECEIPT_GUIDE_V13_URI, RECEIPT_GUIDE_V14_URI)
+  .replace('## Stable concepts versus changing facts', `${RECEIPT_PRODUCT_TERMINOLOGY_GUIDANCE_TEXT}\n\n## Stable concepts versus changing facts`);
+const OFFICIAL_RETURN_FINANCE_GUIDANCE_TEXT = `## Shopify return finance mechanics
+
+Meguro's public Admin GraphQL surface follows the pinned Shopify Admin schema. A return cash refund
+uses \`returnRefund(returnRefundInput:)\` with \`returnId\` and exact
+\`returnRefundLineItems\`. A return-linked store-credit refund uses \`refundCreate(input:)\` with
+the order, exact refund line items, and \`refundMethods[].storeCreditRefund.amount\` as a
+\`MoneyInput\`. Both mutation roots require exactly one field-level
+\`@idempotent(key: String!)\` directive.
+
+Public read-back uses official \`Refund\`, \`OrderTransaction\`, \`Return.refunds\`,
+\`Return.suggestedRefund\`, and \`Return.suggestedFinancialOutcome\` fields. Rehearsal-specific
+resolution kind, customer linkage, modeled economics, settlement, and replay evidence live in the
+private receipt and committed change register; they are not synthetic Shopify fields. Approval
+alone remains non-financial, and \`giftCardCreate\` remains SKU-linked loyalty credit rather than a
+return refund.`;
+const CORRECTED_RETURN_RESOLUTION_EVIDENCE_GUIDANCE_TEXT = RETURN_RESOLUTION_EVIDENCE_GUIDANCE_TEXT
+  .replace('A cash\nrefund is an explicit idempotent `refundCreate` resolution. Return-linked store credit is a distinct\nidempotent `returnRefund` resolution', 'A cash\nrefund is an explicit idempotent `returnRefund` resolution. Return-linked store credit is a distinct\nidempotent `refundCreate` resolution');
+const CUSTOMER_LINKED_RETURN_RESOLUTION_EVIDENCE_GUIDANCE_TEXT = CORRECTED_RETURN_RESOLUTION_EVIDENCE_GUIDANCE_TEXT
+  .replace(
+    'and never routes through SKU-linked loyalty credit.',
+    'and never routes through proactive customer-linked loyalty GiftCards.',
+  );
+const CORRECTED_IDEMPOTENCY_REQUIREMENTS_TEXT = `For Admin GraphQL \`${ADMIN_API_SUPPORTED_VERSIONS.join(' and ')}\`, the authoritative set is:
+\`inventoryAdjustQuantities\`, \`refundCreate\`, and \`returnRefund\` require
+\`@idempotent(key: String!)\`. Place \`@idempotent(key: $idempotencyKey)\` exactly once on the single
+supported mutation root field. The resolved key must be a non-empty string no larger than 256 bytes.
+Use the authority-derived example when present; unrelated roots must not receive this directive.`;
+const DOCUMENTATION_V24_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V24);
+const DOCUMENTATION_V24_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V24);
+const GETTING_STARTED_V28_TEXT = GETTING_STARTED_V27_TEXT
+  .replace('# Getting started with Meguro v27', '# Getting started with Meguro v28')
+  .replace('Published URI: `' + GETTING_STARTED_V27_URI + '`', 'Published URI: `' + GETTING_STARTED_V28_URI + '`')
+  .replace(DOCUMENTATION_V23_VERSION_LABELS_TEXT, DOCUMENTATION_V24_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V23_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V24_DEEPER_DOCUMENTATION_TEXT)
+  .replace(RETURN_RESOLUTION_EVIDENCE_GUIDANCE_TEXT, CORRECTED_RETURN_RESOLUTION_EVIDENCE_GUIDANCE_TEXT)
+  .replace(CURRENT_IDEMPOTENCY_REQUIREMENTS_TEXT, CORRECTED_IDEMPOTENCY_REQUIREMENTS_TEXT)
+  .replace('## Deeper in-band documentation', `${OFFICIAL_RETURN_FINANCE_GUIDANCE_TEXT}\n\n## Deeper in-band documentation`);
+const PRODUCT_GUIDE_V25_TEXT = PRODUCT_GUIDE_V24_TEXT
+  .replace('# Meguro product guide v24', '# Meguro product guide v25')
+  .replace('Published URI: `' + PRODUCT_GUIDE_V24_URI + '`', 'Published URI: `' + PRODUCT_GUIDE_V25_URI + '`')
+  .replace(DOCUMENTATION_V23_VERSION_LABELS_TEXT, DOCUMENTATION_V24_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V27_URI, GETTING_STARTED_V28_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V23_URI, DOCUMENTATION_INDEX_V24_URI)
+  .replace(RETURN_RESOLUTION_EVIDENCE_GUIDANCE_TEXT, CORRECTED_RETURN_RESOLUTION_EVIDENCE_GUIDANCE_TEXT)
+  .replace(CURRENT_IDEMPOTENCY_REQUIREMENTS_TEXT, CORRECTED_IDEMPOTENCY_REQUIREMENTS_TEXT)
+  .replace('## Stable concepts versus changing facts', `${OFFICIAL_RETURN_FINANCE_GUIDANCE_TEXT}\n\n## Stable concepts versus changing facts`);
+const CUSTOMER_LINKED_LOYALTY_GIFT_CARD_GUIDANCE_TEXT = `## Customer-linked loyalty GiftCards
+
+Proactive loyalty value uses Shopify Admin \`giftCardCreate(input:)\` with \`initialValue: Decimal\`
+and \`customerId: ID\`. The public request and \`GiftCard.customer\` identify the modeled customer;
+there is no SKU selector or SKU response field. Meguro derives the internal product cohort only
+from the order/customer authority already present in the practice store.
+
+This mutation is not declared \`@idempotent\`. An exact retry after the first accepted gift card
+returns a structured \`GiftCardUserError\` and applies no second commerce action. Read accepted
+gift cards independently through \`giftCards(first:, after:)\`; their initial value and balance
+reconcile to the accepted-action receipt cost. Return-linked store credit remains a separate
+\`refundCreate.refundMethods.storeCreditRefund\` resolution and never uses \`giftCardCreate\`.`;
+const CORRECTED_OFFICIAL_RETURN_FINANCE_GUIDANCE_TEXT = OFFICIAL_RETURN_FINANCE_GUIDANCE_TEXT
+  .replace(
+    'alone remains non-financial, and `giftCardCreate` remains SKU-linked loyalty credit rather than a\nreturn refund.',
+    'alone remains non-financial. Proactive customer-linked `giftCardCreate` loyalty GiftCards remain\ndistinct from return refunds and return-linked store credit.',
+  );
+const DOCUMENTATION_V25_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V25);
+const DOCUMENTATION_V25_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V25);
+const GETTING_STARTED_V29_TEXT = GETTING_STARTED_V28_TEXT
+  .replace('# Getting started with Meguro v28', '# Getting started with Meguro v29')
+  .replace('Published URI: `' + GETTING_STARTED_V28_URI + '`', 'Published URI: `' + GETTING_STARTED_V29_URI + '`')
+  .replace(DOCUMENTATION_V24_VERSION_LABELS_TEXT, DOCUMENTATION_V25_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V24_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V25_DEEPER_DOCUMENTATION_TEXT)
+  .replace(CORRECTED_RETURN_RESOLUTION_EVIDENCE_GUIDANCE_TEXT, CUSTOMER_LINKED_RETURN_RESOLUTION_EVIDENCE_GUIDANCE_TEXT)
+  .replace(
+    OFFICIAL_RETURN_FINANCE_GUIDANCE_TEXT,
+    `${CORRECTED_OFFICIAL_RETURN_FINANCE_GUIDANCE_TEXT}\n\n${CUSTOMER_LINKED_LOYALTY_GIFT_CARD_GUIDANCE_TEXT}`,
+  );
+const PRODUCT_GUIDE_V26_TEXT = PRODUCT_GUIDE_V25_TEXT
+  .replace('# Meguro product guide v25', '# Meguro product guide v26')
+  .replace('Published URI: `' + PRODUCT_GUIDE_V25_URI + '`', 'Published URI: `' + PRODUCT_GUIDE_V26_URI + '`')
+  .replace(DOCUMENTATION_V24_VERSION_LABELS_TEXT, DOCUMENTATION_V25_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V28_URI, GETTING_STARTED_V29_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V24_URI, DOCUMENTATION_INDEX_V25_URI)
+  .replace(CORRECTED_RETURN_RESOLUTION_EVIDENCE_GUIDANCE_TEXT, CUSTOMER_LINKED_RETURN_RESOLUTION_EVIDENCE_GUIDANCE_TEXT)
+  .replace(
+    OFFICIAL_RETURN_FINANCE_GUIDANCE_TEXT,
+    `${CORRECTED_OFFICIAL_RETURN_FINANCE_GUIDANCE_TEXT}\n\n${CUSTOMER_LINKED_LOYALTY_GIFT_CARD_GUIDANCE_TEXT}`,
   );
+const ORDER_REFUND_AUTHORITY_GUIDANCE_TEXT = `## Return cash resolution and ordinary order refunds
+
+Return approval is policy-only and has no refund or store-credit economics. To resolve one exact
+Return with cash, use \`returnRefund(returnRefundInput:)\` with its \`returnId\` and exact
+\`returnRefundLineItems\`. That is the Return-linked financial operation.
+
+\`refundCreate(input:)\` is instead an ordinary order refund. It may refund a paid order that has no
+Return. \`RefundInput.note\` is opaque customer text and never selects or changes a Return. Cash
+requires an explicit valid \`transactions\` refund; order store credit requires
+\`refundMethods[].storeCreditRefund.amount\`. These methods are mutually exclusive. If neither method is supplied, the practice Admin
+returns structured \`userErrors\` and changes no state. Store credit has no cash transaction, but it
+contributes to the Refund and Order refunded totals.
+
+Read the committed Refund through \`Order.refunds\`. Its id, order, method, amount, cumulative order
+total, and replay identity remain stable after checkpoint reopen. An ordinary order Refund projects
+\`Refund.return\` as null. The cumulative refund cap is the order's authoritative paid amount across
+cash and store-credit methods. Reuse the same \`@idempotent\` key only for an exact replay; the replay
+returns the same Refund and applies no second commerce action or financial effect.
+
+Receipt and Impact footprints keep four distinct counts. \`acceptedMutationCalls\` includes accepted
+replays; \`rejectedMutationCalls\` counts refused calls; \`idempotentReplays\` identifies reused
+results; and \`appliedCommerceActions\` counts only newly applied modeled actions.`;
+const ORDER_REFUND_EVIDENCE_GUIDANCE_TEXT = `## Refund evidence accounting
+
+Return cash uses the committed \`returnRefund\` resolution. Ordinary cash and store-credit order
+refunds use the committed \`refundCreate\` authority and do not select or change a Return. Receipt
+and Impact footprints distinguish accepted calls, rejected calls, idempotent replays, and newly
+applied commerce actions; read the resolution-specific change line for the exact method and amount.`;
+const ORDER_REFUND_LOYALTY_GUIDANCE_TEXT = CUSTOMER_LINKED_LOYALTY_GIFT_CARD_GUIDANCE_TEXT.replace(
+  'Return-linked store credit remains a separate\n`refundCreate.refundMethods.storeCreditRefund` resolution and never uses `giftCardCreate`.',
+  'Order store credit remains a separate ordinary order refund through\n`refundCreate.refundMethods.storeCreditRefund` and never uses `giftCardCreate`.',
+);
+const ADMITTED_RECIPE_DISCOVERY_GUIDANCE_TEXT = `## Discover Admin recipes before lookup
+
+Call \`admin_recipes_list({})\` to enumerate every canonical Admin recipe before choosing one. Every
+listed recipe has already been admitted: its exact document is valid against both the pinned official
+Shopify schema for its declared \`apiVersion\` and Meguro's served subset. A recipe that fails that
+contract is absent from the list rather than listed with a warning.
+
+Each row carries a stable \`id\`, operation name, purpose, confirmation requirement, authored aliases
+and keywords, and the facts you are expected to act on:
+
+- \`apiVersion\` — the Admin version the document is written for. Send it; do not substitute another.
+- \`intendedTemplates\` — the practice store templates the recipe is built for.
+- \`expectedFidelity\` — always \`supported\`, because unsupported coordinates are never published as recipes.
+- \`knownSupportBoundary\` — what the recipe deliberately does not cover.
+- \`outcome\` — for a read, \`emptyResult.meaning\` states exactly what an empty page does and does not
+  prove. Treat an empty page as that answer, not as a failure to retry. For a mutation,
+  \`consequence.statement\` names the state change that commits and \`consequence.readbackProves\`
+  names what an independent read-back establishes.
+- \`prerequisites\` — conditions that must already hold. Each carries a stable \`id\` and, where one
+  exists, the \`establishedBy\` recipe that creates the condition. Run that recipe first.
+
+Then call \`admin_schema({ lookup: "recipe", name: "<id>" })\` with the selected stable id for the exact
+document and the same facts, including the read-back query for a mutation.
+
+If a request is refused for selecting an unsupported coordinate, the error carries one registry-owned
+remedy in \`extensions.remedy\`: the supported coordinate to use and the exact copyable document. Use
+that remedy and ignore any generic GraphQL spelling suggestion.
+
+If \`admin_schema\` returns a recipe miss, follow its bounded \`teaching.nextCall\` exactly. The teaching
+payload contains only canonical recipe ids and authored aliases or keywords; it never guesses a semantic
+match or runs \`admin_probe\`.`;
+const DOCUMENTATION_V26_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V26);
+const DOCUMENTATION_V26_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V26);
+const GETTING_STARTED_V30_TEXT = GETTING_STARTED_V29_TEXT
+  .replace('# Getting started with Meguro v29', '# Getting started with Meguro v30')
+  .replace('Published URI: `' + GETTING_STARTED_V29_URI + '`', 'Published URI: `' + GETTING_STARTED_V30_URI + '`')
+  .replace(DOCUMENTATION_V25_VERSION_LABELS_TEXT, DOCUMENTATION_V26_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V25_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V26_DEEPER_DOCUMENTATION_TEXT)
+  .replace(CUSTOMER_LINKED_RETURN_RESOLUTION_EVIDENCE_GUIDANCE_TEXT, ORDER_REFUND_EVIDENCE_GUIDANCE_TEXT)
+  .replace(CORRECTED_OFFICIAL_RETURN_FINANCE_GUIDANCE_TEXT, ORDER_REFUND_AUTHORITY_GUIDANCE_TEXT)
+  .replace(CUSTOMER_LINKED_LOYALTY_GIFT_CARD_GUIDANCE_TEXT, ORDER_REFUND_LOYALTY_GUIDANCE_TEXT);
+const PRODUCT_GUIDE_V27_TEXT = PRODUCT_GUIDE_V26_TEXT
+  .replace('# Meguro product guide v26', '# Meguro product guide v27')
+  .replace('Published URI: `' + PRODUCT_GUIDE_V26_URI + '`', 'Published URI: `' + PRODUCT_GUIDE_V27_URI + '`')
+  .replace(DOCUMENTATION_V25_VERSION_LABELS_TEXT, DOCUMENTATION_V26_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V29_URI, GETTING_STARTED_V30_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V25_URI, DOCUMENTATION_INDEX_V26_URI)
+  .replace(CUSTOMER_LINKED_RETURN_RESOLUTION_EVIDENCE_GUIDANCE_TEXT, ORDER_REFUND_EVIDENCE_GUIDANCE_TEXT)
+  .replace(CORRECTED_OFFICIAL_RETURN_FINANCE_GUIDANCE_TEXT, ORDER_REFUND_AUTHORITY_GUIDANCE_TEXT)
+  .replace(CUSTOMER_LINKED_LOYALTY_GIFT_CARD_GUIDANCE_TEXT, ORDER_REFUND_LOYALTY_GUIDANCE_TEXT);
+/**
+ * MEG-907: the RULED CANONICAL "When not to use Meguro" copy, carried verbatim from the ruling
+ * document — not paraphrased, re-led, or compressed. The section owns Meguro's limits in Meguro's
+ * own voice per the blame-register law, and deliberately restates no price, tier limit, trial
+ * length, compatibility count, corpus size, percentage, or time span.
+ *
+ * The canonical copy closes with a "Where it fits" line whose receipt claims are gated on Brief #4
+ * landing before launch. That line is HELD here: the quotable report-back block ships on the
+ * authenticated report (MEG-828), but the shared receipt an agent actually hands to a ratifying
+ * human — `meguro.shared-receipt.v2` — does not carry it, and Brief #4's share-page work is ruled
+ * to be built at faucet-open. It is held whole rather than softened or partially paraphrased.
+ */
+const WHEN_NOT_TO_USE_SECTION_TEXT = `## When not to use Meguro
+
+Meguro is deliberately narrow. It is the wrong tool when:
+
+**You need proof of live performance.** Receipts are rehearsal evidence from a simulated store — not forecasts, certifications, or evidence of market demand. Meguro says this in-band because it's true.
+
+**Your critical path lives outside the modeled subset.** Meguro models a subset of the Shopify Admin API and refuses the rest with a teaching error rather than faking behavior. If the calls your app depends on aren't in the modeled subset — the refusal enumerates it, and the compatibility table lists it — Meguro cannot exercise them, and won't pretend to.
+
+**You're testing storefront, themes, or checkout UX.** A practice store is commerce state behind an Admin-shaped API, not a rendered storefront.
+
+**You're load-testing.** The throttle model exists to exercise your agent's backoff discipline, not to benchmark a platform.
+
+**Your agent never touches commerce state.** If it reads a static catalog once, a fixture file is cheaper.
+
+**You want someone to run your agent for you.** Meguro never executes your agent; it provides the store and the record. Bring your own agent — that's the design, not a gap.`;
+
+const DOCUMENTATION_V27_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V27);
+const DOCUMENTATION_V27_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V27);
+const GETTING_STARTED_V31_TEXT = GETTING_STARTED_V30_TEXT
+  .replace('# Getting started with Meguro v30', '# Getting started with Meguro v31')
+  .replace('Published URI: `' + GETTING_STARTED_V30_URI + '`', 'Published URI: `' + GETTING_STARTED_V31_URI + '`')
+  .replace(DOCUMENTATION_V26_VERSION_LABELS_TEXT, DOCUMENTATION_V27_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V26_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V27_DEEPER_DOCUMENTATION_TEXT)
+  .replace(ADMIN_RECIPE_DISCOVERY_GUIDANCE_TEXT, ADMITTED_RECIPE_DISCOVERY_GUIDANCE_TEXT);
+const PRODUCT_GUIDE_V28_TEXT = PRODUCT_GUIDE_V27_TEXT
+  .replace('# Meguro product guide v27', '# Meguro product guide v28')
+  .replace('Published URI: `' + PRODUCT_GUIDE_V27_URI + '`', 'Published URI: `' + PRODUCT_GUIDE_V28_URI + '`')
+  .replace(DOCUMENTATION_V26_VERSION_LABELS_TEXT, DOCUMENTATION_V27_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V30_URI, GETTING_STARTED_V31_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V26_URI, DOCUMENTATION_INDEX_V27_URI)
+  .replace(ADMIN_RECIPE_DISCOVERY_GUIDANCE_TEXT, ADMITTED_RECIPE_DISCOVERY_GUIDANCE_TEXT);
+const DOCUMENTATION_V28_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V28);
+const DOCUMENTATION_V28_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V28);
+const GETTING_STARTED_V32_TEXT = GETTING_STARTED_V31_TEXT
+  .replace('# Getting started with Meguro v31', '# Getting started with Meguro v32')
+  .replace('Published URI: `' + GETTING_STARTED_V31_URI + '`', 'Published URI: `' + GETTING_STARTED_V32_URI + '`')
+  .replace(DOCUMENTATION_V27_VERSION_LABELS_TEXT, DOCUMENTATION_V28_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V27_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V28_DEEPER_DOCUMENTATION_TEXT)
+  .replace(STALE_COMPARE_QUANTITY_SUPERSEDED_TEXT, STALE_CHANGE_FROM_QUANTITY_TEXT);
+const PRODUCT_GUIDE_V29_TEXT = PRODUCT_GUIDE_V28_TEXT
+  .replace('# Meguro product guide v28', '# Meguro product guide v29')
+  .replace('Published URI: `' + PRODUCT_GUIDE_V28_URI + '`', 'Published URI: `' + PRODUCT_GUIDE_V29_URI + '`')
+  .replace(DOCUMENTATION_V27_VERSION_LABELS_TEXT, DOCUMENTATION_V28_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V31_URI, GETTING_STARTED_V32_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V27_URI, DOCUMENTATION_INDEX_V28_URI)
+  // The boundary sits immediately after the orientation, where a reader deciding whether Meguro
+  // fits at all will meet it before investing in the rest of the guide.
+  .replace('## Begin with live store facts', `${WHEN_NOT_TO_USE_SECTION_TEXT}\n\n## Begin with live store facts`)
+  .replace(STALE_COMPARE_QUANTITY_SUPERSEDED_TEXT, STALE_CHANGE_FROM_QUANTITY_TEXT);
 const RECEIPT_GUIDE_V6_TEXT = simulationVocabularyText(
   RECEIPT_GUIDE_V5_TEXT
     .replace('# Meguro receipt guide v5', '# Meguro receipt guide v6')
@@ -1455,6 +3037,413 @@ const RECEIPT_GUIDE_V7_WITH_BASIS = RECEIPT_GUIDE_V6_TEXT
   .replace('Published URI: `' + RECEIPT_GUIDE_V6_URI + '`', 'Published URI: `' + RECEIPT_GUIDE_V7_URI + '`')
   .replace('## Field inventory', `${DAILY_METRIC_BASIS_GUIDE_TEXT}\n\n## Field inventory`);
 const RECEIPT_GUIDE_V7_TEXT = replaceDerivedFieldInventory(RECEIPT_GUIDE_V7_WITH_BASIS, RECEIPT_FIELDS_V7);
+const RECEIPT_GUIDE_V8_WITH_DIMENSIONS = RECEIPT_GUIDE_V7_TEXT
+  .replace('# Meguro receipt guide v7', '# Meguro receipt guide v8')
+  .replace(`Published URI: \`${RECEIPT_GUIDE_V7_URI}\``, `Published URI: \`${RECEIPT_GUIDE_V8_URI}\``)
+  .replace('## Field inventory', `${RUN_RESULT_DIMENSIONS_GUIDANCE_TEXT}\n\n## Field inventory`);
+const RECEIPT_GUIDE_V8_TEXT = replaceDerivedFieldInventory(RECEIPT_GUIDE_V8_WITH_DIMENSIONS, RECEIPT_FIELDS_V8);
+const RECEIPT_GUIDE_V9_WITH_EXPECTED_REFUSALS = RECEIPT_GUIDE_V8_TEXT
+  .replace('# Meguro receipt guide v8', '# Meguro receipt guide v9')
+  .replace(`Published URI: \`${RECEIPT_GUIDE_V8_URI}\``, `Published URI: \`${RECEIPT_GUIDE_V9_URI}\``)
+  .replace('## Field inventory', `${EXPECTED_REFUSAL_GUIDANCE_TEXT}\n\n## Field inventory`);
+const RECEIPT_GUIDE_V9_TEXT = replaceDerivedFieldInventory(RECEIPT_GUIDE_V9_WITH_EXPECTED_REFUSALS, RECEIPT_FIELDS_V9);
+const RECEIPT_GUIDE_V10_WITH_RETURN_RESOLUTIONS = RECEIPT_GUIDE_V9_TEXT
+  .replace('# Meguro receipt guide v9', '# Meguro receipt guide v10')
+  .replace('Published URI: `' + RECEIPT_GUIDE_V9_URI + '`', 'Published URI: `' + RECEIPT_GUIDE_V10_URI + '`')
+  .replace('## Field inventory', `${RETURN_RESOLUTION_EVIDENCE_GUIDANCE_TEXT}\n\n## Field inventory`);
+const RECEIPT_GUIDE_V10_TEXT = replaceDerivedFieldInventory(RECEIPT_GUIDE_V10_WITH_RETURN_RESOLUTIONS, RECEIPT_FIELDS_V10);
+const RECEIPT_GUIDE_V11_WITH_FINAL_GATE = RECEIPT_GUIDE_V10_TEXT
+  .replace('# Meguro receipt guide v10', '# Meguro receipt guide v11')
+  .replace('Published URI: `' + RECEIPT_GUIDE_V10_URI + '`', 'Published URI: `' + RECEIPT_GUIDE_V11_URI + '`')
+  .replace('## Field inventory', `${COMPATIBILITY_AND_FINAL_GATE_GUIDANCE_TEXT}\n\n## Field inventory`);
+const RECEIPT_GUIDE_V11_TEXT = replaceDerivedFieldInventory(RECEIPT_GUIDE_V11_WITH_FINAL_GATE, RECEIPT_FIELDS_V10);
+const COMMITTED_CHANGE_REGISTER_GUIDANCE_TEXT = `## Complete committed change register
+
+For newly issued receipts, \`changes[]\` comes from the accepted action's authoritative modeled
+before/after consequence, not from requested mutation fields. Each row names the operation and
+modeled entity type, carries the exact committed \`before\` and \`after\` values, and identifies its
+\`epistemic\` and \`source\` basis. Numeric rows may also carry \`delta\` and \`unit\`.
+
+Requested values that did not commit do not appear. Normalized values are the committed values.
+Rejected actions do not create change rows. When later accepted actions produce the same public
+consequence fact byte-for-byte, the receipt records that public fact once; distinct before/after
+truth remains distinct. Historical issued receipt bytes and older guide versions do not change.`;
+const RECEIPT_GUIDE_V12_WITH_COMPLETE_CHANGES = RECEIPT_GUIDE_V11_TEXT
+  .replace('# Meguro receipt guide v11', '# Meguro receipt guide v12')
+  .replace('Published URI: `' + RECEIPT_GUIDE_V11_URI + '`', 'Published URI: `' + RECEIPT_GUIDE_V12_URI + '`')
+  .replace('## Field inventory', `${COMMITTED_CHANGE_REGISTER_GUIDANCE_TEXT}\n\n## Field inventory`);
+const RECEIPT_GUIDE_V12_TEXT = replaceDerivedFieldInventory(RECEIPT_GUIDE_V12_WITH_COMPLETE_CHANGES, RECEIPT_FIELDS_V11);
+const RECEIPT_GUIDE_V13_WITH_TEMPLATE_CONTEXT = RECEIPT_GUIDE_V12_TEXT
+  .replace('# Meguro receipt guide v12', '# Meguro receipt guide v13')
+  .replace('Published URI: `' + RECEIPT_GUIDE_V12_URI + '`', 'Published URI: `' + RECEIPT_GUIDE_V13_URI + '`')
+  .replace('## Field inventory', `${TEMPLATE_EVENT_RESOLUTION_GUIDANCE_TEXT}\n\n## Field inventory`);
+const RECEIPT_GUIDE_V13_TEXT = replaceDerivedFieldInventory(
+  RECEIPT_GUIDE_V13_WITH_TEMPLATE_CONTEXT,
+  RECEIPT_FIELDS_V13,
+);
+const RECEIPT_GUIDE_V14_WITH_TERMINOLOGY = RECEIPT_GUIDE_V13_TEXT
+  .replace('# Meguro receipt guide v13', '# Meguro receipt guide v14')
+  .replace('Published URI: `' + RECEIPT_GUIDE_V13_URI + '`', 'Published URI: `' + RECEIPT_GUIDE_V14_URI + '`')
+  .replace('## Field inventory', `${RECEIPT_PRODUCT_TERMINOLOGY_GUIDANCE_TEXT}\n\n## Field inventory`);
+const RECEIPT_GUIDE_V14_TEXT = replaceDerivedFieldInventory(
+  RECEIPT_GUIDE_V14_WITH_TERMINOLOGY,
+  RECEIPT_FIELDS_V13,
+);
+/**
+ * MEG-1034: the v1 capability boundary, published once as new immutable versions.
+ *
+ * The active documents taught verticals a v1 user cannot execute — Shopify Return writes, Gift Card
+ * creation and readback, cross-location transfer — while describing aggregate scenario physics in
+ * the same voice as served entities. These sections replace that teaching. Internal-only physics is
+ * preserved and described as modeled evidence; deferred verticals appear once, as unavailable, with
+ * no request shape, recipe, readback instruction or nearby substitute.
+ */
+const V1_IDEMPOTENCY_REQUIREMENTS_TEXT = `For Admin GraphQL \`${ADMIN_API_SUPPORTED_VERSIONS.join(' and ')}\`, the authoritative set is:
+\`inventoryAdjustQuantities\` and \`refundCreate\` require
+\`@idempotent(key: String!)\`. Place \`@idempotent(key: $idempotencyKey)\` exactly once on the single
+supported mutation root field. The resolved key must be a non-empty string no larger than 256 bytes.
+Use the authority-derived example when present; unrelated roots must not receive this directive.`;
+
+const V1_ORDER_REFUND_AUTHORITY_TEXT = `## Ordinary order refunds
+
+\`refundCreate(input:)\` is the served financial write, and it issues cash only. It refunds a
+canonical Order — one your agent committed by completing a Draft Order.
+
+Name the lines you are refunding. \`input.refundLineItems\` must carry at least one line item of that
+same committed Order, each with a positive whole \`quantity\` and each line named at most once. Value
+and currency come from the Order's own committed lines, never from the request, so \`input.currency\`
+may only repeat the Order's currency and there is no amount field to set. The cumulative refund cap
+is the Order's own outstanding paid amount. \`RefundInput.note\` is opaque customer text.
+
+\`restockType\` chooses what happens to the units: \`RETURN\` restocks them and \`NO_RESTOCK\` does
+not. Those are the only two restock decisions this lane models, and the restock location is the
+Order's own — a caller-selected \`locationId\` is refused.
+
+Read the committed Refund through \`Order.refunds\`; the Order's \`totalRefundedSet\` and the refunded
+leg of \`netPaymentSet\` answer for it too. Its id, order, amount, cumulative order total, and replay
+identity remain stable after checkpoint reopen. Reuse the same \`@idempotent\` key only for an exact
+replay; the replay returns the same Refund and applies no second commerce action or financial effect.
+
+Amount-only refunds, explicit transaction routing, store credit, shipping, duties, discrepancy
+reasons, over-refunding, and a caller-selected \`processedAt\` are not v1 capabilities. Meguro serves
+no \`Order.transactions\`, so \`RefundInput.transactions\`, \`RefundInput.refundMethods\` and
+\`Customer.storeCreditAccounts\` are absent from the schema: naming one fails ordinary GraphQL
+validation rather than returning a substitute.
+
+Return arrivals, returned units, restocking and their refund economics are modeled evidence produced
+by world physics. They are read as Impact evidence, never as a Shopify Return entity, and no Shopify
+Return write is served in v1.
+
+Receipt and Impact footprints keep four distinct counts. \`acceptedMutationCalls\` includes accepted
+replays; \`rejectedMutationCalls\` counts refused calls; \`idempotentReplays\` identifies reused
+results; and \`appliedCommerceActions\` counts only newly applied modeled actions.`;
+
+const V1_REFUND_EVIDENCE_TEXT = `## Refund evidence accounting
+
+A cash refund of a canonical Order's committed lines uses the \`refundCreate\` authority, and it is
+the only served financial write. Modeled return and restocking economics are separate Impact
+evidence and select nothing on the Order. Receipt and Impact footprints distinguish accepted calls,
+rejected calls, idempotent replays, and newly applied commerce actions; read the resolution-specific
+change line for the exact lines and amount.`;
+
+const V1_MODELED_EVIDENCE_TEXT = `## Served capability and modeled evidence
+
+A practice store publishes two different kinds of fact, and a template declares them separately.
+
+- **Served capability.** \`supportedReads\` and \`supportedWrites\` name Shopify Admin coordinates in
+  Meguro's served 2026-07 subset. Every one of them is executable, and every write commits an entity
+  you can read back through an official coordinate.
+- **Modeled evidence.** \`modeledEvidence\` names aggregate world physics: background sales, demand,
+  baskets, return and restocking pressure, fulfillment pressure, loyalty-credit economics, cohort
+  response and cross-location transfer physics. You read these as Impact evidence on the receipt.
+
+Modeled evidence is never a served Shopify entity. Background sales and demand are not \`Order\`
+records, and background return, fulfillment, cohort and loyalty pressure is not a served entity of
+any kind. The only served Orders are the ones an agent commits through Draft-order completion, together
+with their canonical children. The shopper surface commits none: it serves UCP general access, which
+cannot collect payment or place an Order, so a checkout there ends at a buyer handoff.`;
+
+// These six documents were issued before the shopper checkout withdrawal. Their issued bytes remain
+// fixed, so their own construction uses the issuance-time wording rather than the current v1 text.
+const ISSUED_ORDER_REFUND_AUTHORITY_TEXT = `## Ordinary order refunds
+
+\`refundCreate(input:)\` is the served financial write, and it issues cash only. It refunds a
+canonical Order — one your agent committed by completing a Draft Order or a storefront checkout.
+
+Name the lines you are refunding. \`input.refundLineItems\` must carry at least one line item of that
+same committed Order, each with a positive whole \`quantity\` and each line named at most once. Value
+and currency come from the Order's own committed lines, never from the request, so \`input.currency\`
+may only repeat the Order's currency and there is no amount field to set. The cumulative refund cap
+is the Order's own outstanding paid amount. \`RefundInput.note\` is opaque customer text.
+
+\`restockType\` chooses what happens to the units: \`RETURN\` restocks them and \`NO_RESTOCK\` does
+not. Those are the only two restock decisions this lane models, and the restock location is the
+Order's own — a caller-selected \`locationId\` is refused.
+
+Read the committed Refund through \`Order.refunds\`; the Order's \`totalRefundedSet\` and the refunded
+leg of \`netPaymentSet\` answer for it too. Its id, order, amount, cumulative order total, and replay
+identity remain stable after checkpoint reopen. Reuse the same \`@idempotent\` key only for an exact
+replay; the replay returns the same Refund and applies no second commerce action or financial effect.
+
+Amount-only refunds, explicit transaction routing, store credit, shipping, duties, discrepancy
+reasons, over-refunding, and a caller-selected \`processedAt\` are not v1 capabilities. Meguro serves
+no \`Order.transactions\`, so \`RefundInput.transactions\`, \`RefundInput.refundMethods\` and
+\`Customer.storeCreditAccounts\` are absent from the schema: naming one fails ordinary GraphQL
+validation rather than returning a substitute.
+
+Return arrivals, returned units, restocking and their refund economics are modeled evidence produced
+by world physics. They are read as Impact evidence, never as a Shopify Return entity, and no Shopify
+Return write is served in v1.
+
+Receipt and Impact footprints keep four distinct counts. \`acceptedMutationCalls\` includes accepted
+replays; \`rejectedMutationCalls\` counts refused calls; \`idempotentReplays\` identifies reused
+results; and \`appliedCommerceActions\` counts only newly applied modeled actions.`;
+const ISSUED_MODELED_EVIDENCE_TEXT = `## Served capability and modeled evidence
+
+A practice store publishes two different kinds of fact, and a template declares them separately.
+
+- **Served capability.** \`supportedReads\` and \`supportedWrites\` name Shopify Admin coordinates in
+  Meguro's served 2026-07 subset. Every one of them is executable, and every write commits an entity
+  you can read back through an official coordinate.
+- **Modeled evidence.** \`modeledEvidence\` names aggregate world physics: background sales, demand,
+  baskets, return and restocking pressure, fulfillment pressure, loyalty-credit economics, cohort
+  response and cross-location transfer physics. You read these as Impact evidence on the receipt.
+
+Modeled evidence is never a served Shopify entity. Background sales and demand are not \`Order\`
+records, and background return, fulfillment, cohort and loyalty pressure is not a served entity of
+any kind. The only served Orders are the ones an agent commits through Draft-order completion or a
+storefront checkout, together with their canonical children.`;
+
+function issuedCheckoutEraDocumentationText(text) {
+  return text
+    .replace(V1_ORDER_REFUND_AUTHORITY_TEXT, ISSUED_ORDER_REFUND_AUTHORITY_TEXT)
+    .replace(V1_MODELED_EVIDENCE_TEXT, ISSUED_MODELED_EVIDENCE_TEXT);
+}
+
+const V1_VERTICAL_BOUNDARY_TEXT = `## Not available in v1
+
+These Shopify verticals are deferred. Meguro serves no coordinate for them, so a document naming one
+fails ordinary GraphQL validation rather than returning a substitute.
+
+- Arbitrary Product creation. Activate a pre-authored DRAFT Product with
+  \`productUpdate(status: ACTIVE)\` instead.
+- Collections.
+- The Shopify Return lifecycle.
+- Persistent Customer history and enumerable customer-segment membership.
+- Gift Cards.
+- Cross-location inventory transfer as a Shopify operation.
+
+Their modeled counterparts, where the world models one, remain internal physics and are reported as
+modeled evidence.`;
+
+const V1_RECEIPT_RESOLUTION_TEXT = `## Order refund resolution and evidence accounting
+
+A cash refund of a canonical Order's committed lines is a \`refundCreate(input:)\` resolution;
+\`RefundInput.note\` is opaque customer text and the amount is priced from the named lines. Store
+credit is not a v1 refund method. Modeled return and restocking economics are separate Impact
+evidence and are not a Shopify Return lifecycle. The \`storeCreditNetCostCents\` figures under
+\`financialSourceTotals\` are internal-only modeled loyalty-credit economics on the same footing: they
+report world physics, and no Shopify store-credit entity or refund method backs them.`;
+
+const RECEIPT_GUIDE_V15_WITH_BOUNDARY = RECEIPT_GUIDE_V14_TEXT
+  .replace('# Meguro receipt guide v14', '# Meguro receipt guide v15')
+  .replace('Published URI: `' + RECEIPT_GUIDE_V14_URI + '`', 'Published URI: `' + RECEIPT_GUIDE_V15_URI + '`')
+  .replace(`## Return resolution and evidence accounting
+
+Return approval records policy approval only; it has no refund or store-credit economics.
+Return-linked cash is an explicit idempotent \`returnRefund(returnRefundInput:)\` resolution. Ordinary
+order cash and store credit are \`refundCreate(input:)\` resolutions; \`RefundInput.note\` is opaque
+customer text and never selects or changes a Return. The two financial resolutions are
+mutually exclusive for one return.`, V1_RECEIPT_RESOLUTION_TEXT);
+const RECEIPT_GUIDE_V15_TEXT = replaceDerivedFieldInventory(
+  RECEIPT_GUIDE_V15_WITH_BOUNDARY,
+  RECEIPT_FIELDS_V13,
+);
+const PUBLIC_RUN_RECEIPT_MARKDOWN_REPRESENTATION_TEXT = `## Public run receipt JSON and Markdown representations
+
+This contract applies only to a presentation-bearing public **run** receipt. Its
+\`canonicalPath\` addresses canonical JSON; append \`.md\` to address its one fixed Markdown
+alternate. An issued canonical JSON artifact carries \`receipt.presentation.markdown\` with
+\`mediaType\`, \`bytes\`, \`sha256\`, and \`text\`.
+
+Meguro compiles that object before immutable public-receipt storage. The stored canonical JSON
+artifact carries it, so the canonical JSON artifact and its digest cover that stored presentation.
+The \`.md\` resource serves exactly the stored \`receipt.presentation.markdown.text\`. It selects
+those bytes and does not render or classify prose during the request.
+
+JSON and Markdown are distinct representations with distinct digests. \`Content-Digest\` and
+\`X-Meguro-SHA256\` cover the bytes of the representation selected by its fixed URI. The JSON
+resource advertises exactly one Markdown alternate through \`Link\`. \`HEAD\` returns the
+corresponding \`GET\` representation metadata with no body. \`Accept: text/markdown\` on the JSON
+URI does not switch representations and does not introduce \`Vary: Accept\`.
+
+Only permitted browser origins may read \`Content-Digest\`, \`Link\`, and \`X-Meguro-SHA256\` through
+the served CORS exposure contract; do not infer universal origin admission. Unknown, malformed,
+expired, or non-presentation Markdown resources use the same opaque \`receipt-unavailable\` refusal
+and receipt-retention boundary as canonical JSON. Public Impact receipts have no Markdown
+representation contract.`;
+const RECEIPT_GUIDE_V16_WITH_MARKDOWN_REPRESENTATION = RECEIPT_GUIDE_V15_TEXT
+  .replace('# Meguro receipt guide v15', '# Meguro receipt guide v16')
+  .replace('Published URI: `' + RECEIPT_GUIDE_V15_URI + '`', 'Published URI: `' + RECEIPT_GUIDE_V16_URI + '`')
+  .replace('## Field inventory', `${PUBLIC_RUN_RECEIPT_MARKDOWN_REPRESENTATION_TEXT}\n\n## Field inventory`);
+const RECEIPT_GUIDE_V16_TEXT = replaceDerivedFieldInventory(
+  RECEIPT_GUIDE_V16_WITH_MARKDOWN_REPRESENTATION,
+  RECEIPT_FIELDS_V13,
+);
+
+// MEG-967: `send_winback_offer` commits one operating cost —
+// customerCount x (contactCostCents + annoyancePenaltyCents). Naming it an "offer cost" read as
+// offer value, which the discount governs instead. Publish the corrected field name as one new
+// generation; v4-v16 keep their bytes and their original name.
+const RECEIPT_GUIDE_V17_TEXT = RECEIPT_GUIDE_V16_TEXT
+  .replace('# Meguro receipt guide v16', '# Meguro receipt guide v17')
+  .replace('Published URI: `' + RECEIPT_GUIDE_V16_URI + '`', 'Published URI: `' + RECEIPT_GUIDE_V17_URI + '`')
+  .replaceAll('winbackOfferCostCents', 'winbackContactRecoveryCostCents');
+
+const DOCUMENTATION_V29_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V29);
+const DOCUMENTATION_V29_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V29);
+const DOCUMENTATION_V30_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V30);
+const DOCUMENTATION_V30_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V30);
+const DOCUMENTATION_V33_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V33);
+const DOCUMENTATION_V33_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V33);
+const DOCUMENTATION_V34_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V34);
+const DOCUMENTATION_V34_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V34);
+const DOCUMENTATION_V35_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V35);
+const DOCUMENTATION_V35_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V35);
+
+const GETTING_STARTED_V33_TEXT = GETTING_STARTED_V32_TEXT
+  .replace('# Getting started with Meguro v32', '# Getting started with Meguro v33')
+  .replace('Published URI: `' + GETTING_STARTED_V32_URI + '`', 'Published URI: `' + GETTING_STARTED_V33_URI + '`')
+  .replace(DOCUMENTATION_V28_VERSION_LABELS_TEXT, DOCUMENTATION_V29_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V28_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V29_DEEPER_DOCUMENTATION_TEXT)
+  .replaceAll(RECEIPT_GUIDE_V14_URI, RECEIPT_GUIDE_V15_URI)
+  .replace(CORRECTED_IDEMPOTENCY_REQUIREMENTS_TEXT, V1_IDEMPOTENCY_REQUIREMENTS_TEXT)
+  .replace(ORDER_REFUND_EVIDENCE_GUIDANCE_TEXT, V1_REFUND_EVIDENCE_TEXT)
+  .replace(ORDER_REFUND_AUTHORITY_GUIDANCE_TEXT, V1_ORDER_REFUND_AUTHORITY_TEXT)
+  .replace(`${ORDER_REFUND_LOYALTY_GUIDANCE_TEXT}\n\n`, '')
+  .replace('## Deeper in-band documentation', `${V1_MODELED_EVIDENCE_TEXT}\n\n${V1_VERTICAL_BOUNDARY_TEXT}\n\n## Deeper in-band documentation`);
+
+const GETTING_STARTED_V34_SUCCESSOR_TEXT = GETTING_STARTED_V33_TEXT
+  .replace('# Getting started with Meguro v33', '# Getting started with Meguro v34')
+  .replace('Published URI: `' + GETTING_STARTED_V33_URI + '`', 'Published URI: `' + GETTING_STARTED_V34_URI + '`')
+  .replace(DOCUMENTATION_V29_VERSION_LABELS_TEXT, DOCUMENTATION_V30_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V29_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V30_DEEPER_DOCUMENTATION_TEXT)
+  .replaceAll(DOCUMENTATION_INDEX_V29_URI, DOCUMENTATION_INDEX_V30_URI)
+  .replace(`1. Call \`templates_list()\` to discover the exact supported template keys.
+2. Call \`stores_list()\`; reuse an owned practice store or call
+   \`store_create({ templateKey })\` with a key returned by \`templates_list\`.`, `Canonical cold sequence: \`templates_list\` → \`template_get\` → \`store_create\` → \`practice_run_start\`.
+
+1. Call \`templates_list()\` to discover the exact supported template keys. It is the compact
+   complete catalog: every row carries \`key\`, \`label\`, \`category\`, \`recommended\`, \`bestFor\`
+   and \`recommendedRunDays\` — enough to choose, and no contracts.
+2. Call \`template_get({ templateKey })\` for the key you are considering. It returns that one
+   template's complete record: what the agent sees, timing, supported reads and writes, operation
+   contracts, unsupported contracts, capability boundaries, modeled evidence and physics, and
+   rubric fields. Choose from the catalog, then read the template you chose.
+3. Call \`stores_list()\`; reuse an owned practice store or call
+   \`store_create({ templateKey })\` with a key returned by \`templates_list\`.`)
+  .replace(
+    '| Which templates are available? | Call \\`templates_list\\`. |',
+    '| Which templates are available? | Call \\`templates_list\\` to choose, then \\`template_get({ templateKey })\\` for that template\'s contracts and boundaries. |',
+  );
+const GETTING_STARTED_V34_TEXT = issuedCheckoutEraDocumentationText(GETTING_STARTED_V34_SUCCESSOR_TEXT);
+
+const PRODUCT_GUIDE_V30_TEXT = PRODUCT_GUIDE_V29_TEXT
+  .replace('# Meguro product guide v29', '# Meguro product guide v30')
+  .replace('Published URI: `' + PRODUCT_GUIDE_V29_URI + '`', 'Published URI: `' + PRODUCT_GUIDE_V30_URI + '`')
+  .replace(DOCUMENTATION_V28_VERSION_LABELS_TEXT, DOCUMENTATION_V29_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V32_URI, GETTING_STARTED_V33_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V28_URI, DOCUMENTATION_INDEX_V29_URI)
+  .replaceAll(RECEIPT_GUIDE_V14_URI, RECEIPT_GUIDE_V15_URI)
+  .replace(CORRECTED_IDEMPOTENCY_REQUIREMENTS_TEXT, V1_IDEMPOTENCY_REQUIREMENTS_TEXT)
+  .replace(ORDER_REFUND_EVIDENCE_GUIDANCE_TEXT, V1_REFUND_EVIDENCE_TEXT)
+  .replace(ORDER_REFUND_AUTHORITY_GUIDANCE_TEXT, V1_ORDER_REFUND_AUTHORITY_TEXT)
+  .replace(`${ORDER_REFUND_LOYALTY_GUIDANCE_TEXT}\n\n`, '')
+  .replace('## Begin with live store facts', `${V1_MODELED_EVIDENCE_TEXT}\n\n${V1_VERTICAL_BOUNDARY_TEXT}\n\n## Begin with live store facts`);
+
+const PRODUCT_GUIDE_V31_SUCCESSOR_TEXT = PRODUCT_GUIDE_V30_TEXT
+  .replace('# Meguro product guide v30', '# Meguro product guide v31')
+  .replace('Published URI: `' + PRODUCT_GUIDE_V30_URI + '`', 'Published URI: `' + PRODUCT_GUIDE_V31_URI + '`')
+  .replace(DOCUMENTATION_V29_VERSION_LABELS_TEXT, DOCUMENTATION_V30_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V33_URI, GETTING_STARTED_V34_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V29_URI, DOCUMENTATION_INDEX_V30_URI);
+const PRODUCT_GUIDE_V31_TEXT = issuedCheckoutEraDocumentationText(PRODUCT_GUIDE_V31_SUCCESSOR_TEXT);
+
+const CANONICAL_ADVANCE_CURSOR_GUIDANCE_TEXT = `## One server-owned advance cursor
+
+Every practice-run start and status response carries \`practiceRun.advanceCursor\` with exactly
+\`expectedDay\` and \`expectedCallSeq\`. Copy that object unchanged into the next
+\`practice_run_advance\` call or HTTP advance body. Do not choose between \`currentDay\` and
+\`watermarkDay\`, and do not combine call-sequence fields from separate reads.
+
+Start, accepted-call status, zero-call status, advance, checkpoint, terminal confirmation,
+refusal recovery, checkpoint reopen, and completed status all return the same server-owned shape.
+A stale cursor fails closed and moves no Store time; the refusal returns a fresh \`advanceCursor\`
+for one exact retry.`;
+
+const GETTING_STARTED_V35_SUCCESSOR_TEXT = GETTING_STARTED_V34_SUCCESSOR_TEXT
+  .replace('# Getting started with Meguro v34', '# Getting started with Meguro v35')
+  .replace('Published URI: `' + GETTING_STARTED_V34_URI + '`', 'Published URI: `' + GETTING_STARTED_V35_URI + '`')
+  .replace(DOCUMENTATION_V30_VERSION_LABELS_TEXT, DOCUMENTATION_V33_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V30_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V33_DEEPER_DOCUMENTATION_TEXT)
+  .replaceAll(DOCUMENTATION_INDEX_V30_URI, DOCUMENTATION_INDEX_V33_URI)
+  .replace(`- \`storeId\` is the canonical public id of a practice store. \`worldId\` is the legacy alias for the
+  same id; prefer \`storeId\` in new integrations.`, `- \`storeId\` is the public id of a practice store. Pass it unchanged to
+  \`get_connection_details\` and \`practice_run_start\`.
+- When declaring an external-agent source revision, use \`externalAgent.commitSha\`.`)
+  .replace(ADVANCE_CURSOR_GUIDANCE_TEXT, CANONICAL_ADVANCE_CURSOR_GUIDANCE_TEXT);
+const GETTING_STARTED_V35_TEXT = issuedCheckoutEraDocumentationText(GETTING_STARTED_V35_SUCCESSOR_TEXT);
+
+const GETTING_STARTED_V36_SUCCESSOR_TEXT = GETTING_STARTED_V35_SUCCESSOR_TEXT
+  .replace('# Getting started with Meguro v35', '# Getting started with Meguro v36')
+  .replace('Published URI: `' + GETTING_STARTED_V35_URI + '`', 'Published URI: `' + GETTING_STARTED_V36_URI + '`')
+  .replace(DOCUMENTATION_V33_VERSION_LABELS_TEXT, DOCUMENTATION_V34_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V33_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V34_DEEPER_DOCUMENTATION_TEXT)
+  .replaceAll(DOCUMENTATION_INDEX_V33_URI, DOCUMENTATION_INDEX_V34_URI)
+  .replaceAll(GATE_POLICY_V4_URI, GATE_POLICY_V5_URI);
+const GETTING_STARTED_V36_TEXT = issuedCheckoutEraDocumentationText(GETTING_STARTED_V36_SUCCESSOR_TEXT);
+
+const GETTING_STARTED_V37_TEXT = GETTING_STARTED_V36_SUCCESSOR_TEXT
+  .replace('# Getting started with Meguro v36', '# Getting started with Meguro v37')
+  .replace('Published URI: `' + GETTING_STARTED_V36_URI + '`', 'Published URI: `' + GETTING_STARTED_V37_URI + '`')
+  .replace(DOCUMENTATION_V34_VERSION_LABELS_TEXT, DOCUMENTATION_V35_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V34_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V35_DEEPER_DOCUMENTATION_TEXT)
+  .replaceAll(DOCUMENTATION_INDEX_V34_URI, DOCUMENTATION_INDEX_V35_URI)
+  .replace('3. Call `get_connection_details({ storeId })`', '4. Call `get_connection_details({ storeId })`')
+  .replace('4. Call `practice_run_start({ storeId, clock })`', '5. Call `practice_run_start({ storeId, clock })`')
+  .replace('5. Run the commerce agent', '6. Run the commerce agent')
+  .replace('6. Call `practice_run_status({ attemptId })`', '7. Call `practice_run_status({ attemptId })`')
+  .replace('7. Call `practice_run_advance({ attemptId, days, advanceCursor })`', '8. Call `practice_run_advance({ attemptId, days, advanceCursor })`')
+  .replace('8. Call `practice_run_finish({ attemptId })`', '9. Call `practice_run_finish({ attemptId })`')
+  .replace('9. Call `practice_run_report({ attemptId })`', '10. Call `practice_run_report({ attemptId })`');
+
+const PRODUCT_GUIDE_V32_SUCCESSOR_TEXT = PRODUCT_GUIDE_V31_SUCCESSOR_TEXT
+  .replace('# Meguro product guide v31', '# Meguro product guide v32')
+  .replace('Published URI: `' + PRODUCT_GUIDE_V31_URI + '`', 'Published URI: `' + PRODUCT_GUIDE_V32_URI + '`')
+  .replace(DOCUMENTATION_V30_VERSION_LABELS_TEXT, DOCUMENTATION_V33_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V34_URI, GETTING_STARTED_V35_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V30_URI, DOCUMENTATION_INDEX_V33_URI)
+  .replace(ADVANCE_CURSOR_GUIDANCE_TEXT, CANONICAL_ADVANCE_CURSOR_GUIDANCE_TEXT);
+const PRODUCT_GUIDE_V32_TEXT = issuedCheckoutEraDocumentationText(PRODUCT_GUIDE_V32_SUCCESSOR_TEXT);
+
+const PRODUCT_GUIDE_V33_SUCCESSOR_TEXT = PRODUCT_GUIDE_V32_SUCCESSOR_TEXT
+  .replace('# Meguro product guide v32', '# Meguro product guide v33')
+  .replace('Published URI: `' + PRODUCT_GUIDE_V32_URI + '`', 'Published URI: `' + PRODUCT_GUIDE_V33_URI + '`')
+  .replace(DOCUMENTATION_V33_VERSION_LABELS_TEXT, DOCUMENTATION_V34_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V35_URI, GETTING_STARTED_V36_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V33_URI, DOCUMENTATION_INDEX_V34_URI)
+  .replaceAll(RECEIPT_GUIDE_V15_URI, RECEIPT_GUIDE_V17_URI)
+  .replaceAll(GATE_POLICY_V3_URI, GATE_POLICY_V5_URI)
+  .replaceAll(GATE_POLICY_V4_URI, GATE_POLICY_V5_URI);
+const PRODUCT_GUIDE_V33_TEXT = issuedCheckoutEraDocumentationText(PRODUCT_GUIDE_V33_SUCCESSOR_TEXT);
+
+const PRODUCT_GUIDE_V34_TEXT = PRODUCT_GUIDE_V33_SUCCESSOR_TEXT
+  .replace('# Meguro product guide v33', '# Meguro product guide v34')
+  .replace('Published URI: `' + PRODUCT_GUIDE_V33_URI + '`', 'Published URI: `' + PRODUCT_GUIDE_V34_URI + '`')
+  .replace(DOCUMENTATION_V34_VERSION_LABELS_TEXT, DOCUMENTATION_V35_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V36_URI, GETTING_STARTED_V37_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V34_URI, DOCUMENTATION_INDEX_V35_URI);
+
 const GATE_POLICY_V2_TEXT = simulationVocabularyText(
   GATE_POLICY_TEXT
     .replace('# Meguro Gate policy v1', '# Meguro Gate policy v2')
@@ -1467,6 +3456,11 @@ const GATE_POLICY_V1_CHECK_TEXT = GATE_POLICY_V1_CHECKS.map((check) => `### ${ch
 - Flip condition: ${check.flip}.`).join('\n\n');
 const GATE_POLICY_V3_CHECK_TEXT = GATE_POLICY_V3_CHECKS.map((check) => `### ${check.name}
 
+- Receipt facts: ${check.facts.map((fact) => `\`${fact}\``).join(', ')}
+- Threshold: ${check.threshold}.
+- Flip condition: ${check.flip}.`).join('\n\n');
+const GATE_POLICY_V6_CHECK_TEXT = GATE_POLICY_V6_CHECKS.map((check) => `### ${check.name}
+
 - Receipt facts: ${check.facts.map((fact) => `\`${fact}\``).join(', ')}
 - Threshold: ${check.threshold}.
 - Flip condition: ${check.flip}.`).join('\n\n');
@@ -1496,6 +3490,107 @@ corrects its fact-path addressing against the complete canonical verdict payload
 the runtime thresholds or either historical documentation resource. Versions 1 and 2 retain their
 original bytes and digests, while this corrected resource remains immutable at \`${GATE_POLICY_V3_URI}\`.`,
   );
+const GATE_POLICY_V4_TEXT = GATE_POLICY_V3_TEXT
+  .replace('# Meguro Gate policy v3', '# Meguro Configured Receipt Gate policy v4')
+  .replace(`Published URI: \`${GATE_POLICY_V3_URI}\``, `Published URI: \`${GATE_POLICY_V4_URI}\``)
+  .replace('## Canonical fact root', `${RECEIPT_PRODUCT_TERMINOLOGY_GUIDANCE_TEXT}\n\n## Canonical fact root`);
+const GATE_POLICY_V5_TEXT = GATE_POLICY_V4_TEXT
+  .replace('# Meguro Configured Receipt Gate policy v4', '# Meguro Configured Receipt Gate policy v5')
+  .replace('Published URI: `' + GATE_POLICY_V4_URI + '`', 'Published URI: `' + GATE_POLICY_V5_URI + '`')
+  .replaceAll(GATE_POLICY_V3_URI, GATE_POLICY_V5_URI)
+  .replace(
+    'Documentation version 3\ncorrects its fact-path addressing against the complete canonical verdict payload;',
+    'Documentation version 5\npublishes that fact-path addressing against the complete canonical verdict payload;',
+  )
+  .replace(
+    'Versions 1 and 2 retain their\noriginal bytes and digests',
+    'Versions 1 through 4 retain their\noriginal bytes and digests',
+  );
+
+// MEG-1204: one atomic generation. Each new version carries every correction that applies to it and
+// no other movement; v5/v37/v34/v17/v35 and earlier keep their exact bytes and digests.
+const GATE_POLICY_V6_TEXT = GATE_POLICY_V5_TEXT
+  .replace('# Meguro Configured Receipt Gate policy v5', '# Meguro Configured Receipt Gate policy v6')
+  .replaceAll(GATE_POLICY_V5_URI, GATE_POLICY_V6_URI)
+  .replace(GATE_POLICY_V3_CHECK_TEXT, GATE_POLICY_V6_CHECK_TEXT)
+  .replace(MUTABLE_GATE_ABSENCE_TEXT, STATE_NEUTRAL_GATE_PRESENCE_TEXT)
+  .replace('Documentation version 5\npublishes', 'Documentation version 6\npublishes')
+  .replace('Versions 1 through 4 retain their\noriginal bytes and digests', 'Versions 1 through 5 retain their\noriginal bytes and digests');
+
+const RECEIPT_GUIDE_V18_FIELD_INDEX_HEADING_TEXT = `## Generated field index
+
+This section is a generated index of paths, not an authored interpretation. Every documented path
+below participates in the bidirectional completeness guard: it proves that every schema path is
+documented and that no documented path has left its schema. It does not establish what a field
+means; read the authored sections above for meaning, basis, and limits. \`[]\` means each array
+item. A field whose value is an opaque, separately versioned object is documented at that object
+boundary and by its own schema section.`;
+const RECEIPT_GUIDE_V17_FIELD_INVENTORY_HEADING_TEXT = `## Field inventory
+
+Every documented path below participates in the bidirectional completeness guard. \`[]\` means each
+array item. A field whose value is an opaque, separately versioned object is documented at that
+object boundary and by its own schema section.`;
+const RECEIPT_GUIDE_V17_WINBACK_MEANING_TEXT = ' — Recorded winback offer cost cents in meguro.hosted-impact-report.v1; interpret it with that schema\'s basis and adjacent evidence fields.';
+const RECEIPT_GUIDE_V18_WINBACK_MEANING_TEXT = ' — The per-contact recovery operating cost in cents: contact cost plus annoyance penalty for each contacted customer. It is an operating cost, distinct from any discount that changes the recovered price.';
+const RECEIPT_GUIDE_V18_TEXT = RECEIPT_GUIDE_V17_TEXT
+  .replace('# Meguro receipt guide v17', '# Meguro receipt guide v18')
+  .replaceAll(RECEIPT_GUIDE_V17_URI, RECEIPT_GUIDE_V18_URI)
+  .replace(MUTABLE_GATE_ABSENCE_TEXT, STATE_NEUTRAL_GATE_PRESENCE_TEXT)
+  .replace(RECEIPT_GUIDE_V17_FIELD_INVENTORY_HEADING_TEXT, RECEIPT_GUIDE_V18_FIELD_INDEX_HEADING_TEXT)
+  .replaceAll(RECEIPT_GUIDE_V17_WINBACK_MEANING_TEXT, RECEIPT_GUIDE_V18_WINBACK_MEANING_TEXT);
+
+const DOCUMENTATION_V36_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V36);
+const DOCUMENTATION_V36_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V36);
+const DOCUMENTATION_V37_VERSION_LABELS_TEXT = versionLabelsText(DOCUMENTATION_CURRENCY_V37);
+const DOCUMENTATION_V37_DEEPER_DOCUMENTATION_TEXT = deeperDocumentationText(DOCUMENTATION_CURRENCY_V37);
+
+const HISTORY_SPAN_BASIS_FACT_TEXT = `Each practice store's history span is a live per-store fact. Its immutable creation basis is
+\`historySpan.creation\`: \`historySpan.creation.startDate\`, \`historySpan.creation.endDate\`, and
+\`historySpan.creation.days\` always describe the generated span. Its live queryable basis is
+\`historySpan.current.days\`, which can advance when a run advances Store time. Do not combine fields
+across those structures.`;
+const HOSTED_REAL_STORE_HISTORY_LANE_GUIDANCE_TEXT = `Meguro's separate real-store history lane is served through hosted OAuth MCP and public STDIO. Call
+\`runs_list\` to discover history runs, \`run_status\` to inspect one, \`run_report\` to read its report,
+and \`twin_diff\` only for a valid recorded history-run pair.`;
+
+const GETTING_STARTED_V38_TEXT = GETTING_STARTED_V37_TEXT
+  .replace('# Getting started with Meguro v37', '# Getting started with Meguro v38')
+  .replaceAll(GETTING_STARTED_V37_URI, GETTING_STARTED_V38_URI)
+  .replace(DOCUMENTATION_V35_VERSION_LABELS_TEXT, DOCUMENTATION_V36_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V35_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V36_DEEPER_DOCUMENTATION_TEXT)
+  .replace(MUTABLE_GATE_ABSENCE_TEXT, STATE_NEUTRAL_GATE_PRESENCE_TEXT);
+
+const PRODUCT_GUIDE_V35_TEXT = PRODUCT_GUIDE_V34_TEXT
+  .replace('# Meguro product guide v34', '# Meguro product guide v35')
+  .replaceAll(PRODUCT_GUIDE_V34_URI, PRODUCT_GUIDE_V35_URI)
+  .replace(DOCUMENTATION_V35_VERSION_LABELS_TEXT, DOCUMENTATION_V36_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V37_URI, GETTING_STARTED_V38_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V35_URI, DOCUMENTATION_INDEX_V36_URI)
+  .replaceAll(RECEIPT_GUIDE_V17_URI, RECEIPT_GUIDE_V18_URI)
+  .replaceAll(GATE_POLICY_V5_URI, GATE_POLICY_V6_URI)
+  .replace(MUTABLE_GATE_ABSENCE_TEXT, STATE_NEUTRAL_GATE_PRESENCE_TEXT);
+
+const GETTING_STARTED_V39_TEXT = GETTING_STARTED_V38_TEXT
+  .replace('# Getting started with Meguro v38', '# Getting started with Meguro v39')
+  .replaceAll(GETTING_STARTED_V38_URI, GETTING_STARTED_V39_URI)
+  .replace(DOCUMENTATION_V36_VERSION_LABELS_TEXT, DOCUMENTATION_V37_VERSION_LABELS_TEXT)
+  .replace(DOCUMENTATION_V36_DEEPER_DOCUMENTATION_TEXT, DOCUMENTATION_V37_DEEPER_DOCUMENTATION_TEXT)
+  .replaceAll(DOCUMENTATION_INDEX_V36_URI, DOCUMENTATION_INDEX_V37_URI)
+  .replace(REAL_STORE_HISTORY_LANE_BRIDGE, HOSTED_REAL_STORE_HISTORY_LANE_GUIDANCE_TEXT)
+  .replace("Each practice store's history span is a live per-store fact.", HISTORY_SPAN_BASIS_FACT_TEXT)
+  .replaceAll('stores[].historySpan.days', 'stores[].historySpan.current.days')
+  .replaceAll('historySpan.historyDays', 'historySpan.current.days');
+
+const PRODUCT_GUIDE_V36_TEXT = PRODUCT_GUIDE_V35_TEXT
+  .replace('# Meguro product guide v35', '# Meguro product guide v36')
+  .replaceAll(PRODUCT_GUIDE_V35_URI, PRODUCT_GUIDE_V36_URI)
+  .replace(DOCUMENTATION_V36_VERSION_LABELS_TEXT, DOCUMENTATION_V37_VERSION_LABELS_TEXT)
+  .replaceAll(GETTING_STARTED_V38_URI, GETTING_STARTED_V39_URI)
+  .replaceAll(DOCUMENTATION_INDEX_V36_URI, DOCUMENTATION_INDEX_V37_URI)
+  .replace(REAL_STORE_HISTORY_LANE_BRIDGE, HOSTED_REAL_STORE_HISTORY_LANE_GUIDANCE_TEXT)
+  .replace("Each practice store's history span is a live per-store fact.", HISTORY_SPAN_BASIS_FACT_TEXT)
+  .replaceAll('stores[].historySpan.days', 'stores[].historySpan.current.days')
+  .replaceAll('historySpan.historyDays', 'historySpan.current.days');
 
 function gatePolicyValueAt(value, path) {
   return path.replace(/\[(\d+)\]/gu, '.$1').split('.').reduce((current, key) => {
@@ -1674,50 +3769,608 @@ const CATALOG = buildDocumentationCatalog([
     text: GETTING_STARTED_V8_TEXT,
   },
   {
-    topic: 'product-guide',
-    version: PRODUCT_GUIDE_VERSION,
-    uri: PRODUCT_GUIDE_URI,
-    name: 'Meguro product guide v1',
-    title: 'Meguro product guide v1',
-    description: 'Stable product concepts, evidence boundaries, surface responsibilities, and question-to-source routing.',
-    text: PRODUCT_GUIDE_TEXT,
-    expectedSha256: PRODUCT_GUIDE_SHA256,
+    topic: 'getting-started',
+    version: GETTING_STARTED_V9_VERSION,
+    uri: GETTING_STARTED_V9_URI,
+    name: 'Getting started with Meguro v9',
+    title: 'Getting started with Meguro v9',
+    description: 'Hosted sequence with four independent run-result dimensions and neutral modeled-outcome language.',
+    text: GETTING_STARTED_V9_TEXT,
   },
   {
-    topic: 'product-guide',
-    version: PRODUCT_GUIDE_V2_VERSION,
-    uri: PRODUCT_GUIDE_V2_URI,
-    name: 'Meguro product guide v2',
-    title: 'Meguro product guide v2',
-    description: 'Stable product concepts, simulation vocabulary, evidence boundaries, surface responsibilities, and question-to-source routing.',
-    text: PRODUCT_GUIDE_V2_TEXT,
+    topic: 'getting-started',
+    version: GETTING_STARTED_V10_VERSION,
+    uri: GETTING_STARTED_V10_URI,
+    name: 'Getting started with Meguro v10',
+    title: 'Getting started with Meguro v10',
+    description: 'Hosted sequence with immutable pre-call expected-refusal declarations and server-emitted assertion results.',
+    text: GETTING_STARTED_V10_TEXT,
   },
   {
-    topic: 'product-guide',
-    version: PRODUCT_GUIDE_V3_VERSION,
-    uri: PRODUCT_GUIDE_V3_URI,
-    name: 'Meguro product guide v3',
-    title: 'Meguro product guide v3',
-    description: 'World-first product concepts, evidence boundaries, surface responsibilities, and question-to-source routing.',
-    text: PRODUCT_GUIDE_V3_TEXT,
+    topic: 'getting-started',
+    version: GETTING_STARTED_V11_VERSION,
+    uri: GETTING_STARTED_V11_URI,
+    name: 'Getting started with Meguro v11',
+    title: 'Getting started with Meguro v11',
+    description: 'Hosted sequence with live per-store history discovery and explicit ordinary-store versus seeded-sample provenance.',
+    text: GETTING_STARTED_V11_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: 'getting-started',
+    version: GETTING_STARTED_V12_VERSION,
+    uri: GETTING_STARTED_V12_URI,
+    name: 'Getting started with Meguro v12',
+    title: 'Getting started with Meguro v12',
+    description: 'Hosted sequence with registry-derived Admin recipe enumeration and bounded miss recovery.',
+    text: GETTING_STARTED_V12_TEXT,
   },
   {
-    topic: 'product-guide',
-    version: PRODUCT_GUIDE_V5_VERSION,
-    uri: PRODUCT_GUIDE_V5_URI,
-    name: 'Meguro product guide v5',
-    title: 'Meguro product guide v5',
-    description: 'Current-link-derived product concepts with version-label, assertion-family, and effect-level channel guidance.',
-    text: PRODUCT_GUIDE_V5_TEXT,
+    topic: 'getting-started',
+    version: GETTING_STARTED_V13_VERSION,
+    uri: GETTING_STARTED_V13_URI,
+    name: 'Getting started with Meguro v13',
+    title: 'Getting started with Meguro v13',
+    description: 'Hosted sequence with state-aware Admin authentication, read-before-write, and idempotency preflight guidance.',
+    text: GETTING_STARTED_V13_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V14_VERSION,
+    uri: GETTING_STARTED_V14_URI,
+    name: 'Getting started with Meguro v14',
+    title: 'Getting started with Meguro v14',
+    description: 'Hosted sequence with disposable attempt-state, retained evidence, terminal access, metering, and explicit run-end guidance.',
+    text: GETTING_STARTED_V14_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V15_VERSION,
+    uri: GETTING_STARTED_V15_URI,
+    name: 'Getting started with Meguro v15',
+    title: 'Getting started with Meguro v15',
+    description: 'Hosted sequence with environment-derived account entry and the complete two-authority OAuth lifecycle.',
+    text: GETTING_STARTED_V15_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V16_VERSION,
+    uri: GETTING_STARTED_V16_URI,
+    name: 'Getting started with Meguro v16',
+    title: 'Getting started with Meguro v16',
+    description: 'Hosted sequence with explicit, mutually exclusive return-resolution operations and four-way receipt evidence accounting.',
+    text: GETTING_STARTED_V16_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V17_VERSION,
+    uri: GETTING_STARTED_V17_URI,
+    name: 'Getting started with Meguro v17',
+    title: 'Getting started with Meguro v17',
+    description: 'Hosted sequence with the corrected authoritative idempotency set for return-linked store credit.',
+    text: GETTING_STARTED_V17_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V18_VERSION,
+    uri: GETTING_STARTED_V18_URI,
+    name: 'Getting started with Meguro v18',
+    title: 'Getting started with Meguro v18',
+    description: 'Zero-prior-knowledge hosted sequence that defines Meguro, practice stores, Store time, runs, receipts, and the rehearsal boundary before operational guidance.',
+    text: GETTING_STARTED_V18_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V19_VERSION,
+    uri: GETTING_STARTED_V19_URI,
+    name: 'Getting started with Meguro v19',
+    title: 'Getting started with Meguro v19',
+    description: 'Zero-prior-knowledge hosted sequence that defines Meguro, practice stores, Store time, runs, receipts, and the rehearsal boundary, with the server-owned 120-day ordinary-store history default and explicit direct-API override rule.',
+    text: GETTING_STARTED_V19_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V20_VERSION,
+    uri: GETTING_STARTED_V20_URI,
+    name: 'Getting started with Meguro v20',
+    title: 'Getting started with Meguro v20',
+    description: 'Zero-prior-knowledge hosted sequence that preserves the rehearsal boundary and defines the normalized sample-store onboarding, visibility, discovery, permanent-claim, receipt, and metering contract.',
+    text: GETTING_STARTED_V20_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V21_VERSION,
+    uri: GETTING_STARTED_V21_URI,
+    name: 'Getting started with Meguro v21',
+    title: 'Getting started with Meguro v21',
+    description: 'Zero-prior-knowledge hosted sequence that preserves the rehearsal boundary, normalized sample-store contract, and truthful shared store machinery for the explicit 90-day sample history configuration.',
+    text: GETTING_STARTED_V21_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V22_VERSION,
+    uri: GETTING_STARTED_V22_URI,
+    name: 'Getting started with Meguro v22',
+    title: 'Getting started with Meguro v22',
+    description: 'Zero-prior-knowledge hosted sequence preserving the rehearsal boundary, with exact polymorphic Node compatibility scope and one server-owned final receipt Gate.',
+    text: GETTING_STARTED_V22_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V23_VERSION,
+    uri: GETTING_STARTED_V23_URI,
+    name: 'Getting started with Meguro v23',
+    title: 'Getting started with Meguro v23',
+    description: 'Zero-prior-knowledge hosted sequence preserving the rehearsal boundary with one account-owned, user-chosen onboarding evaluation grant and server-owned per-template executable plans.',
+    text: GETTING_STARTED_V23_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V24_VERSION,
+    uri: GETTING_STARTED_V24_URI,
+    name: 'Getting started with Meguro v24',
+    title: 'Getting started with Meguro v24',
+    description: 'Zero-prior-knowledge hosted sequence preserving the rehearsal boundary and routing receipt interpretation to the complete committed change register.',
+    text: GETTING_STARTED_V24_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V25_VERSION,
+    uri: GETTING_STARTED_V25_URI,
+    name: 'Getting started with Meguro v25',
+    title: 'Getting started with Meguro v25',
+    description: 'Zero-prior-knowledge hosted sequence preserving the rehearsal boundary with creation-pinned template event resolution and explicit legacy unavailability.',
+    text: GETTING_STARTED_V25_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V26_VERSION,
+    uri: GETTING_STARTED_V26_URI,
+    name: 'Getting started with Meguro v26',
+    title: 'Getting started with Meguro v26',
+    description: 'Zero-prior-knowledge hosted sequence preserving the rehearsal boundary with one server-owned, machine-copyable practice-run advance cursor.',
+    text: GETTING_STARTED_V26_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V27_VERSION,
+    uri: GETTING_STARTED_V27_URI,
+    name: 'Getting started with Meguro v27',
+    title: 'Getting started with Meguro v27',
+    description: 'Zero-prior-knowledge hosted sequence carrying the server-owned, machine-copyable advance cursor and distinguishing automatic Recorded API behavior from the optional Configured Receipt Gate while preserving frozen machine contracts.',
+    text: GETTING_STARTED_V27_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V28_VERSION,
+    uri: GETTING_STARTED_V28_URI,
+    name: 'Getting started with Meguro v28',
+    title: 'Getting started with Meguro v28',
+    description: 'Zero-prior-knowledge hosted sequence carrying the server-owned, machine-copyable advance cursor, distinguishing automatic Recorded API behavior from the optional Configured Receipt Gate, and using the pinned official Shopify refund, return-refund, store-credit, transaction, and suggested-outcome mechanics.',
+    text: GETTING_STARTED_V28_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V29_VERSION,
+    uri: GETTING_STARTED_V29_URI,
+    name: 'Getting started with Meguro v29',
+    title: 'Getting started with Meguro v29',
+    description: 'Zero-prior-knowledge hosted sequence carrying the server-owned, machine-copyable advance cursor, distinguishing automatic Recorded API behavior from the optional Configured Receipt Gate, and keeping official Shopify return finance distinct from customer-linked loyalty GiftCard mechanics.',
+    text: GETTING_STARTED_V29_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V30_VERSION,
+    uri: GETTING_STARTED_V30_URI,
+    name: 'Getting started with Meguro v30',
+    title: 'Getting started with Meguro v30',
+    description: 'Zero-prior-knowledge hosted sequence carrying the server-owned, machine-copyable practice-run advance cursor, distinguishing automatic Recorded API behavior from the optional Configured Receipt Gate, with Return-linked cash on returnRefund and ordinary cash or store-credit order refunds on refundCreate, including explicit method, replay, cap, and read-back rules.',
+    text: GETTING_STARTED_V30_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V31_VERSION,
+    uri: GETTING_STARTED_V31_URI,
+    name: 'Getting started with Meguro v31',
+    title: 'Getting started with Meguro v31',
+    description: 'Zero-prior-knowledge hosted sequence carrying the server-owned, machine-copyable practice-run advance cursor, distinguishing automatic Recorded API behavior from the optional Configured Receipt Gate, with admitted Admin recipes that publish declared API version, intended templates, support boundary, empty-result or committed-consequence semantics, prerequisites, and one registry-owned copyable remedy.',
+    text: GETTING_STARTED_V31_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V32_VERSION,
+    uri: GETTING_STARTED_V32_URI,
+    name: 'Getting started with Meguro v32',
+    title: 'Getting started with Meguro v32',
+    description: 'Zero-prior-knowledge hosted sequence carrying the server-owned, machine-copyable practice-run advance cursor, distinguishing automatic Recorded API behavior from the optional Configured Receipt Gate, with admitted Admin recipes that publish declared API version, intended templates, support boundary, empty-result or committed-consequence semantics, prerequisites, and one registry-owned copyable remedy.',
+    text: GETTING_STARTED_V32_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V33_VERSION,
+    uri: GETTING_STARTED_V33_URI,
+    name: 'Getting started with Meguro v33',
+    title: 'Getting started with Meguro v33',
+    description: 'Zero-prior-knowledge hosted sequence carrying the server-owned, machine-copyable practice-run advance cursor, distinguishing automatic Recorded API behavior from the optional Configured Receipt Gate, with admitted Admin recipes that publish declared API version, intended templates, support boundary, empty-result or committed-consequence semantics, prerequisites, and one registry-owned copyable remedy, and publishing the v1 served, internal-only and deferred vertical boundary so served Admin capability and modeled Impact evidence are declared separately.',
+    text: GETTING_STARTED_V33_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V34_VERSION,
+    uri: GETTING_STARTED_V34_URI,
+    name: 'Getting started with Meguro v34',
+    title: 'Getting started with Meguro v34',
+    description: 'Zero-prior-knowledge hosted sequence carrying the server-owned, machine-copyable practice-run advance cursor, distinguishing automatic Recorded API behavior from the optional Configured Receipt Gate, with admitted Admin recipes that publish declared API version, intended templates, support boundary, empty-result or committed-consequence semantics, prerequisites, and one registry-owned copyable remedy, and publishing the v1 served, internal-only and deferred vertical boundary so served Admin capability and modeled Impact evidence are declared separately, and publishing the two-tier template discovery hop so templates_list is the compact complete catalog and template_get returns one template\'s complete authoritative record before store_create.',
+    text: GETTING_STARTED_V34_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V35_VERSION,
+    uri: GETTING_STARTED_V35_URI,
+    name: 'Getting started with Meguro v35',
+    title: 'Getting started with Meguro v35',
+    description: 'Zero-prior-knowledge hosted sequence teaching only canonical MCP request forms: storeId, externalAgent.commitSha, and the nested practiceRun.advanceCursor.',
+    text: GETTING_STARTED_V35_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V36_VERSION,
+    uri: GETTING_STARTED_V36_URI,
+    name: 'Getting started with Meguro v36',
+    title: 'Getting started with Meguro v36',
+    description: 'Zero-prior-knowledge hosted sequence with one consistent current documentation generation and canonical MCP request forms.',
+    text: GETTING_STARTED_V36_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V37_VERSION,
+    uri: GETTING_STARTED_V37_URI,
+    name: 'Getting started with Meguro v37',
+    title: 'Getting started with Meguro v37',
+    description: 'Zero-prior-knowledge hosted sequence with one consistent current documentation generation and canonical MCP request forms.',
+    text: GETTING_STARTED_V37_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V38_VERSION,
+    uri: GETTING_STARTED_V38_URI,
+    name: 'Getting started with Meguro v38',
+    title: 'Getting started with Meguro v38',
+    description: 'Zero-prior-knowledge hosted sequence with state-neutral Configured Receipt Gate guidance and one consistent current documentation generation.',
+    text: GETTING_STARTED_V38_TEXT,
+  },
+  {
+    topic: 'getting-started',
+    version: GETTING_STARTED_V39_VERSION,
+    uri: GETTING_STARTED_V39_URI,
+    name: 'Getting started with Meguro v39',
+    title: 'Getting started with Meguro v39',
+    description: 'Zero-prior-knowledge hosted sequence with labelled creation and current history bases, and truthful hosted real-store history-tool guidance.',
+    text: GETTING_STARTED_V39_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_VERSION,
+    uri: PRODUCT_GUIDE_URI,
+    name: 'Meguro product guide v1',
+    title: 'Meguro product guide v1',
+    description: 'Stable product concepts, evidence boundaries, surface responsibilities, and question-to-source routing.',
+    text: PRODUCT_GUIDE_TEXT,
+    expectedSha256: PRODUCT_GUIDE_SHA256,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V2_VERSION,
+    uri: PRODUCT_GUIDE_V2_URI,
+    name: 'Meguro product guide v2',
+    title: 'Meguro product guide v2',
+    description: 'Stable product concepts, simulation vocabulary, evidence boundaries, surface responsibilities, and question-to-source routing.',
+    text: PRODUCT_GUIDE_V2_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V3_VERSION,
+    uri: PRODUCT_GUIDE_V3_URI,
+    name: 'Meguro product guide v3',
+    title: 'Meguro product guide v3',
+    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: 'product-guide',
+    version: PRODUCT_GUIDE_V5_VERSION,
+    uri: PRODUCT_GUIDE_V5_URI,
+    name: 'Meguro product guide v5',
+    title: 'Meguro product guide v5',
+    description: 'Current-link-derived product concepts with version-label, assertion-family, and effect-level channel guidance.',
+    text: PRODUCT_GUIDE_V5_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V6_VERSION,
+    uri: PRODUCT_GUIDE_V6_URI,
+    name: 'Meguro product guide v6',
+    title: 'Meguro product guide v6',
+    description: 'Current product concepts with four independent run-result dimensions and legacy-field guidance.',
+    text: PRODUCT_GUIDE_V6_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V7_VERSION,
+    uri: PRODUCT_GUIDE_V7_URI,
+    name: 'Meguro product guide v7',
+    title: 'Meguro product guide v7',
+    description: 'Current product concepts with exact expected-refusal declaration and classification semantics.',
+    text: PRODUCT_GUIDE_V7_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V8_VERSION,
+    uri: PRODUCT_GUIDE_V8_URI,
+    name: 'Meguro product guide v8',
+    title: 'Meguro product guide v8',
+    description: 'Current product concepts with live per-store history discovery and truthful creation-lane provenance.',
+    text: PRODUCT_GUIDE_V8_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V9_VERSION,
+    uri: PRODUCT_GUIDE_V9_URI,
+    name: 'Meguro product guide v9',
+    title: 'Meguro product guide v9',
+    description: 'Current product concepts with Admin recipe enumeration and bounded lookup-miss teaching.',
+    text: PRODUCT_GUIDE_V9_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V10_VERSION,
+    uri: PRODUCT_GUIDE_V10_URI,
+    name: 'Meguro product guide v10',
+    title: 'Meguro product guide v10',
+    description: 'Current product concepts with structured Admin execution preflight and separated control/data-plane authentication.',
+    text: PRODUCT_GUIDE_V10_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V11_VERSION,
+    uri: PRODUCT_GUIDE_V11_URI,
+    name: 'Meguro product guide v11',
+    title: 'Meguro product guide v11',
+    description: 'Current product concepts with one practice-run lifecycle contract and explicit terminal-boundary confirmation.',
+    text: PRODUCT_GUIDE_V11_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V12_VERSION,
+    uri: PRODUCT_GUIDE_V12_URI,
+    name: 'Meguro product guide v12',
+    title: 'Meguro product guide v12',
+    description: 'Current product concepts with the complete hosted-OAuth server-grant and client-local authority lifecycle.',
+    text: PRODUCT_GUIDE_V12_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V13_VERSION,
+    uri: PRODUCT_GUIDE_V13_URI,
+    name: 'Meguro product guide v13',
+    title: 'Meguro product guide v13',
+    description: 'Current product concepts with explicit return-resolution economics and call, rejection, replay, and action evidence.',
+    text: PRODUCT_GUIDE_V13_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V14_VERSION,
+    uri: PRODUCT_GUIDE_V14_URI,
+    name: 'Meguro product guide v14',
+    title: 'Meguro product guide v14',
+    description: 'Current product concepts with one authoritative idempotency set including return-linked store credit.',
+    text: PRODUCT_GUIDE_V14_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V15_VERSION,
+    uri: PRODUCT_GUIDE_V15_URI,
+    name: 'Meguro product guide v15',
+    title: 'Meguro product guide v15',
+    description: 'Current product concepts with a zero-prior-knowledge primer before operational guidance.',
+    text: PRODUCT_GUIDE_V15_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V16_VERSION,
+    uri: PRODUCT_GUIDE_V16_URI,
+    name: 'Meguro product guide v16',
+    title: 'Meguro product guide v16',
+    description: 'Current product concepts with the server-owned 120-day ordinary-store history default and explicit direct-API override rule.',
+    text: PRODUCT_GUIDE_V16_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V17_VERSION,
+    uri: PRODUCT_GUIDE_V17_URI,
+    name: 'Meguro product guide v17',
+    title: 'Meguro product guide v17',
+    description: 'Current product concepts with one account-owned sample-onboarding authority and ordinary store, lifecycle, visibility, discovery, receipt, and metering behavior.',
+    text: PRODUCT_GUIDE_V17_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V18_VERSION,
+    uri: PRODUCT_GUIDE_V18_URI,
+    name: 'Meguro product guide v18',
+    title: 'Meguro product guide v18',
+    description: 'Current product concepts with one account-owned sample-onboarding authority and truthful shared store machinery for the explicit 90-day sample history configuration.',
+    text: PRODUCT_GUIDE_V18_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V19_VERSION,
+    uri: PRODUCT_GUIDE_V19_URI,
+    name: 'Meguro product guide v19',
+    title: 'Meguro product guide v19',
+    description: 'Current product concepts with exact polymorphic Node compatibility scope and one server-owned final receipt Gate.',
+    text: PRODUCT_GUIDE_V19_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V20_VERSION,
+    uri: PRODUCT_GUIDE_V20_URI,
+    name: 'Meguro product guide v20',
+    title: 'Meguro product guide v20',
+    description: 'Current product concepts preserving the rehearsal boundary with one atomic user-chosen onboarding evaluation grant, bounded receipt segments, and shared MCP/Console planning.',
+    text: PRODUCT_GUIDE_V20_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V21_VERSION,
+    uri: PRODUCT_GUIDE_V21_URI,
+    name: 'Meguro product guide v21',
+    title: 'Meguro product guide v21',
+    description: 'Current product concepts preserving the rehearsal boundary and routing receipt interpretation to the complete committed change register.',
+    text: PRODUCT_GUIDE_V21_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V22_VERSION,
+    uri: PRODUCT_GUIDE_V22_URI,
+    name: 'Meguro product guide v22',
+    title: 'Meguro product guide v22',
+    description: 'Current product concepts preserving the rehearsal boundary with creation-pinned template event resolution and no current-catalog reconstruction.',
+    text: PRODUCT_GUIDE_V22_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V23_VERSION,
+    uri: PRODUCT_GUIDE_V23_URI,
+    name: 'Meguro product guide v23',
+    title: 'Meguro product guide v23',
+    description: 'Current product concepts preserving the rehearsal boundary with one server-owned, machine-copyable practice-run advance cursor.',
+    text: PRODUCT_GUIDE_V23_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V24_VERSION,
+    uri: PRODUCT_GUIDE_V24_URI,
+    name: 'Meguro product guide v24',
+    title: 'Meguro product guide v24',
+    description: 'Current product concepts including the server-owned, machine-copyable advance cursor and distinguishing automatic Recorded API behavior from the optional Configured Receipt Gate while preserving frozen machine contracts.',
+    text: PRODUCT_GUIDE_V24_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V25_VERSION,
+    uri: PRODUCT_GUIDE_V25_URI,
+    name: 'Meguro product guide v25',
+    title: 'Meguro product guide v25',
+    description: 'Current product concepts including the server-owned, machine-copyable advance cursor, distinguishing automatic Recorded API behavior from the optional Configured Receipt Gate, with official Shopify return-finance mechanics and private receipt-owned rehearsal economics.',
+    text: PRODUCT_GUIDE_V25_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V26_VERSION,
+    uri: PRODUCT_GUIDE_V26_URI,
+    name: 'Meguro product guide v26',
+    title: 'Meguro product guide v26',
+    description: 'Current product concepts carrying the server-owned, machine-copyable advance cursor, distinguishing automatic Recorded API behavior from the optional Configured Receipt Gate, with official customer-linked loyalty GiftCards, bounded modeled economics, replay refusal, and distinct return store credit.',
+    text: PRODUCT_GUIDE_V26_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V27_VERSION,
+    uri: PRODUCT_GUIDE_V27_URI,
+    name: 'Meguro product guide v27',
+    title: 'Meguro product guide v27',
+    description: 'Current product concepts carrying the server-owned, machine-copyable practice-run advance cursor, distinguishing automatic Recorded API behavior from the optional Configured Receipt Gate, with one ordinary order-refund authority, explicit cash or store-credit method, opaque notes, cumulative paid-amount caps, stable replay, and no invented Return linkage.',
+    text: PRODUCT_GUIDE_V27_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V28_VERSION,
+    uri: PRODUCT_GUIDE_V28_URI,
+    name: 'Meguro product guide v28',
+    title: 'Meguro product guide v28',
+    description: 'Current product concepts carrying the server-owned, machine-copyable practice-run advance cursor, distinguishing automatic Recorded API behavior from the optional Configured Receipt Gate, with one ordinary order-refund authority, explicit cash or store-credit method, opaque notes, cumulative paid-amount caps, stable replay, and no invented Return linkage.',
+    text: PRODUCT_GUIDE_V28_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V29_VERSION,
+    uri: PRODUCT_GUIDE_V29_URI,
+    name: 'Meguro product guide v29',
+    title: 'Meguro product guide v29',
+    description: 'Current product concepts carrying the server-owned, machine-copyable practice-run advance cursor, distinguishing automatic Recorded API behavior from the optional Configured Receipt Gate, with one ordinary order-refund authority, explicit cash or store-credit method, opaque notes, cumulative paid-amount caps, stable replay, and no invented Return linkage.',
+    text: PRODUCT_GUIDE_V29_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V30_VERSION,
+    uri: PRODUCT_GUIDE_V30_URI,
+    name: 'Meguro product guide v30',
+    title: 'Meguro product guide v30',
+    description: 'Current product concepts carrying the server-owned, machine-copyable practice-run advance cursor, distinguishing automatic Recorded API behavior from the optional Configured Receipt Gate, with one ordinary order-refund authority that refunds named committed Order lines for cash, opaque notes, cumulative paid-amount caps, stable replay, and no invented Return linkage, and publishing the v1 served, internal-only and deferred vertical boundary so aggregate scenario physics is reported as modeled evidence rather than a Shopify entity.',
+    text: PRODUCT_GUIDE_V30_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V31_VERSION,
+    uri: PRODUCT_GUIDE_V31_URI,
+    name: 'Meguro product guide v31',
+    title: 'Meguro product guide v31',
+    description: 'Current product concepts carrying the server-owned, machine-copyable practice-run advance cursor, distinguishing automatic Recorded API behavior from the optional Configured Receipt Gate, with one ordinary order-refund authority that refunds named committed Order lines for cash, opaque notes, cumulative paid-amount caps, stable replay, and no invented Return linkage, and publishing the v1 served, internal-only and deferred vertical boundary so aggregate scenario physics is reported as modeled evidence rather than a Shopify entity, tracking the two-tier template discovery hop introduced in getting-started v34.',
+    text: PRODUCT_GUIDE_V31_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V32_VERSION,
+    uri: PRODUCT_GUIDE_V32_URI,
+    name: 'Meguro product guide v32',
+    title: 'Meguro product guide v32',
+    description: 'Current product concepts carrying only the server-owned, machine-copyable nested practice-run advance cursor.',
+    text: PRODUCT_GUIDE_V32_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V33_VERSION,
+    uri: PRODUCT_GUIDE_V33_URI,
+    name: 'Meguro product guide v33',
+    title: 'Meguro product guide v33',
+    description: 'Current product concepts with one consistent current documentation generation and the server-owned nested practice-run advance cursor.',
+    text: PRODUCT_GUIDE_V33_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V34_VERSION,
+    uri: PRODUCT_GUIDE_V34_URI,
+    name: 'Meguro product guide v34',
+    title: 'Meguro product guide v34',
+    description: 'Current product concepts with one consistent current documentation generation and the server-owned nested practice-run advance cursor.',
+    text: PRODUCT_GUIDE_V34_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V35_VERSION,
+    uri: PRODUCT_GUIDE_V35_URI,
+    name: 'Meguro product guide v35',
+    title: 'Meguro product guide v35',
+    description: 'Current product concepts with state-neutral Configured Receipt Gate guidance and one consistent current documentation generation.',
+    text: PRODUCT_GUIDE_V35_TEXT,
+  },
+  {
+    topic: 'product-guide',
+    version: PRODUCT_GUIDE_V36_VERSION,
+    uri: PRODUCT_GUIDE_V36_URI,
+    name: 'Meguro product guide v36',
+    title: 'Meguro product guide v36',
+    description: 'Current product concepts with labelled creation and current history bases, and truthful hosted real-store history-tool guidance.',
+    text: PRODUCT_GUIDE_V36_TEXT,
   },
   {
     topic: 'index',
@@ -1755,6 +4408,303 @@ const CATALOG = buildDocumentationCatalog([
     description: 'Immutable current-version pointers after the current-link, version-label, and explanatory-rider documentation mint.',
     text: documentationIndexText(DOCUMENTATION_CURRENCY_V4, DOCUMENTATION_INDEX_V4_URI),
   },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V5.indexVersion,
+    uri: DOCUMENTATION_INDEX_V5_URI,
+    name: 'Meguro documentation index v5',
+    title: 'Meguro documentation index v5',
+    description: 'Immutable current-version pointers after the run-result semantic-dimensions documentation mint.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V5, DOCUMENTATION_INDEX_V5_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V6.indexVersion,
+    uri: DOCUMENTATION_INDEX_V6_URI,
+    name: 'Meguro documentation index v6',
+    title: 'Meguro documentation index v6',
+    description: 'Immutable current-version pointers after the expected-refusal assertion documentation mint.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V6, DOCUMENTATION_INDEX_V6_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V7.indexVersion,
+    uri: DOCUMENTATION_INDEX_V7_URI,
+    name: 'Meguro documentation index v7',
+    title: 'Meguro documentation index v7',
+    description: 'Immutable current-version pointers after the live per-store history-truth documentation mint.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V7, DOCUMENTATION_INDEX_V7_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V8.indexVersion,
+    uri: DOCUMENTATION_INDEX_V8_URI,
+    name: 'Meguro documentation index v8',
+    title: 'Meguro documentation index v8',
+    description: 'Immutable current-version pointers after the Admin recipe discovery and teaching-response mint.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V8, DOCUMENTATION_INDEX_V8_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V9.indexVersion,
+    uri: DOCUMENTATION_INDEX_V9_URI,
+    name: 'Meguro documentation index v9',
+    title: 'Meguro documentation index v9',
+    description: 'Immutable current-version pointers after the structured Admin execution-preflight mint.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V9, DOCUMENTATION_INDEX_V9_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V10.indexVersion,
+    uri: DOCUMENTATION_INDEX_V10_URI,
+    name: 'Meguro documentation index v10',
+    title: 'Meguro documentation index v10',
+    description: 'Immutable current-version pointers after the practice-run lifecycle and terminal-confirmation mint.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V10, DOCUMENTATION_INDEX_V10_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V11.indexVersion,
+    uri: DOCUMENTATION_INDEX_V11_URI,
+    name: 'Meguro documentation index v11',
+    title: 'Meguro documentation index v11',
+    description: 'Immutable current-version pointers after the hosted-OAuth authority-lifecycle mint.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V11, DOCUMENTATION_INDEX_V11_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V12.indexVersion,
+    uri: DOCUMENTATION_INDEX_V12_URI,
+    name: 'Meguro documentation index v12',
+    title: 'Meguro documentation index v12',
+    description: 'Immutable current-version pointers after the return-resolution and evidence-accounting mint.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V12, DOCUMENTATION_INDEX_V12_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V13.indexVersion,
+    uri: DOCUMENTATION_INDEX_V13_URI,
+    name: 'Meguro documentation index v13',
+    title: 'Meguro documentation index v13',
+    description: 'Immutable current-version pointers after correcting the return store-credit idempotency contract.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V13, DOCUMENTATION_INDEX_V13_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V14.indexVersion,
+    uri: DOCUMENTATION_INDEX_V14_URI,
+    name: 'Meguro documentation index v14',
+    title: 'Meguro documentation index v14',
+    description: 'Immutable current-version pointers after the zero-prior-knowledge onboarding correction.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V14, DOCUMENTATION_INDEX_V14_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V15.indexVersion,
+    uri: DOCUMENTATION_INDEX_V15_URI,
+    name: 'Meguro documentation index v15',
+    title: 'Meguro documentation index v15',
+    description: 'Immutable current-version pointers after the server-owned ordinary-store history-default mint.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V15, DOCUMENTATION_INDEX_V15_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V16.indexVersion,
+    uri: DOCUMENTATION_INDEX_V16_URI,
+    name: 'Meguro documentation index v16',
+    title: 'Meguro documentation index v16',
+    description: 'Immutable current-version pointers after the sample-normalization closeout documentation mint.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V16, DOCUMENTATION_INDEX_V16_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V17.indexVersion,
+    uri: DOCUMENTATION_INDEX_V17_URI,
+    name: 'Meguro documentation index v17',
+    title: 'Meguro documentation index v17',
+    description: 'Immutable current-version pointers after correcting the sample history configuration to use shared store machinery.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V17, DOCUMENTATION_INDEX_V17_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V18.indexVersion,
+    uri: DOCUMENTATION_INDEX_V18_URI,
+    name: 'Meguro documentation index v18',
+    title: 'Meguro documentation index v18',
+    description: 'Immutable current-version pointers after closing polymorphic Node compatibility and final receipt Gate authority.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V18, DOCUMENTATION_INDEX_V18_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V19.indexVersion,
+    uri: DOCUMENTATION_INDEX_V19_URI,
+    name: 'Meguro documentation index v19',
+    title: 'Meguro documentation index v19',
+    description: 'Immutable current-version pointers after the user-chosen onboarding evaluation grant mint.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V19, DOCUMENTATION_INDEX_V19_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V20.indexVersion,
+    uri: DOCUMENTATION_INDEX_V20_URI,
+    name: 'Meguro documentation index v20',
+    title: 'Meguro documentation index v20',
+    description: 'Immutable current-version pointers after receipts adopted the complete committed change register.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V20, DOCUMENTATION_INDEX_V20_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V21.indexVersion,
+    uri: DOCUMENTATION_INDEX_V21_URI,
+    name: 'Meguro documentation index v21',
+    title: 'Meguro documentation index v21',
+    description: 'Immutable current-version pointers after receipts adopted creation-pinned template event resolution.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V21, DOCUMENTATION_INDEX_V21_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V22.indexVersion,
+    uri: DOCUMENTATION_INDEX_V22_URI,
+    name: 'Meguro documentation index v22',
+    title: 'Meguro documentation index v22',
+    description: 'Immutable current-version pointers after practice runs adopted one server-owned, machine-copyable advance cursor.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V22, DOCUMENTATION_INDEX_V22_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V23.indexVersion,
+    uri: DOCUMENTATION_INDEX_V23_URI,
+    name: 'Meguro documentation index v23',
+    title: 'Meguro documentation index v23',
+    description: 'Immutable current-version pointers after disambiguating automatic Recorded API behavior from the optional Configured Receipt Gate.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V23, DOCUMENTATION_INDEX_V23_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V24.indexVersion,
+    uri: DOCUMENTATION_INDEX_V24_URI,
+    name: 'Meguro documentation index v24',
+    title: 'Meguro documentation index v24',
+    description: 'Immutable current-version pointers after adopting official Shopify return-finance mechanics.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V24, DOCUMENTATION_INDEX_V24_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V25.indexVersion,
+    uri: DOCUMENTATION_INDEX_V25_URI,
+    name: 'Meguro documentation index v25',
+    title: 'Meguro documentation index v25',
+    description: 'Immutable current-version pointers after adopting official customer-linked Shopify loyalty GiftCard mechanics.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V25, DOCUMENTATION_INDEX_V25_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V26.indexVersion,
+    uri: DOCUMENTATION_INDEX_V26_URI,
+    name: 'Meguro documentation index v26',
+    title: 'Meguro documentation index v26',
+    description: 'Immutable current-version pointers after establishing the ordinary order-refund authority and correcting Return linkage teaching.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V26, DOCUMENTATION_INDEX_V26_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V27.indexVersion,
+    uri: DOCUMENTATION_INDEX_V27_URI,
+    name: 'Meguro documentation index v27',
+    title: 'Meguro documentation index v27',
+    description: 'Immutable current-version pointers after admitted Admin recipes began publishing declared version, outcome semantics, prerequisites, and one registry-owned remedy.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V27, DOCUMENTATION_INDEX_V27_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V28.indexVersion,
+    uri: DOCUMENTATION_INDEX_V28_URI,
+    name: 'Meguro documentation index v28',
+    title: 'Meguro documentation index v28',
+    description: 'Immutable current-version pointers after admitted Admin recipes began publishing declared version, outcome semantics, prerequisites, and one registry-owned remedy.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V28, DOCUMENTATION_INDEX_V28_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V29.indexVersion,
+    uri: DOCUMENTATION_INDEX_V29_URI,
+    name: 'Meguro documentation index v29',
+    title: 'Meguro documentation index v29',
+    description: 'Immutable current-version pointers after the v1 served, internal-only and deferred vertical boundary was published.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V29, DOCUMENTATION_INDEX_V29_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V30.indexVersion,
+    uri: DOCUMENTATION_INDEX_V30_URI,
+    name: 'Meguro documentation index v30',
+    title: 'Meguro documentation index v30',
+    description: 'Immutable current-version pointers after the compact templates_list and template_get detail hop were published.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V30, DOCUMENTATION_INDEX_V30_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V31.indexVersion,
+    uri: DOCUMENTATION_INDEX_V31_URI,
+    name: 'Meguro documentation index v31',
+    title: 'Meguro documentation index v31',
+    description: 'Immutable current-version pointers after publishing the stored public run-receipt Markdown representation contract.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V31, DOCUMENTATION_INDEX_V31_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V32.indexVersion,
+    uri: DOCUMENTATION_INDEX_V32_URI,
+    name: 'Meguro documentation index v32',
+    title: 'Meguro documentation index v32',
+    description: 'Immutable current-version pointers after renaming the winback operating cost to its contact/recovery meaning.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V32, DOCUMENTATION_INDEX_V32_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V33.indexVersion,
+    uri: DOCUMENTATION_INDEX_V33_URI,
+    name: 'Meguro documentation index v33',
+    title: 'Meguro documentation index v33',
+    description: 'Immutable current-version pointers after retiring obsolete MCP request aliases.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V33, DOCUMENTATION_INDEX_V33_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V34.indexVersion,
+    uri: DOCUMENTATION_INDEX_V34_URI,
+    name: 'Meguro documentation index v34',
+    title: 'Meguro documentation index v34',
+    description: 'Immutable current-version pointers after reconciling every current documentation cross-reference.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V34, DOCUMENTATION_INDEX_V34_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V35.indexVersion,
+    uri: DOCUMENTATION_INDEX_V35_URI,
+    name: 'Meguro documentation index v35',
+    title: 'Meguro documentation index v35',
+    description: 'Immutable current-version pointers after reconciling every current documentation cross-reference.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V35, DOCUMENTATION_INDEX_V35_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V36.indexVersion,
+    uri: DOCUMENTATION_INDEX_V36_URI,
+    name: 'Meguro documentation index v36',
+    title: 'Meguro documentation index v36',
+    description: 'Immutable current-version pointers for the truthful Gate-check and field-index generation.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V36, DOCUMENTATION_INDEX_V36_URI),
+  },
+  {
+    topic: 'index',
+    version: DOCUMENTATION_CURRENCY_V37.indexVersion,
+    uri: DOCUMENTATION_INDEX_V37_URI,
+    name: 'Meguro documentation index v37',
+    title: 'Meguro documentation index v37',
+    description: 'Immutable current-version pointers for the labelled hosted-history generation.',
+    text: documentationIndexText(DOCUMENTATION_CURRENCY_V37, DOCUMENTATION_INDEX_V37_URI),
+  },
   {
     topic: 'receipt-guide',
     version: RECEIPT_GUIDE_VERSION,
@@ -1818,6 +4768,105 @@ const CATALOG = buildDocumentationCatalog([
     description: 'V6 receipt interpretation plus explicit signed net-unit semantics for daily impact rows.',
     text: RECEIPT_GUIDE_V7_TEXT,
   },
+  {
+    topic: 'receipt-guide',
+    version: RECEIPT_GUIDE_V8_VERSION,
+    uri: RECEIPT_GUIDE_V8_URI,
+    name: 'Meguro receipt guide v8',
+    title: 'Meguro receipt guide v8',
+    description: 'V7 receipt interpretation plus four independent run-result dimensions and neutral modeled-outcome semantics.',
+    text: RECEIPT_GUIDE_V8_TEXT,
+  },
+  {
+    topic: 'receipt-guide',
+    version: RECEIPT_GUIDE_V9_VERSION,
+    uri: RECEIPT_GUIDE_V9_URI,
+    name: 'Meguro receipt guide v9',
+    title: 'Meguro receipt guide v9',
+    description: 'V8 receipt interpretation plus immutable expected-refusal assertion results and handled raw-call coordinates.',
+    text: RECEIPT_GUIDE_V9_TEXT,
+  },
+  {
+    topic: 'receipt-guide',
+    version: RECEIPT_GUIDE_V10_VERSION,
+    uri: RECEIPT_GUIDE_V10_URI,
+    name: 'Meguro receipt guide v10',
+    title: 'Meguro receipt guide v10',
+    description: 'V9 receipt interpretation plus explicit return-resolution economics and four-way mutation evidence accounting.',
+    text: RECEIPT_GUIDE_V10_TEXT,
+  },
+  {
+    topic: 'receipt-guide',
+    version: RECEIPT_GUIDE_V11_VERSION,
+    uri: RECEIPT_GUIDE_V11_URI,
+    name: 'Meguro receipt guide v11',
+    title: 'Meguro receipt guide v11',
+    description: 'V10 receipt interpretation plus exact polymorphic Node compatibility scope and one server-owned final receipt Gate.',
+    text: RECEIPT_GUIDE_V11_TEXT,
+  },
+  {
+    topic: 'receipt-guide',
+    version: RECEIPT_GUIDE_V12_VERSION,
+    uri: RECEIPT_GUIDE_V12_URI,
+    name: 'Meguro receipt guide v12',
+    title: 'Meguro receipt guide v12',
+    description: 'V11 receipt interpretation plus the authoritative complete committed change register and provenance fields.',
+    text: RECEIPT_GUIDE_V12_TEXT,
+  },
+  {
+    topic: 'receipt-guide',
+    version: RECEIPT_GUIDE_V13_VERSION,
+    uri: RECEIPT_GUIDE_V13_URI,
+    name: 'Meguro receipt guide v13',
+    title: 'Meguro receipt guide v13',
+    description: 'V12 receipt interpretation plus creation-pinned template event resolution, measured-horizon boundaries, and explicit legacy unavailability.',
+    text: RECEIPT_GUIDE_V13_TEXT,
+  },
+  {
+    topic: 'receipt-guide',
+    version: RECEIPT_GUIDE_V14_VERSION,
+    uri: RECEIPT_GUIDE_V14_URI,
+    name: 'Meguro receipt guide v14',
+    title: 'Meguro receipt guide v14',
+    description: 'V13 receipt interpretation distinguishing automatic Recorded API behavior from the optional Configured Receipt Gate while preserving frozen machine fields.',
+    text: RECEIPT_GUIDE_V14_TEXT,
+  },
+  {
+    topic: 'receipt-guide',
+    version: RECEIPT_GUIDE_V15_VERSION,
+    uri: RECEIPT_GUIDE_V15_URI,
+    name: 'Meguro receipt guide v15',
+    title: 'Meguro receipt guide v15',
+    description: 'Receipt interpretation distinguishing automatic Recorded API behavior from the optional Configured Receipt Gate while preserving frozen machine fields, with the v1 refund boundary: canonical Order line-item cash refunds are the served financial write and modeled return economics are Impact evidence.',
+    text: RECEIPT_GUIDE_V15_TEXT,
+  },
+  {
+    topic: 'receipt-guide',
+    version: RECEIPT_GUIDE_V16_VERSION,
+    uri: RECEIPT_GUIDE_V16_URI,
+    name: 'Meguro receipt guide v16',
+    title: 'Meguro receipt guide v16',
+    description: 'Receipt interpretation plus the issuance-time stored Markdown representation contract for presentation-bearing public run receipts.',
+    text: RECEIPT_GUIDE_V16_TEXT,
+  },
+  {
+    topic: 'receipt-guide',
+    version: RECEIPT_GUIDE_V17_VERSION,
+    uri: RECEIPT_GUIDE_V17_URI,
+    name: 'Meguro receipt guide v17',
+    title: 'Meguro receipt guide v17',
+    description: 'Receipt interpretation naming the winback operating cost as the contact/recovery cost it commits, distinct from the discount that governs recovered price.',
+    text: RECEIPT_GUIDE_V17_TEXT,
+  },
+  {
+    topic: 'receipt-guide',
+    version: RECEIPT_GUIDE_V18_VERSION,
+    uri: RECEIPT_GUIDE_V18_URI,
+    name: 'Meguro receipt guide v18',
+    title: 'Meguro receipt guide v18',
+    description: 'Receipt interpretation with the generated path list republished as a field index and an authored winback contact-recovery cost definition.',
+    text: RECEIPT_GUIDE_V18_TEXT,
+  },
   {
     topic: 'gate-policy',
     version: GATE_POLICY_VERSION,
@@ -1845,6 +4894,33 @@ const CATALOG = buildDocumentationCatalog([
     description: 'Immutable named checks with absolute fact paths against the complete canonical Gate verdict payload.',
     text: GATE_POLICY_V3_TEXT,
   },
+  {
+    topic: 'gate-policy',
+    version: GATE_POLICY_V4_VERSION,
+    uri: GATE_POLICY_V4_URI,
+    name: 'Meguro Configured Receipt Gate policy v4',
+    title: 'Meguro Configured Receipt Gate policy v4',
+    description: 'Immutable configured-policy guide distinguishing Configured Receipt Gate from automatic Recorded API behavior and its Default run policy provenance.',
+    text: GATE_POLICY_V4_TEXT,
+  },
+  {
+    topic: 'gate-policy',
+    version: GATE_POLICY_V5_VERSION,
+    uri: GATE_POLICY_V5_URI,
+    name: 'Meguro Configured Receipt Gate policy v5',
+    title: 'Meguro Configured Receipt Gate policy v5',
+    description: 'Immutable configured-policy guide with one self-consistent current policy URI and version narrative.',
+    text: GATE_POLICY_V5_TEXT,
+  },
+  {
+    topic: 'gate-policy',
+    version: GATE_POLICY_V6_VERSION,
+    uri: GATE_POLICY_V6_URI,
+    name: 'Meguro Configured Receipt Gate policy v6',
+    title: 'Meguro Configured Receipt Gate policy v6',
+    description: 'Immutable configured-policy guide naming the failing-receipt-evidence check for the single fact it decides on, with state-neutral Gate guidance.',
+    text: GATE_POLICY_V6_TEXT,
+  },
 ], CURRENT_DOCUMENTATION_CURRENCY);
 
 export function documentationResources() {
@@ -1865,10 +4941,14 @@ function documentationList(values, conjunction = 'and') {
   return `${values.slice(0, -1).join(', ')}, ${conjunction} ${values.at(-1)}`;
 }
 
-export function deriveDocumentationToolContract(resources) {
+export function deriveDocumentationToolContract(resources, currency = CURRENT_DOCUMENTATION_CURRENCY) {
   if (!Array.isArray(resources) || resources.length === 0) {
     throw new Error('Documentation tool contract requires at least one published resource');
   }
+  const currentUriByTopic = currency?.currentUriByTopic;
+  if (!currentUriByTopic || typeof currentUriByTopic !== 'object') {
+    throw new Error('Documentation tool contract requires the current documentation currency map');
+  }
   const byTopic = new Map();
   const seen = new Set();
   for (const resource of resources) {
@@ -1895,26 +4975,67 @@ export function deriveDocumentationToolContract(resources) {
   const topics = [...byTopic.keys()].sort(codepointCompare);
   const versions = [...new Set([...byTopic.values()].flatMap((rows) => rows.map((row) => row.version)))]
     .sort((left, right) => left - right);
-  const announcements = topics.map((topic) => {
+  const versionsByTopic = {};
+  const currentByTopic = {};
+  for (const topic of topics) {
     const rows = byTopic.get(topic).sort((left, right) => left.version - right.version);
-    const latest = rows.at(-1);
-    return `${topic} versions [${rows.map((row) => row.version).join(', ')}] `
-      + `(latest v${latest.version}: ${latest.description.replace(/[.]+$/u, '')})`;
-  });
+    versionsByTopic[topic] = rows.map((row) => row.version);
+    const currentUri = String(currentUriByTopic[topic] ?? '');
+    if (!currentUri) throw new Error(`Documentation currency map has no current entry for ${topic}`);
+    const current = documentationVersionFromUri(currentUri);
+    if (!versionsByTopic[topic].includes(current)) {
+      throw new Error(`Documentation currency map names an unpublished ${topic} version: v${current}`);
+    }
+    currentByTopic[topic] = current;
+  }
+  // MEG-1059: one derived `<topic>: latest vN of N` row per topic. The deleted description embedded
+  // every historical version AND each latest document's full description — 2,816 bytes of discovery
+  // that grew with every append-only mint, on a surface a caller reads before it can ask anything.
+  const summary = topics
+    .map((topic) => `${topic}: latest v${currentByTopic[topic]} of ${versionsByTopic[topic].length}`)
+    .join('; ');
   const topicList = documentationList(topics);
-  const versionList = documentationList(versions);
   return deepFreeze({
     topics,
     versions,
-    description: `Read immutable Meguro product and simulation evidence documentation in-band. `
-      + `Published registry: ${announcements.join('; ')}. Account deletion is deliberately not an MCP tool. `
-      + 'Pass the exact published topic and version so cited documentation never resolves to mutable latest content.',
+    versionsByTopic: deepFreeze(versionsByTopic),
+    currentByTopic: deepFreeze(currentByTopic),
+    // MEG-695/MEG-704 vocabulary: docs_read is the one tool that names the rehearsal boundary, and
+    // the prose says "simulation". Compacting the registry must not withdraw that.
+    description: 'Read immutable Meguro simulation documentation in-band, including the rehearsal boundary. '
+      + `Published: ${summary}. `
+      + 'Pass an exact published integer version, or "latest" to resolve this topic\'s current one; '
+      + 'either way the response carries the concrete integer version and its immutable '
+      + 'meguro://docs/<topic>/vN URI, so citations pin bytes. Account deletion is not an MCP tool.',
     topicDescription: `Published Meguro simulation-documentation topic. Registry topics: ${topicList}.`,
-    versionDescription: `Published immutable simulation-documentation version. Registry versions: ${versionList}.`,
+    versionDescription: 'Exact published immutable version, or "latest" for this topic\'s current published version.',
     topicError: `topic must be ${documentationList(topics, 'or')}`,
+    versionError: 'version must be a positive integer or the exact string "latest"',
   });
 }
 
+/**
+ * MEG-1059: resolve one documentation read. `latest` is a discovery sentinel resolved through the
+ * SAME currency map the initialize instructions cite — it mints no alias resource and no second
+ * registry, and the caller is handed the concrete immutable entry.
+ */
+export function resolveDocumentationRead(topic, version, contract = documentationToolContract()) {
+  if (!contract.topics.includes(topic)) throw new Error(contract.topicError);
+  const resolved = version === 'latest' ? contract.currentByTopic[topic] : version;
+  if (!Number.isSafeInteger(resolved) || resolved < 1) throw new Error(contract.versionError);
+  const published = contract.versionsByTopic[topic];
+  if (!published.includes(resolved)) {
+    // Name what this topic actually publishes and the two choices that work. The deleted message
+    // said only "not found", which leaves blind retry as the caller's only move.
+    throw new Error(
+      `${topic} publishes v${published[0]}-v${published.at(-1)}; v${resolved} is not published. `
+      + `Current latest is v${contract.currentByTopic[topic]}. `
+      + `Call docs_read({ topic: "${topic}", version: "latest" }) or an exact published integer.`,
+    );
+  }
+  return documentationByTopic(topic, resolved);
+}
+
 export function documentationToolContract() {
   return deriveDocumentationToolContract(documentationResources());
 }
@@ -1922,10 +5043,10 @@ export function documentationToolContract() {
 export function receiptGuideFieldManifest() {
   return deepFreeze({
     schemas() {
-      return Object.keys(RECEIPT_FIELDS_V7).sort();
+      return Object.keys(RECEIPT_FIELDS_V13).sort();
     },
     schemaFields(schema) {
-      const fields = RECEIPT_FIELDS_V7[schema];
+      const fields = RECEIPT_FIELDS_V13[schema];
       if (!fields) throw new Error(`Receipt schema not documented: ${schema}`);
       return [...fields];
     },