@uluops/registry-mcp 0.8.2 → 0.9.0

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 ## [Unreleased]
 
+## [0.9.0] - 2026-09-26
+
+### Added
+
+- `diff_versions.diff_contract="combined-v1"` selects applicable unified patches with exact source/target YAML when `full=true`. Updated SDK negotiates support; omitted selectors retain legacy full precedence.
+
+## [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

@@ -88,7 +88,7 @@ update_and_publish({ type: "agent", name: "my-agent", version: "1.1.0", yaml: ".
 // Compare versions in three different formats
 diff_versions({ type: "agent", name: "code-validator", from: "1.0.0", to: "1.1.0" })                  // section summary
 diff_versions({ type: "agent", name: "code-validator", from: "1.0.0", to: "1.1.0", format: "fields" })  // structural diff + suggested bump
-diff_versions({ type: "agent", name: "code-validator", from: "1.0.0", to: "1.1.0", format: "unified" }) // git-style diff
+diff_versions({ type: "agent", name: "code-validator", from: "1.0.0", to: "1.1.0", format: "unified", diff_contract: "combined-v1", full: true }) // patch + exact YAML
 
 // Analytics
 get_effectiveness({ type: "agent", name: "code-validator", version: "1.1.0" })
@@ -128,7 +128,7 @@ compare_effectiveness({ type: "agent", name: "code-validator", versions: ["1.0.0
 | Tool | Description |
 |------|-------------|
 | `list_versions` | List all versions of a definition |
-| `diff_versions` | Compare two versions. `format`: `sections` (default), `fields` (structural + suggested bump), `unified` (git-style) |
+| `diff_versions` | Compare two versions. `format`: `sections` (default), `fields` (structural + suggested bump), `unified`. Select `diff_contract="combined-v1"` for an applicable patch; `full=true` adds exact YAML. |
 | `get_dependencies` | Forward dependency graph |
 | `get_dependents` | Reverse dependency graph |
 | `get_execution_stats` | Execution statistics for a definition version |
@@ -244,3 +244,16 @@ 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.
+
+### Applicable unified diffs
+
+Call `diff_versions` with `format: "unified"` and `diff_contract: "combined-v1"`.
+Add `full: true` to receive exact `sourceYaml`/`targetYaml` alongside `unified`.
+An unchanged pair returns an empty patch. The SDK negotiates support and refuses
+unsupported servers without falling back. Legacy omission keeps `full=true`
+precedence (raw `fromYaml`/`toYaml`, no patch) until a future major release with
+at least 90 days notice.

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/diff-versions.d.ts

@@ -13,6 +13,7 @@ export declare const DiffVersionsInputSchema: z.ZodObject<{
     to: z.ZodString;
     full: z.ZodDefault<z.ZodBoolean>;
     format: z.ZodDefault<z.ZodEnum<["sections", "fields", "unified"]>>;
+    diff_contract: z.ZodOptional<z.ZodLiteral<"combined-v1">>;
 }, "strip", z.ZodTypeAny, {
     name: string;
     full: boolean;
@@ -20,6 +21,7 @@ export declare const DiffVersionsInputSchema: z.ZodObject<{
     from: string;
     to: string;
     type?: "agent" | "command" | "workflow" | "pipeline" | undefined;
+    diff_contract?: "combined-v1" | undefined;
 }, {
     name: string;
     from: string;
@@ -27,6 +29,7 @@ export declare const DiffVersionsInputSchema: z.ZodObject<{
     type?: "agent" | "command" | "workflow" | "pipeline" | undefined;
     full?: boolean | undefined;
     format?: "fields" | "sections" | "unified" | undefined;
+    diff_contract?: "combined-v1" | undefined;
 }>;
 export declare function registerDiffVersionsTool(server: McpServerToolRegistration, registryClient: RegistryClient): void;
 //# sourceMappingURL=diff-versions.d.ts.map

package/dist/tools/diff-versions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diff-versions.d.ts","sourceRoot":"","sources":["../../src/tools/diff-versions.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,uBAAuB;;;;;;;;;;;;;;;;;;;;;EAOlC,CAAC;AAEH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,yBAAyB,EACjC,cAAc,EAAE,cAAc,GAC7B,IAAI,CASN"}
+{"version":3,"file":"diff-versions.d.ts","sourceRoot":"","sources":["../../src/tools/diff-versions.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,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;EAQlC,CAAC;AAEH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,yBAAyB,EACjC,cAAc,EAAE,cAAc,GAC7B,IAAI,CASN"}

package/dist/tools/diff-versions.js

@@ -13,8 +13,9 @@ export const DiffVersionsInputSchema = z.object({
     to: z.string().min(1),
     full: z.boolean().default(false),
     format: z.enum(['sections', 'fields', 'unified']).default('sections'),
+    diff_contract: z.literal('combined-v1').optional().describe('Opt-in applicable unified patch; requires format=unified. With full=true also returns exact sourceYaml/targetYaml.'),
 });
 export function registerDiffVersionsTool(server, registryClient) {
-    server.tool('diff_versions', 'Compare two versions of a definition. Returns a section-level summary by default — note that for ADL agents everything nests under one "agent" section, so sectionsModified is always ["agent"]; prefer format="fields" for anything ADL. format="fields" gives a field-level structural diff with classification; its valueDiff entries use diff-match-patch opcodes: [0,"…"]=unchanged, [-1,"…"]=removed, [1,"…"]=added. format="unified" gives a git-style line diff. Pass full=true for raw YAML content.', DiffVersionsInputSchema.shape, createToolHandler(DiffVersionsInputSchema, (n) => registryClient.versions.diff(n.type, n.name, n.from, n.to, { full: n.full, format: n.format }), { toolName: 'diff_versions' }));
+    server.tool('diff_versions', 'Compare two versions of a definition. Returns a section-level summary by default — note that for ADL agents everything nests under one "agent" section, so sectionsModified is always ["agent"]; prefer format="fields" for anything ADL. format="fields" gives a field-level structural diff with classification; its valueDiff entries use diff-match-patch opcodes: [0,"…"]=unchanged, [-1,"…"]=removed, [1,"…"]=added. format="unified" gives a git-style line diff. Select diff_contract="combined-v1" with format="unified" for an applicable patch (empty string for no changes); full=true additionally returns exact sourceYaml/targetYaml. Without the selector, full=true returns raw fromYaml/toYaml and overrides format.', DiffVersionsInputSchema.shape, createToolHandler(DiffVersionsInputSchema, (n) => registryClient.versions.diff(n.type, n.name, n.from, n.to, { full: n.full, format: n.format, ...(n.diffContract !== undefined && { diffContract: n.diffContract }) }), { toolName: 'diff_versions' }));
 }
 //# sourceMappingURL=diff-versions.js.map

package/dist/tools/diff-versions.js.map

@@ -1 +1 @@
-{"version":3,"file":"diff-versions.js","sourceRoot":"","sources":["../../src/tools/diff-versions.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,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,+BAA+B;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;CACtE,CAAC,CAAC;AAEH,MAAM,UAAU,wBAAwB,CACtC,MAAiC,EACjC,cAA8B;IAE9B,MAAM,CAAC,IAAI,CACT,eAAe,EACf,+eAA+e,EAC/e,uBAAuB,CAAC,KAAK,EAC7B,iBAAiB,CAAC,uBAAuB,EAAE,CAAC,CAAC,EAAE,EAAE,CAC/C,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,EAC9F,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CACjC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"diff-versions.js","sourceRoot":"","sources":["../../src/tools/diff-versions.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,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,+BAA+B;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IACrE,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oHAAoH,CAAC;CAClL,CAAC,CAAC;AAEH,MAAM,UAAU,wBAAwB,CACtC,MAAiC,EACjC,cAA8B;IAE9B,MAAM,CAAC,IAAI,CACT,eAAe,EACf,wsBAAwsB,EACxsB,uBAAuB,CAAC,KAAK,EAC7B,iBAAiB,CAAC,uBAAuB,EAAE,CAAC,CAAC,EAAE,EAAE,CAC/C,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,YAAY,KAAK,SAAS,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC,EACrK,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CACjC,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,6 +1,6 @@
 {
   "name": "@uluops/registry-mcp",
-  "version": "0.8.2",
+  "version": "0.9.0",
   "description": "MCP server for the UluOps Registry API — definition management, versioning, and analytics",
   "type": "module",
   "main": "dist/index.js",
@@ -62,7 +62,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "@uluops/registry-sdk": "0.54.0",
+    "@uluops/registry-sdk": "0.55.0",
     "@uluops/sdk-core": "0.18.0",
     "mcp-secure-server": "0.0.25-security",
     "zod": "3.25.76"