@uluops/registry-mcp 0.8.2 → 0.8.3

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## [Unreleased]
 
+## [0.8.3] - 2026-09-24
+
+### Changed
+
+- Add opt-in `nullable-v1` comparison/diff quality contracts with capability negotiation, nullable agent gate rates and explicit run-weighted fraction/denominator metadata. Omitted selection preserves the legacy contract.
+
+
 ## [0.8.2] - 2026-09-24
 
 ### Fixed

package/README.md

@@ -244,3 +244,7 @@ npm run lint
 ## License
 
 MIT
+
+## Quality metric contracts (F04)
+
+`compare_effectiveness` and `get_diff_impact` accept optional `quality_contract: "nullable-v1"`. Select it to preserve absent gate rates/deltas as null with run-weighted basis, gate denominator, and fraction units. Agent gate rates are null. Omission keeps legacy behavior. Requires the F04-capable Registry SDK and producer capability; unsupported selection returns `UNSUPPORTED_CONTRACT` instead of legacy numbers. Release the tolerant SDK and producer before enabling this option.

package/dist/tools/compare-effectiveness.d.ts

@@ -9,15 +9,18 @@ import { type McpServerToolRegistration } from '../types/index.js';
 export declare const CompareEffectivenessInputSchema: z.ZodObject<{
     type: z.ZodOptional<z.ZodEnum<["agent", "command", "workflow", "pipeline"]>>;
     name: z.ZodString;
+    quality_contract: z.ZodOptional<z.ZodLiteral<"nullable-v1">>;
     versions: z.ZodArray<z.ZodString, "many">;
 }, "strip", z.ZodTypeAny, {
     name: string;
     versions: string[];
     type?: "agent" | "command" | "workflow" | "pipeline" | undefined;
+    quality_contract?: "nullable-v1" | undefined;
 }, {
     name: string;
     versions: string[];
     type?: "agent" | "command" | "workflow" | "pipeline" | undefined;
+    quality_contract?: "nullable-v1" | undefined;
 }>;
 export declare function registerCompareEffectivenessTool(server: McpServerToolRegistration, registryClient: RegistryClient): void;
 //# sourceMappingURL=compare-effectiveness.d.ts.map

