@lerianstudio/matcher-mcp 4.5.0-beta.36 → 5.0.0-beta.2

package/dist/copilot/system-prompt.js

@@ -72,8 +72,26 @@ step until the resource is actually usable, and tell the operator exactly what \
 still remains. Never leave them with a broken half-created shell. Do not decide \
 the next step from memory — after each proposal is applied, call the \
 getSetupProgress read tool for that context and propose the action its \`next\` \
-field names (the operationId, path, and required fields it returns); when \
-\`next\` is null the context is ready.
+field names (the operationId, path, and required fields it returns); gate on \
+\`readiness.ready\`, never on \`next\` being null — a null \`next\` can still mean \
+unready (the backend has no action to name for an unmapped gap), so only \
+\`readiness.ready\` being true means the context is actually ready.
+- \`readiness.missing[]\` names each gap using one of six \
+stable identifiers: context.activation.requirement.left-source (no LEFT \
+source yet), context.activation.requirement.right-source (no RIGHT source \
+yet), context.activation.requirement.source-mapping (a source still needs a \
+field map), context.activation.requirement.match-rule (no match rule yet), \
+context.activation.requirement.fee-rule (fee normalization is on but no fee \
+rule exists), and context.activation.requirement.unknown (a setup step \
+outside those five — treat it as "there is still a general setup step \
+remaining" with no specific resource named). \`next.requirementId\` only ever \
+names one of the first five, the actionable ones, never the unknown \
+identifier: an unmapped gap gives the backend no action to name, which is \
+exactly how \`next\` can be null while the context is still unready. These \
+identifiers are for YOU to \
+route on, never for the operator to read: translate the one you see into plain \
+language about what is missing and never paste the raw identifier into your \
+reply.
 - The reconciliation context is the primary example. A bare context is a DRAFT \
 that cannot ingest, match, or report: to be usable it needs at least one LEFT \
 source AND one RIGHT source, a field map for every source, and at least one \
@@ -119,6 +137,19 @@ explain what the mapping does.
 entries, or ingest data — you have no tools for those. If the operator asks, \
 explain what you found and what they would need to do; do not claim to have done \
 it.
+- A failed tool call is a CODED REFUSAL: the tool result carries a matcher \
+\`status\`, \`code\`, and often a \`detail\` sentence. Explain it to the operator in \
+the language they are writing to you in, not by default in English. Always keep \
+the wire \`code\` visible in your answer, exactly as returned — never rename, \
+drop, or invent one, so support can still correlate it with server logs. \
+Translate the \`detail\` the tool actually returned into their language \
+faithfully; never add a cause, a fix, or a fact the tool result did not state. If \
+the result has no usable \`detail\` (blank or absent), say plainly that the \
+request failed and give the \`status\`/\`code\` you do have — never invent an \
+explanation to fill the gap. A 401 or 403 refusal stays SHORT: state in one \
+sentence that the operator is not authorized to do this, and do not speculate \
+about which permission, role, or policy is missing — the tool result does not \
+tell you that, and guessing would be fabrication.
 - Be concise and precise. Prefer exact figures from tool results over vague \
 descriptions. Cite the reconciliation context when it matters.
 

package/dist/copilot/system-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/copilot/system-prompt.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,EAAE;AACF,4EAA4E;AAC5E,yEAAyE;AACzE,wEAAwE;AACxE,+EAA+E;AAC/E,4EAA4E;AAC5E,2EAA2E;AAC3E,aAAa;AACb,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,8EAA8E;AAC9E,+CAA+C;AAC/C,EAAE;AACF,6EAA6E;AAC7E,qEAAqE;AACrE,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,gFAAgF;AAChF,6EAA6E;AAC7E,0EAA0E;AAC1E,8EAA8E;AAC9E,8EAA8E;AAC9E,4EAA4E;AAa5E,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iEAyN6C,CAAA;AAEjE;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,WAAW,CAAA;AACpB,CAAC"}
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../src/copilot/system-prompt.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,EAAE;AACF,4EAA4E;AAC5E,yEAAyE;AACzE,wEAAwE;AACxE,+EAA+E;AAC/E,4EAA4E;AAC5E,2EAA2E;AAC3E,aAAa;AACb,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,8EAA8E;AAC9E,+CAA+C;AAC/C,EAAE;AACF,6EAA6E;AAC7E,qEAAqE;AACrE,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,gFAAgF;AAChF,6EAA6E;AAC7E,0EAA0E;AAC1E,8EAA8E;AAC9E,8EAA8E;AAC9E,4EAA4E;AAa5E,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iEAwP6C,CAAA;AAEjE;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,WAAW,CAAA;AACpB,CAAC"}

package/dist/spec/openapi.yaml

@@ -3449,7 +3449,7 @@ components:
             - "2025-01-15T10:30:00Z"
           type: string
         usedByContexts:
-          description: Number of distinct contexts whose fee rules reference this schedule. Computed at read time from fee_rules (never persisted).
+          description: Number of distinct contexts whose fee rules reference this schedule. Computed at read time from the fee rules that reference this schedule (never persisted).
           examples:
             - 2
           format: int64
@@ -6667,19 +6667,9 @@ components:
     SetupProgressNextResponse:
       additionalProperties: false
       properties:
-        action:
-          description: Stable semantic label of the action.
-          enum:
-            - add_left_source
-            - add_right_source
-            - add_field_map
-            - add_match_rule
-          examples:
-            - add_left_source
-          type: string
         forSource:
           $ref: "#/components/schemas/SetupProgressSourceRef"
-          description: Source the action targets; set only for the field_maps action, naming the unmapped source.
+          description: Source the action targets; set only for the source-mapping action, naming the unmapped source.
         method:
           description: HTTP method of the create endpoint.
           examples:
@@ -6706,19 +6696,19 @@ components:
           type:
             - array
             - "null"
-        slug:
-          description: Readiness slug this action satisfies.
+        requirementId:
+          description: Public activation-requirement identifier this action satisfies.
           enum:
-            - sources_left
-            - sources_right
-            - field_maps
-            - match_rules
+            - context.activation.requirement.left-source
+            - context.activation.requirement.right-source
+            - context.activation.requirement.source-mapping
+            - context.activation.requirement.match-rule
+            - context.activation.requirement.fee-rule
           examples:
-            - sources_left
+            - context.activation.requirement.left-source
           type: string
       required:
-        - slug
-        - action
+        - requirementId
         - operationId
         - method
         - path
@@ -6728,11 +6718,18 @@ components:
       additionalProperties: false
       properties:
         missing:
-          description: Stable slugs of missing requirements (sources_left, sources_right, field_maps, match_rules); empty when ready.
+          description: Stable identifiers of missing activation requirements; empty when ready.
           examples:
-            - - sources_left
-              - match_rules
+            - - context.activation.requirement.left-source
+              - context.activation.requirement.match-rule
           items:
+            enum:
+              - context.activation.requirement.left-source
+              - context.activation.requirement.right-source
+              - context.activation.requirement.source-mapping
+              - context.activation.requirement.match-rule
+              - context.activation.requirement.fee-rule
+              - context.activation.requirement.unknown
             type: string
           type:
             - array
@@ -8789,6 +8786,24 @@ paths:
               schema:
                 $ref: "#/components/schemas/ReconciliationContextResponse"
           description: OK
+        "409":
+          content:
+            application/problem+json:
+              examples:
+                activationNotReady:
+                  summary: Missing a right-side source and a match rule.
+                  value:
+                    type: https://errors.lerian.studio/v1/MTCH-0103
+                    title: Conflict
+                    status: 409
+                    detail: context is not ready for activation; call GET setup-progress for the missing requirements
+                    errors:
+                      - location: context.activation.requirement.right-source
+                      - location: context.activation.requirement.match-rule
+                    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.
         default:
           content:
             application/problem+json:
@@ -12478,6 +12493,30 @@ paths:
       responses:
         "204":
           description: No Content
+        "409":
+          content:
+            application/problem+json:
+              examples:
+                feeScheduleInUse:
+                  summary: Two contexts still reference this schedule's fee rules.
+                  value:
+                    type: https://errors.lerian.studio/v1/MTCH-0108
+                    title: Conflict
+                    status: 409
+                    detail: This fee schedule is still referenced by fee rules; nothing was deleted. Remove the referencing fee rules, then retry the deletion.
+                    errors:
+                      - location: fee-schedule.delete.blocking-contexts
+                        value:
+                          references:
+                            - id: 11111111-1111-1111-1111-111111111111
+                              name: US Card Settlements
+                            - id: 22222222-2222-2222-2222-222222222222
+                              name: EU Card Settlements
+                          count: 2
+                    code: MTCH-0108
+              schema:
+                $ref: "#/components/schemas/Detail"
+          description: Fee schedule is still referenced by fee rules or variance history.
         default:
           content:
             application/problem+json:

package/dist/tools/context/index.js

@@ -11,9 +11,10 @@
 // field.
 //
 // `context_setup_progress` (F3 fix) reports activation/upload prerequisites —
-// configured-resource counts and the stable missing-requirement slugs — so an
-// operator can check readiness before attempting `context_update
-// status=ACTIVE` instead of discovering the gate via a 409.
+// configured-resource counts and the stable missing-requirement identifiers
+// (context.activation.requirement.*) — so an operator can check readiness
+// before attempting `context_update status=ACTIVE` instead of discovering the
+// gate via a 409.
 import { registerContextArchiveTool } from './archive.js';
 import { registerContextCreateTool } from './create.js';
 import { registerContextGetTool } from './get.js';

