@contractspec/lib.feature-flags 1.56.0 → 1.57.0

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

@@ -1,2 +0,0 @@
-import "../registry-utils.js";
-import "./types.js";

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

@@ -1,80 +0,0 @@
-import { VersionedSpecRef } from "../versioning/refs.js";
-import { CapabilityRef, CapabilityRequirement } from "../capabilities/capabilities.js";
-import { ImplementationRef } from "../operations/operation.js";
-import { PresentationTarget } from "../presentations/presentations.js";
-import "../capabilities/index.js";
-import { ExperimentRef } from "../experiments/spec.js";
-import "../operations/index.js";
-import { OwnerShipMeta } from "../ownership.js";
-
-//#region ../contracts/src/features/types.d.ts
-/** Minimal metadata to identify and categorize a feature module. */
-type FeatureModuleMeta = OwnerShipMeta;
-/**
- * Reference to an operation spec.
- * Uses key (OperationSpec.meta.key) and version (OperationSpec.meta.version).
- */
-type OpRef = VersionedSpecRef;
-/**
- * Reference to an event spec.
- * Uses key (EventSpec.meta.key) and version (EventSpec.meta.version).
- */
-type EventRef = VersionedSpecRef;
-/**
- * Reference to a presentation spec.
- * Uses key (PresentationSpec.meta.key) and version (PresentationSpec.meta.version).
- */
-type PresentationRef = VersionedSpecRef;
-/**
- * Reference to a data view spec.
- * Uses key (DataViewSpec.meta.key) and version (DataViewSpec.meta.version).
- */
-type DataViewRef = VersionedSpecRef;
-/**
- * Reference to a form spec.
- * Uses key (FormSpec.meta.key) and version (FormSpec.meta.version).
- */
-type FormRef = VersionedSpecRef;
-/** Group operations/events/presentations into an installable feature. */
-interface FeatureModuleSpec {
-  meta: FeatureModuleMeta;
-  /** Contract operations included in this feature. */
-  operations?: OpRef[];
-  /** Events declared/emitted by this feature. */
-  events?: EventRef[];
-  /** Presentations associated to this feature. */
-  presentations?: PresentationRef[];
-  /** Experiments related to this feature. */
-  experiments?: ExperimentRef[];
-  /** Capability bindings exposed/required by this feature. */
-  capabilities?: {
-    provides?: CapabilityRef[];
-    requires?: CapabilityRequirement[];
-  };
-  /** Optional: link ops to presentations for traceability (e.g., ui for op) */
-  opToPresentation?: {
-    op: OpRef;
-    pres: PresentationRef;
-  }[];
-  /** Optional: declare per-presentation target requirements (V2 descriptors) */
-  presentationsTargets?: {
-    /** Presentation key. */
-    key: string;
-    /** Presentation version. */
-    version: string;
-    /** Required targets that must be supported by the descriptor. */
-    targets: PresentationTarget[];
-  }[];
-  /**
-   * Explicit implementation file mappings for the entire feature module.
-   * Used for tracking and verifying that this feature is correctly implemented.
-   */
-  implementations?: ImplementationRef[];
-  /** Data views associated with this feature. */
-  dataViews?: DataViewRef[];
-  /** Forms associated with this feature. */
-  forms?: FormRef[];
-}
-//#endregion
-export { DataViewRef, EventRef, FeatureModuleMeta, FeatureModuleSpec, FormRef, OpRef, PresentationRef };
-//# sourceMappingURL=types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../../contracts/src/features/types.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;KAQY,iBAAA,GAAoB;;;AAAhC;AAMA;AAMY,KANA,KAAA,GAAQ,gBAMG;AAMvB;AAMA;AAMA;AAGA;AACQ,KAtBI,QAAA,GAAW,gBAsBf;;;;;AAWO,KA3BH,eAAA,GAAkB,gBA2Bf;;;;;AAmBK,KAxCR,WAAA,GAAc,gBAwCN;;;;;KAlCR,OAAA,GAAU;;UAGL,iBAAA;QACT;;eAEO;;WAEJ;;kBAEO;;gBAEF;;;eAGD;eACA;;;;QAGY;UAAa;;;;;;;;;aAQ3B;;;;;;oBAOO;;cAGN;;UAGJ"}

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

