@contractspec/lib.feature-flags 1.50.0 → 1.51.0

package/dist/contracts/src/capabilities/capabilities.d.ts

@@ -1,5 +1,5 @@
-import { OwnerShipMeta } from "../ownership.js";
 import { VersionedSpecRef } from "../versioning/refs.js";
+import { OwnerShipMeta } from "../ownership.js";
 
 //#region ../contracts/src/capabilities/capabilities.d.ts
 /** Classification of capability types. */
@@ -13,10 +13,10 @@ type CapabilitySurface = 'operation' | 'event' | 'workflow' | 'presentation' | '
 interface CapabilitySurfaceRef {
   /** The surface type where this capability is exposed. */
   surface: CapabilitySurface;
-  /** Unique key identifying the capability. */
+  /** Unique key identifying the spec on that surface (e.g., operation key). */
   key: string;
-  /** Semantic version of the capability. */
-  version: string;
+  /** Semantic version of the spec on that surface. */
+  version?: string;
   /** Optional description of what this capability provides. */
   description?: string;
 }
@@ -48,7 +48,11 @@ interface CapabilityRequirement {
 type CapabilityRef = VersionedSpecRef;
 interface CapabilitySpec {
   meta: CapabilityMeta;
+  /** Capabilities this capability extends (inherits requirements from). */
+  extends?: CapabilityRef;
+  /** Surfaces (operations, events, presentations, etc.) this capability provides. */
   provides?: CapabilitySurfaceRef[];
+  /** Capabilities that must be present for this capability to function. */
   requires?: CapabilityRequirement[];
 }
 //#endregion

package/dist/contracts/src/capabilities/capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.d.ts","names":[],"sources":["../../../../../contracts/src/capabilities/capabilities.ts"],"sourcesContent":[],"mappings":";;;;;KAKY,cAAA;AAAZ;AAGY,KAAA,iBAAA,GAAiB,WAAA,GAAA,OAAA,GAAA,UAAA,GAAA,cAAA,GAAA,UAAA;AAW7B;AAYA;AASA;AAiBA;AAEiB,UAxCA,oBAAA,CAwCc;EACvB;EACK,OAAA,EAxCF,iBAwCE;EACA;EAAqB,GAAA,EAAA,MAAA;;;;;;;UA/BjB,cAAA,SAAuB;;QAEhC;;;;;;UAOS,qBAAA;;;;;;SAMR;;;;;;;;;;KAWG,aAAA,GAAgB;UAEX,cAAA;QACT;aACK;aACA"}
+{"version":3,"file":"capabilities.d.ts","names":[],"sources":["../../../../../contracts/src/capabilities/capabilities.ts"],"sourcesContent":[],"mappings":";;;;;KAKY,cAAA;AAAZ;AAGY,KAAA,iBAAA,GAAiB,WAAA,GAAA,OAAA,GAAA,UAAA,GAAA,cAAA,GAAA,UAAA;AAW7B;AAYA;AASA;AAiBA;AAEiB,UAxCA,oBAAA,CAwCc;EACvB;EAEI,OAAA,EAzCD,iBAyCC;EAEC;EAEA,GAAA,EAAA,MAAA;EAAqB;;;;;;UAnCjB,cAAA,SAAuB;;QAEhC;;;;;;UAOS,qBAAA;;;;;;SAMR;;;;;;;;;;KAWG,aAAA,GAAgB;UAEX,cAAA;QACT;;YAEI;;aAEC;;aAEA"}

package/dist/contracts/src/capabilities/context.d.ts

@@ -0,0 +1 @@
+import "./capabilities.js";

package/dist/contracts/src/capabilities/guards.d.ts

@@ -0,0 +1,4 @@
+import "../presentations/presentations.js";
+import "../operations/operation.js";
+import "./context.js";
+import "../events.js";

package/dist/contracts/src/capabilities/index.d.ts

@@ -1,2 +1,5 @@
 import { CapabilityKind, CapabilityMeta, CapabilityRef, CapabilityRequirement, CapabilitySpec, CapabilitySurface, CapabilitySurfaceRef } from "./capabilities.js";
+import "./validation.js";
+import "./context.js";
+import "./guards.js";
 import "./openbanking.js";

package/dist/contracts/src/capabilities/validation.d.ts

@@ -0,0 +1,4 @@
+import "./capabilities.js";
+import "../operations/registry.js";
+import "../presentations/index.js";
+import "../events.js";

package/dist/contracts/src/events.d.ts

@@ -1,5 +1,6 @@
 import { AnySchemaModel } from "../../schema/src/SchemaModel.js";
 import "../../schema/src/index.js";
+import { CapabilityRef } from "./capabilities/capabilities.js";
 import { DocId } from "./docs/registry.js";
 import { OwnerShipMeta } from "./ownership.js";
 import "./registry.js";
@@ -26,6 +27,11 @@ interface EventSpecMeta extends Omit<OwnerShipMeta, 'docId'> {
 interface EventSpec<T extends AnySchemaModel> {
   /** Event metadata including key, version, and ownership. */
   meta: EventSpecMeta;
+  /**
+   * Optional reference to the capability that provides this event.
+   * Used for bidirectional linking between capabilities and events.
+   */
+  capability?: CapabilityRef;
   /**
    * JSON paths to PII fields that should be redacted in logs/exports.
    * @example ['email', 'user.phone', 'billing.address']

package/dist/contracts/src/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","names":[],"sources":["../../../../contracts/src/events.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;UAgDiB,aAAA,SAAsB,KAAK;;UAElC;;;;;;;;;;;UAYO,oBAAoB;;QAE7B;;;;;;;WAOG"}
+{"version":3,"file":"events.d.ts","names":[],"sources":["../../../../contracts/src/events.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;UAiDiB,aAAA,SAAsB,KAAK;;UAElC;;;;;;;;;;;UAYO,oBAAoB;;QAE7B;;;;;eAKO;;;;;;;WAOJ"}

package/dist/contracts/src/experiments/spec.d.ts

@@ -1,5 +1,5 @@
-import "../ownership.js";
 import { OptionalVersionedSpecRef } from "../versioning/refs.js";
+import "../ownership.js";
 import "../policy/spec.js";
 import "../telemetry/spec.js";
 import "../registry.js";

package/dist/contracts/src/features/install.d.ts

@@ -1,6 +1,6 @@
 import "../presentations/presentations.js";
-import "../capabilities/index.js";
 import "../operations/registry.js";
+import "../presentations/index.js";
+import "../capabilities/index.js";
 import "./types.js";
-import "./registry.js";
-import "../presentations/index.js";
+import "./registry.js";

package/dist/contracts/src/features/types.d.ts

@@ -1,11 +1,11 @@
-import { PresentationTarget } from "../presentations/presentations.js";
-import { OwnerShipMeta } from "../ownership.js";
 import { VersionedSpecRef } from "../versioning/refs.js";
 import { CapabilityRef, CapabilityRequirement } from "../capabilities/capabilities.js";
-import "../capabilities/index.js";
-import { ExperimentRef } from "../experiments/spec.js";
+import { PresentationTarget } from "../presentations/presentations.js";
+import { OwnerShipMeta } from "../ownership.js";
 import { ImplementationRef } from "../operations/operation.js";
 import "../operations/index.js";
+import "../capabilities/index.js";
+import { ExperimentRef } from "../experiments/spec.js";
 
 //#region ../contracts/src/features/types.d.ts
 /** Minimal metadata to identify and categorize a feature module. */

package/dist/contracts/src/index.d.ts

@@ -1,22 +1,22 @@
 import "../../schema/src/index.js";
+import { OptionalVersionedSpecRef, VersionedSpecRef } from "./versioning/refs.js";
+import { CapabilityKind, CapabilityMeta, CapabilityRef, CapabilityRequirement, CapabilitySpec, CapabilitySurface, CapabilitySurfaceRef } from "./capabilities/capabilities.js";
 import { PresentationTarget } from "./presentations/presentations.js";
 import { DocId } from "./docs/registry.js";
 import "./docs/index.js";
 import { Owner, OwnerShipMeta, OwnersEnum, Stability, StabilityEnum, Tag, TagsEnum } from "./ownership.js";
 import "./registry-utils.js";
-import { OptionalVersionedSpecRef, VersionedSpecRef } from "./versioning/refs.js";
 import { PolicyRef } from "./policy/spec.js";
 import "./telemetry/index.js";
-import { CapabilityKind, CapabilityMeta, CapabilityRef, CapabilityRequirement, CapabilitySpec, CapabilitySurface, CapabilitySurfaceRef } from "./capabilities/capabilities.js";
-import "./capabilities/index.js";
-import { ExperimentRef } from "./experiments/spec.js";
 import { ResourceRefDescriptor } from "./resources.js";
 import { TestSpecRef } from "./tests/spec.js";
 import { EmitDecl, EmitDeclInline, EmitDeclRef, ImplementationRef, ImplementationType, OpKind, OperationSpec, OperationSpecMeta, TelemetryTrigger } from "./operations/operation.js";
-import "./install.js";
 import "./operations/index.js";
-import { DataViewRef, EventRef, FeatureModuleMeta, FeatureModuleSpec, FormRef, OpRef, PresentationRef } from "./features/types.js";
+import "./install.js";
 import "./presentations/index.js";
+import "./capabilities/index.js";
+import { ExperimentRef } from "./experiments/spec.js";
+import { DataViewRef, EventRef, FeatureModuleMeta, FeatureModuleSpec, FormRef, OpRef, PresentationRef } from "./features/types.js";
 import "./features/index.js";
 import "./data-views/index.js";
 import "./themes.js";

package/dist/contracts/src/install.d.ts

@@ -1,7 +1,7 @@
 import "../../schema/src/index.js";
 import "./resources.js";
-import "./operations/registry.js";
 import "./operations/index.js";
+import "./operations/registry.js";
 import "./types.js";
 import "./events.js";
 import "zod";

package/dist/contracts/src/integrations/openbanking/contracts/accounts.d.ts

@@ -1,4 +1,4 @@
 import "../../../../../schema/src/index.js";
-import "../../../operations/registry.js";
 import "../../../operations/index.js";
+import "../../../operations/registry.js";
 import "../../../index.js";

package/dist/contracts/src/integrations/openbanking/contracts/balances.d.ts

@@ -1,4 +1,4 @@
 import "../../../../../schema/src/index.js";
-import "../../../operations/registry.js";
 import "../../../operations/index.js";
+import "../../../operations/registry.js";
 import "../../../index.js";

package/dist/contracts/src/integrations/openbanking/contracts/transactions.d.ts

@@ -1,4 +1,4 @@
 import "../../../../../schema/src/index.js";
-import "../../../operations/registry.js";
 import "../../../operations/index.js";
+import "../../../operations/registry.js";
 import "../../../index.js";

package/dist/contracts/src/integrations/operations.d.ts

@@ -1,4 +1,4 @@
 import "../../../schema/src/index.js";
-import "../operations/registry.js";
 import "../operations/index.js";
+import "../operations/registry.js";
 import "../index.js";

package/dist/contracts/src/knowledge/operations.d.ts

@@ -1,4 +1,4 @@
 import "../../../schema/src/index.js";
-import "../operations/registry.js";
 import "../operations/index.js";
+import "../operations/registry.js";
 import "../index.js";

package/dist/contracts/src/llm/exporters.d.ts

@@ -1,6 +1,6 @@
 import "../../../schema/src/index.js";
-import "../operations/registry.js";
 import "../operations/index.js";
+import "../operations/registry.js";
 import "../presentations/index.js";
 import "../features/index.js";
 import "../events.js";

package/dist/contracts/src/operations/operation.d.ts

@@ -1,5 +1,6 @@
 import { AnySchemaModel } from "../../../schema/src/SchemaModel.js";
 import "../../../schema/src/index.js";
+import { CapabilityRef } from "../capabilities/capabilities.js";
 import { OwnerShipMeta } from "../ownership.js";
 import { PolicyRef } from "../policy/spec.js";
 import { ResourceRefDescriptor } from "../resources.js";
@@ -70,6 +71,11 @@ interface OperationSpecMeta extends OwnerShipMeta {
  */
 interface OperationSpec<Input extends AnySchemaModel, Output extends AnySchemaModel | ResourceRefDescriptor<boolean>, Events extends readonly EmitDecl[] | undefined = readonly EmitDecl[] | undefined> {
   meta: OperationSpecMeta;
+  /**
+   * Optional reference to the capability that provides this operation.
+   * Used for bidirectional linking between capabilities and operations.
+   */
+  capability?: CapabilityRef;
   io: {
     /** Zod schema for input body payload */
     input: Input | null;

package/dist/contracts/src/operations/operation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operation.d.ts","names":[],"sources":["../../../../../contracts/src/operations/operation.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAmBA;AAaA;AAUA;AAKiB,KAjCL,MAAA,GAiCmB,SAAA,GAAA,OAIpB;AAMX;AAGA;AASA;AAeiB,KAjEL,kBAAA,GAiEkB,SAAA,GAAA,WAAA,GAAA,MAAA,GAAA,MAAA,GAAA,SAAA,GAAA,MAAA,GAAA,OAAA;;;;;AAIf,UAxDE,iBAAA,CAwDF;EAGP;EAIG,IAAA,EAAA,MAAA;EAGE;EAGD,IAAA,EAjEJ,kBAiEI;EAGE;EAGF,WAAA,CAAA,EAAA,MAAA;;AA2BG,UA5FE,WAAA,CA4FF;EAKA,GAAA,EAhGR,SAgGQ,CAhGE,cAgGF,CAAA,CAAA,MAAA,CAAA;EAMH,IAAA,EAAA,MAAA;;AASE,UA3GG,cAAA,CA2GH;EAGJ,GAAA,EAAA,MAAA;EAsCU,OAAA,EAAA,MAAA;EAAiB,IAAA,EAAA,MAAA;WAhJ1B;;;;;;KAMC,QAAA,GAAW,cAAc;UAGpB,gBAAA;;;;;;;;;QAMT;;UAGS,iBAAA,SAA0B;QACnC;;;;;;;;;;;;;UAcS,4BACD,+BACC,iBAAiB,wDACR,kCACX;QAGP;;;WAIG;;aAGE;;YAGD;;cAGE;;YAGF;;aAEC;;;;;;;;;;;;;;;;;;;;;;;;eAyBE;;;;;eAKA;;;;;YAMH;;;;;;;cAQE;cACA;;UAGJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAsCU"}
+{"version":3,"file":"operation.d.ts","names":[],"sources":["../../../../../contracts/src/operations/operation.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAoBA;AAaA;AAUA;AAKiB,KAjCL,MAAA,GAiCmB,SAAA,GAAA,OAIpB;AAMX;AAGA;AASA;AAeiB,KAjEL,kBAAA,GAiEkB,SAAA,GAAA,WAAA,GAAA,MAAA,GAAA,MAAA,GAAA,SAAA,GAAA,MAAA,GAAA,OAAA;;;;;AAIf,UAxDE,iBAAA,CAwDF;EAGP;EAMO,IAAA,EAAA,MAAA;EAIJ;EAGE,IAAA,EApEL,kBAoEK;EAGD;EAGE,WAAA,CAAA,EAAA,MAAA;;AAKD,UAzEI,WAAA,CAyEJ;EAyBE,GAAA,EAjGR,SAiGQ,CAjGE,cAiGF,CAAA,CAAA,MAAA,CAAA;EAKA,IAAA,EAAA,MAAA;;AAcD,UAhHG,cAAA,CAgHH;EACA,GAAA,EAAA,MAAA;EAGJ,OAAA,EAAA,MAAA;EAsCU,IAAA,EAAA,MAAA;EAAiB,OAAA,EAtJ1B,cAsJ0B;;;;;;KAhJzB,QAAA,GAAW,cAAc;UAGpB,gBAAA;;;;;;;;;QAMT;;UAGS,iBAAA,SAA0B;QACnC;;;;;;;;;;;;;UAcS,4BACD,+BACC,iBAAiB,wDACR,kCACX;QAGP;;;;;eAMO;;;WAIJ;;aAGE;;YAGD;;cAGE;;YAGF;;aAEC;;;;;;;;;;;;;;;;;;;;;;;;eAyBE;;;;;eAKA;;;;;YAMH;;;;;;;cAQE;cACA;;UAGJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAsCU"}

package/dist/contracts/src/policy/guards.d.ts

@@ -0,0 +1 @@
+import "../operations/operation.js";

package/dist/contracts/src/policy/index.d.ts

@@ -1,4 +1,6 @@
 import { PolicyRef } from "./spec.js";
 import "./registry.js";
 import "./engine.js";
-import "./opa-adapter.js";
+import "./opa-adapter.js";
+import "./guards.js";
+import "./validation.js";

package/dist/contracts/src/policy/spec.d.ts

@@ -1,5 +1,5 @@
-import "../ownership.js";
 import { VersionedSpecRef } from "../versioning/refs.js";
+import "../ownership.js";
 
 //#region ../contracts/src/policy/spec.d.ts
 

package/dist/contracts/src/policy/validation.d.ts

@@ -0,0 +1,3 @@
+import "./spec.js";
+import "../operations/registry.js";
+import "./registry.js";

package/dist/contracts/src/presentations/presentations.d.ts

@@ -1,4 +1,5 @@
 import "../../../schema/src/index.js";
+import "../capabilities/capabilities.js";
 import "../ownership.js";
 
 //#region ../contracts/src/presentations/presentations.d.ts

package/dist/contracts/src/presentations/presentations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presentations.d.ts","names":[],"sources":["../../../../../contracts/src/presentations/presentations.ts"],"sourcesContent":[],"mappings":";;;;;AAKY,KAAA,kBAAA,GAAkB,OAAA,GAAA,UAAA,GAAA,kBAAA,GAAA,iBAAA"}
+{"version":3,"file":"presentations.d.ts","names":[],"sources":["../../../../../contracts/src/presentations/presentations.ts"],"sourcesContent":[],"mappings":";;;;;;AAMY,KAAA,kBAAA,GAAkB,OAAA,GAAA,UAAA,GAAA,kBAAA,GAAA,iBAAA"}

package/dist/contracts/src/tests/spec.d.ts

@@ -1,5 +1,5 @@
-import "../ownership.js";
 import { OptionalVersionedSpecRef } from "../versioning/refs.js";
+import "../ownership.js";
 
 //#region ../contracts/src/tests/spec.d.ts
 

package/dist/contracts/src/workflow/context.d.ts

@@ -0,0 +1,2 @@
+import "./spec.js";
+import "./state.js";

package/dist/contracts/src/workflow/index.d.ts

@@ -3,4 +3,6 @@ import "./spec.js";
 import "./validation.js";
 import "./state.js";
 import "./runner.js";
-import "./adapters/index.js";
+import "./adapters/index.js";
+import "./context.js";
+import "./sla-monitor.js";

package/dist/contracts/src/workflow/sla-monitor.d.ts

@@ -0,0 +1,2 @@
+import "./spec.js";
+import "./state.js";

package/dist/contracts/src/workflow/validation.d.ts

@@ -1,3 +1,5 @@
+import "../capabilities/capabilities.js";
 import "../operations/registry.js";
 import "./spec.js";
+import "../events.js";
 import "../forms/index.js";

package/dist/schema/src/FieldType.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FieldType.d.ts","names":[],"sources":["../../../../schema/src/FieldType.ts"],"sourcesContent":[],"mappings":";;;;UAGiB,uCAEH,mBACJ,wBAAwB,WAAW;OACtC,CAAA,CAAE,QAAQ;EAJA,UAAA,EAAA,OAAe,GAAA,CAAA,GAAA,GAAA,OAAA,CAAA;;AAGE,KAMtB,YAAA,GAAe,SANO,CAAA,GAAA,EAAA,GAAA,CAAA;;;;;;AAMtB,cAOC,SAPW,CAAG,SAAA,EAAS,YAStB,SATsB,CAAA,SAU1B,iBAV0B,CAUR,SAVQ,EAUG,SAVH,CAAA,CAAA;EAOvB,QAAA,SAAS;EAER,iBAAA,aAAA;EACc,WAAA,CAAA,MAAA,EAIN,eAJM,CAIU,SAJV,EAIqB,SAJrB,CAAA;EAAW;EAID,MAAA,CAAA,CAAA,EAO1B,CAAA,CAAE,OAPwB,CAOhB,SAPgB,CAAA;EAAW;EAA3B,SAAA,CAAA,CAAA,EAYP,iBAZO,CAYW,SAZX,EAYsB,SAZtB,CAAA;EAOA;EAAR,OAAA,CAAA,CAAA,EAAA,OAAA;EAKmB,gBAAA,CAAA,CAAA,EAAA,OAAA,GAAA,CAAA,GAAA,GAAA,OAAA,CAAA;EAAW,aAAA,CAAA,CAAA,EAAA,OAAA"}
+{"version":3,"file":"FieldType.d.ts","names":[],"sources":["../../../../schema/src/FieldType.ts"],"sourcesContent":[],"mappings":";;;;UAGiB,uCAEH,mBACJ,wBAAwB,WAAW;OACtC,CAAA,CAAE,QAAQ;EAJA,UAAA,EAAA,OAAe,GAAA,CAAA,GAAA,GAAA,OAAA,CAAA;;AAGE,KAMtB,YAAA,GAAe,SANO,CAAA,GAAA,EAAA,GAAA,CAAA;;;;;;AAMtB,cAOC,SAPW,CAAA,SAAG,EAAS,YAStB,SATsB,CAAA,SAU1B,iBAV0B,CAUR,SAVQ,EAUG,SAVH,CAAA,CAAA;EAOvB,QAAA,SAAS;EAER,iBAAA,aAAA;EACc,WAAA,CAAA,MAAA,EAIN,eAJM,CAIU,SAJV,EAIqB,SAJrB,CAAA;EAAW;EAID,MAAA,CAAA,CAAA,EAO1B,CAAA,CAAE,OAPwB,CAOhB,SAPgB,CAAA;EAAW;EAA3B,SAAA,CAAA,CAAA,EAYP,iBAZO,CAYW,SAZX,EAYsB,SAZtB,CAAA;EAOA;EAAR,OAAA,CAAA,CAAA,EAAA,OAAA;EAKmB,gBAAA,CAAA,CAAA,EAAA,OAAA,GAAA,CAAA,GAAA,GAAA,OAAA,CAAA;EAAW,aAAA,CAAA,CAAA,EAAA,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.feature-flags",
-  "version": "1.50.0",
+  "version": "1.51.0",
   "description": "Feature flags and experiments module for ContractSpec applications",
   "keywords": [
     "contractspec",
@@ -24,13 +24,13 @@
     "lint:check": "eslint src"
   },
   "dependencies": {
-    "@contractspec/lib.schema": "1.50.0",
-    "@contractspec/lib.contracts": "1.50.0",
+    "@contractspec/lib.schema": "1.51.0",
+    "@contractspec/lib.contracts": "1.51.0",
     "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "1.50.0",
-    "@contractspec/tool.tsdown": "1.50.0",
+    "@contractspec/tool.typescript": "1.51.0",
+    "@contractspec/tool.tsdown": "1.51.0",
     "typescript": "^5.9.3"
   },
   "exports": {