@lerianstudio/matcher-mcp 5.0.0-beta.139 → 5.0.0-beta.140

package/dist/spec/openapi.yaml

@@ -1894,7 +1894,7 @@ components:
             - array
             - "null"
         signConvention:
-          description: "How this context's data carries sign. SAME: a payment carries the same sign as what it settles, so a negative amount is a reversal. OPPOSITE: a payment carries the opposite sign of the invoice it settles. Defaults to SAME."
+          description: "How this context's data carries sign. SAME: a payment carries the same sign as what it settles, so a negative amount is a reversal. OPPOSITE: a payment carries the opposite sign of the invoice it settles. Defaults to SAME. In 1:N contexts only payments of the declared sign are allocated to an invoice, and in N:M contexts a short-paid invoice keeps an open balance only when it is positive under SAME, or when the rule's sign mode is opposite under OPPOSITE; any other short payment stays unmatched; a carried open balance settles on a payment of the declared sign or on a reversal from the invoice's own side, and a row from an archived source stays unmatched. It cannot change once the context has carried a partial balance, or while a match run is in progress."
           enum:
             - SAME
             - OPPOSITE
@@ -6082,7 +6082,7 @@ components:
             - USD
           type: string
         expectedBalance:
-          description: Original outstanding obligation when the item was first opened, as a decimal string
+          description: "Total owed on the item's identity: the face of the obligation it opened on plus every later obligation with the same identity, as a decimal string"
           examples:
             - "1000.00"
           type: string
@@ -6412,7 +6412,7 @@ components:
             - Bank Reconciliation Q1
           type: string
         signConvention:
-          description: "How this context's data carries sign. SAME: a payment carries the same sign as what it settles, so a negative amount is a reversal. OPPOSITE: a payment carries the opposite sign of the invoice it settles."
+          description: "How this context's data carries sign. SAME: a payment carries the same sign as what it settles, so a negative amount is a reversal. OPPOSITE: a payment carries the opposite sign of the invoice it settles. In 1:N contexts only payments of the declared sign are allocated to an invoice, and in N:M contexts a short-paid invoice keeps an open balance only when it is positive under SAME, or when the rule's sign mode is opposite under OPPOSITE; any other short payment stays unmatched; a carried open balance settles on a payment of the declared sign or on a reversal from the invoice's own side, and a row from an archived source stays unmatched. It cannot change once the context has carried a partial balance, or while a match run is in progress."
           enum:
             - SAME
             - OPPOSITE
@@ -8588,7 +8588,7 @@ components:
           maxLength: 100
           type: string
         signConvention:
-          description: "How this context's data carries sign. SAME: a payment carries the same sign as what it settles, so a negative amount is a reversal. OPPOSITE: a payment carries the opposite sign of the invoice it settles. Omit to leave it unchanged."
+          description: "How this context's data carries sign. SAME: a payment carries the same sign as what it settles, so a negative amount is a reversal. OPPOSITE: a payment carries the opposite sign of the invoice it settles. Omit to leave it unchanged. In 1:N contexts only payments of the declared sign are allocated to an invoice, and in N:M contexts a short-paid invoice keeps an open balance only when it is positive under SAME, or when the rule's sign mode is opposite under OPPOSITE; any other short payment stays unmatched; a carried open balance settles on a payment of the declared sign or on a reversal from the invoice's own side, and a row from an archived source stays unmatched. It cannot change once the context has carried a partial balance, or while a match run is in progress."
           enum:
             - SAME
             - OPPOSITE
@@ -8861,7 +8861,7 @@ components:
           maxLength: 50
           type: string
         side:
-          description: Matching side this source feeds. LEFT and RIGHT are the two sides reconciled against each other.
+          description: Matching side this source feeds. LEFT and RIGHT are the two sides reconciled against each other. A change is refused with a 409 once the context has carried a partial balance, or while a match run is in progress.
           enum:
             - LEFT
             - RIGHT
@@ -9568,7 +9568,7 @@ paths:
       tags:
         - Configuration
     patch:
-      description: "Updates fields on a reconciliation context by ID. Transitions to ACTIVE are gated on server-side activation readiness: an unready context is rejected with a 409 carrying the configuration invalid-state code."
+      description: "Updates fields on a reconciliation context by ID. Transitions to ACTIVE are gated on server-side activation readiness: an unready context is rejected with a 409 carrying the configuration invalid-state code. A sign-convention change is refused with a 409 once the context has carried a partial balance, or while a match run is in progress."
       operationId: updateContext
       parameters:
         - description: Context ID
@@ -9609,7 +9609,7 @@ paths:
                     code: MTCH-0103
               schema:
                 $ref: "#/components/schemas/Detail"
-          description: Context activation is blocked by an invalid transition, a duplicate name, an archived context, or missing activation requirements.
+          description: Context activation is blocked by an invalid transition, a duplicate name, an archived context, or missing activation requirements; a sign-convention change, once the context has carried a partial balance or while a match run is in progress.
         default:
           content:
             application/problem+json:
@@ -10543,7 +10543,7 @@ paths:
       tags:
         - Configuration
     patch:
-      description: Updates fields on a reconciliation source by ID.
+      description: Updates fields on a reconciliation source by ID. A side change is refused with a 409 once the source's context has carried a partial balance, or while a match run is in progress.
       operationId: updateSource
       parameters:
         - description: Context ID

package/package.json

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