@knpkv/control-center 0.1.0

package/dist/server/domain/plugins/descriptor.d.ts

@@ -0,0 +1,205 @@
+import * as Schema from "effect/Schema";
+/** Stable reverse-DNS identity of a plugin, independent of package abbreviations. */
+export declare const PluginId: Schema.brand<Schema.String, string>;
+/** Decoded stable plugin identity. */
+export type PluginId = typeof PluginId.Type;
+/** Strict structured semantic version used by plugin and adapter contracts. */
+export declare const SemanticVersion: Schema.Struct<{
+    readonly major: Schema.Int;
+    readonly minor: Schema.Int;
+    readonly patch: Schema.Int;
+}>;
+/** Decoded semantic version. */
+export type SemanticVersion = typeof SemanticVersion.Type;
+/** Independently versioned operations understood by the Control Center host. */
+export declare const PluginCapabilityId: Schema.Literals<readonly ["entity.read", "sync.incremental", "action.propose", "action.execute", "action.cancel", "action.reconcile", "diff.inventory", "diff.content"]>;
+/** Decoded plugin capability identity. */
+export type PluginCapabilityId = typeof PluginCapabilityId.Type;
+/** A capability and the contract versions an adapter can implement. */
+export declare const PluginCapabilityOfferV1: Schema.Struct<{
+    readonly capabilityId: Schema.Literals<readonly ["entity.read", "sync.incremental", "action.propose", "action.execute", "action.cancel", "action.reconcile", "diff.inventory", "diff.content"]>;
+    readonly supportedVersions: Schema.$Array<Schema.Int>;
+    readonly requirement: Schema.Literals<readonly ["required", "optional"]>;
+}>;
+/** Decoded capability offer. */
+export type PluginCapabilityOfferV1 = typeof PluginCapabilityOfferV1.Type;
+/** Secret-free metadata describing a plugin configuration field. */
+export declare const PluginConfigurationFieldV1: Schema.toTaggedUnion<"_tag", readonly [Schema.TaggedStruct<"text", {
+    key: Schema.brand<Schema.String, string>;
+    label: Schema.String;
+    description: Schema.String;
+    required: Schema.Boolean;
+}>, Schema.TaggedStruct<"url", {
+    key: Schema.brand<Schema.String, string>;
+    label: Schema.String;
+    description: Schema.String;
+    required: Schema.Boolean;
+}>, Schema.TaggedStruct<"boolean", {
+    key: Schema.brand<Schema.String, string>;
+    label: Schema.String;
+    description: Schema.String;
+    required: Schema.Boolean;
+}>, Schema.Struct<{
+    readonly _tag: Schema.tag<"integer">;
+    readonly minimum: Schema.NullOr<Schema.Int>;
+    readonly maximum: Schema.NullOr<Schema.Int>;
+    readonly key: Schema.brand<Schema.String, string>;
+    readonly label: Schema.String;
+    readonly description: Schema.String;
+    readonly required: Schema.Boolean;
+}>, Schema.TaggedStruct<"select", {
+    readonly options: Schema.$Array<Schema.Struct<{
+        readonly label: Schema.String;
+        readonly value: Schema.brand<Schema.String, string>;
+    }>>;
+    readonly key: Schema.brand<Schema.String, string>;
+    readonly label: Schema.String;
+    readonly description: Schema.String;
+    readonly required: Schema.Boolean;
+}>, Schema.TaggedStruct<"secret-reference", {
+    readonly secretKind: Schema.Literals<readonly ["token", "password", "private-key", "certificate", "opaque"]>;
+    readonly key: Schema.brand<Schema.String, string>;
+    readonly label: Schema.String;
+    readonly description: Schema.String;
+    readonly required: Schema.Boolean;
+}>]>;
+/** Decoded plugin configuration metadata. */
+export type PluginConfigurationFieldV1 = typeof PluginConfigurationFieldV1.Type;
+/** Raw version-one descriptor decoded before an adapter factory may run. */
+export declare const PluginDescriptorV1: Schema.Struct<{
+    readonly contractId: Schema.Literal<"dev.knpkv.control-center.plugin">;
+    readonly contractVersion: Schema.Struct<{
+        readonly major: Schema.Int;
+        readonly minor: Schema.Int;
+        readonly patch: Schema.Int;
+    }>;
+    readonly pluginId: Schema.brand<Schema.String, string>;
+    readonly adapterVersion: Schema.Struct<{
+        readonly major: Schema.Int;
+        readonly minor: Schema.Int;
+        readonly patch: Schema.Int;
+    }>;
+    readonly displayName: Schema.String;
+    readonly configurationFields: Schema.$Array<Schema.toTaggedUnion<"_tag", readonly [Schema.TaggedStruct<"text", {
+        key: Schema.brand<Schema.String, string>;
+        label: Schema.String;
+        description: Schema.String;
+        required: Schema.Boolean;
+    }>, Schema.TaggedStruct<"url", {
+        key: Schema.brand<Schema.String, string>;
+        label: Schema.String;
+        description: Schema.String;
+        required: Schema.Boolean;
+    }>, Schema.TaggedStruct<"boolean", {
+        key: Schema.brand<Schema.String, string>;
+        label: Schema.String;
+        description: Schema.String;
+        required: Schema.Boolean;
+    }>, Schema.Struct<{
+        readonly _tag: Schema.tag<"integer">;
+        readonly minimum: Schema.NullOr<Schema.Int>;
+        readonly maximum: Schema.NullOr<Schema.Int>;
+        readonly key: Schema.brand<Schema.String, string>;
+        readonly label: Schema.String;
+        readonly description: Schema.String;
+        readonly required: Schema.Boolean;
+    }>, Schema.TaggedStruct<"select", {
+        readonly options: Schema.$Array<Schema.Struct<{
+            readonly label: Schema.String;
+            readonly value: Schema.brand<Schema.String, string>;
+        }>>;
+        readonly key: Schema.brand<Schema.String, string>;
+        readonly label: Schema.String;
+        readonly description: Schema.String;
+        readonly required: Schema.Boolean;
+    }>, Schema.TaggedStruct<"secret-reference", {
+        readonly secretKind: Schema.Literals<readonly ["token", "password", "private-key", "certificate", "opaque"]>;
+        readonly key: Schema.brand<Schema.String, string>;
+        readonly label: Schema.String;
+        readonly description: Schema.String;
+        readonly required: Schema.Boolean;
+    }>]>>;
+    readonly capabilities: Schema.$Array<Schema.Struct<{
+        readonly capabilityId: Schema.Literals<readonly ["entity.read", "sync.incremental", "action.propose", "action.execute", "action.cancel", "action.reconcile", "diff.inventory", "diff.content"]>;
+        readonly supportedVersions: Schema.$Array<Schema.Int>;
+        readonly requirement: Schema.Literals<readonly ["required", "optional"]>;
+    }>>;
+}>;
+/** Decoded version-one plugin descriptor. */
+export type PluginDescriptorV1 = typeof PluginDescriptorV1.Type;
+/** One capability version selected by the host during negotiation. */
+export declare const NegotiatedPluginCapabilityV1: Schema.Struct<{
+    readonly capabilityId: Schema.Literals<readonly ["entity.read", "sync.incremental", "action.propose", "action.execute", "action.cancel", "action.reconcile", "diff.inventory", "diff.content"]>;
+    readonly version: Schema.Int;
+}>;
+/** Decoded negotiated capability. */
+export type NegotiatedPluginCapabilityV1 = typeof NegotiatedPluginCapabilityV1.Type;
+/** Descriptor accepted by the host after contract and capability negotiation. */
+export declare const NegotiatedPluginDescriptorV1: Schema.Struct<{
+    readonly descriptor: Schema.Struct<{
+        readonly contractId: Schema.Literal<"dev.knpkv.control-center.plugin">;
+        readonly contractVersion: Schema.Struct<{
+            readonly major: Schema.Int;
+            readonly minor: Schema.Int;
+            readonly patch: Schema.Int;
+        }>;
+        readonly pluginId: Schema.brand<Schema.String, string>;
+        readonly adapterVersion: Schema.Struct<{
+            readonly major: Schema.Int;
+            readonly minor: Schema.Int;
+            readonly patch: Schema.Int;
+        }>;
+        readonly displayName: Schema.String;
+        readonly configurationFields: Schema.$Array<Schema.toTaggedUnion<"_tag", readonly [Schema.TaggedStruct<"text", {
+            key: Schema.brand<Schema.String, string>;
+            label: Schema.String;
+            description: Schema.String;
+            required: Schema.Boolean;
+        }>, Schema.TaggedStruct<"url", {
+            key: Schema.brand<Schema.String, string>;
+            label: Schema.String;
+            description: Schema.String;
+            required: Schema.Boolean;
+        }>, Schema.TaggedStruct<"boolean", {
+            key: Schema.brand<Schema.String, string>;
+            label: Schema.String;
+            description: Schema.String;
+            required: Schema.Boolean;
+        }>, Schema.Struct<{
+            readonly _tag: Schema.tag<"integer">;
+            readonly minimum: Schema.NullOr<Schema.Int>;
+            readonly maximum: Schema.NullOr<Schema.Int>;
+            readonly key: Schema.brand<Schema.String, string>;
+            readonly label: Schema.String;
+            readonly description: Schema.String;
+            readonly required: Schema.Boolean;
+        }>, Schema.TaggedStruct<"select", {
+            readonly options: Schema.$Array<Schema.Struct<{
+                readonly label: Schema.String;
+                readonly value: Schema.brand<Schema.String, string>;
+            }>>;
+            readonly key: Schema.brand<Schema.String, string>;
+            readonly label: Schema.String;
+            readonly description: Schema.String;
+            readonly required: Schema.Boolean;
+        }>, Schema.TaggedStruct<"secret-reference", {
+            readonly secretKind: Schema.Literals<readonly ["token", "password", "private-key", "certificate", "opaque"]>;
+            readonly key: Schema.brand<Schema.String, string>;
+            readonly label: Schema.String;
+            readonly description: Schema.String;
+            readonly required: Schema.Boolean;
+        }>]>>;
+        readonly capabilities: Schema.$Array<Schema.Struct<{
+            readonly capabilityId: Schema.Literals<readonly ["entity.read", "sync.incremental", "action.propose", "action.execute", "action.cancel", "action.reconcile", "diff.inventory", "diff.content"]>;
+            readonly supportedVersions: Schema.$Array<Schema.Int>;
+            readonly requirement: Schema.Literals<readonly ["required", "optional"]>;
+        }>>;
+    }>;
+    readonly capabilities: Schema.$Array<Schema.Struct<{
+        readonly capabilityId: Schema.Literals<readonly ["entity.read", "sync.incremental", "action.propose", "action.execute", "action.cancel", "action.reconcile", "diff.inventory", "diff.content"]>;
+        readonly version: Schema.Int;
+    }>>;
+}>;
+/** Decoded negotiated plugin descriptor. */
+export type NegotiatedPluginDescriptorV1 = typeof NegotiatedPluginDescriptorV1.Type;
+//# sourceMappingURL=descriptor.d.ts.map