package/dist/tools/context/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/context/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,wEAAwE;AACxE,+EAA+E;AAC/E,+EAA+E;AAC/E,+EAA+E;AAC/E,gFAAgF;AAChF,+EAA+E;AAC/E,iFAAiF;AACjF,+EAA+E;AAC/E,+EAA+E;AAC/E,SAAS;AACT,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,iEAAiE;AACjE,4DAA4D;AAI5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAA;AACnD,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAA;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAA;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AAEvD,8DAA8D;AAC9D,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,yBAAyB,CAAC,MAAM,CAAC,CAAA;IACjC,uBAAuB,CAAC,MAAM,CAAC,CAAA;IAC/B,sBAAsB,CAAC,MAAM,CAAC,CAAA;IAC9B,yBAAyB,CAAC,MAAM,CAAC,CAAA;IACjC,0BAA0B,CAAC,MAAM,CAAC,CAAA;IAClC,0BAA0B,CAAC,MAAM,CAAC,CAAA;IAClC,gCAAgC,CAAC,MAAM,CAAC,CAAA;IACxC,2BAA2B,CAAC,MAAM,CAAC,CAAA;AACrC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/context/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,wEAAwE;AACxE,+EAA+E;AAC/E,+EAA+E;AAC/E,+EAA+E;AAC/E,gFAAgF;AAChF,+EAA+E;AAC/E,iFAAiF;AACjF,+EAA+E;AAC/E,+EAA+E;AAC/E,SAAS;AACT,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,0EAA0E;AAC1E,8EAA8E;AAC9E,kBAAkB;AAIlB,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAA;AACnD,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAA;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,EAAE,gCAAgC,EAAE,MAAM,qBAAqB,CAAA;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AAEvD,8DAA8D;AAC9D,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,yBAAyB,CAAC,MAAM,CAAC,CAAA;IACjC,uBAAuB,CAAC,MAAM,CAAC,CAAA;IAC/B,sBAAsB,CAAC,MAAM,CAAC,CAAA;IAC9B,yBAAyB,CAAC,MAAM,CAAC,CAAA;IACjC,0BAA0B,CAAC,MAAM,CAAC,CAAA;IAClC,0BAA0B,CAAC,MAAM,CAAC,CAAA;IAClC,gCAAgC,CAAC,MAAM,CAAC,CAAA;IACxC,2BAA2B,CAAC,MAAM,CAAC,CAAA;AACrC,CAAC"}