@@ -1,2 +0,0 @@
-import "../presentations/presentations.js";
-import "./types.js";

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

@@ -1,3 +0,0 @@
-import "../../../schema/src/index.js";
-import "../registry-utils.js";
-import "../ownership.js";

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

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

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

@@ -1,53 +0,0 @@
-import "../../schema/src/index.js";
-import { ResourceRefDescriptor } from "./resources.js";
-import { OptionalVersionedSpecRef, VersionedSpecRef } from "./versioning/refs.js";
-import { PolicyRef } from "./policy/spec.js";
-import { TestSpecRef } from "./tests/spec.js";
-import { CapabilityKind, CapabilityMeta, CapabilityRef, CapabilityRequirement, CapabilitySpec, CapabilitySurface, CapabilitySurfaceRef } from "./capabilities/capabilities.js";
-import { EmitDecl, EmitDeclInline, EmitDeclRef, ImplementationRef, ImplementationType, OpKind, OperationSpec, OperationSpecMeta, TelemetryTrigger } from "./operations/operation.js";
-import "./registry-utils.js";
-import "./telemetry/index.js";
-import { PresentationTarget } from "./presentations/presentations.js";
-import "./presentations/index.js";
-import "./capabilities/index.js";
-import { ExperimentRef } from "./experiments/spec.js";
-import "./install.js";
-import "./data-views/index.js";
-import "./operations/index.js";
-import { DataViewRef, EventRef, FeatureModuleMeta, FeatureModuleSpec, FormRef, OpRef, PresentationRef } from "./features/types.js";
-import "./features/index.js";
-import "./themes.js";
-import "./app-config/spec.js";
-import "./app-config/runtime.js";
-import "./experiments/spec-resolver.js";
-import "./types.js";
-import "./forms/index.js";
-import { DocId } from "./docs/registry.js";
-import "./docs/index.js";
-import { Owner, OwnerShipMeta, OwnersEnum, Stability, StabilityEnum, Tag, TagsEnum } from "./ownership.js";
-import { EventSpec, EventSpecMeta } from "./events.js";
-import "./client/index.js";
-import "./prompt.js";
-import "./promptRegistry.js";
-import "./server/index.js";
-import "./contract-registry/index.js";
-import "./jsonschema.js";
-import "./openapi.js";
-import "./model-registry.js";
-import "./onboarding-base.js";
-import "./policy/index.js";
-import "./migrations.js";
-import "./tests/index.js";
-import "./experiments/evaluator.js";
-import "./integrations/index.js";
-import "./knowledge/index.js";
-import "./integrations/operations.js";
-import "./knowledge/operations.js";
-import "./regenerator/index.js";
-import "./workspace-config/index.js";
-import "./workflow/index.js";
-import "./schema-to-markdown.js";
-import "./llm/index.js";
-import "./app-config/validation.js";
-import "./examples/index.js";
-import "./serialization/index.js";

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

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

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

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

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

@@ -1,6 +0,0 @@
-import "./spec.js";
-import "./connection.js";
-import "./providers/index.js";
-import "./openbanking/models.js";
-import "./openbanking/contracts/index.js";
-import "./openbanking/guards.js";

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

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

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

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

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

@@ -1,5 +0,0 @@
-import "../../../operations/registry.js";
-import "./accounts.js";
-import "./transactions.js";
-import "./balances.js";
-import "../openbanking.feature.js";

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

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

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

@@ -1 +0,0 @@
-import "../../app-config/runtime.js";

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

@@ -1 +0,0 @@
-import "../../../../schema/src/index.js";

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

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

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

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

package/dist/contracts/src/integrations/providers/elevenlabs.d.ts

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

package/dist/contracts/src/integrations/providers/gcs-storage.d.ts

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

package/dist/contracts/src/integrations/providers/gmail.d.ts

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

package/dist/contracts/src/integrations/providers/google-calendar.d.ts

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

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

@@ -1,11 +0,0 @@
-import "./stripe.js";
-import "./postmark.js";
-import "./qdrant.js";
-import "./mistral.js";
-import "./elevenlabs.js";
-import "./gmail.js";
-import "./google-calendar.js";
-import "./twilio-sms.js";
-import "./gcs-storage.js";
-import "./powens.js";
-import "./registry.js";

package/dist/contracts/src/integrations/providers/mistral.d.ts

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