package/dist/server/domain/plugins/descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../../../src/domain/plugins/descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAcvC,qFAAqF;AACrF,eAAO,MAAM,QAAQ,qCAAqC,CAAA;AAE1D,sCAAsC;AACtC,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAA;AAE3C,+EAA+E;AAC/E,eAAO,MAAM,eAAe;;;;EAIkB,CAAA;AAE9C,gCAAgC;AAChC,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAEzD,gFAAgF;AAChF,eAAO,MAAM,kBAAkB,0KASkB,CAAA;AAEjD,0CAA0C;AAC1C,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA;AAE/D,uEAAuE;AACvE,eAAO,MAAM,uBAAuB;;;;EAUkB,CAAA;AAEtD,gCAAgC;AAChC,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAC,IAAI,CAAA;AAuDzE,oEAAoE;AACpE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAOF,CAAA;AAErC,6CAA6C;AAC7C,MAAM,MAAM,0BAA0B,GAAG,OAAO,0BAA0B,CAAC,IAAI,CAAA;AAE/E,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BiB,CAAA;AAEhD,6CAA6C;AAC7C,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA;AAE/D,sEAAsE;AACtE,eAAO,MAAM,4BAA4B;;;EAGkB,CAAA;AAE3D,qCAAqC;AACrC,MAAM,MAAM,4BAA4B,GAAG,OAAO,4BAA4B,CAAC,IAAI,CAAA;AAEnF,iFAAiF;AACjF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYkB,CAAA;AAE3D,4CAA4C;AAC5C,MAAM,MAAM,4BAA4B,GAAG,OAAO,4BAA4B,CAAC,IAAI,CAAA"}

