sap-wm-mcp 0.2.7 → 0.2.8

package/README.md

@@ -13,7 +13,7 @@ Connect AI agents — Claude, Copilot, or any MCP-compatible client — directly
 >
 > This project ships a custom RAP OData V4 service that exposes classic WM operations as a proper API — and wraps it in an MCP server so AI agents can drive it. Large portions of the SAP install base are still on classic WM. This fills the gap.
 
-The **npm package** ships 21 tools covering core operations, analytics, shift management, anomaly detection, audit history, and proactive replenishment. This repository contains the 9 open-sourced tool implementations — the ABAP RAP service source and additional tool source are available separately (see [ABAP Service Installation](#abap-service-installation)).
+The **npm package** ships 22 tools covering core operations, analytics, shift management, anomaly detection, audit history, proactive replenishment, and interim zone reconciliation. This repository contains the 9 open-sourced tool implementations — the ABAP RAP service source and additional tool source are available separately (see [ABAP Service Installation](#abap-service-installation)).
 
 ---
 
@@ -374,7 +374,7 @@ For write operations:
 
 ## Tools Reference
 
-The npm package ships **21 tools** across five capability areas. The 9 tools below are open-sourced in this repository. Analytics, shift management, anomaly detection, and operations tools are available in the published package.
+The npm package ships **22 tools** across five capability areas. The 9 tools below are open-sourced in this repository. Analytics, shift management, anomaly detection, and operations tools are available in the published package.
 
 ---
 
@@ -536,6 +536,7 @@ The following tools are available in the published npm package and fully functio
 | `get_inventory_anomalies` | Bins stuck in mid-inventory state — empty bins with locks, open count docs, orphaned lock codes |
 | `get_transfer_order_history` | Full TO history — creator, executor (resolved from LTAP.QNAME), and item detail; filterable by date range, status, movement type, material, `createdBy`, or `executedBy` |
 | `get_replenishment_needs` | Find forward-pick bins at or below a stock threshold — `defaultReplenishQty` param (default 50) used as fallback when no bin max qty is configured; flags bins with an open replenishment TO to avoid duplicate moves |
+| `get_interim_zone_anomalies` | Detect positive stock stranded in interim/staging zones (types 999, 998, 902) — surfaces same-day, overnight, and multi-day strandings with likely cause per zone; use `minDaysStranded` to filter noise during active shifts |
 
 ---
 
@@ -677,7 +678,8 @@ sap-wm-mcp/
 │   ├── confirmTransferOrderSU.js     ← confirm_transfer_order_su
 │   ├── cancelTransferOrder.js        ← cancel_transfer_order
 │   ├── transferOrderHistory.js       ← get_transfer_order_history
-│   └── replenishmentNeeds.js         ← get_replenishment_needs
+│   ├── replenishmentNeeds.js         ← get_replenishment_needs
+│   └── interimZoneAnomalies.js       ← get_interim_zone_anomalies
 ├── .env.example
 └── package.json
 ```

package/index.js

@@ -28,8 +28,9 @@ import { getInventoryAnomalies } from './tools/inventoryAnomalies.js';
 import { getTransferOrderHistory } from './tools/transferOrderHistory.js';
 import { cancelTransferOrder } from './tools/cancelTransferOrder.js';
 import { getReplenishmentNeeds } from './tools/replenishmentNeeds.js';
+import { getInterimZoneAnomalies } from './tools/interimZoneAnomalies.js';
 
-const server = new McpServer({ name: 'sap-wm-mcp', version: '0.2.6' });
+const server = new McpServer({ name: 'sap-wm-mcp', version: '0.2.8' });
 
 // Tool 1 — get_bin_status
 server.tool(
@@ -457,6 +458,27 @@ server.tool(
   }
 );
 
+// Tool 22 — get_interim_zone_anomalies
+server.tool(
+  'get_interim_zone_anomalies',
+  'Detect positive stock stranded in interim/staging zones (types 999, 998, 902) where stock should only pass through briefly. Surfaces same-day, overnight, and multi-day strandings with likely cause per zone type. Run when stock appears to be lost or unaccounted for, or as part of end-of-shift reconciliation.',
+  {
+    warehouse:       z.string().describe('Warehouse number e.g. 102'),
+    interimTypes:    z.array(z.string()).optional().default(['999', '998', '902']).describe('Interim storage types to check — default [999, 998, 902]'),
+    minDaysStranded: z.number().optional().default(0).describe('Only return stock stranded for at least this many days. Default 0 = include same-day strandings.'),
+    material:        z.string().optional().describe('Narrow to a specific material e.g. TG0001'),
+    top:             z.number().optional().default(100).describe('Max quants to scan (scans top * 3 internally to account for client-side filtering)')
+  },
+  async (params) => {
+    try {
+      const result = await getInterimZoneAnomalies(params);
+      return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    } catch (err) {
+      return { content: [{ type: 'text', text: `Error: ${err.message}` }], isError: true };
+    }
+  }
+);
+
 const transport = new StdioServerTransport();
 await server.connect(transport);
 console.error('SAP WM MCP Server running (stdio)...');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sap-wm-mcp",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "MCP server for SAP Classic Warehouse Management — connects AI agents to S/4HANA WM via a custom RAP OData V4 service. For systems where EWM is not active.",
   "type": "module",
   "main": "index.js",

package/tools/interimZoneAnomalies.js

@@ -0,0 +1,82 @@
+import { s4hGet } from '../lib/s4hClient.js';
+import { esc } from '../lib/sanitize.js';
+
+const BASE = `/sap/opu/odata4/iwbep/all/srvd/sap/zsd_wmmcpservice/0001/WMWarehouseStock`;
+
+const INTERIM_CAUSE = {
+  '999': 'SU/GI interim — GI posted before TO confirmation; confirm open TO or create reversal',
+  '998': 'GR interim — goods receipt without putaway TO; check open TRs and create putaway',
+  '902': 'GR staging (WE-ZONE) — putaway TO not yet created or confirmed; check GR monitor',
+};
+
+export async function getInterimZoneAnomalies({
+  warehouse,
+  interimTypes = ['999', '998', '902'],
+  minDaysStranded = 0,
+  material,
+  top = 100
+}) {
+  const typeFilter = interimTypes.map(t => `StorageType eq '${esc(t)}'`).join(' or ');
+  const filters = [
+    `WarehouseNumber eq '${esc(warehouse)}'`,
+    `(${typeFilter})`
+  ];
+  if (material) filters.push(`Material eq '${esc(material)}'`);
+
+  const path = `${BASE}?$filter=${encodeURIComponent(filters.join(' and '))}&$top=${top * 3}`;
+  const data = await s4hGet(path);
+  const rows = data.value ?? [];
+
+  const today = new Date();
+
+  const stranded = rows
+    .filter(r => parseFloat(r.TotalStock ?? 0) > 0)
+    .map(r => {
+      const daysSinceMove = r.LastMovementDate
+        ? Math.floor((today - new Date(r.LastMovementDate)) / 86400000)
+        : null;
+      const ageFlag = daysSinceMove === null ? 'unknown'
+        : daysSinceMove === 0               ? 'same-day'
+        : daysSinceMove === 1               ? 'overnight'
+        :                                     'multi-day';
+      return {
+        storageType:  r.StorageType,
+        bin:          r.StorageBin,
+        material:     r.Material?.trimStart?.() ?? r.Material,
+        plant:        r.Plant,
+        qty:          parseFloat(r.TotalStock ?? 0),
+        uom:          r.UnitOfMeasure,
+        lastMove:     r.LastMovementDate ?? 'unknown',
+        daysSinceMove,
+        ageFlag,
+        likelyCause:  INTERIM_CAUSE[r.StorageType] ?? 'Positive stock in interim zone — investigate movement chain'
+      };
+    })
+    .filter(r => (r.daysSinceMove ?? 0) >= minDaysStranded)
+    .sort((a, b) => (b.daysSinceMove ?? 0) - (a.daysSinceMove ?? 0));
+
+  const byType = {};
+  for (const r of stranded) {
+    if (!byType[r.storageType]) byType[r.storageType] = { count: 0, totalQty: 0 };
+    byType[r.storageType].count++;
+    byType[r.storageType].totalQty += r.qty;
+  }
+
+  return {
+    count: stranded.length,
+    truncated: rows.length === top * 3,
+    warehouse,
+    filters: {
+      interimTypes,
+      minDaysStranded,
+      material: material ?? 'all'
+    },
+    summary: {
+      multiDay:  stranded.filter(r => r.ageFlag === 'multi-day').length,
+      overnight: stranded.filter(r => r.ageFlag === 'overnight').length,
+      sameDay:   stranded.filter(r => r.ageFlag === 'same-day').length,
+    },
+    byStorageType: byType,
+    stranded
+  };
+}