@contractspec/lib.contracts 1.44.0 → 1.45.0

package/dist/llm/exporters.js

@@ -326,7 +326,7 @@ function featureToMarkdown(feature, deps, options = {}) {
 		lines.push("| Name | Version | Type |");
 		lines.push("|------|---------|------|");
 		for (const op of feature.operations) {
-			const kind = (deps?.specs?.getSpec(op.key, op.version))?.meta.kind ?? "unknown";
+			const kind = (deps?.specs?.get(op.key, op.version))?.meta.kind ?? "unknown";
 			lines.push(`| ${op.key} | v${op.version} | ${kind} |`);
 		}
 		lines.push("");
@@ -334,7 +334,7 @@ function featureToMarkdown(feature, deps, options = {}) {
 			lines.push("### Operation Details");
 			lines.push("");
 			for (const op of feature.operations) {
-				const spec = deps.specs.getSpec(op.key, op.version);
+				const spec = deps.specs.get(op.key, op.version);
 				if (spec) {
 					lines.push(`---`);
 					lines.push("");

package/dist/llm/types.d.ts

@@ -50,7 +50,7 @@ interface SpecExportResult {
   /** Metadata about the export */
   meta: {
     specName: string;
-    specVersion: number;
+    specVersion: string;
     exportedAt: string;
     wordCount: number;
   };
@@ -76,7 +76,7 @@ interface ImplementationPlan {
   target: {
     type: 'spec' | 'feature' | 'presentation';
     key: string;
-    version: number;
+    version: string;
   };
   /** Context section */
   context: {
@@ -155,7 +155,7 @@ interface VerificationReport {
   /** Metadata about the verification */
   meta: {
     specName: string;
-    specVersion: number;
+    specVersion: string;
     implementationPath: string;
     verifiedAt: string;
     duration: number;
@@ -179,7 +179,7 @@ interface AgentPrompt {
 /** Input for spec lookup */
 interface SpecLookup {
   name: string;
-  version?: number;
+  version?: string;
 }
 /** Input for feature lookup */
 interface FeatureLookup {

package/dist/markdown.js

@@ -8,7 +8,7 @@ import "./operations/index.js";
 */
 function operationsToMarkdown(registry, _extras) {
 	const lines = [];
-	for (const spec of registry.listSpecs()) {
+	for (const spec of registry.list()) {
 		const m = spec.meta;
 		lines.push(`# ${m.key}.v${m.version}`);
 		lines.push("");

package/dist/migrations.d.ts

@@ -31,7 +31,7 @@ interface MigrationMeta extends OwnerShipMeta {
   /** Fully qualified migration name (e.g., "sigil.db.2025_01_add_users"). */
   key: string;
   /** Increment when the migration changes. */
-  version: number;
+  version: string;
 }
 interface MigrationPlan {
   up: MigrationStep[];
@@ -46,7 +46,7 @@ declare class MigrationRegistry {
   private readonly items;
   register(spec: MigrationSpec): this;
   list(): MigrationSpec[];
-  get(name: string, version?: number): MigrationSpec | undefined;
+  get(name: string, version?: string): MigrationSpec | undefined;
 }
 //#endregion
 export { DataMigrationStep, MigrationCheck, MigrationMeta, MigrationPlan, MigrationRegistry, MigrationSpec, MigrationStep, MigrationStepBase, MigrationStepKind, SchemaMigrationStep, ValidationMigrationStep };

package/dist/migrations.js

@@ -1,3 +1,5 @@
+import { compareVersions } from "compare-versions";
+
 //#region src/migrations.ts
 const migrationKey = (name, version) => `${name}.v${version}`;
 var MigrationRegistry = class {
@@ -9,25 +11,21 @@ var MigrationRegistry = class {
 		return this;
 	}
 	list() {
-		return [...this.items.values()].sort((a, b) => compareKey(migrationKey(a.meta.key, a.meta.version), migrationKey(b.meta.key, b.meta.version)));
+		return [...this.items.values()].sort((a, b) => {
+			const byName = a.meta.key.localeCompare(b.meta.key);
+			return byName !== 0 ? byName : compareVersions(a.meta.version, b.meta.version);
+		});
 	}
 	get(name, version) {
 		if (version != null) return this.items.get(migrationKey(name, version));
 		let candidate;
-		let max = -Infinity;
 		for (const spec of this.items.values()) {
 			if (spec.meta.key !== name) continue;
-			if (spec.meta.version > max) {
-				max = spec.meta.version;
-				candidate = spec;
-			}
+			if (!candidate || compareVersions(spec.meta.version, candidate.meta.version) > 0) candidate = spec;
 		}
 		return candidate;
 	}
 };
-function compareKey(a, b) {
-	return a < b ? -1 : a > b ? 1 : 0;
-}
 
 //#endregion
 export { MigrationRegistry };

package/dist/onboarding-base.d.ts

@@ -1,136 +1,136 @@
 import { OperationSpec } from "./operations/operation.js";
 import "./index.js";
-import * as _contractspec_lib_schema53 from "@contractspec/lib.schema";
+import * as _contractspec_lib_schema0 from "@contractspec/lib.schema";
 import { SchemaModel } from "@contractspec/lib.schema";
 
 //#region src/onboarding-base.d.ts
 /** Save/update onboarding draft (auto-save during flow) */
 declare const SaveOnboardingDraftInput: SchemaModel<{
   data: {
-    type: _contractspec_lib_schema53.FieldType<unknown, unknown>;
+    type: _contractspec_lib_schema0.FieldType<unknown, unknown>;
     isOptional: false;
   };
 }>;
 declare const SaveOnboardingDraftOutput: SchemaModel<{
   id: {
-    type: _contractspec_lib_schema53.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   organizationId: {
-    type: _contractspec_lib_schema53.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
 }>;
 declare const SaveOnboardingDraftBaseSpec: OperationSpec<SchemaModel<{
   data: {
-    type: _contractspec_lib_schema53.FieldType<unknown, unknown>;
+    type: _contractspec_lib_schema0.FieldType<unknown, unknown>;
     isOptional: false;
   };
 }>, SchemaModel<{
   id: {
-    type: _contractspec_lib_schema53.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   organizationId: {
-    type: _contractspec_lib_schema53.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
 }>, undefined>;
 /** Get current onboarding draft (on mount/restore) */
 declare const GetOnboardingDraftOutput: SchemaModel<{
   id: {
-    type: _contractspec_lib_schema53.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   organizationId: {
-    type: _contractspec_lib_schema53.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   data: {
-    type: _contractspec_lib_schema53.FieldType<unknown, unknown>;
+    type: _contractspec_lib_schema0.FieldType<unknown, unknown>;
     isOptional: true;
   };
   createdAt: {
-    type: _contractspec_lib_schema53.FieldType<Date, string>;
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
     isOptional: true;
   };
   updatedAt: {
-    type: _contractspec_lib_schema53.FieldType<Date, string>;
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
     isOptional: true;
   };
 }>;
-declare const GetOnboardingDraftBaseSpec: OperationSpec<_contractspec_lib_schema53.AnySchemaModel, SchemaModel<{
+declare const GetOnboardingDraftBaseSpec: OperationSpec<_contractspec_lib_schema0.AnySchemaModel, SchemaModel<{
   id: {
-    type: _contractspec_lib_schema53.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   organizationId: {
-    type: _contractspec_lib_schema53.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   data: {
-    type: _contractspec_lib_schema53.FieldType<unknown, unknown>;
+    type: _contractspec_lib_schema0.FieldType<unknown, unknown>;
     isOptional: true;
   };
   createdAt: {
-    type: _contractspec_lib_schema53.FieldType<Date, string>;
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
     isOptional: true;
   };
   updatedAt: {
-    type: _contractspec_lib_schema53.FieldType<Date, string>;
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
     isOptional: true;
   };
 }>, undefined>;
 /** Delete onboarding draft (cleanup after completion or cancel) */
 declare const DeleteOnboardingDraftOutput: SchemaModel<{
   ok: {
-    type: _contractspec_lib_schema53.FieldType<boolean, boolean>;
+    type: _contractspec_lib_schema0.FieldType<boolean, boolean>;
     isOptional: false;
   };
 }>;
-declare const DeleteOnboardingDraftBaseSpec: OperationSpec<_contractspec_lib_schema53.AnySchemaModel, SchemaModel<{
+declare const DeleteOnboardingDraftBaseSpec: OperationSpec<_contractspec_lib_schema0.AnySchemaModel, SchemaModel<{
   ok: {
-    type: _contractspec_lib_schema53.FieldType<boolean, boolean>;
+    type: _contractspec_lib_schema0.FieldType<boolean, boolean>;
     isOptional: false;
   };
 }>, undefined>;
 /** Complete onboarding (final submit, creates entities) */
 declare const CompleteOnboardingBaseInput: SchemaModel<{
   data: {
-    type: _contractspec_lib_schema53.FieldType<unknown, unknown>;
+    type: _contractspec_lib_schema0.FieldType<unknown, unknown>;
     isOptional: false;
   };
 }>;
 declare const CompleteOnboardingBaseOutput: SchemaModel<{
   success: {
-    type: _contractspec_lib_schema53.FieldType<boolean, boolean>;
+    type: _contractspec_lib_schema0.FieldType<boolean, boolean>;
     isOptional: false;
   };
   userId: {
-    type: _contractspec_lib_schema53.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   organizationId: {
-    type: _contractspec_lib_schema53.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
 }>;
 declare const CompleteOnboardingBaseSpec: OperationSpec<SchemaModel<{
   data: {
-    type: _contractspec_lib_schema53.FieldType<unknown, unknown>;
+    type: _contractspec_lib_schema0.FieldType<unknown, unknown>;
     isOptional: false;
   };
 }>, SchemaModel<{
   success: {
-    type: _contractspec_lib_schema53.FieldType<boolean, boolean>;
+    type: _contractspec_lib_schema0.FieldType<boolean, boolean>;
     isOptional: false;
   };
   userId: {
-    type: _contractspec_lib_schema53.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   organizationId: {
-    type: _contractspec_lib_schema53.FieldType<string, string>;
+    type: _contractspec_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
 }>, undefined>;

package/dist/onboarding-base.js

@@ -34,7 +34,7 @@ const SaveOnboardingDraftOutput = new SchemaModel({
 const SaveOnboardingDraftBaseSpec = defineCommand({
 	meta: {
 		key: "base.onboarding.saveDraft",
-		version: 1,
+		version: "1.0.0",
 		stability: StabilityEnum.Beta,
 		owners: [OwnersEnum.PlatformSigil],
 		tags: ["onboarding", "draft"],
@@ -85,7 +85,7 @@ const GetOnboardingDraftOutput = new SchemaModel({
 const GetOnboardingDraftBaseSpec = defineQuery({
 	meta: {
 		key: "base.onboarding.getDraft",
-		version: 1,
+		version: "1.0.0",
 		stability: StabilityEnum.Beta,
 		owners: [OwnersEnum.PlatformSigil],
 		tags: ["onboarding", "draft"],
@@ -118,7 +118,7 @@ const DeleteOnboardingDraftOutput = new SchemaModel({
 const DeleteOnboardingDraftBaseSpec = defineCommand({
 	meta: {
 		key: "base.onboarding.deleteDraft",
-		version: 1,
+		version: "1.0.0",
 		stability: StabilityEnum.Beta,
 		owners: [OwnersEnum.PlatformSigil],
 		tags: ["onboarding", "draft"],
@@ -169,7 +169,7 @@ const CompleteOnboardingBaseOutput = new SchemaModel({
 const CompleteOnboardingBaseSpec = defineCommand({
 	meta: {
 		key: "base.onboarding.complete",
-		version: 1,
+		version: "1.0.0",
 		stability: StabilityEnum.Beta,
 		owners: [OwnersEnum.PlatformSigil],
 		tags: ["onboarding"],

package/dist/openapi.js

@@ -1,6 +1,13 @@
 import { defaultRestPath, jsonSchemaForSpec } from "./jsonschema.js";
+import { compareVersions } from "compare-versions";
 
 //#region src/openapi.ts
+/**
+* OpenAPI export utilities.
+*
+* @deprecated Import from @contractspec/lib.contracts-transformers/openapi instead.
+* This file is kept for backwards compatibility.
+*/
 function toOperationId(name, version) {
 	return `${name.replace(/\./g, "_")}_v${version}`;
 }
@@ -15,9 +22,9 @@ function toRestPath(spec) {
 	return path.startsWith("/") ? path : `/${path}`;
 }
 function openApiForRegistry(registry, options = {}) {
-	const specs = registry.listSpecs().filter((s) => s.meta.kind === "command" || s.meta.kind === "query").slice().sort((a, b) => {
+	const specs = registry.list().filter((s) => s.meta.kind === "command" || s.meta.kind === "query").slice().sort((a, b) => {
 		const byName = a.meta.key.localeCompare(b.meta.key);
-		return byName !== 0 ? byName : a.meta.version - b.meta.version;
+		return byName !== 0 ? byName : compareVersions(a.meta.version, b.meta.version);
 	});
 	const doc = {
 		openapi: "3.1.0",

package/dist/operations/operation.d.ts

@@ -1,7 +1,7 @@
 import { OwnerShipMeta } from "../ownership.js";
 import { PolicyRef } from "../policy/spec.js";
-import { ResourceRefDescriptor } from "../resources.js";
 import { EventSpec } from "../events.js";
+import { ResourceRefDescriptor } from "../resources.js";
 import { TestSpecRef } from "../tests/spec.js";
 import { AnySchemaModel } from "@contractspec/lib.schema";
 
@@ -33,7 +33,7 @@ interface EmitDeclRef {
 }
 interface EmitDeclInline {
   key: string;
-  version: number;
+  version: string;
   when: string;
   payload: AnySchemaModel;
 }
@@ -46,7 +46,7 @@ declare const isEmitDeclRef: (e: EmitDecl) => e is EmitDeclRef;
 interface TelemetryTrigger {
   event: {
     key: string;
-    version?: number;
+    version?: string;
   };
   properties?: (args: {
     input: unknown;

package/dist/operations/registry.d.ts

@@ -1,29 +1,22 @@
-import { GroupKeyFn, RegistryFilter } from "../registry-utils.js";
 import { ResourceRefDescriptor } from "../resources.js";
-import { HandlerCtx } from "../types.js";
 import { AnyOperationSpec, OperationSpec } from "./operation.js";
 import { HandlerForOperationSpec } from "../install.js";
+import { HandlerCtx } from "../types.js";
+import { SpecContractRegistry } from "../registry.js";
 import { AnySchemaModel } from "@contractspec/lib.schema";
 
 //#region src/operations/registry.d.ts
-type OperationKey = `${string}.v${number}`;
-declare function opKey(key: string, version: number): OperationKey;
+
+type OperationKey = `${string}.v${string}`;
+declare function opKey(key: string, version: string): OperationKey;
 type AnyOperationHandler = (args: unknown, ctx: HandlerCtx) => Promise<unknown>;
 /**
  * In-memory registry for ContractSpecs and their bound handlers.
  * Provides validation, policy enforcement, and guarded event emission at execute time.
  */
-declare class OperationSpecRegistry {
-  private specs;
+declare class OperationSpecRegistry extends SpecContractRegistry<'operation', AnyOperationSpec> {
   private handlers;
-  /**
-   * Registers a OperationSpec definition.
-   *
-   * @param spec - The contract specification to register.
-   * @returns The registry instance for chaining.
-   * @throws If a spec with the same name and version is already registered.
-   */
-  register<I extends AnySchemaModel, O extends AnySchemaModel | ResourceRefDescriptor<boolean>>(spec: OperationSpec<I, O>): this;
+  constructor(items?: AnyOperationSpec[]);
   /**
    * Binds a runtime handler implementation to a previously registered spec.
    *
@@ -33,57 +26,15 @@ declare class OperationSpecRegistry {
    * @throws If the spec is not found or a handler is already bound.
    */
   bind<I extends AnySchemaModel, O extends AnySchemaModel | ResourceRefDescriptor<boolean>>(spec: OperationSpec<I, O>, handler: HandlerForOperationSpec<OperationSpec<I, O>>): this;
-  /**
-   * Retrieves a registered spec by name and version.
-   * If version is omitted, returns the highest version found.
-   *
-   * @param name - Operation name.
-   * @param version - (Optional) Specific version.
-   */
-  getSpec(key: string, version?: number): AnyOperationSpec | undefined;
   /**
    * Retrieves the bound handler for a spec.
    */
-  getHandler(key: string, version?: number): AnyOperationHandler | undefined;
-  /** Iterate all registered specs. */
-  listSpecs(): AnyOperationSpec[];
+  getHandler(key: string, version?: string): AnyOperationHandler | undefined;
   /** Iterate all bound operations (spec+handler). */
   listBound(): {
     spec: AnyOperationSpec;
     handler: AnyOperationHandler;
   }[];
-  /**
-   * Filter specs by criteria.
-   */
-  filter(criteria: RegistryFilter): AnyOperationSpec[];
-  /**
-   * List specs with specific tag.
-   */
-  listByTag(tag: string): AnyOperationSpec[];
-  /**
-   * List specs by owner.
-   */
-  listByOwner(owner: string): AnyOperationSpec[];
-  /**
-   * Group specs by key function.
-   */
-  groupBy(keyFn: GroupKeyFn<AnyOperationSpec>): Map<string, AnyOperationSpec[]>;
-  /**
-   * Group by domain (first segment of name).
-   */
-  groupByDomain(): Map<string, AnyOperationSpec[]>;
-  /**
-   * Group by tag.
-   */
-  groupByTag(): Map<string, AnyOperationSpec[]>;
-  /**
-   * Get unique tags from all specs.
-   */
-  getUniqueTags(): string[];
-  /**
-   * Get unique owners from all specs.
-   */
-  getUniqueOwners(): string[];
   /**
    * Execute an operation by name/version with full runtime protections:
    * 1. Validates input against Zod schema.
@@ -97,7 +48,7 @@ declare class OperationSpecRegistry {
    * @param rawInput - The raw input payload (e.g. from JSON body).
    * @param ctx - The runtime context (actor, tenant, etc.).
    */
-  execute(key: string, version: number | undefined, rawInput: unknown, ctx: HandlerCtx): Promise<unknown>;
+  execute(key: string, version: string | undefined, rawInput: unknown, ctx: HandlerCtx): Promise<unknown>;
 }
 //#endregion
 export { OperationKey, OperationSpecRegistry, opKey };

package/dist/operations/registry.js

@@ -1,9 +1,16 @@
-import { GroupingStrategies, filterBy, getUniqueOwners, getUniqueTags, groupBy, init_registry_utils } from "../registry-utils.js";
+import { SpecContractRegistry } from "../registry.js";
 import { eventKey } from "../events.js";
 import { isEmitDeclRef } from "./operation.js";
 
 //#region src/operations/registry.ts
-init_registry_utils();
+/**
+* OperationSpecRegistry:
+* - Registers ContractSpecs (unique by name+version)
+* - Binds runtime handlers to specs
+* - Provides lookup, iteration, and a safe execute() with validation/policy/enforcement
+*
+* Includes a minimal OpRegistry shim for backward-compat (deprecated).
+*/
 function opKey(key, version) {
 	return `${key}.v${version}`;
 }
@@ -11,21 +18,10 @@ function opKey(key, version) {
 * In-memory registry for ContractSpecs and their bound handlers.
 * Provides validation, policy enforcement, and guarded event emission at execute time.
 */
-var OperationSpecRegistry = class {
-	specs = /* @__PURE__ */ new Map();
+var OperationSpecRegistry = class extends SpecContractRegistry {
 	handlers = /* @__PURE__ */ new Map();
-	/**
-	* Registers a OperationSpec definition.
-	*
-	* @param spec - The contract specification to register.
-	* @returns The registry instance for chaining.
-	* @throws If a spec with the same name and version is already registered.
-	*/
-	register(spec) {
-		const key = opKey(spec.meta.key, spec.meta.version);
-		if (this.specs.has(key)) throw new Error(`Duplicate spec ${key}`);
-		this.specs.set(key, spec);
-		return this;
+	constructor(items) {
+		super("operation", items);
 	}
 	/**
 	* Binds a runtime handler implementation to a previously registered spec.
@@ -37,47 +33,23 @@ var OperationSpecRegistry = class {
 	*/
 	bind(spec, handler) {
 		const key = opKey(spec.meta.key, spec.meta.version);
-		if (!this.specs.has(key)) throw new Error(`Cannot bind; spec not found: ${key}`);
+		if (!this.items.has(key)) throw new Error(`Cannot bind; spec not found: ${key}`);
 		if (this.handlers.has(key)) throw new Error(`Handler already bound for ${key}`);
 		this.handlers.set(key, handler);
 		return this;
 	}
 	/**
-	* Retrieves a registered spec by name and version.
-	* If version is omitted, returns the highest version found.
-	*
-	* @param name - Operation name.
-	* @param version - (Optional) Specific version.
-	*/
-	getSpec(key, version) {
-		if (version != null) return this.specs.get(opKey(key, version));
-		let found;
-		let maxV = -Infinity;
-		for (const [k, s] of this.specs.entries()) {
-			if (!k.startsWith(`${key}.v`)) continue;
-			if (s.meta.version > maxV) {
-				maxV = s.meta.version;
-				found = s;
-			}
-		}
-		return found;
-	}
-	/**
 	* Retrieves the bound handler for a spec.
 	*/
 	getHandler(key, version) {
-		const spec = this.getSpec(key, version);
+		const spec = this.get(key, version);
 		if (!spec) return void 0;
 		return this.handlers.get(opKey(spec.meta.key, spec.meta.version));
 	}
-	/** Iterate all registered specs. */
-	listSpecs() {
-		return [...this.specs.values()];
-	}
 	/** Iterate all bound operations (spec+handler). */
 	listBound() {
 		const out = [];
-		for (const [k, spec] of this.specs.entries()) {
+		for (const [k, spec] of this.items.entries()) {
 			const h = this.handlers.get(k);
 			if (h) out.push({
 				spec,
@@ -87,54 +59,6 @@ var OperationSpecRegistry = class {
 		return out;
 	}
 	/**
-	* Filter specs by criteria.
-	*/
-	filter(criteria) {
-		return filterBy(this.listSpecs(), criteria);
-	}
-	/**
-	* List specs with specific tag.
-	*/
-	listByTag(tag) {
-		return this.listSpecs().filter((s) => s.meta.tags?.includes(tag));
-	}
-	/**
-	* List specs by owner.
-	*/
-	listByOwner(owner) {
-		return this.listSpecs().filter((s) => s.meta.owners?.includes(owner));
-	}
-	/**
-	* Group specs by key function.
-	*/
-	groupBy(keyFn) {
-		return groupBy(this.listSpecs(), keyFn);
-	}
-	/**
-	* Group by domain (first segment of name).
-	*/
-	groupByDomain() {
-		return this.groupBy(GroupingStrategies.byDomain);
-	}
-	/**
-	* Group by tag.
-	*/
-	groupByTag() {
-		return this.groupBy(GroupingStrategies.byTag);
-	}
-	/**
-	* Get unique tags from all specs.
-	*/
-	getUniqueTags() {
-		return getUniqueTags(this.listSpecs());
-	}
-	/**
-	* Get unique owners from all specs.
-	*/
-	getUniqueOwners() {
-		return getUniqueOwners(this.listSpecs());
-	}
-	/**
 	* Execute an operation by name/version with full runtime protections:
 	* 1. Validates input against Zod schema.
 	* 2. Enforces policy (Auth, RBAC, Rate Limits) via PDP.
@@ -148,7 +72,7 @@ var OperationSpecRegistry = class {
 	* @param ctx - The runtime context (actor, tenant, etc.).
 	*/
 	async execute(key, version, rawInput, ctx) {
-		const baseSpec = this.getSpec(key, version);
+		const baseSpec = this.get(key, version);
 		if (!baseSpec) throw new Error(`Spec not found for ${key}${version ? `.v${version}` : ""}`);
 		const spec = await ctx.specVariantResolver?.resolve({
 			name: baseSpec.meta.key,
@@ -215,7 +139,7 @@ var OperationSpecRegistry = class {
 			if (!telemetryContext || !trigger?.event) return;
 			try {
 				const props = trigger.properties?.(details) ?? {};
-				await telemetryContext.track(trigger.event.key, trigger.event.version ?? 1, props, {
+				await telemetryContext.track(trigger.event.key, trigger.event.version ?? "1.0.0", props, {
 					tenantId: ctx.organizationId ?? void 0,
 					organizationId: ctx.organizationId,
 					userId: ctx.userId,

package/dist/ownership.d.ts

@@ -63,7 +63,7 @@ declare const Tags: {
 };
 interface OwnerShipMeta {
   /** Breaking changes => bump version */
-  version: number;
+  version: string;
   /** Fully-qualified spec key (e.g., "sigil.beginSignup") */
   key: string;
   /** Human-friendly spec title (e.g., "Signup begin") */