package/dist/server/domain/plugins/discovery.d.ts

@@ -0,0 +1,39 @@
+import * as Schema from "effect/Schema";
+/** Secret-free provider endpoint advertised during connection discovery. */
+export declare const PluginDiscoveryEndpointV1: Schema.Struct<{
+    readonly kind: Schema.Literals<readonly ["api", "web", "graphql", "webhook"]>;
+    readonly url: Schema.decodeTo<Schema.URL, Schema.String, never, never>;
+    readonly label: Schema.NullOr<Schema.String>;
+}>;
+/** Decoded safe provider endpoint metadata. */
+export type PluginDiscoveryEndpointV1 = typeof PluginDiscoveryEndpointV1.Type;
+/**
+ * Safe connection metadata discovered from the provider.
+ * Credentials, raw headers, and provider response bodies are deliberately absent.
+ */
+export declare const PluginDiscoveryV1: Schema.Struct<{
+    readonly account: Schema.NullOr<Schema.Struct<{
+        readonly providerImmutableId: Schema.String;
+        readonly displayName: Schema.String;
+    }>>;
+    readonly workspace: Schema.NullOr<Schema.Struct<{
+        readonly providerImmutableId: Schema.String;
+        readonly displayName: Schema.String;
+    }>>;
+    readonly resource: Schema.decodeTo<Schema.toType<Schema.NullOr<Schema.Struct<{
+        readonly providerImmutableId: Schema.String;
+        readonly displayName: Schema.String;
+    }>>>, Schema.optional<Schema.NullOr<Schema.Struct<{
+        readonly providerImmutableId: Schema.String;
+        readonly displayName: Schema.String;
+    }>>>, never, never>;
+    readonly endpoints: Schema.$Array<Schema.Struct<{
+        readonly kind: Schema.Literals<readonly ["api", "web", "graphql", "webhook"]>;
+        readonly url: Schema.decodeTo<Schema.URL, Schema.String, never, never>;
+        readonly label: Schema.NullOr<Schema.String>;
+    }>>;
+    readonly discoveredAt: Schema.DateTimeUtcFromString;
+}>;
+/** Decoded secret-free connection discovery metadata. */
+export type PluginDiscoveryV1 = typeof PluginDiscoveryV1.Type;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/server/domain/plugins/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../../src/domain/plugins/discovery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AA+BvC,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB;;;;EAIpC,CAAA;AAEF,+CAA+C;AAC/C,MAAM,MAAM,yBAAyB,GAAG,OAAO,yBAAyB,CAAC,IAAI,CAAA;AAE7E;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;EAgBkB,CAAA;AAEhD,yDAAyD;AACzD,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAA"}

