@lssm/lib.communication-spec 3.1.1

package/dist/contracts/discord-community.events.d.ts

@@ -0,0 +1,162 @@
+export declare const CommunicationDiscordCommunityEventV1PayloadModel: import("@lssm/lib.schema").SchemaModel<{
+    sourceRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    guildId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    trustZone: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    entityRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    evidenceRefs: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isArray: true;
+        isOptional: false;
+    };
+    occurredAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+}>;
+export declare const CommunicationDiscordInstallationAuthorizedV1Event: import("@lssm/lib.contracts-spec").EventSpec<import("@lssm/lib.schema").SchemaModel<{
+    sourceRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    guildId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    trustZone: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    entityRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    evidenceRefs: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isArray: true;
+        isOptional: false;
+    };
+    occurredAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+}>>;
+export declare const CommunicationDiscordInstallationHealthChangedV1Event: import("@lssm/lib.contracts-spec").EventSpec<import("@lssm/lib.schema").SchemaModel<{
+    sourceRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    guildId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    trustZone: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    entityRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    evidenceRefs: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isArray: true;
+        isOptional: false;
+    };
+    occurredAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+}>>;
+export declare const CommunicationDiscordProviderEventIngestedV2Event: import("@lssm/lib.contracts-spec").EventSpec<import("@lssm/lib.schema").SchemaModel<{
+    sourceRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    guildId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    trustZone: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    entityRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    evidenceRefs: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isArray: true;
+        isOptional: false;
+    };
+    occurredAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+}>>;
+export declare const CommunicationCommunityInsightPublishedV1Event: import("@lssm/lib.contracts-spec").EventSpec<import("@lssm/lib.schema").SchemaModel<{
+    sourceRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    guildId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    trustZone: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    entityRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    evidenceRefs: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isArray: true;
+        isOptional: false;
+    };
+    occurredAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+}>>;
+export declare const CommunicationCommunityKaizenDigestPublishedV1Event: import("@lssm/lib.contracts-spec").EventSpec<import("@lssm/lib.schema").SchemaModel<{
+    sourceRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    guildId: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    trustZone: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    entityRef: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isOptional: false;
+    };
+    evidenceRefs: {
+        type: import("@lssm/lib.schema").FieldType<string, string>;
+        isArray: true;
+        isOptional: false;
+    };
+    occurredAt: {
+        type: import("@lssm/lib.schema").FieldType<Date, string>;
+        isOptional: false;
+    };
+}>>;

package/dist/contracts/discord-community.events.js

