@lerianstudio/matcher-mcp 4.5.0-beta.32 → 4.5.0-beta.34

package/dist/spec/openapi.yaml

@@ -182,6 +182,11 @@ components:
           examples:
             - Bank wire fee adjustment
           type: string
+        direction:
+          description: "Direction of the entry: DEBIT explains a shortfall (moves the outstanding variance up, toward zero), CREDIT explains a surplus (moves it down)"
+          examples:
+            - DEBIT
+          type: string
         id:
           description: Unique identifier for the adjustment
           examples:
@@ -216,6 +221,7 @@ components:
         - id
         - contextId
         - type
+        - direction
         - amount
         - currency
         - description
@@ -2937,6 +2943,12 @@ components:
             - 524288
           format: int64
           type: integer
+        contextId:
+          description: Identifier of the reconciliation context this export was queued for (UUID).
+          examples:
+            - 550e8400-e29b-41d4-a716-446655440000
+          format: uuid
+          type: string
         createdAt:
           description: Timestamp when the job was created (RFC 3339, UTC).
           examples:
@@ -3025,6 +3037,7 @@ components:
           type: string
       required:
         - id
+        - contextId
         - reportType
         - format
         - status
@@ -4357,6 +4370,41 @@ components:
         - requiredFields
         - createdAt
       type: object
+    ListAdjustmentsResponse:
+      additionalProperties: false
+      properties:
+        hasMore:
+          examples:
+            - true
+          type: boolean
+        items:
+          description: Page of recorded adjustments
+          items:
+            $ref: "#/components/schemas/AdjustmentResponse"
+          maxItems: 200
+          type:
+            - array
+            - "null"
+        limit:
+          examples:
+            - 20
+          format: int64
+          maximum: 200
+          minimum: 1
+          type: integer
+        nextCursor:
+          examples:
+            - eyJpZCI6IjEyMyJ9
+          type: string
+        prevCursor:
+          examples:
+            - eyJpZCI6IjEyMiJ9
+          type: string
+      required:
+        - items
+        - limit
+        - hasMore
+      type: object
     ListArchivesResponse:
       additionalProperties: false
       properties:
@@ -8121,6 +8169,11 @@ components:
     VarianceReportRowResponse:
       additionalProperties: false
       properties:
+        adjustmentsApplied:
+          description: "Signed sum of the adjustments an operator recorded against this row: positive for debits, negative for credits, as a decimal string."
+          examples:
+            - "200.00"
+          type: string
         currency:
           description: ISO 4217 currency code for the amounts in this row.
           examples:
@@ -8138,10 +8191,15 @@ components:
             - INTERCHANGE
           type: string
         netVariance:
-          description: Signed difference between actual and expected totals (actual minus expected), as a decimal string.
+          description: Signed difference between actual and expected totals (actual minus expected), as a decimal string. This is the RAW difference and ignores any adjustment an operator recorded.
           examples:
             - "-200.00"
           type: string
+        outstandingVariance:
+          description: Net variance plus applied adjustments — the difference nobody has explained yet, as a decimal string. Zero means fully explained.
+          examples:
+            - "0.00"
+          type: string
         sourceId:
           description: Identifier of the source for this variance row (UUID).
           examples:
@@ -8171,6 +8229,8 @@ components:
         - totalExpected
         - totalActual
         - netVariance
+        - adjustmentsApplied
+        - outstandingVariance
       type: object
     VerifyBody:
       additionalProperties: false
@@ -14152,6 +14212,73 @@ paths:
       summary: List match candidates for a transaction
       tags:
         - Matching
+  /v1/matching/contexts/{contextId}/adjustments:
+    get:
+      description: Lists the balancing entries an operator recorded against a context, newest first. These are the corrections the variance report nets into its outstanding figure, so this is the read that makes that figure decomposable. Narrow to one match group with matchGroupId.
+      operationId: listAdjustments
+      parameters:
+        - description: Context ID whose adjustments to list
+          in: path
+          name: contextId
+          required: true
+          schema:
+            description: Context ID whose adjustments to list
+            format: uuid
+            type: string
+        - description: Narrow to the entries balancing one match group. Omit to read the whole context.
+          explode: false
+          in: query
+          name: matchGroupId
+          schema:
+            description: Narrow to the entries balancing one match group. Omit to read the whole context.
+            format: uuid
+            type: string
+        - description: Maximum number of records to return
+          explode: false
+          in: query
+          name: limit
+          schema:
+            default: 20
+            description: Maximum number of records to return
+            format: int64
+            maximum: 200
+            minimum: 1
+            type: integer
+        - description: Opaque pagination cursor
+          explode: false
+          in: query
+          name: cursor
+          schema:
+            description: Opaque pagination cursor
+            type: string
+        - description: Sort order
+          explode: false
+          in: query
+          name: sort_order
+          schema:
+            description: Sort order
+            enum:
+              - asc
+              - desc
+            type: string
+      responses:
+        "200":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ListAdjustmentsResponse"
+          description: OK
+        default:
+          content:
+            application/problem+json:
+              schema:
+                $ref: "#/components/schemas/Detail"
+          description: Error
+      security:
+        - BearerAuth: []
+      summary: List recorded adjustments
+      tags:
+        - Matching
   /v1/matching/contexts/{contextId}/open-items:
     get:
       description: Returns a cursor-paginated list of open-item residual ledger entries for a reconciliation context — the carried, partially-filled, and aged obligations the context carries forward across match runs. These are structurally distinct from never-matched (UNMATCHED) transactions. Optionally narrowed by lifecycle status. The listing is readable regardless of context status.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lerianstudio/matcher-mcp",
-  "version": "4.5.0-beta.32",
+  "version": "4.5.0-beta.34",
   "type": "module",
   "description": "Model Context Protocol server for the Matcher reconciliation engine",
   "license": "Apache-2.0",