package/dist/tools/context/next-step.js

@@ -44,13 +44,19 @@ export function registerContextNextStepTool(server) {
             'its readiness gate. Provide contextId (UUID path param, not a tenant ' +
             'field). Returns { ready, next, thenCall }: ready is true only when the ' +
             'context satisfies every activation requirement; next is the exact ' +
-            'action to take (slug, action, operationId, method, path, requiredFields ' +
-            '— field NAMES only, never values; you supply the values), or null when ' +
-            'ready; thenCall instructs you to apply next and call next_step again ' +
-            'with the same contextId, repeating until ready is true (null when ' +
-            'ready). Prefer this over context_setup_progress when you just need the ' +
-            'next action to advance setup. Returns a structured RFC 9457 error on ' +
-            'failure (e.g. 404 if the context does not exist or is not yours).',
+            'action to take (requirementId — one of the FIVE public ' +
+            'context.activation.requirement.* identifiers: left-source, ' +
+            'right-source, source-mapping, match-rule, fee-rule; the sixth, ' +
+            'context.activation.requirement.unknown, never reaches next — the ' +
+            "backend returns a null next for an unmapped slug — it appears only in " +
+            'context_setup_progress readiness.missing[]; operationId, method, ' +
+            'path, requiredFields — field NAMES only, never values; you supply the ' +
+            'values), or null when ready; thenCall instructs you to apply next and ' +
+            'call next_step again with the same contextId, repeating until ready is ' +
+            'true (null when ready). Prefer this over context_setup_progress when ' +
+            'you just need the next action to advance setup. Returns a structured ' +
+            'RFC 9457 error on failure (e.g. 404 if the context does not exist or ' +
+            'is not yours).',
         inputSchema: nextStepInputShape,
     }, async (args, extra) => {
         let client;

package/dist/tools/context/next-step.js.map

@@ -1 +1 @@
-{"version":3,"file":"next-step.js","sourceRoot":"","sources":["../../../src/tools/context/next-step.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,mEAAmE;AACnE,+BAA+B;AAC/B,EAAE;AACF,gFAAgF;AAChF,gFAAgF;AAChF,iFAAiF;AACjF,gFAAgF;AAChF,gFAAgF;AAChF,iFAAiF;AACjF,EAAE;AACF,6EAA6E;AAC7E,mEAAmE;AACnE,kFAAkF;AAClF,iFAAiF;AACjF,8DAA8D;AAE9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAA;AAE9D;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAC/B,8EAA8E;IAC9E,qDAAqD,CAAA;AAEvD,iEAAiE;AACjE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,sEAAsE,CAAC;CACpF,CAAA;AAWD;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,YAAY,CACjB,WAAW,EACX;QACE,WAAW,EACT,wEAAwE;YACxE,uEAAuE;YACvE,yEAAyE;YACzE,oEAAoE;YACpE,0EAA0E;YAC1E,yEAAyE;YACzE,uEAAuE;YACvE,oEAAoE;YACpE,yEAAyE;YACzE,uEAAuE;YACvE,mEAAmE;QACrE,WAAW,EAAE,kBAAkB;KAChC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,IAAI,MAAM,CAAA;QACV,IAAI,CAAC;YACH,4DAA4D;YAC5D,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAA;QACtC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,oBAAoB,EAAE,CAAC;gBACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,CAAA;YAC1E,CAAC;YACD,MAAM,GAAG,CAAA;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAoB;gBACnD,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,wBAAwB,CAAC,IAAI,CAAC,SAAS,CAAC;aAC/C,CAAC,CAAA;YACF,wEAAwE;YACxE,8DAA8D;YAC9D,MAAM,KAAK,GAAG,IAAI,EAAE,SAAS,EAAE,KAAK,IAAI,KAAK,CAAA;YAC7C,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,IAAI,CAAA;YAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAA;YACnD,OAAO;gBACL,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE;iBAClE;aACF,CAAA;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,qEAAqE;YACrE,2DAA2D;YAC3D,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,OAAO,WAAW,CAAC,GAAG,CAAC,CAAA;YACzB,CAAC;YACD,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC,CACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"next-step.js","sourceRoot":"","sources":["../../../src/tools/context/next-step.ts"],"names":[],"mappings":"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"}

package/dist/tools/context/setup-progress.js

@@ -6,9 +6,9 @@
 // + match rules to already exist (the readiness gate). Before this tool, an
 // operator only discovered the gate by hitting a 403/409. This tool reports
 // the SAME aggregate state matcher's readiness gate checks — configured-
-// resource counts, last-run state, and the stable missing-requirement slugs —
-// in one request, so an operator-driving LLM can check readiness BEFORE
-// attempting activation instead of after failing it.
+// resource counts, last-run state, and the stable missing-requirement
+// identifiers — in one request, so an operator-driving LLM can check
+// readiness BEFORE attempting activation instead of after failing it.
 //
 // contextId is the only input (a UUID path param); no tenant field is
 // accepted (matcher scopes to the relayed token's tenant).
@@ -43,11 +43,17 @@ export function registerContextSetupProgressTool(server) {
             'schedules { total }; lastRun (id/status/completedAt of the most ' +
             'recent match run, or null if it never ran); and readiness ' +
             '{ ready, missing[] } — ready is true only when every requirement is ' +
-            'met, and missing[] names the stable gaps using the SAME slugs ' +
-            '(sources_left, sources_right, field_maps, match_rules) the 409 ' +
-            'activation-rejection payload uses. Returns a structured RFC 9457 ' +
-            'error on failure (e.g. 404 if the context does not exist or is not ' +
-            'yours).',
+            'met, and missing[] names the stable gaps. The 409 activation ' +
+            'rejection itself carries NO requirement detail — it is deliberately ' +
+            'generic — so this is where to read the identifiers: ' +
+            'context.activation.requirement.left-source, ' +
+            'context.activation.requirement.right-source, ' +
+            'context.activation.requirement.source-mapping, ' +
+            'context.activation.requirement.match-rule, ' +
+            'context.activation.requirement.fee-rule, or ' +
+            'context.activation.requirement.unknown. Returns a structured RFC ' +
+            '9457 error on failure (e.g. 404 if the context does not exist or is ' +
+            'not yours).',
         inputSchema: getContextSetupProgressInputShape,
     }, async (args, extra) => {
         return dispatchContext({ method: 'GET', path: contextSetupProgressPath(args.contextId) }, extra);

package/dist/tools/context/setup-progress.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup-progress.js","sourceRoot":"","sources":["../../../src/tools/context/setup-progress.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,+EAA+E;AAC/E,4EAA4E;AAC5E,4EAA4E;AAC5E,yEAAyE;AACzE,8EAA8E;AAC9E,wEAAwE;AACxE,qDAAqD;AACrD,EAAE;AACF,sEAAsE;AACtE,2DAA2D;AAE3D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE1D,uDAAuD;AACvD,MAAM,UAAU,wBAAwB,CAAC,SAAiB;IACxD,OAAO,GAAG,WAAW,CAAC,SAAS,CAAC,iBAAiB,CAAA;AACnD,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,MAAM,iCAAiC,GAAG;IAC/C,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,mEAAmE,CAAC;CACjF,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,gCAAgC,CAAC,MAAiB;IAChE,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,WAAW,EACT,mEAAmE;YACnE,uEAAuE;YACvE,sEAAsE;YACtE,oEAAoE;YACpE,sEAAsE;YACtE,qEAAqE;YACrE,sEAAsE;YACtE,+DAA+D;YAC/D,kEAAkE;YAClE,4DAA4D;YAC5D,sEAAsE;YACtE,gEAAgE;YAChE,iEAAiE;YACjE,mEAAmE;YACnE,qEAAqE;YACrE,SAAS;QACX,WAAW,EAAE,iCAAiC;KAC/C,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,eAAe,CACpB,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,wBAAwB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EACjE,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"setup-progress.js","sourceRoot":"","sources":["../../../src/tools/context/setup-progress.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,+EAA+E;AAC/E,4EAA4E;AAC5E,4EAA4E;AAC5E,yEAAyE;AACzE,sEAAsE;AACtE,qEAAqE;AACrE,sEAAsE;AACtE,EAAE;AACF,sEAAsE;AACtE,2DAA2D;AAE3D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE1D,uDAAuD;AACvD,MAAM,UAAU,wBAAwB,CAAC,SAAiB;IACxD,OAAO,GAAG,WAAW,CAAC,SAAS,CAAC,iBAAiB,CAAA;AACnD,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,MAAM,iCAAiC,GAAG;IAC/C,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,mEAAmE,CAAC;CACjF,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,gCAAgC,CAAC,MAAiB;IAChE,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,WAAW,EACT,mEAAmE;YACnE,uEAAuE;YACvE,sEAAsE;YACtE,oEAAoE;YACpE,sEAAsE;YACtE,qEAAqE;YACrE,sEAAsE;YACtE,+DAA+D;YAC/D,kEAAkE;YAClE,4DAA4D;YAC5D,sEAAsE;YACtE,+DAA+D;YAC/D,sEAAsE;YACtE,sDAAsD;YACtD,8CAA8C;YAC9C,+CAA+C;YAC/C,iDAAiD;YACjD,6CAA6C;YAC7C,8CAA8C;YAC9C,mEAAmE;YACnE,sEAAsE;YACtE,aAAa;QACf,WAAW,EAAE,iCAAiC;KAC/C,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,eAAe,CACpB,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,wBAAwB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EACjE,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/field-map/delete.js

@@ -5,7 +5,8 @@
 // scopes to the relayed token's tenant). A 204 response surfaces as `null`
 // (see dispatchFieldMap), matching the other curated families' delete
 // behavior. Deleting a source's only field map will reopen the
-// `field_maps` readiness gap reported by context_setup_progress.
+// context.activation.requirement.source-mapping readiness gap reported by
+// context_setup_progress.
 import { z } from 'zod';
 import { dispatchFieldMap, fieldMapPath } from './shared.js';
 /** Zod raw shape for `field_map_delete` input — just the flat id. */
@@ -23,8 +24,9 @@ export const deleteFieldMapInputShape = {
 export function registerFieldMapDeleteTool(server) {
     server.registerTool('field_map_delete', {
         description: 'Delete a field map by id (UUID path param, not a tenant field). ' +
-            "Removing a source's only field map reopens the field_maps " +
-            'activation-readiness gap (see context_setup_progress) and an ACTIVE ' +
+            "Removing a source's only field map reopens the " +
+            'context.activation.requirement.source-mapping activation-readiness ' +
+            'gap (see context_setup_progress) and an ACTIVE ' +
             "context's matching/ingestion against that source will be affected. " +
             'Returns null on success (204), or a structured RFC 9457 error.',
         inputSchema: deleteFieldMapInputShape,

package/dist/tools/field-map/delete.js.map

@@ -1 +1 @@
-{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/tools/field-map/delete.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,2EAA2E;AAC3E,sEAAsE;AACtE,+DAA+D;AAC/D,iEAAiE;AAEjE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE5D,qEAAqE;AACrE,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,oCAAoC,CAAC;CAClD,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,WAAW,EACT,kEAAkE;YAClE,4DAA4D;YAC5D,sEAAsE;YACtE,qEAAqE;YACrE,gEAAgE;QAClE,WAAW,EAAE,wBAAwB;KACtC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,gBAAgB,CACrB,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,EACzD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/tools/field-map/delete.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,2EAA2E;AAC3E,sEAAsE;AACtE,+DAA+D;AAC/D,0EAA0E;AAC1E,0BAA0B;AAE1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE5D,qEAAqE;AACrE,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,oCAAoC,CAAC;CAClD,CAAA;AAOD;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAiB;IAC1D,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,WAAW,EACT,kEAAkE;YAClE,iDAAiD;YACjD,qEAAqE;YACrE,iDAAiD;YACjD,qEAAqE;YACrE,gEAAgE;QAClE,WAAW,EAAE,wBAAwB;KACtC,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,OAAO,gBAAgB,CACrB,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,EACzD,KAAK,CACN,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/tools/field-map/index.js

@@ -1,11 +1,11 @@
 // Curated field-map vertical: five typed tools over the matcher field-map
 // resource — create, list, get, update, delete. Field maps bind a source's
 // raw column names to matcher's canonical reconciliation vocabulary and gate
-// context activation (the `field_maps` readiness slug — see
-// context_setup_progress). Closes findings N3 (field-map shape undiscoverable)
-// and N4/F6 (createFieldMap generic-only, ingestion read/write asymmetry):
-// before this family, all five operations were UNCOVERED (neither curated nor
-// generic-only).
+// context activation (the context.activation.requirement.source-mapping
+// readiness identifier — see context_setup_progress). Closes findings N3
+// (field-map shape undiscoverable) and N4/F6 (createFieldMap generic-only,
+// ingestion read/write asymmetry): before this family, all five operations
+// were UNCOVERED (neither curated nor generic-only).
 //
 // Path shape is mixed, unlike sources: create/get are source-nested
 // (/v1/contexts/{contextId}/sources/{sourceId}/field-maps), list is

package/dist/tools/field-map/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/field-map/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,2EAA2E;AAC3E,6EAA6E;AAC7E,4DAA4D;AAC5D,+EAA+E;AAC/E,2EAA2E;AAC3E,8EAA8E;AAC9E,iBAAiB;AACjB,EAAE;AACF,oEAAoE;AACpE,oEAAoE;AACpE,8EAA8E;AAC9E,yEAAyE;AACzE,6EAA6E;AAC7E,2EAA2E;AAC3E,wEAAwE;AACxE,gBAAgB;AAIhB,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAA;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAA;AACpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAExD,qEAAqE;AACrE,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,0BAA0B,CAAC,MAAM,CAAC,CAAA;IAClC,wBAAwB,CAAC,MAAM,CAAC,CAAA;IAChC,uBAAuB,CAAC,MAAM,CAAC,CAAA;IAC/B,0BAA0B,CAAC,MAAM,CAAC,CAAA;IAClC,0BAA0B,CAAC,MAAM,CAAC,CAAA;AACpC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/field-map/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,2EAA2E;AAC3E,6EAA6E;AAC7E,wEAAwE;AACxE,yEAAyE;AACzE,2EAA2E;AAC3E,2EAA2E;AAC3E,qDAAqD;AACrD,EAAE;AACF,oEAAoE;AACpE,oEAAoE;AACpE,8EAA8E;AAC9E,yEAAyE;AACzE,6EAA6E;AAC7E,2EAA2E;AAC3E,wEAAwE;AACxE,gBAAgB;AAIhB,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAA;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAA;AACpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAA;AAExD,qEAAqE;AACrE,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,0BAA0B,CAAC,MAAM,CAAC,CAAA;IAClC,wBAAwB,CAAC,MAAM,CAAC,CAAA;IAChC,uBAAuB,CAAC,MAAM,CAAC,CAAA;IAC/B,0BAA0B,CAAC,MAAM,CAAC,CAAA;IAClC,0BAA0B,CAAC,MAAM,CAAC,CAAA;AACpC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lerianstudio/matcher-mcp",
-  "version": "4.5.0-beta.36",
+  "version": "5.0.0-beta.2",
   "type": "module",
   "description": "Model Context Protocol server for the Matcher reconciliation engine",
   "license": "Apache-2.0",
@@ -41,6 +41,7 @@
     "build": "tsc",
     "postbuild": "node scripts/vendor-spec.mjs",
     "typecheck": "tsc --noEmit",
+    "pretest": "node scripts/vendor-spec.mjs",
     "test": "vitest run",
     "lint": "eslint ."
   },