@@ -0,0 +1,2 @@
+// @bun
+import{defineEvent as n,docId as u}from"@lssm/lib.contracts-spec";import{defineSchemaModel as p,ScalarTypeEnum as t}from"@lssm/lib.schema";import{z as i}from"zod";var c={id:"communication-os.discord-community-intelligence.v1",title:"Multi-guild Discord community intelligence",body:"Additive contracts for policy-scoped Discord guild monitoring, protected provider events, governed identity correlation, evidence-backed community insights, coaching scorecards, and Kaizen digests. Raw staff content never enters cross-guild projections.",kind:"reference",route:"/docs/communication-os/discord-community-intelligence-v1",visibility:"public"},d=i.enum(["staff","managed-community"]),g=i.enum(["pending","active","degraded","revoked"]),v=i.object({id:i.string().min(1),tenantId:i.string().min(1),workspaceId:i.string().min(1),spaceId:i.string().min(1),network:i.literal("discord"),guildId:i.string().min(1),name:i.string().min(1),specialtyKeys:i.array(i.string().min(1)),trustZone:d,status:g,policyRef:i.string().min(1),retentionPolicyRef:i.string().min(1),createdAt:i.string().datetime(),updatedAt:i.string().datetime()}).strict(),h=i.object({id:i.string().min(1),sourceId:i.string().min(1),guildId:i.string().min(1),applicationId:i.string().min(1),botUserId:i.string().min(1),credentialRef:i.string().min(1),declaredIntents:i.array(i.string().min(1)),verifiedPermissions:i.array(i.string().min(1)),allowedChannelIds:i.array(i.string().min(1)),excludedChannelIds:i.array(i.string().min(1)),backfillDays:i.number().int().min(0).max(90),health:i.enum(["pending","healthy","degraded","offline","revoked"]),installationEvidenceRefs:i.array(i.string().min(1)).min(1),lastVerifiedAt:i.string().datetime().optional()}).strict(),C=i.object({id:i.string().min(1),tenantId:i.string().min(1),provider:i.literal("discord"),providerUserId:i.string().min(1),canonicalPrincipalRef:i.string().min(1).optional(),guildMemberships:i.array(i.object({guildId:i.string().min(1),roleIds:i.array(i.string().min(1)),state:i.enum(["active","left","banned"]),observedAt:i.string().datetime()}).strict()),mergeEvidence:i.array(i.object({providerUserId:i.string().min(1),decision:i.literal("approved"),decidedByPrincipalRef:i.string().min(1),evidenceRef:i.string().min(1),decidedAt:i.string().datetime()}).strict())}).strict(),I=i.object({id:i.string().min(1),schemaVersion:i.literal("2.0.0"),sourceId:i.string().min(1),trustZone:d,guildId:i.string().min(1),channelId:i.string().min(1).optional(),threadId:i.string().min(1).optional(),actorProviderUserId:i.string().min(1).optional(),eventKind:i.string().min(1),gatewaySessionId:i.string().min(1).optional(),gatewaySequence:i.number().int().nonnegative().optional(),providerEventId:i.string().min(1),occurredAt:i.string().datetime(),protectedContent:i.object({ciphertextRef:i.string().min(1),digest:i.string().min(1),redactionStatus:i.enum(["pending","applied","not_required"])}).strict().optional(),metadata:i.record(i.string(),i.string()),evidenceRefs:i.array(i.string().min(1)).min(1)}).strict(),m=i.object({sourceIds:i.array(i.string().min(1)).min(1),windowStart:i.string().datetime(),windowEnd:i.string().datetime(),confidence:i.number().min(0).max(1),evidenceRefs:i.array(i.string().min(1)).min(1)}).strict(),S=m.extend({id:i.string().min(1),kind:i.enum(["recurring_question","pain_point","friction_trend","emerging_topic","response_gap","moderation_pattern"]),title:i.string().min(1),summary:i.string().min(1),specialtyKeys:i.array(i.string().min(1)),metricValue:i.number().optional()}).strict(),b=m.extend({id:i.string().min(1),staffPrincipalRef:i.string().min(1),visibility:i.literal("authorized_manager"),metrics:i.record(i.string(),i.number()),coachingObservations:i.array(i.string().min(1))}).strict(),x=m.extend({id:i.string().min(1),status:i.enum(["draft","published"]),insightRefs:i.array(i.string().min(1)),changes:i.array(i.string().min(1)),suggestedExperiments:i.array(i.string().min(1)),generatedAt:i.string().datetime()}).strict();var l=[u(c.id)],o=(r,a,s)=>({key:r,version:"1.0.0",stability:"experimental",owners:["platform.communication-os"],tags:["communication","discord",...s],description:a,docId:l}),y=(r,a,s)=>({key:r,version:"2.0.0",stability:"experimental",owners:["platform.communication-os"],tags:["communication","discord",...s],description:a,docId:l}),e=p({name:"CommunicationDiscordCommunityEventV1Payload",fields:{sourceRef:{type:t.String_unsecure(),isOptional:!1},guildId:{type:t.String_unsecure(),isOptional:!1},trustZone:{type:t.String_unsecure(),isOptional:!1},entityRef:{type:t.String_unsecure(),isOptional:!1},evidenceRefs:{type:t.String_unsecure(),isArray:!0,isOptional:!1},occurredAt:{type:t.DateTime(),isOptional:!1}}}),P=n({meta:o("communication.discord-installation.authorized","A read-only Discord guild installation was authorized and evidenced",["installation","authorized"]),payload:e}),k=n({meta:o("communication.discord-installation.health-changed","Permissions, intents, connectivity, or capture coverage changed",["installation","health"]),payload:e}),w=n({meta:y("communication.provider-event.ingested","A protected non-message provider event entered the typed journal",["provider-event","ingestion"]),payload:e}),R=n({meta:o("communication.community-insight.published","A policy-approved, evidence-backed community insight was published",["insight","published"]),payload:e}),A=n({meta:o("communication.community-kaizen-digest.published","An evidence-backed Kaizen digest was published",["kaizen","digest","published"]),payload:e});export{R as CommunicationCommunityInsightPublishedV1Event,A as CommunicationCommunityKaizenDigestPublishedV1Event,e as CommunicationDiscordCommunityEventV1PayloadModel,P as CommunicationDiscordInstallationAuthorizedV1Event,k as CommunicationDiscordInstallationHealthChangedV1Event,w as CommunicationDiscordProviderEventIngestedV2Event};