package/dist/tools/compare-effectiveness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compare-effectiveness.d.ts","sourceRoot":"","sources":["../../src/tools/compare-effectiveness.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAmC,KAAK,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAGpG,eAAO,MAAM,+BAA+B;;;;;;;;;;;;EAI1C,CAAC;AAEH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,yBAAyB,EACjC,cAAc,EAAE,cAAc,GAC7B,IAAI,CASN"}
+{"version":3,"file":"compare-effectiveness.d.ts","sourceRoot":"","sources":["../../src/tools/compare-effectiveness.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAmC,KAAK,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAGpG,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;EAK1C,CAAC;AAEH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,yBAAyB,EACjC,cAAc,EAAE,cAAc,GAC7B,IAAI,CASN"}

package/dist/tools/compare-effectiveness.js

@@ -9,9 +9,10 @@ import { createToolHandler } from '../utils/tool-handler.js';
 export const CompareEffectivenessInputSchema = z.object({
     type: DefinitionTypeWithDefaultSchema,
     name: z.string().min(1),
+    quality_contract: z.literal('nullable-v1').optional().describe('Preserve absent gate rates as null with run-weighted basis, gate denominator and fraction units; requires advertised server support'),
     versions: z.array(z.string().min(1)).min(2).max(5),
 });
 export function registerCompareEffectivenessTool(server, registryClient) {
-    server.tool('compare_effectiveness', 'Compare effectiveness metrics across 2-5 definition versions side-by-side: pass rate, avg score, run count, health score, and translator version.', CompareEffectivenessInputSchema.shape, createToolHandler(CompareEffectivenessInputSchema, (n) => registryClient.analytics.compare(n.type, n.name, n.versions), { toolName: 'compare_effectiveness' }));
+    server.tool('compare_effectiveness', 'Compare effectiveness metrics across 2-5 definition versions side-by-side: pass rate, avg score, run count, health score, and translator version. Select quality_contract=nullable-v1 for truthful absent gate rates; agent gate rates are null and scores remain a separate metric.', CompareEffectivenessInputSchema.shape, createToolHandler(CompareEffectivenessInputSchema, (n) => registryClient.analytics.compare(n.type, n.name, n.versions, n.qualityContract === 'nullable-v1' ? { qualityContract: n.qualityContract } : undefined), { toolName: 'compare_effectiveness' }));
 }
 //# sourceMappingURL=compare-effectiveness.js.map

package/dist/tools/compare-effectiveness.js.map

@@ -1 +1 @@
-{"version":3,"file":"compare-effectiveness.js","sourceRoot":"","sources":["../../src/tools/compare-effectiveness.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,+BAA+B,EAAkC,MAAM,mBAAmB,CAAC;AACpG,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,IAAI,EAAE,+BAA+B;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACnD,CAAC,CAAC;AAEH,MAAM,UAAU,gCAAgC,CAC9C,MAAiC,EACjC,cAA8B;IAE9B,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,mJAAmJ,EACnJ,+BAA+B,CAAC,KAAK,EACrC,iBAAiB,CAAC,+BAA+B,EAAE,CAAC,CAAC,EAAE,EAAE,CACvD,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,EAC5D,EAAE,QAAQ,EAAE,uBAAuB,EAAE,CAAC,CACzC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"compare-effectiveness.js","sourceRoot":"","sources":["../../src/tools/compare-effectiveness.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,+BAA+B,EAAkC,MAAM,mBAAmB,CAAC;AACpG,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,IAAI,EAAE,+BAA+B;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qIAAqI,CAAC;IACrM,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACnD,CAAC,CAAC;AAEH,MAAM,UAAU,gCAAgC,CAC9C,MAAiC,EACjC,cAA8B;IAE9B,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,sRAAsR,EACtR,+BAA+B,CAAC,KAAK,EACrC,iBAAiB,CAAC,+BAA+B,EAAE,CAAC,CAAC,EAAE,EAAE,CACvD,cAAc,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,eAAe,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EACtJ,EAAE,QAAQ,EAAE,uBAAuB,EAAE,CAAC,CACzC,CAAC;AACJ,CAAC"}

package/dist/tools/get-diff-impact.d.ts

@@ -9,6 +9,7 @@ import { type McpServerToolRegistration } from '../types/index.js';
 export declare const GetDiffImpactInputSchema: z.ZodEffects<z.ZodObject<{
     type: z.ZodOptional<z.ZodEnum<["agent", "command", "workflow", "pipeline"]>>;
     name: z.ZodString;
+    quality_contract: z.ZodOptional<z.ZodLiteral<"nullable-v1">>;
     from_version: z.ZodOptional<z.ZodString>;
     to_version: z.ZodOptional<z.ZodString>;
     from: z.ZodOptional<z.ZodString>;
@@ -18,6 +19,7 @@ export declare const GetDiffImpactInputSchema: z.ZodEffects<z.ZodObject<{
     type?: "agent" | "command" | "workflow" | "pipeline" | undefined;
     from?: string | undefined;
     to?: string | undefined;
+    quality_contract?: "nullable-v1" | undefined;
     from_version?: string | undefined;
     to_version?: string | undefined;
 }, {
@@ -25,6 +27,7 @@ export declare const GetDiffImpactInputSchema: z.ZodEffects<z.ZodObject<{
     type?: "agent" | "command" | "workflow" | "pipeline" | undefined;
     from?: string | undefined;
     to?: string | undefined;
+    quality_contract?: "nullable-v1" | undefined;
     from_version?: string | undefined;
     to_version?: string | undefined;
 }>, {
@@ -32,6 +35,7 @@ export declare const GetDiffImpactInputSchema: z.ZodEffects<z.ZodObject<{
     type?: "agent" | "command" | "workflow" | "pipeline" | undefined;
     from?: string | undefined;
     to?: string | undefined;
+    quality_contract?: "nullable-v1" | undefined;
     from_version?: string | undefined;
     to_version?: string | undefined;
 }, {
@@ -39,6 +43,7 @@ export declare const GetDiffImpactInputSchema: z.ZodEffects<z.ZodObject<{
     type?: "agent" | "command" | "workflow" | "pipeline" | undefined;
     from?: string | undefined;
     to?: string | undefined;
+    quality_contract?: "nullable-v1" | undefined;
     from_version?: string | undefined;
     to_version?: string | undefined;
 }>;

package/dist/tools/get-diff-impact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-diff-impact.d.ts","sourceRoot":"","sources":["../../src/tools/get-diff-impact.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAmC,KAAK,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAGpG,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAapC,CAAC;AAEF,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,yBAAyB,EACjC,cAAc,EAAE,cAAc,GAC7B,IAAI,CASN"}
+{"version":3,"file":"get-diff-impact.d.ts","sourceRoot":"","sources":["../../src/tools/get-diff-impact.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAmC,KAAK,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAGpG,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcpC,CAAC;AAEF,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,yBAAyB,EACjC,cAAc,EAAE,cAAc,GAC7B,IAAI,CASN"}

package/dist/tools/get-diff-impact.js

@@ -9,6 +9,7 @@ import { createToolHandler } from '../utils/tool-handler.js';
 export const GetDiffImpactInputSchema = z.object({
     type: DefinitionTypeWithDefaultSchema,
     name: z.string().min(1),
+    quality_contract: z.literal('nullable-v1').optional().describe('Preserve absent gate rates and deltas as null; requires advertised server support'),
     // RG14: diff_versions uses from/to; this tool used from_version/to_version —
     // same concept, adjacent tools, a coin-flip for callers. Both spellings are
     // accepted here; from/to win when both are present (they match the sibling).
@@ -18,6 +19,6 @@ export const GetDiffImpactInputSchema = z.object({
     to: z.string().min(1).optional().describe('Alias for to_version (matches diff_versions)'),
 }).refine((v) => Boolean(v.from ?? v.from_version) && Boolean(v.to ?? v.to_version), { message: "Provide the version pair as either from/to or from_version/to_version." });
 export function registerGetDiffImpactTool(server, registryClient) {
-    server.tool('get_diff_impact', 'Get structural diff combined with metric deltas between two definition versions. Accepts from/to (matching diff_versions) or from_version/to_version. Deltas are observational, not causal — caveats are always included.', GetDiffImpactInputSchema.innerType().shape, createToolHandler(GetDiffImpactInputSchema, (n) => registryClient.analytics.getDiffImpact(n.type, n.name, n.from ?? n.fromVersion, n.to ?? n.toVersion), { toolName: 'get_diff_impact' }));
+    server.tool('get_diff_impact', 'Get structural diff combined with metric deltas between two definition versions. Accepts from/to (matching diff_versions) or from_version/to_version. Deltas are observational, not causal — caveats are always included. Select quality_contract=nullable-v1 for null absent gate rates and deltas, with explicit denominator and fraction units.', GetDiffImpactInputSchema.innerType().shape, createToolHandler(GetDiffImpactInputSchema, (n) => registryClient.analytics.getDiffImpact(n.type, n.name, n.from ?? n.fromVersion, n.to ?? n.toVersion, n.qualityContract === 'nullable-v1' ? { qualityContract: n.qualityContract } : undefined), { toolName: 'get_diff_impact' }));
 }
 //# sourceMappingURL=get-diff-impact.js.map

package/dist/tools/get-diff-impact.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-diff-impact.js","sourceRoot":"","sources":["../../src/tools/get-diff-impact.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,+BAA+B,EAAkC,MAAM,mBAAmB,CAAC;AACpG,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,+BAA+B;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,6EAA6E;IAC7E,4EAA4E;IAC5E,6EAA6E;IAC7E,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC1C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IAC7F,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;CAC1F,CAAC,CAAC,MAAM,CACP,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,EACzE,EAAE,OAAO,EAAE,wEAAwE,EAAE,CACtF,CAAC;AAEF,MAAM,UAAU,yBAAyB,CACvC,MAAiC,EACjC,cAA8B;IAE9B,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,2NAA2N,EAC1N,wBAAuF,CAAC,SAAS,EAAE,CAAC,KAAK,EAC1G,iBAAiB,CAAC,wBAAwB,EAAE,CAAC,CAAC,EAAE,EAAE,CAChD,cAAc,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,EACpG,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC,CACnC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"get-diff-impact.js","sourceRoot":"","sources":["../../src/tools/get-diff-impact.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,+BAA+B,EAAkC,MAAM,mBAAmB,CAAC;AACpG,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,+BAA+B;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mFAAmF,CAAC;IACnJ,6EAA6E;IAC7E,4EAA4E;IAC5E,6EAA6E;IAC7E,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC1C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IAC7F,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;CAC1F,CAAC,CAAC,MAAM,CACP,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,EACzE,EAAE,OAAO,EAAE,wEAAwE,EAAE,CACtF,CAAC;AAEF,MAAM,UAAU,yBAAyB,CACvC,MAAiC,EACjC,cAA8B;IAE9B,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,oVAAoV,EACnV,wBAAuF,CAAC,SAAS,EAAE,CAAC,KAAK,EAC1G,iBAAiB,CAAC,wBAAwB,EAAE,CAAC,CAAC,EAAE,EAAE,CAChD,cAAc,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,eAAe,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAC9L,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC,CACnC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@uluops/registry-mcp",
-  "version": "0.8.2",
-  "description": "MCP server for the UluOps Registry API — definition management, versioning, and analytics",
+  "version": "0.8.3",
+  "description": "MCP server for the UluOps Registry API \u2014 definition management, versioning, and analytics",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -62,7 +62,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "@uluops/registry-sdk": "0.54.0",
+    "@uluops/registry-sdk": "0.54.1",
     "@uluops/sdk-core": "0.18.0",
     "mcp-secure-server": "0.0.25-security",
     "zod": "3.25.76"