@fabricorg/platform 0.9.0 → 0.11.0

package/dist/index.d.cts

@@ -2,11 +2,12 @@ export { ACTOR_TYPES, ActionContext, ActionDefinition, ActionHandler, ActionId,
 export { AdapterAttempt, AdapterCircuitBreakerConfig, AdapterExecutionContext, AdapterExecutionResult, AdapterExecutor, AdapterImplementation, AdapterRegistry, AdapterRetryPolicy, ExecuteWithRetryOptions, MissingAdapterRegistrationError, ResolvedAdapterRetryPolicy, executeWithAdapterRetry, getRetryDelayMs, resolveAdapterRetryPolicy } from './adapters/index.cjs';
 export { AssetEventActorType, AssetEventEnvelope, AssetEventSubjectType, AssetEventType, EventTypeRegistry, createEventTypeRegistry, getRegisteredEventTypes, getRegisteredSubjectTypes, isValidEventType, isValidSubjectType, registerEventType, registerSubjectType } from './events/index.cjs';
 export { FABRIC_ID_PREFIXES, FabricIdPrefix, createFabricId, isFabricId, parseFabricId } from './ids/index.cjs';
-export { EventTypeRegistration, EventTypeRegistrationInput, FabricModule, IdPrefixRegistration, ModuleDependency, ModuleDependencyInput, ModuleDisplayRendererRegistration, ModuleRegistry, ObjectTypeRegistration, ObjectTypeRegistrationInput, PolicyRegistration, StateMachineRegistration, createModuleRegistry, getEventTypeName, getModuleDependencyNamespace, getObjectTypeName, registerFabricModule, registerFabricModules, validateModuleNamespace } from './modules/index.cjs';
-export { FabricObjectType, assertObjectType, getRegisteredObjectTypes, isValidObjectType, registerObjectType } from './objects/index.cjs';
+export { JsonSchemaExportableValidator, MODULE_MANIFEST_VERSION, ModuleManifest, ModuleManifestAction, ModuleManifestActionStateMachine, ModuleManifestActionV1, ModuleManifestAdapterStep, ModuleManifestBundle, ModuleManifestBundleV1, ModuleManifestCodePolicy, ModuleManifestDataPolicy, ModuleManifestEventType, ModuleManifestIdPrefix, ModuleManifestObjectType, ModuleManifestObjectTypeV1, ModuleManifestPolicy, ModuleManifestStateMachine, ModuleManifestStateMachineTransition, ModuleManifestV1, ModuleManifestView, exportModuleManifest, exportModuleManifestBundle, isJsonSchemaExportableValidator, normalizeModuleManifest, normalizeModuleManifestBundle } from './manifest/index.cjs';
+export { CapabilityMetadata, CapabilitySlotDefinition, DeclarativeInvariant, EventTypeRegistration, EventTypeRegistrationInput, FabricModule, IdPrefixRegistration, InvariantEnforcement, ModuleDependency, ModuleDependencyInput, ModuleDisplayRendererRegistration, ModuleRegistry, ObjectRelationCardinality, ObjectRelationDefinition, ObjectRelationDeleteBehavior, ObjectRelationSemantics, ObjectTypeRegistration, ObjectTypeRegistrationInput, PolicyRegistration, StateMachineRegistration, createModuleRegistry, getEventTypeName, getModuleDependencyNamespace, getObjectTypeName, registerFabricModule, registerFabricModules, validateModuleNamespace } from './modules/index.cjs';
+export { FabricObjectType, JsonPrimitive, JsonValue, PortableJsonSchema, assertObjectType, assertPortableJsonSchema, getRegisteredObjectTypes, isValidObjectType, registerObjectType } from './objects/index.cjs';
 export { DataPolicyComparisonOperator, DataPolicyCondition, DataPolicyConditionResult, DataPolicyDefinition, DataPolicyLiteral, DataPolicySource, DataPolicySourceReference, DataPolicyValidationResult, PolicyContext, PolicyCorrectiveAction, PolicyCorrectiveActionBase, PolicyCorrectiveActionKind, PolicyDispatchEvidence, PolicyEvaluationMode, PolicyEvaluationResult, PolicyEvaluator, PolicyFact, PolicyFallbackDefinition, PolicyFallbackTrigger, PolicyGuidance, PolicyGuidanceValidationResult, PolicyId, PolicyInvokeActionCorrectiveAction, PolicyKind, PolicyManualCorrectiveAction, PolicyNavigateCorrectiveAction, PolicyOutcome, RuntimePolicyDefinition, aggregatePolicyOutcomes, assertPolicyId, evaluatePolicyDefinition, evaluatePolicyDefinitions, evaluateRegisteredPolicies, getRegisteredPolicyIds, registerPolicy, registerPolicyIfMissing, resolvePolicy, validateDataPolicyDefinition, validatePolicyGuidance } from './policies/index.cjs';
 export { StateClass, StateDefinition, StateMachineDatabaseClient, StateMachineDefinition, TransitionContext, getAllowedTransitions, getEntityStateClass, registerStateMachine, registerStateMachineIfMissing, resolveStateMachine, validateTransition } from './state-machines/index.cjs';
-export { ReplayEventsOptions, ReplayEventsResult, ReplayScope, ReplaySnapshot, ReplayWarning, ReplayWarningCode, ReplayableAssetEvent, replayEvents } from './projections/index.cjs';
+export { ReplayEventsOptions, ReplayEventsResult, ReplayScope, ReplaySnapshot, ReplayViewOptions, ReplayWarning, ReplayWarningCode, ReplayableAssetEvent, ViewContract, ViewEventConsumption, getRegisteredViewContractKeys, registerViewContract, registerViewContractIfMissing, replayEvents, replayView, resolveViewContract, viewContractKey } from './projections/index.cjs';
 export { CachedDisplayDescriptor, DisplayContext, DisplayDatabaseClient, DisplayDescriptor, DisplayRenderer, DisplayRendererRegistration, denormalizeDisplaySnapshot, registerDisplayRenderer, renderEventDisplay, resolveDisplayRenderer } from './displays/index.cjs';
 export { ANONYMIZATION_POLICY_VERSION, AnalyticsDataContract, AnalyticsDataContractSource, AnalyticsEligibilityDecision, AnonymizationContext, AnonymizationEngine, AnonymizationFieldMetadata, AnonymizationLifecycleEvidence, AnonymizationMetadata, AnonymizationResult, AssetEventLike, DataClassificationRule, EvidencePacketLike, FieldRedactor, PLATFORM_PRIVACY_POLICY_VERSION, PlatformDataClass, RedactionMethod, RedactionRule, RetentionRule, anonymizeAssetEventPayload, anonymizeEvidencePacket, anonymizeJsonValue, buildAnonymizationLifecycleEvidence, stableChecksum } from './privacy/index.cjs';
 export { EvidenceGenerationContext, EvidencePacketEnvelope, EvidencePacketReference, EvidencePacketStatus, EvidencePacketSubject, EvidenceRenderer } from './evidence/index.cjs';

package/dist/index.d.ts

@@ -2,11 +2,12 @@ export { ACTOR_TYPES, ActionContext, ActionDefinition, ActionHandler, ActionId,
 export { AdapterAttempt, AdapterCircuitBreakerConfig, AdapterExecutionContext, AdapterExecutionResult, AdapterExecutor, AdapterImplementation, AdapterRegistry, AdapterRetryPolicy, ExecuteWithRetryOptions, MissingAdapterRegistrationError, ResolvedAdapterRetryPolicy, executeWithAdapterRetry, getRetryDelayMs, resolveAdapterRetryPolicy } from './adapters/index.js';
 export { AssetEventActorType, AssetEventEnvelope, AssetEventSubjectType, AssetEventType, EventTypeRegistry, createEventTypeRegistry, getRegisteredEventTypes, getRegisteredSubjectTypes, isValidEventType, isValidSubjectType, registerEventType, registerSubjectType } from './events/index.js';
 export { FABRIC_ID_PREFIXES, FabricIdPrefix, createFabricId, isFabricId, parseFabricId } from './ids/index.js';
-export { EventTypeRegistration, EventTypeRegistrationInput, FabricModule, IdPrefixRegistration, ModuleDependency, ModuleDependencyInput, ModuleDisplayRendererRegistration, ModuleRegistry, ObjectTypeRegistration, ObjectTypeRegistrationInput, PolicyRegistration, StateMachineRegistration, createModuleRegistry, getEventTypeName, getModuleDependencyNamespace, getObjectTypeName, registerFabricModule, registerFabricModules, validateModuleNamespace } from './modules/index.js';
-export { FabricObjectType, assertObjectType, getRegisteredObjectTypes, isValidObjectType, registerObjectType } from './objects/index.js';
+export { JsonSchemaExportableValidator, MODULE_MANIFEST_VERSION, ModuleManifest, ModuleManifestAction, ModuleManifestActionStateMachine, ModuleManifestActionV1, ModuleManifestAdapterStep, ModuleManifestBundle, ModuleManifestBundleV1, ModuleManifestCodePolicy, ModuleManifestDataPolicy, ModuleManifestEventType, ModuleManifestIdPrefix, ModuleManifestObjectType, ModuleManifestObjectTypeV1, ModuleManifestPolicy, ModuleManifestStateMachine, ModuleManifestStateMachineTransition, ModuleManifestV1, ModuleManifestView, exportModuleManifest, exportModuleManifestBundle, isJsonSchemaExportableValidator, normalizeModuleManifest, normalizeModuleManifestBundle } from './manifest/index.js';
+export { CapabilityMetadata, CapabilitySlotDefinition, DeclarativeInvariant, EventTypeRegistration, EventTypeRegistrationInput, FabricModule, IdPrefixRegistration, InvariantEnforcement, ModuleDependency, ModuleDependencyInput, ModuleDisplayRendererRegistration, ModuleRegistry, ObjectRelationCardinality, ObjectRelationDefinition, ObjectRelationDeleteBehavior, ObjectRelationSemantics, ObjectTypeRegistration, ObjectTypeRegistrationInput, PolicyRegistration, StateMachineRegistration, createModuleRegistry, getEventTypeName, getModuleDependencyNamespace, getObjectTypeName, registerFabricModule, registerFabricModules, validateModuleNamespace } from './modules/index.js';
+export { FabricObjectType, JsonPrimitive, JsonValue, PortableJsonSchema, assertObjectType, assertPortableJsonSchema, getRegisteredObjectTypes, isValidObjectType, registerObjectType } from './objects/index.js';
 export { DataPolicyComparisonOperator, DataPolicyCondition, DataPolicyConditionResult, DataPolicyDefinition, DataPolicyLiteral, DataPolicySource, DataPolicySourceReference, DataPolicyValidationResult, PolicyContext, PolicyCorrectiveAction, PolicyCorrectiveActionBase, PolicyCorrectiveActionKind, PolicyDispatchEvidence, PolicyEvaluationMode, PolicyEvaluationResult, PolicyEvaluator, PolicyFact, PolicyFallbackDefinition, PolicyFallbackTrigger, PolicyGuidance, PolicyGuidanceValidationResult, PolicyId, PolicyInvokeActionCorrectiveAction, PolicyKind, PolicyManualCorrectiveAction, PolicyNavigateCorrectiveAction, PolicyOutcome, RuntimePolicyDefinition, aggregatePolicyOutcomes, assertPolicyId, evaluatePolicyDefinition, evaluatePolicyDefinitions, evaluateRegisteredPolicies, getRegisteredPolicyIds, registerPolicy, registerPolicyIfMissing, resolvePolicy, validateDataPolicyDefinition, validatePolicyGuidance } from './policies/index.js';
 export { StateClass, StateDefinition, StateMachineDatabaseClient, StateMachineDefinition, TransitionContext, getAllowedTransitions, getEntityStateClass, registerStateMachine, registerStateMachineIfMissing, resolveStateMachine, validateTransition } from './state-machines/index.js';
-export { ReplayEventsOptions, ReplayEventsResult, ReplayScope, ReplaySnapshot, ReplayWarning, ReplayWarningCode, ReplayableAssetEvent, replayEvents } from './projections/index.js';
+export { ReplayEventsOptions, ReplayEventsResult, ReplayScope, ReplaySnapshot, ReplayViewOptions, ReplayWarning, ReplayWarningCode, ReplayableAssetEvent, ViewContract, ViewEventConsumption, getRegisteredViewContractKeys, registerViewContract, registerViewContractIfMissing, replayEvents, replayView, resolveViewContract, viewContractKey } from './projections/index.js';
 export { CachedDisplayDescriptor, DisplayContext, DisplayDatabaseClient, DisplayDescriptor, DisplayRenderer, DisplayRendererRegistration, denormalizeDisplaySnapshot, registerDisplayRenderer, renderEventDisplay, resolveDisplayRenderer } from './displays/index.js';
 export { ANONYMIZATION_POLICY_VERSION, AnalyticsDataContract, AnalyticsDataContractSource, AnalyticsEligibilityDecision, AnonymizationContext, AnonymizationEngine, AnonymizationFieldMetadata, AnonymizationLifecycleEvidence, AnonymizationMetadata, AnonymizationResult, AssetEventLike, DataClassificationRule, EvidencePacketLike, FieldRedactor, PLATFORM_PRIVACY_POLICY_VERSION, PlatformDataClass, RedactionMethod, RedactionRule, RetentionRule, anonymizeAssetEventPayload, anonymizeEvidencePacket, anonymizeJsonValue, buildAnonymizationLifecycleEvidence, stableChecksum } from './privacy/index.js';
 export { EvidenceGenerationContext, EvidencePacketEnvelope, EvidencePacketReference, EvidencePacketStatus, EvidencePacketSubject, EvidenceRenderer } from './evidence/index.js';

package/dist/index.js

@@ -1,12 +1,13 @@
+export { createDeterministicIdFactory, createFakeActionContext, createInMemoryAdapterRegistry } from './chunk-IFMZPLM4.js';
 export { FABRIC_ID_PREFIXES, createFabricId, isFabricId, parseFabricId } from './chunk-RALMUSOX.js';
-export { createModuleRegistry, getEventTypeName, getModuleDependencyNamespace, getObjectTypeName, registerFabricModule, registerFabricModules, validateModuleNamespace } from './chunk-35DD3H55.js';
-export { assertObjectType, getRegisteredObjectTypes, isValidObjectType, registerObjectType } from './chunk-I35B576X.js';
+export { MODULE_MANIFEST_VERSION, exportModuleManifest, exportModuleManifestBundle, isJsonSchemaExportableValidator, normalizeModuleManifest, normalizeModuleManifestBundle } from './chunk-NFP5DJBT.js';
+export { createModuleRegistry, getEventTypeName, getModuleDependencyNamespace, getObjectTypeName, registerFabricModule, registerFabricModules, validateModuleNamespace } from './chunk-3JQI3OFC.js';
+export { assertObjectType, assertPortableJsonSchema, getRegisteredObjectTypes, isValidObjectType, registerObjectType } from './chunk-3S6UTP4X.js';
 export { aggregatePolicyOutcomes, assertPolicyId, evaluatePolicyDefinition, evaluatePolicyDefinitions, evaluateRegisteredPolicies, getRegisteredPolicyIds, registerPolicy, registerPolicyIfMissing, resolvePolicy, validateDataPolicyDefinition, validatePolicyGuidance } from './chunk-6ER62UUN.js';
 export { ANONYMIZATION_POLICY_VERSION, AnonymizationEngine, FieldRedactor, PLATFORM_PRIVACY_POLICY_VERSION, anonymizeAssetEventPayload, anonymizeEvidencePacket, anonymizeJsonValue, buildAnonymizationLifecycleEvidence, stableChecksum } from './chunk-X7WC4AYC.js';
-export { replayEvents } from './chunk-JSTGOT6P.js';
+export { getRegisteredViewContractKeys, registerViewContract, registerViewContractIfMissing, replayEvents, replayView, resolveViewContract, viewContractKey } from './chunk-7WASIL46.js';
 export { getAllowedTransitions, getEntityStateClass, registerStateMachine, registerStateMachineIfMissing, resolveStateMachine, validateTransition } from './chunk-T2JLSZN6.js';
-export { createDeterministicIdFactory, createFakeActionContext, createInMemoryAdapterRegistry } from './chunk-IFMZPLM4.js';
-export { ACTOR_TYPES, assertActionId, assertActorType, getRegisteredActionIds, isActorType, isRegisteredActionId, registerAction, registerActionIfMissing, resolveAction, resolveRegisteredAction } from './chunk-4SMPJPJ6.js';
+export { ACTOR_TYPES, assertActionId, assertActorType, getRegisteredActionIds, isActorType, isRegisteredActionId, registerAction, registerActionIfMissing, resolveAction, resolveRegisteredAction } from './chunk-JM55UQWK.js';
 export { AdapterRegistry, MissingAdapterRegistrationError, executeWithAdapterRetry, getRetryDelayMs, resolveAdapterRetryPolicy } from './chunk-3ZW5USXF.js';
 export { AgentActionPolicyRegistry } from './chunk-OFCCZ27Z.js';
 export { denormalizeDisplaySnapshot, registerDisplayRenderer, renderEventDisplay, resolveDisplayRenderer } from './chunk-O5WVBQ7P.js';

package/dist/manifest/index.cjs

@@ -0,0 +1,40 @@
+'use strict';
+
+var chunkRYCHDNHZ_cjs = require('../chunk-RYCHDNHZ.cjs');
+require('../chunk-ODP3DO6P.cjs');
+require('../chunk-XCL2HBMB.cjs');
+require('../chunk-NJL3US7H.cjs');
+require('../chunk-O7IHZ53Y.cjs');
+require('../chunk-UV252FLT.cjs');
+require('../chunk-HLRIXNVG.cjs');
+require('../chunk-EO4VSB2O.cjs');
+require('../chunk-JAXDEK5Z.cjs');
+
+
+
+Object.defineProperty(exports, "MODULE_MANIFEST_VERSION", {
+  enumerable: true,
+  get: function () { return chunkRYCHDNHZ_cjs.MODULE_MANIFEST_VERSION; }
+});
+Object.defineProperty(exports, "exportModuleManifest", {
+  enumerable: true,
+  get: function () { return chunkRYCHDNHZ_cjs.exportModuleManifest; }
+});
+Object.defineProperty(exports, "exportModuleManifestBundle", {
+  enumerable: true,
+  get: function () { return chunkRYCHDNHZ_cjs.exportModuleManifestBundle; }
+});
+Object.defineProperty(exports, "isJsonSchemaExportableValidator", {
+  enumerable: true,
+  get: function () { return chunkRYCHDNHZ_cjs.isJsonSchemaExportableValidator; }
+});
+Object.defineProperty(exports, "normalizeModuleManifest", {
+  enumerable: true,
+  get: function () { return chunkRYCHDNHZ_cjs.normalizeModuleManifest; }
+});
+Object.defineProperty(exports, "normalizeModuleManifestBundle", {
+  enumerable: true,
+  get: function () { return chunkRYCHDNHZ_cjs.normalizeModuleManifestBundle; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/manifest/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/manifest/index.d.cts

@@ -0,0 +1,181 @@
+import { SchemaValidator, AdapterStepRetryPolicy } from '../actions/index.cjs';
+import { CapabilityMetadata, ModuleDependency, ObjectRelationDefinition, DeclarativeInvariant, FabricModule } from '../modules/index.cjs';
+import { PortableJsonSchema, JsonValue } from '../objects/index.cjs';
+import { PolicyKind, DataPolicyDefinition, PolicyFallbackDefinition } from '../policies/index.cjs';
+import { StateDefinition } from '../state-machines/index.cjs';
+import '../displays/index.cjs';
+import '../projections/index.cjs';
+
+/**
+ * Version of the module manifest contract. Bump when the serialized shape
+ * changes in a way consumers must detect.
+ */
+declare const MODULE_MANIFEST_VERSION: 2;
+interface ModuleManifestObjectType {
+    type: string;
+    displayName?: string;
+    idPrefix?: string;
+    schema?: PortableJsonSchema;
+    semantics?: Record<string, JsonValue>;
+    relations?: ObjectRelationDefinition[];
+    invariants?: DeclarativeInvariant[];
+}
+interface ModuleManifestIdPrefix {
+    prefix: string;
+    name: string;
+}
+interface ModuleManifestEventType {
+    eventType: string;
+    schemaVersion: number;
+    description?: string;
+}
+interface ModuleManifestActionStateMachine {
+    entityType: string;
+    /** Present only when the binding declares a static target state. */
+    targetState?: string;
+}
+interface ModuleManifestAdapterStep {
+    adapterType: string;
+    operation: string;
+    retryPolicy?: AdapterStepRetryPolicy;
+}
+interface ModuleManifestAction {
+    actionId: string;
+    version: number;
+    kind: "atomic" | "saga";
+    idempotent: boolean;
+    mutatesDomain: boolean;
+    emitsEvents: string[];
+    policies?: string[];
+    requiredRoles?: string[];
+    requiredPermissions?: string[];
+    eventPhase?: "before_adapters" | "after_adapters";
+    /**
+     * JSON Schema for the action parameters, present only when the action's
+     * `schema` validator implements {@link JsonSchemaExportableValidator}.
+     */
+    parameterSchema?: unknown;
+    parameterSchemaFormat?: "json-schema";
+    resultSchema?: unknown;
+    resultSchemaFormat?: "json-schema";
+    stateMachine?: ModuleManifestActionStateMachine;
+    adapterSteps?: ModuleManifestAdapterStep[];
+}
+interface ModuleManifestCodePolicy {
+    type: "code";
+    policyId: string;
+    version: number;
+    previewSafe?: boolean;
+}
+interface ModuleManifestDataPolicy {
+    type: "data";
+    policyId: string;
+    policyVersion: number;
+    kind: PolicyKind;
+    dataDefinition?: DataPolicyDefinition;
+    codeEvaluatorPolicyId?: string;
+    fallback?: PolicyFallbackDefinition;
+}
+type ModuleManifestPolicy = ModuleManifestCodePolicy | ModuleManifestDataPolicy;
+interface ModuleManifestStateMachineTransition {
+    from: string;
+    to: string;
+    causedByAction: string;
+    /** `true` when the transition declares a guard function. The guard itself is never serialized. */
+    hasGuard: boolean;
+}
+interface ModuleManifestStateMachine {
+    entityType: string;
+    /** States in declaration order (`Object.values` order of the definition record). */
+    states: StateDefinition[];
+    transitions: ModuleManifestStateMachineTransition[];
+}
+interface ModuleManifestView {
+    name: string;
+    version: string;
+    shape: PortableJsonSchema;
+    consumes: Array<{
+        eventType: string;
+        schemaVersions: number[];
+    }>;
+    scope: "tenant-space";
+    snapshotVersion: number;
+    compatibleSnapshotVersions?: number[];
+}
+/**
+ * Stable, JSON-serializable description of a {@link FabricModule}'s ontology:
+ * object types, subject types, id prefixes, event types, actions, policies,
+ * and state machines. Intended for downstream tooling (semantics exporters,
+ * docs generators, tool generators) that cannot consume live module code.
+ *
+ * The manifest contains definitions only — never raw parameter values,
+ * secrets, or runtime data. Function fields (`handler`, `evaluate`, `guard`,
+ * dynamic `targetState`, adapter `getInput`) are never serialized.
+ */
+interface ModuleManifest {
+    manifestVersion: typeof MODULE_MANIFEST_VERSION;
+    namespace: string;
+    version?: string;
+    displayName?: string;
+    description?: string;
+    capability?: CapabilityMetadata;
+    dependencies: ModuleDependency[];
+    objectTypes: ModuleManifestObjectType[];
+    subjectTypes: string[];
+    idPrefixes: ModuleManifestIdPrefix[];
+    eventTypes: ModuleManifestEventType[];
+    actions: ModuleManifestAction[];
+    policies: ModuleManifestPolicy[];
+    stateMachines: ModuleManifestStateMachine[];
+    views: ModuleManifestView[];
+}
+interface ModuleManifestBundle {
+    manifestVersion: typeof MODULE_MANIFEST_VERSION;
+    /** Manifests in the input module order. */
+    modules: ModuleManifest[];
+}
+/** Manifest v1 remains accepted by v2 readers; missing v2 fields normalize to absence. */
+type ModuleManifestObjectTypeV1 = Omit<ModuleManifestObjectType, "schema" | "semantics" | "relations" | "invariants">;
+type ModuleManifestActionV1 = Omit<ModuleManifestAction, "resultSchema" | "resultSchemaFormat">;
+type ModuleManifestV1 = Omit<ModuleManifest, "manifestVersion" | "objectTypes" | "actions" | "views"> & {
+    manifestVersion: 1;
+    objectTypes: ModuleManifestObjectTypeV1[];
+    actions: ModuleManifestActionV1[];
+};
+type ModuleManifestBundleV1 = Omit<ModuleManifestBundle, "manifestVersion" | "modules"> & {
+    manifestVersion: 1;
+    modules: ModuleManifestV1[];
+};
+declare function normalizeModuleManifest(manifest: ModuleManifest | ModuleManifestV1): ModuleManifest;
+declare function normalizeModuleManifestBundle(bundle: ModuleManifestBundle | ModuleManifestBundleV1): ModuleManifestBundle;
+/**
+ * A {@link SchemaValidator} that can also export its parameter schema as JSON
+ * Schema (for example a Zod 4 schema via `z.toJSONSchema`). Keeps the platform
+ * zero-dependency while letting schema-bearing actions flow into manifests.
+ */
+interface JsonSchemaExportableValidator extends SchemaValidator {
+    toJSONSchema(): Record<string, unknown>;
+}
+declare function isJsonSchemaExportableValidator(schema: SchemaValidator): schema is JsonSchemaExportableValidator;
+/**
+ * Export a stable, JSON-serializable manifest of a module's ontology.
+ *
+ * This is a pure function of the module object: it does not read or mutate the
+ * global module/action/policy/state-machine registries, and the module does
+ * not need to be registered first. Declaration order is preserved everywhere
+ * (nothing is sorted), so the same module object always produces a
+ * byte-identical `JSON.stringify` result.
+ *
+ * The manifest contains definitions only — never raw parameter values,
+ * secrets, or runtime data. Function fields are elided (`handler`,
+ * policy `evaluate`, transition `guard` → `hasGuard`, dynamic `targetState`,
+ * adapter `getInput`).
+ */
+declare function exportModuleManifest(module: FabricModule<unknown>): ModuleManifest;
+/**
+ * Export manifests for a set of modules, preserving the input order.
+ * Like {@link exportModuleManifest}, this is pure and registry-free.
+ */
+declare function exportModuleManifestBundle(modules: FabricModule<unknown>[]): ModuleManifestBundle;
+
+export { type JsonSchemaExportableValidator, MODULE_MANIFEST_VERSION, type ModuleManifest, type ModuleManifestAction, type ModuleManifestActionStateMachine, type ModuleManifestActionV1, type ModuleManifestAdapterStep, type ModuleManifestBundle, type ModuleManifestBundleV1, type ModuleManifestCodePolicy, type ModuleManifestDataPolicy, type ModuleManifestEventType, type ModuleManifestIdPrefix, type ModuleManifestObjectType, type ModuleManifestObjectTypeV1, type ModuleManifestPolicy, type ModuleManifestStateMachine, type ModuleManifestStateMachineTransition, type ModuleManifestV1, type ModuleManifestView, exportModuleManifest, exportModuleManifestBundle, isJsonSchemaExportableValidator, normalizeModuleManifest, normalizeModuleManifestBundle };

package/dist/manifest/index.d.ts

@@ -0,0 +1,181 @@
+import { SchemaValidator, AdapterStepRetryPolicy } from '../actions/index.js';
+import { CapabilityMetadata, ModuleDependency, ObjectRelationDefinition, DeclarativeInvariant, FabricModule } from '../modules/index.js';
+import { PortableJsonSchema, JsonValue } from '../objects/index.js';
+import { PolicyKind, DataPolicyDefinition, PolicyFallbackDefinition } from '../policies/index.js';
+import { StateDefinition } from '../state-machines/index.js';
+import '../displays/index.js';
+import '../projections/index.js';
+
+/**
+ * Version of the module manifest contract. Bump when the serialized shape
+ * changes in a way consumers must detect.
+ */
+declare const MODULE_MANIFEST_VERSION: 2;
+interface ModuleManifestObjectType {
+    type: string;
+    displayName?: string;
+    idPrefix?: string;
+    schema?: PortableJsonSchema;
+    semantics?: Record<string, JsonValue>;
+    relations?: ObjectRelationDefinition[];
+    invariants?: DeclarativeInvariant[];
+}
+interface ModuleManifestIdPrefix {
+    prefix: string;
+    name: string;
+}
+interface ModuleManifestEventType {
+    eventType: string;
+    schemaVersion: number;
+    description?: string;
+}
+interface ModuleManifestActionStateMachine {
+    entityType: string;
+    /** Present only when the binding declares a static target state. */
+    targetState?: string;
+}
+interface ModuleManifestAdapterStep {
+    adapterType: string;
+    operation: string;
+    retryPolicy?: AdapterStepRetryPolicy;
+}
+interface ModuleManifestAction {
+    actionId: string;
+    version: number;
+    kind: "atomic" | "saga";
+    idempotent: boolean;
+    mutatesDomain: boolean;
+    emitsEvents: string[];
+    policies?: string[];
+    requiredRoles?: string[];
+    requiredPermissions?: string[];
+    eventPhase?: "before_adapters" | "after_adapters";
+    /**
+     * JSON Schema for the action parameters, present only when the action's
+     * `schema` validator implements {@link JsonSchemaExportableValidator}.
+     */
+    parameterSchema?: unknown;
+    parameterSchemaFormat?: "json-schema";
+    resultSchema?: unknown;
+    resultSchemaFormat?: "json-schema";
+    stateMachine?: ModuleManifestActionStateMachine;
+    adapterSteps?: ModuleManifestAdapterStep[];
+}
+interface ModuleManifestCodePolicy {
+    type: "code";
+    policyId: string;
+    version: number;
+    previewSafe?: boolean;
+}
+interface ModuleManifestDataPolicy {
+    type: "data";
+    policyId: string;
+    policyVersion: number;
+    kind: PolicyKind;
+    dataDefinition?: DataPolicyDefinition;
+    codeEvaluatorPolicyId?: string;
+    fallback?: PolicyFallbackDefinition;
+}
+type ModuleManifestPolicy = ModuleManifestCodePolicy | ModuleManifestDataPolicy;
+interface ModuleManifestStateMachineTransition {
+    from: string;
+    to: string;
+    causedByAction: string;
+    /** `true` when the transition declares a guard function. The guard itself is never serialized. */
+    hasGuard: boolean;
+}
+interface ModuleManifestStateMachine {
+    entityType: string;
+    /** States in declaration order (`Object.values` order of the definition record). */
+    states: StateDefinition[];
+    transitions: ModuleManifestStateMachineTransition[];
+}
+interface ModuleManifestView {
+    name: string;
+    version: string;
+    shape: PortableJsonSchema;
+    consumes: Array<{
+        eventType: string;
+        schemaVersions: number[];
+    }>;
+    scope: "tenant-space";
+    snapshotVersion: number;
+    compatibleSnapshotVersions?: number[];
+}
+/**
+ * Stable, JSON-serializable description of a {@link FabricModule}'s ontology:
+ * object types, subject types, id prefixes, event types, actions, policies,
+ * and state machines. Intended for downstream tooling (semantics exporters,
+ * docs generators, tool generators) that cannot consume live module code.
+ *
+ * The manifest contains definitions only — never raw parameter values,
+ * secrets, or runtime data. Function fields (`handler`, `evaluate`, `guard`,
+ * dynamic `targetState`, adapter `getInput`) are never serialized.
+ */
+interface ModuleManifest {
+    manifestVersion: typeof MODULE_MANIFEST_VERSION;
+    namespace: string;
+    version?: string;
+    displayName?: string;
+    description?: string;
+    capability?: CapabilityMetadata;
+    dependencies: ModuleDependency[];
+    objectTypes: ModuleManifestObjectType[];
+    subjectTypes: string[];
+    idPrefixes: ModuleManifestIdPrefix[];
+    eventTypes: ModuleManifestEventType[];
+    actions: ModuleManifestAction[];
+    policies: ModuleManifestPolicy[];
+    stateMachines: ModuleManifestStateMachine[];
+    views: ModuleManifestView[];
+}
+interface ModuleManifestBundle {
+    manifestVersion: typeof MODULE_MANIFEST_VERSION;
+    /** Manifests in the input module order. */
+    modules: ModuleManifest[];
+}
+/** Manifest v1 remains accepted by v2 readers; missing v2 fields normalize to absence. */
+type ModuleManifestObjectTypeV1 = Omit<ModuleManifestObjectType, "schema" | "semantics" | "relations" | "invariants">;
+type ModuleManifestActionV1 = Omit<ModuleManifestAction, "resultSchema" | "resultSchemaFormat">;
+type ModuleManifestV1 = Omit<ModuleManifest, "manifestVersion" | "objectTypes" | "actions" | "views"> & {
+    manifestVersion: 1;
+    objectTypes: ModuleManifestObjectTypeV1[];
+    actions: ModuleManifestActionV1[];
+};
+type ModuleManifestBundleV1 = Omit<ModuleManifestBundle, "manifestVersion" | "modules"> & {
+    manifestVersion: 1;
+    modules: ModuleManifestV1[];
+};
+declare function normalizeModuleManifest(manifest: ModuleManifest | ModuleManifestV1): ModuleManifest;
+declare function normalizeModuleManifestBundle(bundle: ModuleManifestBundle | ModuleManifestBundleV1): ModuleManifestBundle;
+/**
+ * A {@link SchemaValidator} that can also export its parameter schema as JSON
+ * Schema (for example a Zod 4 schema via `z.toJSONSchema`). Keeps the platform
+ * zero-dependency while letting schema-bearing actions flow into manifests.
+ */
+interface JsonSchemaExportableValidator extends SchemaValidator {
+    toJSONSchema(): Record<string, unknown>;
+}
+declare function isJsonSchemaExportableValidator(schema: SchemaValidator): schema is JsonSchemaExportableValidator;
+/**
+ * Export a stable, JSON-serializable manifest of a module's ontology.
+ *
+ * This is a pure function of the module object: it does not read or mutate the
+ * global module/action/policy/state-machine registries, and the module does
+ * not need to be registered first. Declaration order is preserved everywhere
+ * (nothing is sorted), so the same module object always produces a
+ * byte-identical `JSON.stringify` result.
+ *
+ * The manifest contains definitions only — never raw parameter values,
+ * secrets, or runtime data. Function fields are elided (`handler`,
+ * policy `evaluate`, transition `guard` → `hasGuard`, dynamic `targetState`,
+ * adapter `getInput`).
+ */
+declare function exportModuleManifest(module: FabricModule<unknown>): ModuleManifest;
+/**
+ * Export manifests for a set of modules, preserving the input order.
+ * Like {@link exportModuleManifest}, this is pure and registry-free.
+ */
+declare function exportModuleManifestBundle(modules: FabricModule<unknown>[]): ModuleManifestBundle;
+
+export { type JsonSchemaExportableValidator, MODULE_MANIFEST_VERSION, type ModuleManifest, type ModuleManifestAction, type ModuleManifestActionStateMachine, type ModuleManifestActionV1, type ModuleManifestAdapterStep, type ModuleManifestBundle, type ModuleManifestBundleV1, type ModuleManifestCodePolicy, type ModuleManifestDataPolicy, type ModuleManifestEventType, type ModuleManifestIdPrefix, type ModuleManifestObjectType, type ModuleManifestObjectTypeV1, type ModuleManifestPolicy, type ModuleManifestStateMachine, type ModuleManifestStateMachineTransition, type ModuleManifestV1, type ModuleManifestView, exportModuleManifest, exportModuleManifestBundle, isJsonSchemaExportableValidator, normalizeModuleManifest, normalizeModuleManifestBundle };

package/dist/manifest/index.js

@@ -0,0 +1,11 @@
+export { MODULE_MANIFEST_VERSION, exportModuleManifest, exportModuleManifestBundle, isJsonSchemaExportableValidator, normalizeModuleManifest, normalizeModuleManifestBundle } from '../chunk-NFP5DJBT.js';
+import '../chunk-3JQI3OFC.js';
+import '../chunk-3S6UTP4X.js';
+import '../chunk-6ER62UUN.js';
+import '../chunk-7WASIL46.js';
+import '../chunk-T2JLSZN6.js';
+import '../chunk-JM55UQWK.js';
+import '../chunk-O5WVBQ7P.js';
+import '../chunk-4YQOGV7H.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/manifest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/modules/index.cjs

@@ -1,10 +1,11 @@
 'use strict';
 
-var chunkSSYKDXR4_cjs = require('../chunk-SSYKDXR4.cjs');
-require('../chunk-QETQGAXJ.cjs');
+var chunkODP3DO6P_cjs = require('../chunk-ODP3DO6P.cjs');
+require('../chunk-XCL2HBMB.cjs');
 require('../chunk-NJL3US7H.cjs');
+require('../chunk-O7IHZ53Y.cjs');
 require('../chunk-UV252FLT.cjs');
-require('../chunk-BWNPGRRV.cjs');
+require('../chunk-HLRIXNVG.cjs');
 require('../chunk-EO4VSB2O.cjs');
 require('../chunk-JAXDEK5Z.cjs');
 
@@ -12,31 +13,31 @@ require('../chunk-JAXDEK5Z.cjs');
 
 Object.defineProperty(exports, "createModuleRegistry", {
   enumerable: true,
-  get: function () { return chunkSSYKDXR4_cjs.createModuleRegistry; }
+  get: function () { return chunkODP3DO6P_cjs.createModuleRegistry; }
 });
 Object.defineProperty(exports, "getEventTypeName", {
   enumerable: true,
-  get: function () { return chunkSSYKDXR4_cjs.getEventTypeName; }
+  get: function () { return chunkODP3DO6P_cjs.getEventTypeName; }
 });
 Object.defineProperty(exports, "getModuleDependencyNamespace", {
   enumerable: true,
-  get: function () { return chunkSSYKDXR4_cjs.getModuleDependencyNamespace; }
+  get: function () { return chunkODP3DO6P_cjs.getModuleDependencyNamespace; }
 });
 Object.defineProperty(exports, "getObjectTypeName", {
   enumerable: true,
-  get: function () { return chunkSSYKDXR4_cjs.getObjectTypeName; }
+  get: function () { return chunkODP3DO6P_cjs.getObjectTypeName; }
 });
 Object.defineProperty(exports, "registerFabricModule", {
   enumerable: true,
-  get: function () { return chunkSSYKDXR4_cjs.registerFabricModule; }
+  get: function () { return chunkODP3DO6P_cjs.registerFabricModule; }
 });
 Object.defineProperty(exports, "registerFabricModules", {
   enumerable: true,
-  get: function () { return chunkSSYKDXR4_cjs.registerFabricModules; }
+  get: function () { return chunkODP3DO6P_cjs.registerFabricModules; }
 });
 Object.defineProperty(exports, "validateModuleNamespace", {
   enumerable: true,
-  get: function () { return chunkSSYKDXR4_cjs.validateModuleNamespace; }
+  get: function () { return chunkODP3DO6P_cjs.validateModuleNamespace; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/modules/index.d.cts

@@ -1,5 +1,7 @@
 import { ActionDefinition } from '../actions/index.cjs';
 import { DisplayRenderer } from '../displays/index.cjs';
+import { PortableJsonSchema, JsonValue } from '../objects/index.cjs';
+import { ViewContract } from '../projections/index.cjs';
 
 interface ModuleDependency {
     namespace: string;
@@ -23,6 +25,29 @@ interface ObjectTypeRegistration {
     displayName?: string;
     idPrefix?: string;
     isCoreModuleType?: boolean;
+    schema?: PortableJsonSchema;
+    semantics?: Record<string, JsonValue>;
+    relations?: ObjectRelationDefinition[];
+    invariants?: DeclarativeInvariant[];
+}
+type ObjectRelationCardinality = "one" | "many";
+type ObjectRelationSemantics = "reference" | "owned";
+type ObjectRelationDeleteBehavior = "restrict" | "cascade" | "set-null";
+interface ObjectRelationDefinition {
+    name: string;
+    target: `${string}.${string}`;
+    cardinality: ObjectRelationCardinality;
+    required?: boolean;
+    semantics: ObjectRelationSemantics;
+    onTargetDelete: ObjectRelationDeleteBehavior;
+}
+type InvariantEnforcement = "json-schema" | "state-machine" | "policy" | "host-adapter" | "application";
+interface DeclarativeInvariant {
+    id: string;
+    description: string;
+    required?: boolean;
+    enforcement: InvariantEnforcement;
+    enforcementRef?: string;
 }
 type ObjectTypeRegistrationInput = string | ObjectTypeRegistration;
 interface ModuleDisplayRendererRegistration {
@@ -38,11 +63,33 @@ interface StateMachineRegistration {
     entityType: string;
     states: string[];
 }
+interface CapabilitySlotDefinition {
+    name: string;
+    description: string;
+    shape?: PortableJsonSchema;
+}
+interface CapabilityMetadata {
+    displayName: string;
+    description: string;
+    roles?: string[];
+    stability: "experimental" | "beta" | "stable" | "deprecated";
+    deprecated?: {
+        since: string;
+        replacement?: string;
+        message: string;
+    };
+    slots?: CapabilitySlotDefinition[];
+    certification?: {
+        profile: string;
+        required: boolean;
+    };
+}
 interface FabricModule<TDb = unknown> {
     namespace: string;
     version?: string;
     displayName?: string;
     description?: string;
+    capability?: CapabilityMetadata;
     dependencies?: ModuleDependencyInput[];
     objectTypes?: ObjectTypeRegistrationInput[];
     subjectTypes?: string[];
@@ -59,6 +106,7 @@ interface FabricModule<TDb = unknown> {
     dataClassifications?: unknown[];
     retentionRules?: unknown[];
     evidenceRenderers?: unknown[];
+    views?: ViewContract[];
 }
 interface ModuleRegistry<TDb = unknown> {
     modules: ReadonlyMap<string, FabricModule<TDb>>;
@@ -71,4 +119,4 @@ declare function createModuleRegistry<TDb = unknown>(modules?: FabricModule<TDb>
 declare function registerFabricModule(module: FabricModule<unknown>): void;
 declare function registerFabricModules(modules: FabricModule<unknown>[]): FabricModule<unknown>[];
 
-export { type EventTypeRegistration, type EventTypeRegistrationInput, type FabricModule, type IdPrefixRegistration, type ModuleDependency, type ModuleDependencyInput, type ModuleDisplayRendererRegistration, type ModuleRegistry, type ObjectTypeRegistration, type ObjectTypeRegistrationInput, type PolicyRegistration, type StateMachineRegistration, createModuleRegistry, getEventTypeName, getModuleDependencyNamespace, getObjectTypeName, registerFabricModule, registerFabricModules, validateModuleNamespace };
+export { type CapabilityMetadata, type CapabilitySlotDefinition, type DeclarativeInvariant, type EventTypeRegistration, type EventTypeRegistrationInput, type FabricModule, type IdPrefixRegistration, type InvariantEnforcement, type ModuleDependency, type ModuleDependencyInput, type ModuleDisplayRendererRegistration, type ModuleRegistry, type ObjectRelationCardinality, type ObjectRelationDefinition, type ObjectRelationDeleteBehavior, type ObjectRelationSemantics, type ObjectTypeRegistration, type ObjectTypeRegistrationInput, type PolicyRegistration, type StateMachineRegistration, createModuleRegistry, getEventTypeName, getModuleDependencyNamespace, getObjectTypeName, registerFabricModule, registerFabricModules, validateModuleNamespace };