@contractspec/lib.contracts 1.44.1 → 1.45.1

package/dist/app-config/events.js

@@ -15,7 +15,7 @@ const ConfigDraftCreatedEvent = defineEvent({
 	meta: {
 		...lifecycleOwnership,
 		key: "app_config.draft_created",
-		version: 1,
+		version: "1.0.0",
 		description: "A new tenant config draft was created."
 	},
 	payload: new SchemaModel({
@@ -30,7 +30,7 @@ const ConfigDraftCreatedEvent = defineEvent({
 				isOptional: false
 			},
 			version: {
-				type: ScalarTypeEnum.Int_unsecure(),
+				type: ScalarTypeEnum.String_unsecure(),
 				isOptional: false
 			},
 			blueprintName: {
@@ -38,7 +38,7 @@ const ConfigDraftCreatedEvent = defineEvent({
 				isOptional: false
 			},
 			blueprintVersion: {
-				type: ScalarTypeEnum.Int_unsecure(),
+				type: ScalarTypeEnum.String_unsecure(),
 				isOptional: false
 			},
 			createdBy: {
@@ -56,7 +56,7 @@ const ConfigPromotedToPreviewEvent = defineEvent({
 	meta: {
 		...lifecycleOwnership,
 		key: "app_config.promoted_to_preview",
-		version: 1,
+		version: "1.0.0",
 		description: "A tenant config draft was promoted to preview."
 	},
 	payload: new SchemaModel({
@@ -71,7 +71,7 @@ const ConfigPromotedToPreviewEvent = defineEvent({
 				isOptional: false
 			},
 			version: {
-				type: ScalarTypeEnum.Int_unsecure(),
+				type: ScalarTypeEnum.String_unsecure(),
 				isOptional: false
 			},
 			promotedBy: {
@@ -90,7 +90,7 @@ const ConfigPublishedEvent = defineEvent({
 	meta: {
 		...lifecycleOwnership,
 		key: "app_config.published",
-		version: 1,
+		version: "1.0.0",
 		description: "A tenant config version was published to production."
 	},
 	payload: new SchemaModel({
@@ -105,11 +105,11 @@ const ConfigPublishedEvent = defineEvent({
 				isOptional: false
 			},
 			version: {
-				type: ScalarTypeEnum.Int_unsecure(),
+				type: ScalarTypeEnum.String_unsecure(),
 				isOptional: false
 			},
 			previousVersion: {
-				type: ScalarTypeEnum.Int_unsecure(),
+				type: ScalarTypeEnum.String_unsecure(),
 				isOptional: true
 			},
 			publishedBy: {
@@ -132,7 +132,7 @@ const ConfigRolledBackEvent = defineEvent({
 	meta: {
 		...lifecycleOwnership,
 		key: "app_config.rolled_back",
-		version: 1,
+		version: "1.0.0",
 		description: "A tenant config was rolled back to a previous version."
 	},
 	payload: new SchemaModel({
@@ -147,15 +147,15 @@ const ConfigRolledBackEvent = defineEvent({
 				isOptional: false
 			},
 			newVersion: {
-				type: ScalarTypeEnum.Int_unsecure(),
+				type: ScalarTypeEnum.String_unsecure(),
 				isOptional: false
 			},
 			rolledBackFrom: {
-				type: ScalarTypeEnum.Int_unsecure(),
+				type: ScalarTypeEnum.String_unsecure(),
 				isOptional: false
 			},
 			rolledBackTo: {
-				type: ScalarTypeEnum.Int_unsecure(),
+				type: ScalarTypeEnum.String_unsecure(),
 				isOptional: false
 			},
 			rolledBackBy: {

package/dist/app-config/lifecycle-contracts.d.ts

@@ -3,50 +3,50 @@ import { OperationSpec } from "../operations/operation.js";
 import { OperationSpecRegistry } from "../operations/registry.js";
 import "../operations/index.js";
 import "../index.js";
-import * as _contractspec_lib_schema467 from "@contractspec/lib.schema";
+import * as _contractspec_lib_schema102 from "@contractspec/lib.schema";
 import { SchemaModel } from "@contractspec/lib.schema";
 
 //#region src/app-config/lifecycle-contracts.d.ts
 declare const CreateTenantConfigDraftCommand: OperationSpec<SchemaModel<{
   tenantId: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   blueprintName: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   blueprintVersion: {
-    type: _contractspec_lib_schema467.FieldType<number, number>;
+    type: _contractspec_lib_schema102.FieldType<number, number>;
     isOptional: false;
   };
   environment: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: true;
   };
   fromVersion: {
-    type: _contractspec_lib_schema467.FieldType<number, number>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: true;
   };
   createdBy: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
 }>, SchemaModel<{
   version: {
-    type: _contractspec_lib_schema467.FieldType<number, number>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   status: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   createdAt: {
-    type: _contractspec_lib_schema467.FieldType<Date, string>;
+    type: _contractspec_lib_schema102.FieldType<Date, string>;
     isOptional: false;
   };
 }>, {
@@ -55,32 +55,32 @@ declare const CreateTenantConfigDraftCommand: OperationSpec<SchemaModel<{
 }[]>;
 declare const PromoteTenantConfigToPreviewCommand: OperationSpec<SchemaModel<{
   tenantId: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   version: {
-    type: _contractspec_lib_schema467.FieldType<number, number>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   promotedBy: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
 }>, SchemaModel<{
   version: {
-    type: _contractspec_lib_schema467.FieldType<number, number>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   status: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   warnings: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: true;
     isArray: true;
   };
@@ -90,44 +90,44 @@ declare const PromoteTenantConfigToPreviewCommand: OperationSpec<SchemaModel<{
 }[]>;
 declare const PublishTenantConfigCommand: OperationSpec<SchemaModel<{
   tenantId: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   version: {
-    type: _contractspec_lib_schema467.FieldType<number, number>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   environment: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: true;
   };
   publishedBy: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   changeSummary: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: true;
   };
 }>, SchemaModel<{
   version: {
-    type: _contractspec_lib_schema467.FieldType<number, number>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   status: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   previousVersion: {
-    type: _contractspec_lib_schema467.FieldType<number, number>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: true;
   };
   publishedAt: {
-    type: _contractspec_lib_schema467.FieldType<Date, string>;
+    type: _contractspec_lib_schema102.FieldType<Date, string>;
     isOptional: false;
   };
 }>, {
@@ -136,40 +136,40 @@ declare const PublishTenantConfigCommand: OperationSpec<SchemaModel<{
 }[]>;
 declare const RollbackTenantConfigCommand: OperationSpec<SchemaModel<{
   tenantId: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   toVersion: {
-    type: _contractspec_lib_schema467.FieldType<number, number>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   environment: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: true;
   };
   rolledBackBy: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   reason: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
 }>, SchemaModel<{
   newVersion: {
-    type: _contractspec_lib_schema467.FieldType<number, number>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   status: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   rolledBackFrom: {
-    type: _contractspec_lib_schema467.FieldType<number, number>;
+    type: _contractspec_lib_schema102.FieldType<number, number>;
     isOptional: false;
   };
 }>, {
@@ -178,22 +178,22 @@ declare const RollbackTenantConfigCommand: OperationSpec<SchemaModel<{
 }[]>;
 declare const ListTenantConfigVersionsQuery: OperationSpec<SchemaModel<{
   tenantId: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
 }>, SchemaModel<{
   versions: {
     type: SchemaModel<{
       meta: {
-        type: _contractspec_lib_schema467.FieldType<Record<string, unknown>, Record<string, unknown>>;
+        type: _contractspec_lib_schema102.FieldType<Record<string, unknown>, Record<string, unknown>>;
         isOptional: false;
       };
       config: {
-        type: _contractspec_lib_schema467.FieldType<Record<string, unknown>, Record<string, unknown>>;
+        type: _contractspec_lib_schema102.FieldType<Record<string, unknown>, Record<string, unknown>>;
         isOptional: false;
       };
     }>;
@@ -203,35 +203,35 @@ declare const ListTenantConfigVersionsQuery: OperationSpec<SchemaModel<{
   transitions: {
     type: SchemaModel<{
       tenantId: {
-        type: _contractspec_lib_schema467.FieldType<string, string>;
+        type: _contractspec_lib_schema102.FieldType<string, string>;
         isOptional: false;
       };
       appId: {
-        type: _contractspec_lib_schema467.FieldType<string, string>;
+        type: _contractspec_lib_schema102.FieldType<string, string>;
         isOptional: false;
       };
       fromStatus: {
-        type: _contractspec_lib_schema467.FieldType<string, string>;
+        type: _contractspec_lib_schema102.FieldType<string, string>;
         isOptional: false;
       };
       toStatus: {
-        type: _contractspec_lib_schema467.FieldType<string, string>;
+        type: _contractspec_lib_schema102.FieldType<string, string>;
         isOptional: false;
       };
       version: {
-        type: _contractspec_lib_schema467.FieldType<number, number>;
+        type: _contractspec_lib_schema102.FieldType<string, string>;
         isOptional: false;
       };
       timestamp: {
-        type: _contractspec_lib_schema467.FieldType<Date, string>;
+        type: _contractspec_lib_schema102.FieldType<Date, string>;
         isOptional: false;
       };
       actor: {
-        type: _contractspec_lib_schema467.FieldType<string, string>;
+        type: _contractspec_lib_schema102.FieldType<string, string>;
         isOptional: false;
       };
       reason: {
-        type: _contractspec_lib_schema467.FieldType<string, string>;
+        type: _contractspec_lib_schema102.FieldType<string, string>;
         isOptional: true;
       };
     }>;
@@ -241,26 +241,26 @@ declare const ListTenantConfigVersionsQuery: OperationSpec<SchemaModel<{
 }>, undefined>;
 declare const GetTenantConfigVersionQuery: OperationSpec<SchemaModel<{
   tenantId: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   appId: {
-    type: _contractspec_lib_schema467.FieldType<string, string>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
   version: {
-    type: _contractspec_lib_schema467.FieldType<number, number>;
+    type: _contractspec_lib_schema102.FieldType<string, string>;
     isOptional: false;
   };
 }>, SchemaModel<{
   version: {
     type: SchemaModel<{
       meta: {
-        type: _contractspec_lib_schema467.FieldType<Record<string, unknown>, Record<string, unknown>>;
+        type: _contractspec_lib_schema102.FieldType<Record<string, unknown>, Record<string, unknown>>;
         isOptional: false;
       };
       config: {
-        type: _contractspec_lib_schema467.FieldType<Record<string, unknown>, Record<string, unknown>>;
+        type: _contractspec_lib_schema102.FieldType<Record<string, unknown>, Record<string, unknown>>;
         isOptional: false;
       };
     }>;

package/dist/app-config/lifecycle-contracts.js

@@ -9,14 +9,14 @@ const LifecyclePolicy = {
 	auth: "admin",
 	policies: [{
 		key: "platform.app-config.manage",
-		version: 1
+		version: "1.0.0"
 	}]
 };
 const LifecycleReadPolicy = {
 	auth: "admin",
 	policies: [{
 		key: "platform.app-config.read",
-		version: 1
+		version: "1.0.0"
 	}]
 };
 const ConfigVersionRecord = new SchemaModel({
@@ -52,7 +52,7 @@ const ConfigTransitionRecord = new SchemaModel({
 			isOptional: false
 		},
 		version: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: false
 		},
 		timestamp: {
@@ -93,7 +93,7 @@ const CreateDraftInput = new SchemaModel({
 			isOptional: true
 		},
 		fromVersion: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: true
 		},
 		createdBy: {
@@ -106,7 +106,7 @@ const CreateDraftOutput = new SchemaModel({
 	name: "CreateTenantConfigDraftOutput",
 	fields: {
 		version: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: false
 		},
 		status: {
@@ -122,7 +122,7 @@ const CreateDraftOutput = new SchemaModel({
 const CreateTenantConfigDraftCommand = defineCommand({
 	meta: {
 		key: "appConfig.lifecycle.createDraft",
-		version: 1,
+		version: "1.0.0",
 		description: "Creates a new draft tenant config version.",
 		owners: [OwnersEnum.PlatformSigil],
 		tags: [TagsEnum.Hygiene, "app-config"],
@@ -152,7 +152,7 @@ const PromotePreviewInput = new SchemaModel({
 			isOptional: false
 		},
 		version: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: false
 		},
 		promotedBy: {
@@ -165,7 +165,7 @@ const PromotePreviewOutput = new SchemaModel({
 	name: "PromoteTenantConfigPreviewOutput",
 	fields: {
 		version: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: false
 		},
 		status: {
@@ -182,7 +182,7 @@ const PromotePreviewOutput = new SchemaModel({
 const PromoteTenantConfigToPreviewCommand = defineCommand({
 	meta: {
 		key: "appConfig.lifecycle.promoteToPreview",
-		version: 1,
+		version: "1.0.0",
 		description: "Promotes a draft tenant config to preview/testing state.",
 		owners: [OwnersEnum.PlatformSigil],
 		tags: [TagsEnum.Hygiene, "app-config"],
@@ -212,7 +212,7 @@ const PublishConfigInput = new SchemaModel({
 			isOptional: false
 		},
 		version: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: false
 		},
 		environment: {
@@ -233,7 +233,7 @@ const PublishConfigOutput = new SchemaModel({
 	name: "PublishTenantConfigOutput",
 	fields: {
 		version: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: false
 		},
 		status: {
@@ -241,7 +241,7 @@ const PublishConfigOutput = new SchemaModel({
 			isOptional: false
 		},
 		previousVersion: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: true
 		},
 		publishedAt: {
@@ -253,7 +253,7 @@ const PublishConfigOutput = new SchemaModel({
 const PublishTenantConfigCommand = defineCommand({
 	meta: {
 		key: "appConfig.lifecycle.publish",
-		version: 1,
+		version: "1.0.0",
 		description: "Publishes a preview tenant config to production.",
 		owners: [OwnersEnum.PlatformSigil],
 		tags: [TagsEnum.Hygiene, "app-config"],
@@ -283,7 +283,7 @@ const RollbackConfigInput = new SchemaModel({
 			isOptional: false
 		},
 		toVersion: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: false
 		},
 		environment: {
@@ -304,7 +304,7 @@ const RollbackConfigOutput = new SchemaModel({
 	name: "RollbackTenantConfigOutput",
 	fields: {
 		newVersion: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: false
 		},
 		status: {
@@ -320,7 +320,7 @@ const RollbackConfigOutput = new SchemaModel({
 const RollbackTenantConfigCommand = defineCommand({
 	meta: {
 		key: "appConfig.lifecycle.rollback",
-		version: 1,
+		version: "1.0.0",
 		description: "Rolls back to a previously published tenant config version.",
 		owners: [OwnersEnum.PlatformSigil],
 		tags: [TagsEnum.Hygiene, "app-config"],
@@ -369,7 +369,7 @@ const ListVersionsOutput = new SchemaModel({
 const ListTenantConfigVersionsQuery = defineQuery({
 	meta: {
 		key: "appConfig.lifecycle.listVersions",
-		version: 1,
+		version: "1.0.0",
 		description: "Lists all versions of a tenant configuration.",
 		owners: [OwnersEnum.PlatformSigil],
 		tags: ["app-config", TagsEnum.Hygiene],
@@ -395,7 +395,7 @@ const GetVersionInput = new SchemaModel({
 			isOptional: false
 		},
 		version: {
-			type: ScalarTypeEnum.Int_unsecure(),
+			type: ScalarTypeEnum.String_unsecure(),
 			isOptional: false
 		}
 	}
@@ -410,7 +410,7 @@ const GetVersionOutput = new SchemaModel({
 const GetTenantConfigVersionQuery = defineQuery({
 	meta: {
 		key: "appConfig.lifecycle.getVersion",
-		version: 1,
+		version: "1.0.0",
 		description: "Fetches a single tenant config version by id.",
 		owners: [OwnersEnum.PlatformSigil],
 		tags: ["app-config", TagsEnum.Hygiene],

package/dist/app-config/lifecycle.d.ts

@@ -11,7 +11,7 @@ interface ConfigTransition {
   appId: string;
   fromStatus: ConfigStatus;
   toStatus: ConfigStatus;
-  version: number;
+  version: string;
   timestamp: string | Date;
   actor: string;
   reason?: string;
@@ -21,7 +21,7 @@ interface ConfigVersionHistory {
   appId: string;
   versions: TenantAppConfigVersion[];
   transitions: ConfigTransition[];
-  currentPublished?: number;
+  currentPublished?: string;
 }
 //#endregion
 export { ConfigStatus, ConfigTransition, ConfigVersionHistory, TenantAppConfigVersion };

package/dist/app-config/runtime.d.ts

@@ -2,7 +2,6 @@ import { CapabilityRef, CapabilityRegistry, CapabilitySpec } from "../capabiliti
 import "../capabilities/index.js";
 import { PolicyRef, PolicySpec } from "../policy/spec.js";
 import { TelemetryRegistry, TelemetrySpec } from "../telemetry/spec.js";
-import { ExperimentRef, ExperimentRegistry, ExperimentSpec } from "../experiments/spec.js";
 import { DataViewSpec } from "../data-views/spec.js";
 import { DataViewRegistry } from "../data-views/registry.js";
 import "../data-views/index.js";
@@ -18,6 +17,7 @@ import { AppKnowledgeBinding } from "../knowledge/binding.js";
 import { ResolvedBranding } from "./branding.js";
 import { Locale, TranslationEntry } from "../translations/catalog.js";
 import { AppBlueprintSpec, AppIntegrationSlot, AppRouteConfig, AppThemeBinding, FeatureFlagState, SpecPointer, TelemetryBinding, TenantAppConfig, TranslationCatalogPointer } from "./spec.js";
+import { ExperimentRef, ExperimentRegistry, ExperimentSpec } from "../experiments/spec.js";
 import { FeatureModuleSpec, FeatureRef } from "../features/types.js";
 import { FeatureRegistry } from "../features/registry.js";
 import "../features/index.js";
@@ -45,8 +45,8 @@ interface ResolvedAppConfig {
   tenantId: string;
   environment?: string;
   blueprintName: string;
-  blueprintVersion: number;
-  configVersion: number;
+  blueprintVersion: string;
+  configVersion: string;
   capabilities: {
     enabled: CapabilityRef[];
     disabled: CapabilityRef[];

package/dist/app-config/spec.d.ts

@@ -2,7 +2,6 @@ import { OwnerShipMeta } from "../ownership.js";
 import { CapabilityRef } from "../capabilities/capabilities.js";
 import "../capabilities/index.js";
 import { PolicyRef } from "../policy/spec.js";
-import { ExperimentRef } from "../experiments/spec.js";
 import { ThemeRef } from "../themes.js";
 import { IntegrationCategory, IntegrationOwnershipMode } from "../integrations/spec.js";
 import { AppIntegrationBinding } from "../integrations/binding.js";
@@ -10,13 +9,15 @@ import { AppKnowledgeBinding } from "../knowledge/binding.js";
 import { BrandingDefaults, TenantBrandingConfig } from "./branding.js";
 import { Locale, TranslationEntry } from "../translations/catalog.js";
 import { ConfigStatus } from "./lifecycle.js";
+import { SpecContractRegistry } from "../registry.js";
+import { ExperimentRef } from "../experiments/spec.js";
 import { FeatureRef } from "../features/types.js";
 import "../features/index.js";
 
 //#region src/app-config/spec.d.ts
 interface SpecPointer {
   key: string;
-  version?: number;
+  version?: string;
 }
 interface AppRouteConfig {
   path: string;
@@ -29,7 +30,7 @@ interface AppRouteConfig {
 }
 interface TranslationCatalogPointer {
   key: string;
-  version: number;
+  version: string;
 }
 interface AppIntegrationSlot {
   /** Slot identifier unique within the blueprint (e.g., "primaryPayments"). */
@@ -90,11 +91,8 @@ interface AppBlueprintSpec {
   routes?: AppRouteConfig[];
   notes?: string;
 }
-declare class AppBlueprintRegistry {
-  private readonly items;
-  register(spec: AppBlueprintSpec): this;
-  list(): AppBlueprintSpec[];
-  get(key: string, version?: number): AppBlueprintSpec | undefined;
+declare class AppBlueprintRegistry extends SpecContractRegistry<'app-config', AppBlueprintSpec> {
+  constructor(items?: AppBlueprintSpec[]);
 }
 declare function makeAppBlueprintKey(meta: AppBlueprintMeta): string;
 interface TenantAppConfigMeta {
@@ -102,16 +100,16 @@ interface TenantAppConfigMeta {
   tenantId: string;
   appId: string;
   blueprintName: string;
-  blueprintVersion: number;
+  blueprintVersion: string;
   environment?: string;
   /** Monotonic version for auditing changes to the tenant config. */
-  version: number;
+  version: string;
   status: ConfigStatus;
   createdBy?: string;
   publishedBy?: string;
   publishedAt?: string | Date;
-  rolledBackFrom?: number;
-  rolledBackTo?: number;
+  rolledBackFrom?: string;
+  rolledBackTo?: string;
   changeSummary?: string;
   createdAt?: string | Date;
   updatedAt?: string | Date;