package/dist/contracts/src/integrations/providers/postmark.d.ts

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

package/dist/contracts/src/integrations/providers/powens.d.ts

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

package/dist/contracts/src/integrations/providers/qdrant.d.ts

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

package/dist/contracts/src/integrations/providers/registry.d.ts

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

package/dist/contracts/src/integrations/providers/stripe.d.ts

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

package/dist/contracts/src/integrations/providers/twilio-sms.d.ts

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

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

@@ -1,3 +0,0 @@
-import "../registry.js";
-import "../capabilities/index.js";
-import "../ownership.js";

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

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

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

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

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

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

package/dist/contracts/src/knowledge/spaces/email-threads.d.ts

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

package/dist/contracts/src/knowledge/spaces/financial-docs.d.ts

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

package/dist/contracts/src/knowledge/spaces/financial-overview.d.ts

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

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

@@ -1,6 +0,0 @@
-import "./product-canon.js";
-import "./support-faq.js";
-import "./email-threads.js";
-import "./uploaded-docs.js";
-import "./financial-docs.js";
-import "./financial-overview.js";

package/dist/contracts/src/knowledge/spaces/product-canon.d.ts

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

package/dist/contracts/src/knowledge/spaces/support-faq.d.ts

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

package/dist/contracts/src/knowledge/spaces/uploaded-docs.d.ts

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

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

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

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

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

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

@@ -1,3 +0,0 @@
-import "./types.js";
-import "./exporters.js";
-import "./prompts.js";

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

@@ -1,2 +0,0 @@
-import "../operations/index.js";
-import "./types.js";

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

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

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

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

package/dist/contracts/src/model-registry.d.ts

@@ -1 +0,0 @@
-import "../../schema/src/index.js";

package/dist/contracts/src/onboarding-base.d.ts

@@ -1,2 +0,0 @@
-import "../../schema/src/index.js";
-import "./index.js";

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

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

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

@@ -1,3 +0,0 @@
-import { EmitDecl, EmitDeclInline, EmitDeclRef, ImplementationRef, ImplementationType, OpKind, OperationSpec, OperationSpecMeta, TelemetryTrigger } from "./operation.js";
-import "./report/index.js";
-import "./registry.js";

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