package/dist/server/domain/plugins/events.d.ts

@@ -0,0 +1,232 @@
+import * as Schema from "effect/Schema";
+/** Stable adapter event identity used to make checkpoint replay idempotent. */
+export declare const PluginEventId: Schema.brand<Schema.String, string>;
+/** Decoded adapter event identity. */
+export type PluginEventId = typeof PluginEventId.Type;
+/** Opaque bounded checkpoint owned by one plugin sync stream. */
+export declare const PluginCheckpointV1: Schema.brand<Schema.String, string>;
+/** Decoded plugin checkpoint. */
+export type PluginCheckpointV1 = typeof PluginCheckpointV1.Type;
+/** Opaque page cursor for optional paginated reads. */
+export declare const PluginPageCursorV1: Schema.brand<Schema.String, string>;
+/** Decoded plugin page cursor. */
+export type PluginPageCursorV1 = typeof PluginPageCursorV1.Type;
+/** Stable entity category emitted without vendor-specific response shapes. */
+export declare const PluginEntityType: Schema.brand<Schema.String, string>;
+/** Decoded normalized entity type. */
+export type PluginEntityType = typeof PluginEntityType.Type;
+/** Normalized provider-relative path safe to carry across diff and storage boundaries. */
+export declare const PluginRelativePathV1: Schema.brand<Schema.String, "PluginRelativePathV1">;
+/** Decoded normalized provider-relative path. */
+export type PluginRelativePathV1 = typeof PluginRelativePathV1.Type;
+/** Adapter-owned reference to a provider entity; host scope is deliberately absent. */
+export declare const PluginEntityReferenceV1: Schema.Struct<{
+    entityType: Schema.brand<Schema.String, string>;
+    vendorImmutableId: Schema.brand<Schema.String, "VendorImmutableId">;
+}>;
+/** Decoded provider entity reference. */
+export type PluginEntityReferenceV1 = typeof PluginEntityReferenceV1.Type;
+/** Vendor-neutral event emitted by a plugin and scoped by the host on ingestion. */
+export declare const NormalizedPluginEventV1: Schema.toTaggedUnion<"_tag", readonly [Schema.TaggedStruct<"UpsertEntity", {
+    readonly sourceUrl: Schema.NullOr<Schema.decodeTo<Schema.URL, Schema.String, never, never>>;
+    readonly title: Schema.String;
+    readonly attributes: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+    readonly entityType: Schema.brand<Schema.String, string>;
+    readonly vendorImmutableId: Schema.brand<Schema.String, "VendorImmutableId">;
+    readonly eventId: Schema.brand<Schema.String, string>;
+    readonly observedAt: Schema.DateTimeUtcFromString;
+    readonly revision: Schema.brand<Schema.String, "Revision">;
+}>, Schema.TaggedStruct<"TombstoneEntity", {
+    readonly reason: Schema.String;
+    readonly entityType: Schema.brand<Schema.String, string>;
+    readonly vendorImmutableId: Schema.brand<Schema.String, "VendorImmutableId">;
+    readonly eventId: Schema.brand<Schema.String, string>;
+    readonly observedAt: Schema.DateTimeUtcFromString;
+    readonly revision: Schema.brand<Schema.String, "Revision">;
+}>, Schema.TaggedStruct<"AppendEvidence", {
+    readonly evidenceId: Schema.brand<Schema.String, string>;
+    readonly subject: Schema.Struct<{
+        entityType: Schema.brand<Schema.String, string>;
+        vendorImmutableId: Schema.brand<Schema.String, "VendorImmutableId">;
+    }>;
+    readonly evidenceType: Schema.brand<Schema.String, string>;
+    readonly summary: Schema.String;
+    readonly capturedAt: Schema.DateTimeUtcFromString;
+    readonly data: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+    readonly eventId: Schema.brand<Schema.String, string>;
+    readonly observedAt: Schema.DateTimeUtcFromString;
+    readonly revision: Schema.brand<Schema.String, "Revision">;
+}>, Schema.TaggedStruct<"UpsertPerson", {
+    readonly vendorPersonId: Schema.brand<Schema.String, string>;
+    readonly displayName: Schema.String;
+    readonly avatarUrl: Schema.NullOr<Schema.decodeTo<Schema.URL, Schema.String, never, never>>;
+    readonly active: Schema.Boolean;
+    readonly eventId: Schema.brand<Schema.String, string>;
+    readonly observedAt: Schema.DateTimeUtcFromString;
+    readonly revision: Schema.brand<Schema.String, "Revision">;
+}>, Schema.TaggedStruct<"ProposeRelationship", {
+    readonly relationshipId: Schema.brand<Schema.String, string>;
+    readonly from: Schema.Struct<{
+        entityType: Schema.brand<Schema.String, string>;
+        vendorImmutableId: Schema.brand<Schema.String, "VendorImmutableId">;
+    }>;
+    readonly to: Schema.Struct<{
+        entityType: Schema.brand<Schema.String, string>;
+        vendorImmutableId: Schema.brand<Schema.String, "VendorImmutableId">;
+    }>;
+    readonly relationshipType: Schema.brand<Schema.String, string>;
+    readonly confidence: Schema.Number;
+    readonly evidenceIds: Schema.$Array<Schema.brand<Schema.String, string>>;
+    readonly eventId: Schema.brand<Schema.String, string>;
+    readonly observedAt: Schema.DateTimeUtcFromString;
+    readonly revision: Schema.brand<Schema.String, "Revision">;
+}>]>;
+/** Decoded normalized plugin event. */
+export type NormalizedPluginEventV1 = typeof NormalizedPluginEventV1.Type;
+/** A fully decoded page whose events and checkpoint must commit atomically. */
+export declare const PluginSyncPageV1: Schema.Struct<{
+    readonly events: Schema.$Array<Schema.toTaggedUnion<"_tag", readonly [Schema.TaggedStruct<"UpsertEntity", {
+        readonly sourceUrl: Schema.NullOr<Schema.decodeTo<Schema.URL, Schema.String, never, never>>;
+        readonly title: Schema.String;
+        readonly attributes: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+        readonly entityType: Schema.brand<Schema.String, string>;
+        readonly vendorImmutableId: Schema.brand<Schema.String, "VendorImmutableId">;
+        readonly eventId: Schema.brand<Schema.String, string>;
+        readonly observedAt: Schema.DateTimeUtcFromString;
+        readonly revision: Schema.brand<Schema.String, "Revision">;
+    }>, Schema.TaggedStruct<"TombstoneEntity", {
+        readonly reason: Schema.String;
+        readonly entityType: Schema.brand<Schema.String, string>;
+        readonly vendorImmutableId: Schema.brand<Schema.String, "VendorImmutableId">;
+        readonly eventId: Schema.brand<Schema.String, string>;
+        readonly observedAt: Schema.DateTimeUtcFromString;
+        readonly revision: Schema.brand<Schema.String, "Revision">;
+    }>, Schema.TaggedStruct<"AppendEvidence", {
+        readonly evidenceId: Schema.brand<Schema.String, string>;
+        readonly subject: Schema.Struct<{
+            entityType: Schema.brand<Schema.String, string>;
+            vendorImmutableId: Schema.brand<Schema.String, "VendorImmutableId">;
+        }>;
+        readonly evidenceType: Schema.brand<Schema.String, string>;
+        readonly summary: Schema.String;
+        readonly capturedAt: Schema.DateTimeUtcFromString;
+        readonly data: Schema.Codec<Schema.Json, Schema.Json, never, never>;
+        readonly eventId: Schema.brand<Schema.String, string>;
+        readonly observedAt: Schema.DateTimeUtcFromString;
+        readonly revision: Schema.brand<Schema.String, "Revision">;
+    }>, Schema.TaggedStruct<"UpsertPerson", {
+        readonly vendorPersonId: Schema.brand<Schema.String, string>;
+        readonly displayName: Schema.String;
+        readonly avatarUrl: Schema.NullOr<Schema.decodeTo<Schema.URL, Schema.String, never, never>>;
+        readonly active: Schema.Boolean;
+        readonly eventId: Schema.brand<Schema.String, string>;
+        readonly observedAt: Schema.DateTimeUtcFromString;
+        readonly revision: Schema.brand<Schema.String, "Revision">;
+    }>, Schema.TaggedStruct<"ProposeRelationship", {
+        readonly relationshipId: Schema.brand<Schema.String, string>;
+        readonly from: Schema.Struct<{
+            entityType: Schema.brand<Schema.String, string>;
+            vendorImmutableId: Schema.brand<Schema.String, "VendorImmutableId">;
+        }>;
+        readonly to: Schema.Struct<{
+            entityType: Schema.brand<Schema.String, string>;
+            vendorImmutableId: Schema.brand<Schema.String, "VendorImmutableId">;
+        }>;
+        readonly relationshipType: Schema.brand<Schema.String, string>;
+        readonly confidence: Schema.Number;
+        readonly evidenceIds: Schema.$Array<Schema.brand<Schema.String, string>>;
+        readonly eventId: Schema.brand<Schema.String, string>;
+        readonly observedAt: Schema.DateTimeUtcFromString;
+        readonly revision: Schema.brand<Schema.String, "Revision">;
+    }>]>>;
+    readonly checkpointAfterPage: Schema.brand<Schema.String, string>;
+    readonly hasMore: Schema.Boolean;
+}>;
+/** Decoded plugin sync page. */
+export type PluginSyncPageV1 = typeof PluginSyncPageV1.Type;
+/** Request to resume a logical plugin stream from an accepted checkpoint. */
+export declare const PluginSyncRequestV1: Schema.Struct<{
+    readonly streamKey: Schema.brand<Schema.String, string>;
+    readonly checkpoint: Schema.NullOr<Schema.brand<Schema.String, string>>;
+}>;
+/** Decoded plugin sync request. */
+export type PluginSyncRequestV1 = typeof PluginSyncRequestV1.Type;
+/** Request for one normalized entity by its immutable provider reference. */
+export declare const ReadPluginEntityRequestV1: Schema.Struct<{
+    entityType: Schema.brand<Schema.String, string>;
+    vendorImmutableId: Schema.brand<Schema.String, "VendorImmutableId">;
+}>;
+/** Decoded normalized entity read request. */
+export type ReadPluginEntityRequestV1 = typeof ReadPluginEntityRequestV1.Type;
+/** Authoritative result of a normalized plugin entity read. */
+export declare const ReadPluginEntityResultV1: Schema.toTaggedUnion<"_tag", readonly [Schema.TaggedStruct<"found", {
+    readonly event: Schema.TaggedStruct<"UpsertEntity", {
+        readonly sourceUrl: Schema.NullOr<Schema.decodeTo<Schema.URL, Schema.String, never, never>>;
+        readonly title: Schema.String;
+        readonly attributes: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+        readonly entityType: Schema.brand<Schema.String, string>;
+        readonly vendorImmutableId: Schema.brand<Schema.String, "VendorImmutableId">;
+        readonly eventId: Schema.brand<Schema.String, string>;
+        readonly observedAt: Schema.DateTimeUtcFromString;
+        readonly revision: Schema.brand<Schema.String, "Revision">;
+    }>;
+}>, Schema.TaggedStruct<"missing", {
+    readonly reference: Schema.Struct<{
+        entityType: Schema.brand<Schema.String, string>;
+        vendorImmutableId: Schema.brand<Schema.String, "VendorImmutableId">;
+    }>;
+    readonly observedAt: Schema.DateTimeUtcFromString;
+}>]>;
+/** Decoded normalized entity read result. */
+export type ReadPluginEntityResultV1 = typeof ReadPluginEntityResultV1.Type;
+/** One bounded file-like entry in a complete diff inventory. */
+export declare const PluginDiffInventoryEntryV1: Schema.Struct<{
+    readonly path: Schema.brand<Schema.String, "PluginRelativePathV1">;
+    readonly previousPath: Schema.NullOr<Schema.brand<Schema.String, "PluginRelativePathV1">>;
+    readonly status: Schema.Literals<readonly ["added", "modified", "deleted", "renamed", "copied"]>;
+    readonly binary: Schema.Boolean;
+    readonly generated: Schema.Boolean;
+    readonly oversized: Schema.Boolean;
+}>;
+/** Request for one page of a complete diff inventory. */
+export declare const DiffInventoryPageRequestV1: Schema.Struct<{
+    readonly entity: Schema.Struct<{
+        entityType: Schema.brand<Schema.String, string>;
+        vendorImmutableId: Schema.brand<Schema.String, "VendorImmutableId">;
+    }>;
+    readonly cursor: Schema.NullOr<Schema.brand<Schema.String, string>>;
+}>;
+/** A bounded diff inventory page. */
+export declare const DiffInventoryPageV1: Schema.Struct<{
+    readonly entries: Schema.$Array<Schema.Struct<{
+        readonly path: Schema.brand<Schema.String, "PluginRelativePathV1">;
+        readonly previousPath: Schema.NullOr<Schema.brand<Schema.String, "PluginRelativePathV1">>;
+        readonly status: Schema.Literals<readonly ["added", "modified", "deleted", "renamed", "copied"]>;
+        readonly binary: Schema.Boolean;
+        readonly generated: Schema.Boolean;
+        readonly oversized: Schema.Boolean;
+    }>>;
+    readonly nextCursor: Schema.NullOr<Schema.brand<Schema.String, string>>;
+}>;
+/** Request for a bounded byte range of before/after diff content. */
+export declare const DiffContentRangeRequestV1: Schema.Struct<{
+    readonly entity: Schema.Struct<{
+        entityType: Schema.brand<Schema.String, string>;
+        vendorImmutableId: Schema.brand<Schema.String, "VendorImmutableId">;
+    }>;
+    readonly path: Schema.brand<Schema.String, "PluginRelativePathV1">;
+    readonly side: Schema.Literals<readonly ["before", "after"]>;
+    readonly offset: Schema.Int;
+    readonly length: Schema.Int;
+}>;
+/** Bounded content range with explicit availability metadata. */
+export declare const DiffContentRangeV1: Schema.Struct<{
+    readonly bytesBase64: Schema.NullOr<Schema.String>;
+    readonly totalBytes: Schema.NullOr<Schema.Int>;
+    readonly unavailableReason: Schema.NullOr<Schema.Literals<readonly ["binary", "generated", "oversized", "missing", "provider-unavailable"]>>;
+}>;
+export type DiffInventoryPageRequestV1 = typeof DiffInventoryPageRequestV1.Type;
+export type DiffInventoryPageV1 = typeof DiffInventoryPageV1.Type;
+export type DiffContentRangeRequestV1 = typeof DiffContentRangeRequestV1.Type;
+export type DiffContentRangeV1 = typeof DiffContentRangeV1.Type;
+//# sourceMappingURL=events.d.ts.map

