unreal-engine-mcp-server 0.5.21 → 0.6.0-a

package/dist/tools/catalog/capabilities/hashing.d.ts

@@ -0,0 +1,14 @@
+export declare class CapabilitySerializationError extends Error {
+    readonly code: "CAPABILITY_SERIALIZATION_ERROR";
+    constructor(message: string);
+}
+export declare function stableJsonStringify(value: unknown): string;
+export type CapabilityHashBundle = {
+    readonly algorithm: 'sha256';
+    readonly schema: string;
+    readonly content: string;
+};
+export declare function readField(source: unknown, key: string): unknown;
+export declare function computeCapabilityHashes(source: unknown): CapabilityHashBundle;
+export declare function stripUndefined(value: unknown): unknown;
+//# sourceMappingURL=hashing.d.ts.map

package/dist/tools/catalog/capabilities/hashing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashing.d.ts","sourceRoot":"","sources":["../../../../src/tools/catalog/capabilities/hashing.ts"],"names":[],"mappings":"AAEA,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,IAAI,EAAG,gCAAgC,CAAU;gBAC9C,OAAO,EAAE,MAAM;CAI5B;AAmCD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE1D;AAMD,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,oBAAoB,CAS7E;AAgBD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAkBtD"}

package/dist/tools/catalog/capabilities/hashing.js