@@ -1,176 +0,0 @@
-import { AnySchemaModel } from "../../../schema/src/SchemaModel.js";
-import "../../../schema/src/index.js";
-import { ResourceRefDescriptor } from "../resources.js";
-import { PolicyRef } from "../policy/spec.js";
-import { TestSpecRef } from "../tests/spec.js";
-import { CapabilityRef } from "../capabilities/capabilities.js";
-import { OwnerShipMeta } from "../ownership.js";
-import { EventSpec } from "../events.js";
-
-//#region ../contracts/src/operations/operation.d.ts
-
-/**
- * Distinguishes between state-changing operations (command) and read-only operations (query).
- */
-type OpKind = 'command' | 'query';
-/**
- * Type of implementation artifact.
- */
-type ImplementationType = 'handler' | 'component' | 'form' | 'test' | 'service' | 'hook' | 'other';
-/**
- * Reference to an implementation file for a spec.
- * Used for explicit implementation mapping.
- */
-interface ImplementationRef {
-  /** Path to implementation file (relative to workspace root) */
-  path: string;
-  /** Type of implementation artifact */
-  type: ImplementationType;
-  /** Optional human-readable description */
-  description?: string;
-}
-interface EmitDeclRef {
-  ref: EventSpec<AnySchemaModel>['meta'];
-  when: string;
-}
-interface EmitDeclInline {
-  key: string;
-  version: string;
-  when: string;
-  payload: AnySchemaModel;
-}
-/**
- * Declaration of an event that an operation may emit.
- * Can be a reference to an `EventSpec` or an inline definition.
- */
-type EmitDecl = EmitDeclRef | EmitDeclInline;
-interface TelemetryTrigger {
-  event: {
-    key: string;
-    version?: string;
-  };
-  properties?: (args: {
-    input: unknown;
-    output?: unknown;
-    error?: unknown;
-  }) => Record<string, unknown>;
-}
-interface OperationSpecMeta extends OwnerShipMeta {
-  kind: OpKind;
-  /** Business goal: why this exists */
-  goal: string;
-  /** Background, constraints, scope edges (feeds docs & LLM context) */
-  context: string;
-}
-/**
- * The core specification interface for any operation (Command or Query).
- *
- * @template Input - The Zod-backed schema model for the input payload.
- * @template Output - The Zod-backed schema model for the output payload, or a resource reference.
- * @template Events - Tuple of events that this operation may emit.
- */
-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;
-    /** Zod schema for URL path parameters */
-    params?: AnySchemaModel;
-    /** Zod schema for query string parameters */
-    query?: AnySchemaModel;
-    /** Zod schema for HTTP headers */
-    headers?: AnySchemaModel;
-    /** Zod schema for output payload */
-    output: Output;
-    /** Named, typed errors this op may throw (optional) */
-    errors?: Record<string, {
-      description: string;
-      http?: number;
-      gqlCode?: string;
-      when: string;
-    }>;
-  };
-  policy: {
-    /** Minimal auth category allowed to call this op */
-    auth: 'anonymous' | 'user' | 'admin';
-    /** Idempotency hint. Queries default true; commands default false. */
-    idempotent?: boolean;
-    /** Soft rate limit suggestion; adapter enforces via limiter */
-    rateLimit?: {
-      rpm: number;
-      key: 'user' | 'org' | 'global';
-    };
-    /** Feature flags that must be ON for this op to run */
-    flags?: string[];
-    /** Whether a human must approve before action (e.g., risky commands) */
-    escalate?: 'human_review' | null;
-    /** JSONPath-like pointers to redact from logs/prompts */
-    pii?: string[];
-    /** Referenced policy specs governing access */
-    policies?: PolicyRef[];
-    /** Field-level overrides referencing policy specs */
-    fieldPolicies?: {
-      field: string;
-      actions: ('read' | 'write')[];
-      policy?: PolicyRef;
-    }[];
-  };
-  sideEffects?: {
-    /** Declared events this op may emit; runtime will guard against others */
-    emits?: Events;
-    /** Analytics intents (names); the service decides the sink */
-    analytics?: string[];
-    /** Audit intents (labels); the service decides storage */
-    audit?: string[];
-  };
-  telemetry?: {
-    success?: TelemetryTrigger;
-    failure?: TelemetryTrigger;
-  };
-  tests?: TestSpecRef[];
-  transport?: {
-    rest?: {
-      /** Override HTTP method (default: POST for commands, GET for queries) */
-      method?: 'GET' | 'POST';
-      /** Override path (default derived from meta.name/version) */
-      path?: string;
-    };
-    gql?: {
-      /** Override field name (default: dots→underscores + _vN) */
-      field?: string;
-      returns?: string;
-    };
-    mcp?: {
-      /** Override tool identifier (default: "<name>.v<version>") */
-      toolName?: string;
-    };
-  };
-  acceptance?: {
-    /** Gherkin-lite scenarios for docs & auto tests */
-    scenarios?: {
-      key: string;
-      given: string[];
-      when: string[];
-      then: string[];
-    }[];
-    /** Request/response examples (used for docs & snapshot tests) */
-    examples?: {
-      key: string;
-      input: unknown;
-      output: unknown;
-    }[];
-  };
-  /**
-   * Explicit implementation file mappings.
-   * Used for tracking and verifying that this spec is correctly implemented.
-   */
-  implementations?: ImplementationRef[];
-}
-//#endregion
-export { EmitDecl, EmitDeclInline, EmitDeclRef, ImplementationRef, ImplementationType, OpKind, OperationSpec, OperationSpecMeta, TelemetryTrigger };
-//# sourceMappingURL=operation.d.ts.map

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

@@ -1 +0,0 @@
-{"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/operations/registry.d.ts

@@ -1,6 +0,0 @@
-import "../../../schema/src/index.js";
-import "../resources.js";
-import "./operation.js";
-import "../registry.js";
-import "../install.js";
-import "../types.js";

package/dist/contracts/src/operations/report/getContractVerificationStatus.d.ts

@@ -1,3 +0,0 @@
-import "../../../../schema/src/index.js";
-import "../index.js";
-import "zod";

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

@@ -1,4 +0,0 @@
-import "./getContractVerificationStatus.js";
-import "../../install.js";
-import "../../data-views/report/contractVerificationTable.js";
-import "../registry.js";