package/dist/contracts/discord-community.models.d.ts

@@ -0,0 +1,167 @@
+import type { DocBlock } from '@lssm/lib.contracts-spec';
+import { z } from 'zod';
+export declare const DiscordCommunityIntelligenceDocBlock: DocBlock;
+export declare const CommunicationCommunityTrustZoneSchema: z.ZodEnum<{
+    "managed-community": "managed-community";
+    staff: "staff";
+}>;
+export declare const CommunicationCommunitySourceStatusSchema: z.ZodEnum<{
+    active: "active";
+    degraded: "degraded";
+    pending: "pending";
+    revoked: "revoked";
+}>;
+export declare const CommunicationCommunitySourceV1Schema: z.ZodObject<{
+    id: z.ZodString;
+    tenantId: z.ZodString;
+    workspaceId: z.ZodString;
+    spaceId: z.ZodString;
+    network: z.ZodLiteral<"discord">;
+    guildId: z.ZodString;
+    name: z.ZodString;
+    specialtyKeys: z.ZodArray<z.ZodString>;
+    trustZone: z.ZodEnum<{
+        "managed-community": "managed-community";
+        staff: "staff";
+    }>;
+    status: z.ZodEnum<{
+        active: "active";
+        degraded: "degraded";
+        pending: "pending";
+        revoked: "revoked";
+    }>;
+    policyRef: z.ZodString;
+    retentionPolicyRef: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strict>;
+export declare const DiscordGuildInstallationV1Schema: z.ZodObject<{
+    id: z.ZodString;
+    sourceId: z.ZodString;
+    guildId: z.ZodString;
+    applicationId: z.ZodString;
+    botUserId: z.ZodString;
+    credentialRef: z.ZodString;
+    declaredIntents: z.ZodArray<z.ZodString>;
+    verifiedPermissions: z.ZodArray<z.ZodString>;
+    allowedChannelIds: z.ZodArray<z.ZodString>;
+    excludedChannelIds: z.ZodArray<z.ZodString>;
+    backfillDays: z.ZodNumber;
+    health: z.ZodEnum<{
+        degraded: "degraded";
+        healthy: "healthy";
+        offline: "offline";
+        pending: "pending";
+        revoked: "revoked";
+    }>;
+    installationEvidenceRefs: z.ZodArray<z.ZodString>;
+    lastVerifiedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const CommunicationProviderIdentityV1Schema: z.ZodObject<{
+    id: z.ZodString;
+    tenantId: z.ZodString;
+    provider: z.ZodLiteral<"discord">;
+    providerUserId: z.ZodString;
+    canonicalPrincipalRef: z.ZodOptional<z.ZodString>;
+    guildMemberships: z.ZodArray<z.ZodObject<{
+        guildId: z.ZodString;
+        roleIds: z.ZodArray<z.ZodString>;
+        state: z.ZodEnum<{
+            active: "active";
+            banned: "banned";
+            left: "left";
+        }>;
+        observedAt: z.ZodString;
+    }, z.core.$strict>>;
+    mergeEvidence: z.ZodArray<z.ZodObject<{
+        providerUserId: z.ZodString;
+        decision: z.ZodLiteral<"approved">;
+        decidedByPrincipalRef: z.ZodString;
+        evidenceRef: z.ZodString;
+        decidedAt: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const CommunicationNormalizedProviderEventV2Schema: z.ZodObject<{
+    id: z.ZodString;
+    schemaVersion: z.ZodLiteral<"2.0.0">;
+    sourceId: z.ZodString;
+    trustZone: z.ZodEnum<{
+        "managed-community": "managed-community";
+        staff: "staff";
+    }>;
+    guildId: z.ZodString;
+    channelId: z.ZodOptional<z.ZodString>;
+    threadId: z.ZodOptional<z.ZodString>;
+    actorProviderUserId: z.ZodOptional<z.ZodString>;
+    eventKind: z.ZodString;
+    gatewaySessionId: z.ZodOptional<z.ZodString>;
+    gatewaySequence: z.ZodOptional<z.ZodNumber>;
+    providerEventId: z.ZodString;
+    occurredAt: z.ZodString;
+    protectedContent: z.ZodOptional<z.ZodObject<{
+        ciphertextRef: z.ZodString;
+        digest: z.ZodString;
+        redactionStatus: z.ZodEnum<{
+            applied: "applied";
+            not_required: "not_required";
+            pending: "pending";
+        }>;
+    }, z.core.$strict>>;
+    metadata: z.ZodRecord<z.ZodString, z.ZodString>;
+    evidenceRefs: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const CommunityInsightV1Schema: z.ZodObject<{
+    sourceIds: z.ZodArray<z.ZodString>;
+    windowStart: z.ZodString;
+    windowEnd: z.ZodString;
+    confidence: z.ZodNumber;
+    evidenceRefs: z.ZodArray<z.ZodString>;
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        emerging_topic: "emerging_topic";
+        friction_trend: "friction_trend";
+        moderation_pattern: "moderation_pattern";
+        pain_point: "pain_point";
+        recurring_question: "recurring_question";
+        response_gap: "response_gap";
+    }>;
+    title: z.ZodString;
+    summary: z.ZodString;
+    specialtyKeys: z.ZodArray<z.ZodString>;
+    metricValue: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const CommunityStaffScorecardV1Schema: z.ZodObject<{
+    sourceIds: z.ZodArray<z.ZodString>;
+    windowStart: z.ZodString;
+    windowEnd: z.ZodString;
+    confidence: z.ZodNumber;
+    evidenceRefs: z.ZodArray<z.ZodString>;
+    id: z.ZodString;
+    staffPrincipalRef: z.ZodString;
+    visibility: z.ZodLiteral<"authorized_manager">;
+    metrics: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    coachingObservations: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const CommunityKaizenDigestV1Schema: z.ZodObject<{
+    sourceIds: z.ZodArray<z.ZodString>;
+    windowStart: z.ZodString;
+    windowEnd: z.ZodString;
+    confidence: z.ZodNumber;
+    evidenceRefs: z.ZodArray<z.ZodString>;
+    id: z.ZodString;
+    status: z.ZodEnum<{
+        draft: "draft";
+        published: "published";
+    }>;
+    insightRefs: z.ZodArray<z.ZodString>;
+    changes: z.ZodArray<z.ZodString>;
+    suggestedExperiments: z.ZodArray<z.ZodString>;
+    generatedAt: z.ZodString;
+}, z.core.$strict>;
+export type CommunicationCommunitySourceV1 = z.infer<typeof CommunicationCommunitySourceV1Schema>;
+export type DiscordGuildInstallationV1 = z.infer<typeof DiscordGuildInstallationV1Schema>;
+export type CommunicationProviderIdentityV1 = z.infer<typeof CommunicationProviderIdentityV1Schema>;
+export type CommunicationNormalizedProviderEventV2 = z.infer<typeof CommunicationNormalizedProviderEventV2Schema>;
+export type CommunityInsightV1 = z.infer<typeof CommunityInsightV1Schema>;
+export type CommunityStaffScorecardV1 = z.infer<typeof CommunityStaffScorecardV1Schema>;
+export type CommunityKaizenDigestV1 = z.infer<typeof CommunityKaizenDigestV1Schema>;

package/dist/contracts/discord-community.models.js

@@ -0,0 +1,2 @@
+// @bun
+import{z as i}from"zod";var o={id:"communication-os.discord-community-intelligence.v1",title:"Multi-guild Discord community intelligence",body:"Additive contracts for policy-scoped Discord guild monitoring, protected provider events, governed identity correlation, evidence-backed community insights, coaching scorecards, and Kaizen digests. Raw staff content never enters cross-guild projections.",kind:"reference",route:"/docs/communication-os/discord-community-intelligence-v1",visibility:"public"},n=i.enum(["staff","managed-community"]),e=i.enum(["pending","active","degraded","revoked"]),m=i.object({id:i.string().min(1),tenantId:i.string().min(1),workspaceId:i.string().min(1),spaceId:i.string().min(1),network:i.literal("discord"),guildId:i.string().min(1),name:i.string().min(1),specialtyKeys:i.array(i.string().min(1)),trustZone:n,status:e,policyRef:i.string().min(1),retentionPolicyRef:i.string().min(1),createdAt:i.string().datetime(),updatedAt:i.string().datetime()}).strict(),s=i.object({id:i.string().min(1),sourceId:i.string().min(1),guildId:i.string().min(1),applicationId:i.string().min(1),botUserId:i.string().min(1),credentialRef:i.string().min(1),declaredIntents:i.array(i.string().min(1)),verifiedPermissions:i.array(i.string().min(1)),allowedChannelIds:i.array(i.string().min(1)),excludedChannelIds:i.array(i.string().min(1)),backfillDays:i.number().int().min(0).max(90),health:i.enum(["pending","healthy","degraded","offline","revoked"]),installationEvidenceRefs:i.array(i.string().min(1)).min(1),lastVerifiedAt:i.string().datetime().optional()}).strict(),a=i.object({id:i.string().min(1),tenantId:i.string().min(1),provider:i.literal("discord"),providerUserId:i.string().min(1),canonicalPrincipalRef:i.string().min(1).optional(),guildMemberships:i.array(i.object({guildId:i.string().min(1),roleIds:i.array(i.string().min(1)),state:i.enum(["active","left","banned"]),observedAt:i.string().datetime()}).strict()),mergeEvidence:i.array(i.object({providerUserId:i.string().min(1),decision:i.literal("approved"),decidedByPrincipalRef:i.string().min(1),evidenceRef:i.string().min(1),decidedAt:i.string().datetime()}).strict())}).strict(),c=i.object({id:i.string().min(1),schemaVersion:i.literal("2.0.0"),sourceId:i.string().min(1),trustZone:n,guildId:i.string().min(1),channelId:i.string().min(1).optional(),threadId:i.string().min(1).optional(),actorProviderUserId:i.string().min(1).optional(),eventKind:i.string().min(1),gatewaySessionId:i.string().min(1).optional(),gatewaySequence:i.number().int().nonnegative().optional(),providerEventId:i.string().min(1),occurredAt:i.string().datetime(),protectedContent:i.object({ciphertextRef:i.string().min(1),digest:i.string().min(1),redactionStatus:i.enum(["pending","applied","not_required"])}).strict().optional(),metadata:i.record(i.string(),i.string()),evidenceRefs:i.array(i.string().min(1)).min(1)}).strict(),t=i.object({sourceIds:i.array(i.string().min(1)).min(1),windowStart:i.string().datetime(),windowEnd:i.string().datetime(),confidence:i.number().min(0).max(1),evidenceRefs:i.array(i.string().min(1)).min(1)}).strict(),d=t.extend({id:i.string().min(1),kind:i.enum(["recurring_question","pain_point","friction_trend","emerging_topic","response_gap","moderation_pattern"]),title:i.string().min(1),summary:i.string().min(1),specialtyKeys:i.array(i.string().min(1)),metricValue:i.number().optional()}).strict(),g=t.extend({id:i.string().min(1),staffPrincipalRef:i.string().min(1),visibility:i.literal("authorized_manager"),metrics:i.record(i.string(),i.number()),coachingObservations:i.array(i.string().min(1))}).strict(),l=t.extend({id:i.string().min(1),status:i.enum(["draft","published"]),insightRefs:i.array(i.string().min(1)),changes:i.array(i.string().min(1)),suggestedExperiments:i.array(i.string().min(1)),generatedAt:i.string().datetime()}).strict();export{e as CommunicationCommunitySourceStatusSchema,m as CommunicationCommunitySourceV1Schema,n as CommunicationCommunityTrustZoneSchema,c as CommunicationNormalizedProviderEventV2Schema,a as CommunicationProviderIdentityV1Schema,d as CommunityInsightV1Schema,l as CommunityKaizenDigestV1Schema,g as CommunityStaffScorecardV1Schema,o as DiscordCommunityIntelligenceDocBlock,s as DiscordGuildInstallationV1Schema};