package/dist/server/domain/plugins/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/domain/plugins/events.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAcvC,+EAA+E;AAC/E,eAAO,MAAM,aAAa,qCAAsC,CAAA;AAEhE,sCAAsC;AACtC,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAA;AAErD,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,qCAA6C,CAAA;AAE5E,iCAAiC;AACjC,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA;AAE/D,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,qCAA6C,CAAA;AAE5E,kCAAkC;AAClC,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA;AAE/D,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,qCAAyC,CAAA;AAEtE,sCAAsC;AACtC,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAA;AA6B3D,0FAA0F;AAC1F,eAAO,MAAM,oBAAoB,qDAIW,CAAA;AAE5C,iDAAiD;AACjD,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAA;AAiBnE,uFAAuF;AACvF,eAAO,MAAM,uBAAuB;;;EAAuC,CAAA;AAE3E,yCAAyC;AACzC,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAC,IAAI,CAAA;AAmDzE,oFAAoF;AACpF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAMC,CAAA;AAErC,uCAAuC;AACvC,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAC,IAAI,CAAA;AAEzE,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAakB,CAAA;AAE/C,gCAAgC;AAChC,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAA;AAE3D,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB;;;EAGkB,CAAA;AAElD,mCAAmC;AACnC,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAA;AAEjE,6EAA6E;AAC7E,eAAO,MAAM,yBAAyB;;;EAA0B,CAAA;AAEhE,8CAA8C;AAC9C,MAAM,MAAM,yBAAyB,GAAG,OAAO,yBAAyB,CAAC,IAAI,CAAA;AAU7E,+DAA+D;AAC/D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;IAEpC,CAAA;AAED,6CAA6C;AAC7C,MAAM,MAAM,wBAAwB,GAAG,OAAO,wBAAwB,CAAC,IAAI,CAAA;AAE3E,gEAAgE;AAChE,eAAO,MAAM,0BAA0B;;;;;;;EAOrC,CAAA;AAEF,yDAAyD;AACzD,eAAO,MAAM,0BAA0B;;;;;;EAGrC,CAAA;AAEF,qCAAqC;AACrC,eAAO,MAAM,mBAAmB;;;;;;;;;;EAO9B,CAAA;AAEF,qEAAqE;AACrE,eAAO,MAAM,yBAAyB;;;;;;;;;EAMpC,CAAA;AAEF,iEAAiE;AACjE,eAAO,MAAM,kBAAkB;;;;EAY9B,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG,OAAO,0BAA0B,CAAC,IAAI,CAAA;AAC/E,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC,IAAI,CAAA;AACjE,MAAM,MAAM,yBAAyB,GAAG,OAAO,yBAAyB,CAAC,IAAI,CAAA;AAC7E,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA"}