@@ -0,0 +1,80 @@
+import { createHash } from 'node:crypto';
+export class CapabilitySerializationError extends Error {
+    code = 'CAPABILITY_SERIALIZATION_ERROR';
+    constructor(message) {
+        super(message);
+        this.name = 'CapabilitySerializationError';
+    }
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function normalize(value) {
+    if (typeof value === 'bigint') {
+        throw new CapabilitySerializationError('Capability hash input must not contain bigint');
+    }
+    if (typeof value === 'function' ||
+        typeof value === 'symbol' ||
+        typeof value === 'undefined') {
+        throw new CapabilitySerializationError('Capability hash input must be JSON-compatible');
+    }
+    if (typeof value === 'number') {
+        if (Number.isNaN(value) || !Number.isFinite(value)) {
+            throw new CapabilitySerializationError('Capability hash input must not contain NaN or Infinity');
+        }
+        if (value === 0 && 1 / value < 0)
+            return 0;
+        return value;
+    }
+    if (Array.isArray(value))
+        return value.map(normalize);
+    if (isPlainObject(value)) {
+        const out = {};
+        for (const key of Object.keys(value).sort())
+            out[key] = normalize(value[key]);
+        return out;
+    }
+    return value;
+}
+export function stableJsonStringify(value) {
+    return JSON.stringify(normalize(value));
+}
+function sha256Hex(input) {
+    return createHash('sha256').update(input).digest('hex');
+}
+export function readField(source, key) {
+    return isPlainObject(source) ? source[key] : undefined;
+}
+export function computeCapabilityHashes(source) {
+    const record = isPlainObject(source) ? source : {};
+    const rawSchemas = readField(record, 'schemas');
+    const schemas = isPlainObject(rawSchemas) ? rawSchemas : {};
+    const input = readField(schemas, 'input');
+    const output = readField(schemas, 'output');
+    const schemaHash = sha256Hex(stableJsonStringify({ input, output }));
+    const contentHash = sha256Hex(stableJsonStringify({ ...record, schemaHash }));
+    return { algorithm: 'sha256', schema: schemaHash, content: contentHash };
+}
+export function stripUndefined(value) {
+    if (Array.isArray(value))
+        return value.map(stripUndefined);
+    if (value !== null && typeof value === 'object') {
+        const out = {};
+        for (const [key, entry] of Object.entries(value)) {
+            if (entry === undefined)
+                continue;
+            const shaped = stripUndefined(entry);
+            if (key === '__proto__') {
+                Object.defineProperty(out, key, {
+                    value: shaped, enumerable: true, writable: true, configurable: true,
+                });
+            }
+            else {
+                out[key] = shaped;
+            }
+        }
+        return out;
+    }
+    return value;
+}
+//# sourceMappingURL=hashing.js.map

package/dist/tools/catalog/capabilities/hashing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashing.js","sourceRoot":"","sources":["../../../../src/tools/catalog/capabilities/hashing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IAC5C,IAAI,GAAG,gCAAyC,CAAC;IAC1D,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,4BAA4B,CAAC,+CAA+C,CAAC,CAAC;IAC1F,CAAC;IACD,IACE,OAAO,KAAK,KAAK,UAAU;QAC3B,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,WAAW,EAC5B,CAAC;QACD,MAAM,IAAI,4BAA4B,CAAC,+CAA+C,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,4BAA4B,CACpC,wDAAwD,CACzD,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC;YAAE,OAAO,CAAC,CAAC;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtD,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9E,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAQD,MAAM,UAAU,SAAS,CAAC,MAAe,EAAE,GAAW;IACpD,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAe;IACrD,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,SAAS,CAAC,mBAAmB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACrE,MAAM,WAAW,GAAG,SAAS,CAAC,mBAAmB,CAAC,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;IAC9E,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAC3E,CAAC;AAgBD,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC3D,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YAC5E,IAAI,KAAK,KAAK,SAAS;gBAAE,SAAS;YAClC,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YACrC,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;gBACxB,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE;oBAC9B,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI;iBACpE,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;YACpB,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/tools/catalog/capabilities/identifiers.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+export declare const CapabilityIdSchema: z.core.$ZodBranded<z.ZodString, "CapabilityId", "out">;
+export declare const CapabilityAliasSchema: z.core.$ZodBranded<z.ZodString, "CapabilityAlias", "out">;
+export declare const LegacyToolNameSchema: z.core.$ZodBranded<z.ZodString, "LegacyToolName", "out">;
+export declare const LegacyActionNameSchema: z.core.$ZodBranded<z.ZodString, "LegacyActionName", "out">;
+export declare const UnrealVersionSchema: z.ZodReadonly<z.ZodObject<{
+    major: z.ZodLiteral<5>;
+    minor: z.ZodNumber;
+    patch: z.ZodNumber;
+    channel: z.ZodEnum<{
+        stable: "stable";
+        preview: "preview";
+    }>;
+    preview: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>>;
+export type CapabilityId = z.infer<typeof CapabilityIdSchema>;
+export type CapabilityAlias = z.infer<typeof CapabilityAliasSchema>;
+export type LegacyToolName = z.infer<typeof LegacyToolNameSchema>;
+export type LegacyActionName = z.infer<typeof LegacyActionNameSchema>;
+export type UnrealVersion = z.infer<typeof UnrealVersionSchema>;
+//# sourceMappingURL=identifiers.d.ts.map

package/dist/tools/catalog/capabilities/identifiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifiers.d.ts","sourceRoot":"","sources":["../../../../src/tools/catalog/capabilities/identifiers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,kBAAkB,wDAIL,CAAC;AAE3B,eAAO,MAAM,qBAAqB,2DAIL,CAAC;AAE9B,eAAO,MAAM,oBAAoB,0DAIL,CAAC;AAE7B,eAAO,MAAM,sBAAsB,4DAIL,CAAC;AAE/B,eAAO,MAAM,mBAAmB;;;;;;;;;mBAqB9B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/tools/catalog/capabilities/identifiers.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+import { UNREAL_RELEASE_CHANNELS } from './constants.js';
+const canonicalIdPattern = /^[a-z][a-z0-9_]*(?:\.[a-z][a-z0-9_]*)+$/;
+const legacyNamePattern = /^[a-z][a-z0-9_]*$/;
+export const CapabilityIdSchema = z.string()
+    .min(3)
+    .max(160)
+    .regex(canonicalIdPattern, 'Expected a lower-snake-case dotted capability ID')
+    .brand();
+export const CapabilityAliasSchema = z.string()
+    .min(3)
+    .max(160)
+    .regex(canonicalIdPattern, 'Expected a lower-snake-case dotted capability alias')
+    .brand();
+export const LegacyToolNameSchema = z.string()
+    .min(1)
+    .max(80)
+    .regex(legacyNamePattern, 'Expected a lower-snake-case legacy tool name')
+    .brand();
+export const LegacyActionNameSchema = z.string()
+    .min(1)
+    .max(120)
+    .regex(legacyNamePattern, 'Expected a lower-snake-case legacy action name')
+    .brand();
+export const UnrealVersionSchema = z.strictObject({
+    major: z.literal(5),
+    minor: z.number().int().min(0).max(99),
+    patch: z.number().int().min(0).max(999),
+    channel: z.enum(UNREAL_RELEASE_CHANNELS),
+    preview: z.number().int().positive().max(99).optional()
+}).readonly().superRefine((version, context) => {
+    if (version.channel === 'preview' && version.preview === undefined) {
+        context.addIssue({
+            code: 'custom',
+            path: ['preview'],
+            message: 'Preview releases require a positive preview number'
+        });
+    }
+    if (version.channel === 'stable' && version.preview !== undefined) {
+        context.addIssue({
+            code: 'custom',
+            path: ['preview'],
+            message: 'Stable releases cannot declare a preview number'
+        });
+    }
+});
+//# sourceMappingURL=identifiers.js.map

package/dist/tools/catalog/capabilities/identifiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifiers.js","sourceRoot":"","sources":["../../../../src/tools/catalog/capabilities/identifiers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,MAAM,kBAAkB,GAAG,yCAAyC,CAAC;AACrE,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAE9C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,EAAE;KACzC,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,KAAK,CAAC,kBAAkB,EAAE,kDAAkD,CAAC;KAC7E,KAAK,EAAkB,CAAC;AAE3B,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,EAAE;KAC5C,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,KAAK,CAAC,kBAAkB,EAAE,qDAAqD,CAAC;KAChF,KAAK,EAAqB,CAAC;AAE9B,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,EAAE;KAC3C,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,EAAE,CAAC;KACP,KAAK,CAAC,iBAAiB,EAAE,8CAA8C,CAAC;KACxE,KAAK,EAAoB,CAAC;AAE7B,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,EAAE;KAC7C,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,GAAG,CAAC;KACR,KAAK,CAAC,iBAAiB,EAAE,gDAAgD,CAAC;KAC1E,KAAK,EAAsB,CAAC;AAE/B,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,YAAY,CAAC;IAChD,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CACxD,CAAC,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;IAC7C,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACnE,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,SAAS,CAAC;YACjB,OAAO,EAAE,oDAAoD;SAC9D,CAAC,CAAC;IACL,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAClE,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,SAAS,CAAC;YACjB,OAAO,EAAE,iDAAiD;SAC3D,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/tools/catalog/capabilities/index.d.ts

@@ -0,0 +1,11 @@
+export { CapabilityCatalogSchema } from './catalog-schema.js';
+export { BEHAVIOR_EFFECTS, COMPENSATION_MODES, CONSENT_MODES, DATA_ACCESS_CLASSES, DEPRECATION_STATUSES, DISPATCH_MODES, DRAFT_2020_12_SCHEMA_URI, EDITOR_STATES, HASH_ALGORITHM, IDEMPOTENCY_CLASSES, LATENCY_CLASSES, NORMALIZATION_CLASSES, NORMALIZATION_DISPOSITIONS, POLICY_SCOPES, PREVIEW_MODES, PREVIEW_REPORTS, RESOURCE_CLASSES, SEMANTICS_EVIDENCE_GRADES, UNDO_MODES, UNREAL_RELEASE_CHANNELS } from './constants.js';
+export { computeCapabilityHashes, readField, stableJsonStringify } from './hashing.js';
+export type { CapabilityAlias, CapabilityId, LegacyActionName, LegacyToolName, UnrealVersion } from './identifiers.js';
+export { CapabilityAliasSchema, CapabilityIdSchema, LegacyActionNameSchema, LegacyToolNameSchema, UnrealVersionSchema } from './identifiers.js';
+export { Draft202012ObjectSchemaSchema } from './json-schema.js';
+export type { CapabilityAvailability, CapabilityBehavior, CapabilityBehaviorSource, CapabilityCatalog, CapabilityCompensationSemantics, CapabilityCost, CapabilityDeprecation, CapabilityDiscovery, CapabilityDispatchBy, CapabilityExample, CapabilityHashes, CapabilityNormalization, CapabilityPolicy, CapabilityPreviewSemantics, CapabilityRecord, CapabilityRecordSource, CapabilityRouting, CapabilitySchemas, CapabilitySemantics, CapabilitySemanticsEvidence, CapabilityUndoSemantics, Draft202012ObjectSchema, JsonObject, JsonPrimitive, JsonValue, LegacyCapabilityId } from './model.js';
+export { capabilityErrorPointers, createCapabilityRecord, parseCapabilityCatalog, parseCapabilityRecord } from './parser.js';
+export { CapabilityRecordSchema, CapabilityRecordSourceSchema } from './record-schema.js';
+export * from './semantic/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/catalog/capabilities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/catalog/capabilities/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,wBAAwB,EACxB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,0BAA0B,EAC1B,aAAa,EACb,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,yBAAyB,EACzB,UAAU,EACV,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACvF,YAAY,EACV,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,aAAa,EACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AACjE,YAAY,EACV,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,+BAA+B,EAC/B,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,gBAAgB,EAChB,0BAA0B,EAC1B,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,EACvB,uBAAuB,EACvB,UAAU,EACV,aAAa,EACb,SAAS,EACT,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAC1F,cAAc,qBAAqB,CAAC"}

package/dist/tools/catalog/capabilities/index.js

@@ -0,0 +1,9 @@
+export { CapabilityCatalogSchema } from './catalog-schema.js';
+export { BEHAVIOR_EFFECTS, COMPENSATION_MODES, CONSENT_MODES, DATA_ACCESS_CLASSES, DEPRECATION_STATUSES, DISPATCH_MODES, DRAFT_2020_12_SCHEMA_URI, EDITOR_STATES, HASH_ALGORITHM, IDEMPOTENCY_CLASSES, LATENCY_CLASSES, NORMALIZATION_CLASSES, NORMALIZATION_DISPOSITIONS, POLICY_SCOPES, PREVIEW_MODES, PREVIEW_REPORTS, RESOURCE_CLASSES, SEMANTICS_EVIDENCE_GRADES, UNDO_MODES, UNREAL_RELEASE_CHANNELS } from './constants.js';
+export { computeCapabilityHashes, readField, stableJsonStringify } from './hashing.js';
+export { CapabilityAliasSchema, CapabilityIdSchema, LegacyActionNameSchema, LegacyToolNameSchema, UnrealVersionSchema } from './identifiers.js';
+export { Draft202012ObjectSchemaSchema } from './json-schema.js';
+export { capabilityErrorPointers, createCapabilityRecord, parseCapabilityCatalog, parseCapabilityRecord } from './parser.js';
+export { CapabilityRecordSchema, CapabilityRecordSourceSchema } from './record-schema.js';
+export * from './semantic/index.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/catalog/capabilities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/catalog/capabilities/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,wBAAwB,EACxB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,0BAA0B,EAC1B,aAAa,EACb,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,yBAAyB,EACzB,UAAU,EACV,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAQvF,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AA6BjE,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAC1F,cAAc,qBAAqB,CAAC"}

package/dist/tools/catalog/capabilities/json-schema.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import type { JsonValue } from './model.js';
+export declare const jsonObjectSchema: z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+export declare const Draft202012ObjectSchemaSchema: z.ZodObject<{
+    $schema: z.ZodLiteral<"https://json-schema.org/draft/2020-12/schema">;
+    type: z.ZodLiteral<"object">;
+    properties: z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+    required: z.ZodArray<z.ZodString>;
+    additionalProperties: z.ZodUnion<readonly [z.ZodBoolean, z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>]>;
+    requiredOneOf: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+//# sourceMappingURL=json-schema.d.ts.map

package/dist/tools/catalog/capabilities/json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../../../../src/tools/catalog/capabilities/json-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAe5C,eAAO,MAAM,gBAAgB,uGAAwC,CAAC;AAoCtE,eAAO,MAAM,6BAA6B;;;;;;;kBAsBtC,CAAC"}

package/dist/tools/catalog/capabilities/json-schema.js

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+import { DRAFT_2020_12_SCHEMA_URI } from './constants.js';
+import { isRecord } from '../../../utils/validation/type-guards.js';
+const REFLECTION_MARKER = 'x-unreal-reflection-boundary';
+const jsonValueSchema = z.lazy(() => z.union([
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.null(),
+    z.array(jsonValueSchema),
+    z.record(z.string(), jsonValueSchema)
+]));
+export const jsonObjectSchema = z.record(z.string(), jsonValueSchema);
+function isUnboundedObject(node) {
+    if (node.type !== 'object')
+        return false;
+    const additional = node.additionalProperties;
+    const unbounded = additional === true || additional === undefined;
+    return unbounded && node[REFLECTION_MARKER] !== true;
+}
+function walk(node, path, ctx) {
+    if (typeof node === 'function' || typeof node === 'symbol') {
+        ctx.addIssue({
+            code: 'custom',
+            path: [...path],
+            message: 'JSON Schema must be JSON-compatible'
+        });
+        return;
+    }
+    if (Array.isArray(node)) {
+        node.forEach((item, index) => {
+            walk(item, [...path, String(index)], ctx);
+        });
+        return;
+    }
+    if (isRecord(node)) {
+        if (isUnboundedObject(node)) {
+            ctx.addIssue({
+                code: 'custom',
+                path: [...path],
+                message: 'Unbounded object schema requires x-unreal-reflection-boundary: true'
+            });
+        }
+        for (const key of Object.keys(node))
+            walk(node[key], [...path, key], ctx);
+    }
+}
+export const Draft202012ObjectSchemaSchema = z
+    .strictObject({
+    $schema: z.literal(DRAFT_2020_12_SCHEMA_URI),
+    type: z.literal('object'),
+    properties: jsonObjectSchema,
+    required: z.array(z.string()),
+    additionalProperties: z.union([z.boolean(), jsonObjectSchema]),
+    requiredOneOf: z.array(z.string()).min(1).optional()
+})
+    .superRefine((schema, ctx) => {
+    if (schema.requiredOneOf !== undefined) {
+        schema.requiredOneOf.forEach((name, index) => {
+            if (!Object.prototype.hasOwnProperty.call(schema.properties, name)) {
+                ctx.addIssue({
+                    code: 'custom',
+                    path: ['requiredOneOf', index],
+                    message: `requiredOneOf member '${name}' must reference a declared property`
+                });
+            }
+        });
+    }
+    walk(schema, [], ctx);
+});
+//# sourceMappingURL=json-schema.js.map

package/dist/tools/catalog/capabilities/json-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.js","sourceRoot":"","sources":["../../../../src/tools/catalog/capabilities/json-schema.ts"],"names":[],"mappings":"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"}

package/dist/tools/catalog/capabilities/migration/alias-generation.d.ts

@@ -0,0 +1,16 @@
+import type { CapabilityAlias } from '../identifiers.js';
+import type { CanonicalCapabilityRef } from './types.js';
+export type GeneratedAlias = {
+    readonly alias: CapabilityAlias;
+    readonly canonicalId: CanonicalCapabilityRef;
+    readonly source: 'inventory-alias' | 'lossy-replacement';
+};
+export type AliasConflict = {
+    readonly alias: CapabilityAlias;
+    readonly canonicalIds: ReadonlyArray<CanonicalCapabilityRef>;
+};
+export declare function generateAliases(): {
+    readonly aliases: ReadonlyArray<GeneratedAlias>;
+    readonly conflicts: ReadonlyArray<AliasConflict>;
+};
+//# sourceMappingURL=alias-generation.d.ts.map

package/dist/tools/catalog/capabilities/migration/alias-generation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alias-generation.d.ts","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/migration/alias-generation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,KAAK,EAAE,sBAAsB,EAAa,MAAM,YAAY,CAAC;AAYpE,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,mBAAmB,CAAC;CAC1D,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAC;CAC9D,CAAC;AAOF,wBAAgB,eAAe,IAAI;IACjC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;CAClD,CAgCA"}

package/dist/tools/catalog/capabilities/migration/alias-generation.js

@@ -0,0 +1,36 @@
+import { compareAscii } from '../../../../utils/serialization/ordering.js';
+import { CapabilityAliasSchema } from '../identifiers.js';
+import { migrationMap } from './migration-map.js';
+function aliasFromLegacyKey(key) {
+    return CapabilityAliasSchema.parse(key.replace('::', '.'));
+}
+export function generateAliases() {
+    const byAlias = new Map();
+    const add = (alias, canonicalId) => {
+        const set = byAlias.get(alias) ?? new Set();
+        set.add(canonicalId);
+        byAlias.set(alias, set);
+    };
+    for (const entry of migrationMap.entries.values()) {
+        if (entry.disposition === 'alias' && entry.canonicalId) {
+            add(aliasFromLegacyKey(entry.legacyKey), entry.canonicalId);
+        }
+    }
+    const aliases = [];
+    const conflicts = [];
+    for (const [alias, canonicalSet] of byAlias) {
+        const canonicalIds = [...canonicalSet];
+        if (canonicalIds.length > 1) {
+            conflicts.push({ alias: CapabilityAliasSchema.parse(alias), canonicalIds });
+            continue;
+        }
+        aliases.push({
+            alias,
+            canonicalId: canonicalIds[0],
+            source: 'inventory-alias'
+        });
+    }
+    aliases.sort((a, b) => compareAscii(a.alias, b.alias));
+    return { aliases, conflicts };
+}
+//# sourceMappingURL=alias-generation.js.map

package/dist/tools/catalog/capabilities/migration/alias-generation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alias-generation.js","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/migration/alias-generation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,6CAA6C,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAwBlD,SAAS,kBAAkB,CAAC,GAAc;IAExC,OAAO,qBAAqB,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,eAAe;IAI7B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgD,CAAC;IAExE,MAAM,GAAG,GAAG,CAAC,KAAsB,EAAE,WAAmC,EAAQ,EAAE;QAChF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,EAA0B,CAAC;QACpE,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC1B,CAAC,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QAClD,IAAI,KAAK,CAAC,WAAW,KAAK,OAAO,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACvD,GAAG,CAAC,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,MAAM,SAAS,GAAoB,EAAE,CAAC;IACtC,KAAK,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,IAAI,OAAO,EAAE,CAAC;QAC5C,MAAM,YAAY,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC;QACvC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;YAC5E,SAAS;QACX,CAAC;QACD,OAAO,CAAC,IAAI,CAAC;YACX,KAAK;YACL,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;YAC5B,MAAM,EAAE,iBAAiB;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACvD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAChC,CAAC"}

package/dist/tools/catalog/capabilities/migration/artifact.d.ts

@@ -0,0 +1,123 @@
+import { z } from 'zod';
+declare const entrySchema: z.ZodObject<{
+    legacyKey: z.ZodString;
+    tool: z.core.$ZodBranded<z.ZodString, "LegacyToolName", "out">;
+    action: z.core.$ZodBranded<z.ZodString, "LegacyActionName", "out">;
+    disposition: z.ZodEnum<{
+        canonical: "canonical";
+        alias: "alias";
+        removed: "removed";
+        "non-translatable": "non-translatable";
+    }>;
+    canonicalId: z.ZodOptional<z.ZodString>;
+    removal: z.ZodOptional<z.ZodObject<{
+        since: z.ZodString;
+        guidance: z.ZodString;
+        replacement: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    nonTranslatable: z.ZodOptional<z.ZodObject<{
+        reason: z.ZodString;
+        guidance: z.ZodObject<{
+            canonicalId: z.ZodOptional<z.ZodString>;
+            reason: z.ZodString;
+            nextCall: z.ZodObject<{
+                operation: z.ZodLiteral<"execute">;
+                tool: z.core.$ZodBranded<z.ZodString, "LegacyToolName", "out">;
+                action: z.core.$ZodBranded<z.ZodString, "LegacyActionName", "out">;
+            }, z.core.$strict>;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    argumentTransform: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodEnum<{
+            rename: "rename";
+            identity: "identity";
+            "drop-unsupported": "drop-unsupported";
+        }>;
+        renames: z.ZodRecord<z.ZodString, z.ZodString>;
+        dropped: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    deprecation: z.ZodObject<{
+        status: z.ZodEnum<{
+            deprecated: "deprecated";
+            active: "active";
+            removed: "removed";
+        }>;
+        window: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const MigrationArtifactSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"task20.migration.v1">;
+    generatedAt: z.ZodString;
+    occurrenceCount: z.ZodNumber;
+    entryCount: z.ZodNumber;
+    resolvedCanonicalCount: z.ZodNumber;
+    typedRemovalCount: z.ZodNumber;
+    nonTranslatableCount: z.ZodNumber;
+    aliasCount: z.ZodNumber;
+    conflictCount: z.ZodNumber;
+    contentHash: z.ZodString;
+    entries: z.ZodArray<z.ZodObject<{
+        legacyKey: z.ZodString;
+        tool: z.core.$ZodBranded<z.ZodString, "LegacyToolName", "out">;
+        action: z.core.$ZodBranded<z.ZodString, "LegacyActionName", "out">;
+        disposition: z.ZodEnum<{
+            canonical: "canonical";
+            alias: "alias";
+            removed: "removed";
+            "non-translatable": "non-translatable";
+        }>;
+        canonicalId: z.ZodOptional<z.ZodString>;
+        removal: z.ZodOptional<z.ZodObject<{
+            since: z.ZodString;
+            guidance: z.ZodString;
+            replacement: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        nonTranslatable: z.ZodOptional<z.ZodObject<{
+            reason: z.ZodString;
+            guidance: z.ZodObject<{
+                canonicalId: z.ZodOptional<z.ZodString>;
+                reason: z.ZodString;
+                nextCall: z.ZodObject<{
+                    operation: z.ZodLiteral<"execute">;
+                    tool: z.core.$ZodBranded<z.ZodString, "LegacyToolName", "out">;
+                    action: z.core.$ZodBranded<z.ZodString, "LegacyActionName", "out">;
+                }, z.core.$strict>;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+        argumentTransform: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodEnum<{
+                rename: "rename";
+                identity: "identity";
+                "drop-unsupported": "drop-unsupported";
+            }>;
+            renames: z.ZodRecord<z.ZodString, z.ZodString>;
+            dropped: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+        deprecation: z.ZodObject<{
+            status: z.ZodEnum<{
+                deprecated: "deprecated";
+                active: "active";
+                removed: "removed";
+            }>;
+            window: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    aliases: z.ZodArray<z.ZodObject<{
+        alias: z.core.$ZodBranded<z.ZodString, "CapabilityAlias", "out">;
+        canonicalId: z.ZodString;
+        source: z.ZodEnum<{
+            "inventory-alias": "inventory-alias";
+            "lossy-replacement": "lossy-replacement";
+        }>;
+    }, z.core.$strict>>;
+    conflicts: z.ZodArray<z.ZodObject<{
+        alias: z.core.$ZodBranded<z.ZodString, "CapabilityAlias", "out">;
+        canonicalIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type MigrationArtifact = z.infer<typeof MigrationArtifactSchema>;
+export type MigrationArtifactEntry = z.infer<typeof entrySchema>;
+export declare function buildMigrationArtifact(): MigrationArtifact;
+export declare const migrationArtifact: MigrationArtifact;
+export {};
+//# sourceMappingURL=artifact.d.ts.map

package/dist/tools/catalog/capabilities/migration/artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/migration/artifact.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8CxB,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAwBf,CAAC;AAQH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmBlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAsBjE,wBAAgB,sBAAsB,IAAI,iBAAiB,CAgC1D;AAED,eAAO,MAAM,iBAAiB,EAAE,iBAA4C,CAAC"}

package/dist/tools/catalog/capabilities/migration/artifact.js

@@ -0,0 +1,118 @@
+import { createHash } from 'node:crypto';
+import { z } from 'zod';
+import { CapabilityAliasSchema, LegacyActionNameSchema, LegacyToolNameSchema } from '../identifiers.js';
+import { stableJsonStringify, stripUndefined } from '../hashing.js';
+import { compareAscii } from '../../../../utils/serialization/ordering.js';
+import { migrationMap } from './migration-map.js';
+import { generateAliases } from './alias-generation.js';
+function deterministicStringify(value) {
+    return stableJsonStringify(stripUndefined(value));
+}
+const argumentTransformSchema = z.strictObject({
+    kind: z.enum(['identity', 'rename', 'drop-unsupported']),
+    renames: z.record(z.string(), z.string()),
+    dropped: z.array(z.string())
+});
+const replacementGuidanceSchema = z.strictObject({
+    canonicalId: z.string().optional(),
+    reason: z.string(),
+    nextCall: z.strictObject({
+        operation: z.literal('execute'),
+        tool: LegacyToolNameSchema,
+        action: LegacyActionNameSchema
+    })
+});
+const entrySchema = z.strictObject({
+    legacyKey: z.string(),
+    tool: LegacyToolNameSchema,
+    action: LegacyActionNameSchema,
+    disposition: z.enum(['canonical', 'alias', 'removed', 'non-translatable']),
+    canonicalId: z.string().optional(),
+    removal: z
+        .strictObject({
+        since: z.string(),
+        guidance: z.string(),
+        replacement: z.string().optional()
+    })
+        .optional(),
+    nonTranslatable: z
+        .strictObject({
+        reason: z.string(),
+        guidance: replacementGuidanceSchema
+    })
+        .optional(),
+    argumentTransform: argumentTransformSchema.optional(),
+    deprecation: z.strictObject({
+        status: z.enum(['active', 'deprecated', 'removed']),
+        window: z.string()
+    })
+});
+const aliasSchema = z.strictObject({
+    alias: CapabilityAliasSchema,
+    canonicalId: z.string(),
+    source: z.enum(['inventory-alias', 'lossy-replacement'])
+});
+export const MigrationArtifactSchema = z.strictObject({
+    schemaVersion: z.literal('task20.migration.v1'),
+    generatedAt: z.string(),
+    occurrenceCount: z.number().int().nonnegative(),
+    entryCount: z.number().int().nonnegative(),
+    resolvedCanonicalCount: z.number().int().nonnegative(),
+    typedRemovalCount: z.number().int().nonnegative(),
+    nonTranslatableCount: z.number().int().nonnegative(),
+    aliasCount: z.number().int().nonnegative(),
+    conflictCount: z.number().int().nonnegative(),
+    contentHash: z.string().regex(/^[0-9a-f]{64}$/),
+    entries: z.array(entrySchema),
+    aliases: z.array(aliasSchema),
+    conflicts: z.array(z.strictObject({
+        alias: CapabilityAliasSchema,
+        canonicalIds: z.array(z.string())
+    }))
+});
+function entryToJson(entry) {
+    return {
+        legacyKey: entry.legacyKey,
+        tool: entry.tool,
+        action: entry.action,
+        disposition: entry.disposition,
+        canonicalId: entry.canonicalId,
+        removal: entry.removal,
+        nonTranslatable: entry.nonTranslatable,
+        argumentTransform: entry.argumentTransform
+            ? {
+                kind: entry.argumentTransform.kind,
+                renames: { ...entry.argumentTransform.renames },
+                dropped: [...entry.argumentTransform.dropped]
+            }
+            : undefined,
+        deprecation: entry.deprecation
+    };
+}
+export function buildMigrationArtifact() {
+    const entries = [...migrationMap.entries.values()].map(entryToJson);
+    entries.sort((a, b) => compareAscii(a.legacyKey, b.legacyKey));
+    const { aliases, conflicts } = generateAliases();
+    const resolvedCanonicalCount = entries.filter((e) => e.disposition === 'canonical' || e.disposition === 'alias').length;
+    const typedRemovalCount = entries.filter((e) => e.disposition === 'removed').length;
+    const nonTranslatableCount = entries.filter((e) => e.disposition === 'non-translatable').length;
+    const payload = {
+        schemaVersion: migrationMap.schemaVersion,
+        generatedAt: migrationMap.generatedAt,
+        occurrenceCount: migrationMap.occurrenceCount,
+        entryCount: entries.length,
+        resolvedCanonicalCount,
+        typedRemovalCount,
+        nonTranslatableCount,
+        aliasCount: aliases.length,
+        conflictCount: conflicts.length,
+        entries,
+        aliases: [...aliases],
+        conflicts: conflicts.map((c) => ({ alias: c.alias, canonicalIds: [...c.canonicalIds] }))
+    };
+    const contentHash = createHash('sha256').update(deterministicStringify(payload)).digest('hex');
+    const artifact = { ...payload, contentHash };
+    return MigrationArtifactSchema.parse(artifact);
+}
+export const migrationArtifact = buildMigrationArtifact();
+//# sourceMappingURL=artifact.js.map

package/dist/tools/catalog/capabilities/migration/artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.js","sourceRoot":"","sources":["../../../../../src/tools/catalog/capabilities/migration/artifact.ts"],"names":[],"mappings":"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"}