package/dist/server/domain/plugins/index.d.ts

@@ -0,0 +1,11 @@
+/** Browser-safe versioned plugin descriptor and capability schemas. */
+export * from "./descriptor.js";
+/** Browser-safe payload and collection bounds shared by plugin contracts. */
+export * from "./bounds.js";
+/** Browser-safe provider account, workspace, and endpoint discovery metadata. */
+export * from "./discovery.js";
+/** Browser-safe normalized plugin events and paginated read schemas. */
+export * from "./events.js";
+/** Browser-safe governed-action proposal and outcome schemas. */
+export * from "./actions.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/domain/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/domain/plugins/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,cAAc,iBAAiB,CAAA;AAC/B,6EAA6E;AAC7E,cAAc,aAAa,CAAA;AAC3B,iFAAiF;AACjF,cAAc,gBAAgB,CAAA;AAC9B,wEAAwE;AACxE,cAAc,aAAa,CAAA;AAC3B,iEAAiE;AACjE,cAAc,cAAc,CAAA"}

package/dist/server/domain/readiness/evaluate.d.ts

@@ -0,0 +1,4 @@
+import type { EnvironmentReadinessAssessment, EnvironmentReadinessEvaluationInput } from "./model.js";
+/** Pure V1 derivation of one immutable environment readiness assessment. */
+export declare const assessEnvironmentReadiness: (input: EnvironmentReadinessEvaluationInput) => EnvironmentReadinessAssessment;
+//# sourceMappingURL=evaluate.d.ts.map

package/dist/server/domain/readiness/evaluate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../../../src/domain/readiness/evaluate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,8BAA8B,EAC9B,mCAAmC,EAIpC,MAAM,YAAY,CAAA;AA2BnB,4EAA4E;AAC5E,eAAO,MAAM,0BAA0B,GACrC,OAAO,mCAAmC,KACzC,8BA8CF,CAAA"}

package/dist/server/domain/readiness/index.d.ts

@@ -0,0 +1,7 @@
+/** Evidence-derived, provider-neutral release readiness contracts. */
+export * from "./evaluate.js";
+export * from "./material.js";
+export * from "./model.js";
+export * from "./policy.js";
+export * from "./rollup.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/domain/readiness/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/domain/readiness/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}