From 8db95bfc424f20c8e208998171a4e12f2336263b Mon Sep 17 00:00:00 2001
From: npub19zza5yyr075j4vvlg2drsh2xe0xy3dqxhfchlgtw8vryglrry3gq8q7tzk
 <2885da10837fa92ab19f429a385d46cbcc48b406ba717fa16e3b06447c632450@sprout-oss.stage.blox.sqprod.co>
Date: Tue, 7 Jul 2026 20:47:28 -0700
Subject: [PATCH] chore(desktop): generate kinds.ts constants from buzz-core
 kind.rs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The desktop kind registry was a hand-maintained mirror of
crates/buzz-core/src/kind.rs: 55 constants vs 121 upstream, no drift
check, and 10 names that diverged from their canonical buzz-core
spelling. Silent drift here means the client simply doesn't recognize
an event kind — no error, just missing behavior (launch-readiness
review, cross-cutting finding #1).

This makes buzz-core the single source of truth for kind numbers:

- desktop/scripts/generate-kinds.mjs parses kind.rs (read-only input)
  and emits kinds.generated.ts — byte-stable output, source order
  preserved, first doc-comment line carried over, do-not-edit header.
- kinds.ts re-exports the full generated registry, keeps the 10 legacy
  desktop-local names as aliases of the canonical constants (values can
  no longer drift), and retains the desktop-specific derived kind sets
  unchanged.
- pnpm check now runs generate-kinds.mjs --check, which fails CI on any
  drift between kinds.generated.ts and kind.rs — including manual edits
  to the generated file.

No values changed: audit of all 55 pre-existing constants found zero
name/value mismatches against kind.rs (10 naming aliases only).
Behavior is unchanged; all existing imports keep working.

Part of the launch-readiness complexity drip (clients queue #1).
Next up: extend the same generation to mobile's EventKind.

Co-authored-by: Bradley Axen <baxen@squareup.com>
Signed-off-by: Bradley Axen <baxen@squareup.com>
---
 desktop/package.json                          |   4 +-
 desktop/scripts/generate-kinds.mjs            | 108 ++++++++
 .../src/shared/constants/kinds.generated.ts   | 254 ++++++++++++++++++
 desktop/src/shared/constants/kinds.ts         | 113 ++++----
 4 files changed, 414 insertions(+), 65 deletions(-)
 create mode 100644 desktop/scripts/generate-kinds.mjs
 create mode 100644 desktop/src/shared/constants/kinds.generated.ts

diff --git a/desktop/package.json b/desktop/package.json
index ed17b84e3..aa5d1bfd8 100644
--- a/desktop/package.json
+++ b/desktop/package.json
@@ -10,8 +10,10 @@
     "check:file-sizes": "node ./scripts/check-file-sizes.mjs",
     "check:px-text": "node ./scripts/check-px-text.mjs",
     "check:pubkey-truncation": "node ./scripts/check-pubkey-truncation.mjs",
+    "check:kinds": "node ./scripts/generate-kinds.mjs --check",
+    "generate:kinds": "node ./scripts/generate-kinds.mjs",
     "lint": "biome lint .",
-    "check": "biome check . && pnpm check:file-sizes && pnpm check:px-text && pnpm check:pubkey-truncation",
+    "check": "biome check . && pnpm check:file-sizes && pnpm check:px-text && pnpm check:pubkey-truncation && pnpm check:kinds",
     "format": "biome format --write .",
     "test": "node --import ./test-loader.mjs --experimental-strip-types --test 'src/**/*.test.mjs'",
     "preview": "vite preview",
diff --git a/desktop/scripts/generate-kinds.mjs b/desktop/scripts/generate-kinds.mjs
new file mode 100644
index 000000000..ff44b68b0
--- /dev/null
+++ b/desktop/scripts/generate-kinds.mjs
@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+// Generates desktop/src/shared/constants/kinds.generated.ts from
+// crates/buzz-core/src/kind.rs — the authoritative Buzz kind registry.
+//
+// Usage:
+//   node scripts/generate-kinds.mjs            # write the generated file
+//   node scripts/generate-kinds.mjs --check    # fail (exit 1) if the committed
+//                                              # file differs from regenerated
+//                                              # output (drift or hand-edits)
+//
+// kind.rs is read-only input; never edit it from here. Output is byte-stable:
+// constants are emitted in kind.rs source order with the first doc-comment
+// line carried over.
+
+import { readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const desktopDir = dirname(dirname(fileURLToPath(import.meta.url)));
+const repoRoot = dirname(desktopDir);
+const sourcePath = join(repoRoot, "crates", "buzz-core", "src", "kind.rs");
+const outputPath = join(
+  desktopDir,
+  "src",
+  "shared",
+  "constants",
+  "kinds.generated.ts",
+);
+
+function parseKinds(rustSource) {
+  const lines = rustSource.split("\n");
+  const kinds = [];
+  let docFirstLine = null;
+  for (const line of lines) {
+    const doc = line.match(/^\s*\/\/\/\s?(.*)$/);
+    if (doc) {
+      // Keep only the first line of each doc block as the TS comment.
+      if (docFirstLine === null) docFirstLine = doc[1].trim();
+      continue;
+    }
+    const konst = line.match(/^pub const (KIND_\w+): u32 = (\d+);/);
+    if (konst) {
+      kinds.push({ name: konst[1], value: konst[2], doc: docFirstLine });
+      docFirstLine = null;
+      continue;
+    }
+    // Any non-doc line (blank, attribute, other item) ends a doc block.
+    docFirstLine = null;
+  }
+  return kinds;
+}
+
+function render(kinds) {
+  const header = `// GENERATED FILE — DO NOT EDIT.
+//
+// Generated from crates/buzz-core/src/kind.rs (the authoritative Buzz kind
+// registry) by desktop/scripts/generate-kinds.mjs. To change a kind number or
+// add a kind, edit kind.rs and re-run:
+//
+//   node scripts/generate-kinds.mjs
+//
+// CI runs \`node scripts/generate-kinds.mjs --check\` (via \`pnpm check\`) and
+// fails on any drift between this file and kind.rs, including manual edits
+// to this file.
+`;
+  const body = kinds
+    .map(({ name, value, doc }) => {
+      const comment = doc ? `/** ${doc} */\n` : "";
+      return `${comment}export const ${name} = ${value};\n`;
+    })
+    .join("");
+  return `${header}\n${body}`;
+}
+
+const kinds = parseKinds(readFileSync(sourcePath, "utf8"));
+if (kinds.length === 0) {
+  console.error(
+    `generate-kinds: parsed 0 constants from ${sourcePath} — parser is broken or kind.rs moved`,
+  );
+  process.exit(1);
+}
+const generated = render(kinds);
+
+if (process.argv.includes("--check")) {
+  let committed = null;
+  try {
+    committed = readFileSync(outputPath, "utf8");
+  } catch {
+    console.error(
+      `generate-kinds --check: ${outputPath} is missing; run node scripts/generate-kinds.mjs`,
+    );
+    process.exit(1);
+  }
+  if (committed !== generated) {
+    console.error(
+      "generate-kinds --check: kinds.generated.ts is out of sync with crates/buzz-core/src/kind.rs.\n" +
+        "Re-run `node scripts/generate-kinds.mjs` from desktop/ and commit the result.\n" +
+        "(If you edited kinds.generated.ts by hand: don't — edit kind.rs instead.)",
+    );
+    process.exit(1);
+  }
+  console.log(`generate-kinds --check: OK (${kinds.length} constants in sync)`);
+} else {
+  writeFileSync(outputPath, generated);
+  console.log(
+    `generate-kinds: wrote ${kinds.length} constants to ${outputPath}`,
+  );
+}
diff --git a/desktop/src/shared/constants/kinds.generated.ts b/desktop/src/shared/constants/kinds.generated.ts
new file mode 100644
index 000000000..33efa4cf1
--- /dev/null
+++ b/desktop/src/shared/constants/kinds.generated.ts
@@ -0,0 +1,254 @@
+// GENERATED FILE — DO NOT EDIT.
+//
+// Generated from crates/buzz-core/src/kind.rs (the authoritative Buzz kind
+// registry) by desktop/scripts/generate-kinds.mjs. To change a kind number or
+// add a kind, edit kind.rs and re-run:
+//
+//   node scripts/generate-kinds.mjs
+//
+// CI runs `node scripts/generate-kinds.mjs --check` (via `pnpm check`) and
+// fails on any drift between this file and kind.rs, including manual edits
+// to this file.
+
+/** NIP-01: User profile metadata. */
+export const KIND_PROFILE = 0;
+/** NIP-01: Short text note. */
+export const KIND_TEXT_NOTE = 1;
+/** NIP-02: Contact list / follow list. */
+export const KIND_CONTACT_LIST = 3;
+/** NIP-51: Mute list (replaceable, 10000–19999 range) — pubkeys/events/threads/words a user has muted. */
+export const KIND_MUTE_LIST = 10000;
+/** NIP-51: Pin list (replaceable) — events the user has pinned to their profile. */
+export const KIND_PIN_LIST = 10001;
+/** NIP-65: Relay list metadata (replaceable) — read/write relay preferences for the outbox model. */
+export const KIND_NIP65_RELAY_LIST_METADATA = 10002;
+/** NIP-51: Bookmark list (replaceable) — events/articles/hashtags/URLs the user has bookmarked. */
+export const KIND_BOOKMARK_LIST = 10003;
+/** NIP-51: Emoji list (replaceable) — user preferred emojis and pointers to emoji sets. */
+export const KIND_EMOJI_LIST = 10030;
+/** NIP-51: Follow set (parameterized replaceable, 30000–39999 range) — named curated lists of pubkeys. */
+export const KIND_FOLLOW_SET = 30000;
+/** NIP-51: Bookmark set (parameterized replaceable) — named curated bookmark collections. */
+export const KIND_BOOKMARK_SET = 30003;
+/** NIP-51 / NIP-30: Emoji set (parameterized replaceable). */
+export const KIND_EMOJI_SET = 30030;
+/** NIP-01: Channel metadata (replaceable). Not used by Buzz today. */
+export const KIND_CHANNEL_METADATA = 41;
+/** NIP-09: Event deletion request. */
+export const KIND_DELETION = 5;
+/** NIP-25: Content is emoji char or `+`/`-`. */
+export const KIND_REACTION = 7;
+/** NIP-17: Outer envelope for private DMs — hides sender, content, timestamp. */
+export const KIND_GIFT_WRAP = 1059;
+/** NIP-94: File metadata attachment. */
+export const KIND_FILE_METADATA = 1063;
+/** NIP-23: Long-form content (articles, blog posts, RFCs). */
+export const KIND_LONG_FORM = 30023;
+/** NIP-38: User status (general, music, or custom d-tag). */
+export const KIND_USER_STATUS = 30315;
+/** NIP-78 / NIP-RS: Per-client read state blob for cross-device read position sync. */
+export const KIND_READ_STATE = 30078;
+/** NIP-42 auth event — never stored (carries bearer tokens). */
+export const KIND_AUTH = 22242;
+/** BUD-01: Blossom upload auth (used in upload.rs, not stored). */
+export const KIND_BLOSSOM_AUTH = 24242;
+/** NIP-98: HTTP auth event (used in nip98.rs, not stored). */
+export const KIND_HTTP_AUTH = 27235;
+/** Agent metadata + owner reference (replaceable, agent-authored). */
+export const KIND_AGENT_PROFILE = 10100;
+/** NIP-AE: Agent Engram (parameterized replaceable, agent-authored). */
+export const KIND_AGENT_ENGRAM = 30174;
+/** NIP-ER: Event Reminder (parameterized replaceable, author-only). */
+export const KIND_EVENT_REMINDER = 30300;
+/** NIP-AP: Agent Persona (parameterized replaceable, owner-authored). */
+export const KIND_PERSONA = 30175;
+/** NIP-AP: Agent Team (parameterized replaceable, owner-authored). */
+export const KIND_TEAM = 30176;
+/** NIP-AP: Managed Agent (parameterized replaceable, owner-authored). */
+export const KIND_MANAGED_AGENT = 30177;
+/** NIP-29: Add a user to a group. */
+export const KIND_NIP29_PUT_USER = 9000;
+/** NIP-29: Remove a user from a group. */
+export const KIND_NIP29_REMOVE_USER = 9001;
+/** NIP-29: Edit group metadata. */
+export const KIND_NIP29_EDIT_METADATA = 9002;
+/** NIP-29: Delete an event from a group. */
+export const KIND_NIP29_DELETE_EVENT = 9005;
+/** NIP-29: Create a new group. */
+export const KIND_NIP29_CREATE_GROUP = 9007;
+/** NIP-29: Delete a group. */
+export const KIND_NIP29_DELETE_GROUP = 9008;
+/** NIP-29: Create an invite to a group. */
+export const KIND_NIP29_CREATE_INVITE = 9009;
+/** NIP-29: Request to join a group. */
+export const KIND_NIP29_JOIN_REQUEST = 9021;
+/** NIP-29: Request to leave a group. */
+export const KIND_NIP29_LEAVE_REQUEST = 9022;
+/** NIP-43: Relay membership list snapshot (relay-signed, replaceable by convention). */
+export const KIND_NIP43_MEMBERSHIP_LIST = 13534;
+/** NIP-43: Member added announcement (relay-signed). */
+export const KIND_NIP43_MEMBER_ADDED = 8000;
+/** NIP-43: Member removed announcement (relay-signed). */
+export const KIND_NIP43_MEMBER_REMOVED = 8001;
+/** NIP-43: User leave request (user-signed, ephemeral). */
+export const KIND_NIP43_LEAVE_REQUEST = 28936;
+/** NIP-IA: Request that the relay archive a target identity. */
+export const KIND_IA_ARCHIVE_REQUEST = 9035;
+/** NIP-IA: Request that the relay unarchive a target identity. */
+export const KIND_IA_UNARCHIVE_REQUEST = 9036;
+/** NIP-IA: Archived-identity delta (relay-signed). */
+export const KIND_IA_ARCHIVED = 8002;
+/** NIP-IA: Unarchived-identity delta (relay-signed). */
+export const KIND_IA_UNARCHIVED = 8003;
+/** NIP-IA: Archived identities list snapshot (relay-signed, replaceable). */
+export const KIND_IA_ARCHIVED_LIST = 13535;
+/** NIP-29: Addressable group metadata state. */
+export const KIND_NIP29_GROUP_METADATA = 39000;
+/** NIP-29: Addressable group admins list. */
+export const KIND_NIP29_GROUP_ADMINS = 39001;
+/** NIP-29: Addressable group members list. */
+export const KIND_NIP29_GROUP_MEMBERS = 39002;
+/** NIP-29: Addressable group roles definition. */
+export const KIND_NIP29_GROUP_ROLES = 39003;
+/** Thread summary overlay: `e`/`d` tag = root event id, content = */
+export const KIND_THREAD_SUMMARY = 39005;
+/** Window bounds overlay: `d` tag = `<channel_id>:<request-cursor-or-head>`, */
+export const KIND_WINDOW_BOUNDS = 39006;
+/** Workflow definition (parameterized replaceable, d=workflow_uuid). */
+export const KIND_WORKFLOW_DEF = 30620;
+/** Mesh-LLM relay status (relay-signed, parameterized replaceable, d=buzz-relay-mesh). */
+export const KIND_MESH_LLM_RELAY_STATUS = 30621;
+/** NIP-DV: per-viewer DM visibility snapshot (relay-signed, parameterized */
+export const KIND_DM_VISIBILITY = 30622;
+/** Ephemeral: user presence update (online/away/offline). */
+export const KIND_PRESENCE_UPDATE = 20001;
+/** NIP-AB: Device pairing event. Ephemeral — relay may discard after delivery. */
+export const KIND_PAIRING = 24134;
+/** Ephemeral: typing indicator for a channel. */
+export const KIND_TYPING_INDICATOR = 20002;
+/** Ephemeral: owner-scoped encrypted agent observer telemetry and control frame. */
+export const KIND_AGENT_OBSERVER_FRAME = 24200;
+/** Ephemeral: huddle emoji reaction burst. Channel-scoped to the ephemeral */
+export const KIND_HUDDLE_REACTION = 24810;
+/** Ephemeral: mesh status report (desktop → relay). A relay member reports its */
+export const KIND_MESH_STATUS_REPORT = 24620;
+/** Ephemeral: mesh connect request (desktop → relay). A relay member asks the */
+export const KIND_MESH_CONNECT_REQUEST = 24621;
+/** Ephemeral: mesh call-me-now signal (relay → desktop, relay-signed). The live */
+export const KIND_MESH_CALL_ME_NOW = 24622;
+/** NIP-29 group chat message kind. V1 used kind:10001 (replaceable range — wrong), then 40001. */
+export const KIND_STREAM_MESSAGE = 9;
+/** V1 used kind:10002 (replaceable range — wrong). */
+export const KIND_STREAM_MESSAGE_V2 = 40002;
+/** V1 used kind:10004 (replaceable range + NIP-51 collision — wrong). */
+export const KIND_STREAM_MESSAGE_EDIT = 40003;
+/** A stream message that has been pinned in a channel. */
+export const KIND_STREAM_MESSAGE_PINNED = 40004;
+/** A stream message that has been bookmarked by a user. */
+export const KIND_STREAM_MESSAGE_BOOKMARKED = 40005;
+/** A stream message scheduled for future delivery. */
+export const KIND_STREAM_MESSAGE_SCHEDULED = 40006;
+/** A reminder attached to a stream message or time. */
+export const KIND_STREAM_REMINDER = 40007;
+/** A diff/patch message showing file changes (unified diff format). */
+export const KIND_STREAM_MESSAGE_DIFF = 40008;
+/** Canvas (shared document) for a channel. */
+export const KIND_CANVAS = 40100;
+/** System message for channel state changes (join, leave, rename, etc.). */
+export const KIND_SYSTEM_MESSAGE = 40099;
+/** Channel metadata with computed fields (relay-signed sidecar). */
+export const KIND_CHANNEL_SUMMARY = 40901;
+/** Bulk presence state (relay-signed sidecar). */
+export const KIND_PRESENCE_SNAPSHOT = 40902;
+/** Open/create DM (p-tags = participants). */
+export const KIND_DM_OPEN = 41010;
+/** Add member to group DM. */
+export const KIND_DM_ADD_MEMBER = 41011;
+/** Hide DM from sidebar. */
+export const KIND_DM_HIDE = 41012;
+/** A new direct-message conversation was created. */
+export const KIND_DM_CREATED = 41001;
+/** An agent job was requested. */
+export const KIND_JOB_REQUEST = 43001;
+/** An agent accepted a job request. */
+export const KIND_JOB_ACCEPTED = 43002;
+/** Progress update for an in-flight agent job. */
+export const KIND_JOB_PROGRESS = 43003;
+/** Final result of a completed agent job. */
+export const KIND_JOB_RESULT = 43004;
+/** A job cancellation was requested. */
+export const KIND_JOB_CANCEL = 43005;
+/** An agent job failed with an error. */
+export const KIND_JOB_ERROR = 43006;
+/** Relay-signed notification: the target pubkey was added to a channel. */
+export const KIND_MEMBER_ADDED_NOTIFICATION = 44100;
+/** Relay-signed notification: the target pubkey was removed from a channel. */
+export const KIND_MEMBER_REMOVED_NOTIFICATION = 44101;
+/** NIP-AM: Agent Turn Metric — durable per-turn token-usage record (agent-authored). */
+export const KIND_AGENT_TURN_METRIC = 44200;
+/** A forum post (thread root). */
+export const KIND_FORUM_POST = 45001;
+/** A vote on a forum post. */
+export const KIND_FORUM_VOTE = 45002;
+/** A comment reply on a forum post. */
+export const KIND_FORUM_COMMENT = 45003;
+/** Trigger workflow execution. */
+export const KIND_WORKFLOW_TRIGGER = 46020;
+/** Grant pending approval. */
+export const KIND_APPROVAL_GRANT = 46030;
+/** Deny pending approval. */
+export const KIND_APPROVAL_DENY = 46031;
+/** A workflow was triggered by a matching event. */
+export const KIND_WORKFLOW_TRIGGERED = 46001;
+/** A workflow step began execution. */
+export const KIND_WORKFLOW_STEP_STARTED = 46002;
+/** A workflow step completed successfully. */
+export const KIND_WORKFLOW_STEP_COMPLETED = 46003;
+/** A workflow step failed. */
+export const KIND_WORKFLOW_STEP_FAILED = 46004;
+/** The entire workflow completed successfully. */
+export const KIND_WORKFLOW_COMPLETED = 46005;
+/** The entire workflow failed. */
+export const KIND_WORKFLOW_FAILED = 46006;
+/** The workflow was cancelled before completion. */
+export const KIND_WORKFLOW_CANCELLED = 46007;
+/** A workflow step is waiting for human approval. */
+export const KIND_WORKFLOW_APPROVAL_REQUESTED = 46010;
+/** A pending workflow approval was granted. */
+export const KIND_WORKFLOW_APPROVAL_GRANTED = 46011;
+/** A pending workflow approval was denied. */
+export const KIND_WORKFLOW_APPROVAL_DENIED = 46012;
+/** An audit log entry was recorded. */
+export const KIND_AUDIT_ENTRY = 48001;
+/** A huddle (audio/video session) was started. */
+export const KIND_HUDDLE_STARTED = 48100;
+/** A participant joined a huddle. */
+export const KIND_HUDDLE_PARTICIPANT_JOINED = 48101;
+/** A participant left a huddle. */
+export const KIND_HUDDLE_PARTICIPANT_LEFT = 48102;
+/** A huddle ended. */
+export const KIND_HUDDLE_ENDED = 48103;
+/** Huddle channel guidelines/rules document. */
+export const KIND_HUDDLE_GUIDELINES = 48106;
+/** Internal kind for media upload audit entries. Not a relay event kind. */
+export const KIND_MEDIA_UPLOAD = 49001;
+/** NIP-34: Repository announcement (parameterized replaceable, d-tag = repo-id). */
+export const KIND_GIT_REPO_ANNOUNCEMENT = 30617;
+/** NIP-34: Repository state — current branch/tag refs (parameterized replaceable, d-tag = repo-id). */
+export const KIND_GIT_REPO_STATE = 30618;
+/** NIP-34: Patch (git format-patch output). */
+export const KIND_GIT_PATCH = 1617;
+/** NIP-34: Pull request. */
+export const KIND_GIT_PULL_REQUEST = 1618;
+/** NIP-34: Pull request update (tip commit change). */
+export const KIND_GIT_PR_UPDATE = 1619;
+/** NIP-34: Issue. */
+export const KIND_GIT_ISSUE = 1621;
+/** NIP-34: Status — Open. */
+export const KIND_GIT_STATUS_OPEN = 1630;
+/** NIP-34: Status — Applied / Merged. */
+export const KIND_GIT_STATUS_MERGED = 1631;
+/** NIP-34: Status — Closed. */
+export const KIND_GIT_STATUS_CLOSED = 1632;
+/** NIP-34: Status — Draft. */
+export const KIND_GIT_STATUS_DRAFT = 1633;
diff --git a/desktop/src/shared/constants/kinds.ts b/desktop/src/shared/constants/kinds.ts
index 8b6c8dca6..da3701878 100644
--- a/desktop/src/shared/constants/kinds.ts
+++ b/desktop/src/shared/constants/kinds.ts
@@ -1,67 +1,52 @@
-export const KIND_DELETION = 5;
-export const KIND_REACTION = 7;
-export const KIND_TEXT_NOTE = 1;
-export const KIND_STREAM_MESSAGE = 9;
-// Buzz-native deletion. The relay soft-deletes the target and emits a
-// kind:40099 system message. Treated as a deletion marker alongside kind:5.
-export const KIND_NIP29_DELETE_EVENT = 9005;
-export const KIND_STREAM_MESSAGE_V2 = 40002;
-export const KIND_STREAM_MESSAGE_EDIT = 40003;
-export const KIND_CHANNEL_THREAD_SUMMARY = 39005;
-export const KIND_CHANNEL_WINDOW_BOUNDS = 39006;
-export const KIND_STREAM_MESSAGE_DIFF = 40008;
-export const KIND_REMINDER = 40007;
-export const KIND_SYSTEM_MESSAGE = 40099;
-export const KIND_JOB_REQUEST = 43001;
-export const KIND_JOB_ACCEPTED = 43002;
-export const KIND_JOB_PROGRESS = 43003;
-export const KIND_JOB_RESULT = 43004;
-export const KIND_JOB_CANCEL = 43005;
-export const KIND_JOB_ERROR = 43006;
-export const KIND_FORUM_POST = 45001;
-export const KIND_FORUM_COMMENT = 45003;
-export const KIND_APPROVAL_REQUEST = 46010;
-export const KIND_MEMBER_ADDED_NOTIFICATION = 44100;
-export const KIND_MEMBER_REMOVED_NOTIFICATION = 44101;
-export const KIND_TYPING_INDICATOR = 20002;
-export const KIND_HUDDLE_REACTION = 24810;
-export const KIND_HUDDLE_STARTED = 48100;
-export const KIND_HUDDLE_PARTICIPANT_JOINED = 48101;
-export const KIND_HUDDLE_PARTICIPANT_LEFT = 48102;
-export const KIND_HUDDLE_ENDED = 48103;
-// NIP-78 application-specific data. All use kind 30078; the relay
-// differentiates them by d-tag ("read-state:<slotId>", "channel-sections", "channel-mutes", "channel-stars", "channel-sort").
-export const KIND_READ_STATE = 30078;
-export const KIND_CHANNEL_SECTIONS = 30078;
-export const KIND_CHANNEL_MUTES = 30078;
-export const KIND_CHANNEL_STARS = 30078;
-export const KIND_CHANNEL_SORT = 30078;
-// NIP-33 persona/team/managed-agent projection events (d-tag keyed). Published
-// backend-side as secrets-stripped snapshots; the inbound sync hook subscribes
-// to all three to patch local records. Mirror of buzz-core's KIND_PERSONA etc.
-export const KIND_PERSONA = 30175;
-export const KIND_TEAM = 30176;
-export const KIND_MANAGED_AGENT = 30177;
-export const KIND_USER_STATUS = 30315;
-export const KIND_AGENT_OBSERVER_FRAME = 24200;
-export const KIND_AGENT_TURN_METRIC = 44200;
-export const KIND_MESH_STATUS_REPORT = 24620;
-export const KIND_MESH_CONNECT_REQUEST = 24621;
-export const KIND_MESH_CALL_ME_NOW = 24622;
-export const KIND_EVENT_REMINDER = 30300;
-export const KIND_REPO_ANNOUNCEMENT = 30617;
-export const KIND_REPO_STATE = 30618;
-export const KIND_GIT_PATCH = 1617;
-export const KIND_GIT_PULL_REQUEST = 1618;
-export const KIND_GIT_PR_UPDATE = 1619;
-export const KIND_GIT_ISSUE = 1621;
-export const KIND_GIT_STATUS_OPEN = 1630;
-export const KIND_GIT_STATUS_MERGED = 1631;
-export const KIND_GIT_STATUS_CLOSED = 1632;
-export const KIND_GIT_STATUS_DRAFT = 1633;
-// NIP-DV: relay-signed per-viewer DM visibility snapshot (d=viewer pubkey,
-// h-tags = currently-hidden DM channel ids).
-export const KIND_DM_VISIBILITY = 30622;
+// Kind constants are generated from crates/buzz-core/src/kind.rs (the
+// authoritative Buzz kind registry) into kinds.generated.ts — run
+// `node scripts/generate-kinds.mjs` after editing kind.rs. This module
+// re-exports the full registry, keeps legacy desktop-local alias names, and
+// defines the desktop-specific derived kind sets below.
+export * from "./kinds.generated.ts";
+
+// Legacy desktop-local names for constants whose canonical (buzz-core) name
+// differs. Aliased to the generated registry so values cannot drift; new code
+// should prefer the canonical names.
+//
+// The KIND_CHANNEL_* aliases are all NIP-78 application-specific data
+// (kind 30078); the relay differentiates them by d-tag ("read-state:<slotId>",
+// "channel-sections", "channel-mutes", "channel-stars", "channel-sort").
+export {
+  KIND_WORKFLOW_APPROVAL_REQUESTED as KIND_APPROVAL_REQUEST,
+  KIND_READ_STATE as KIND_CHANNEL_MUTES,
+  KIND_READ_STATE as KIND_CHANNEL_SECTIONS,
+  KIND_READ_STATE as KIND_CHANNEL_SORT,
+  KIND_READ_STATE as KIND_CHANNEL_STARS,
+  KIND_THREAD_SUMMARY as KIND_CHANNEL_THREAD_SUMMARY,
+  KIND_WINDOW_BOUNDS as KIND_CHANNEL_WINDOW_BOUNDS,
+  KIND_STREAM_REMINDER as KIND_REMINDER,
+  KIND_GIT_REPO_ANNOUNCEMENT as KIND_REPO_ANNOUNCEMENT,
+  KIND_GIT_REPO_STATE as KIND_REPO_STATE,
+} from "./kinds.generated.ts";
+
+import {
+  KIND_DELETION,
+  KIND_FORUM_COMMENT,
+  KIND_FORUM_POST,
+  KIND_HUDDLE_ENDED,
+  KIND_HUDDLE_PARTICIPANT_JOINED,
+  KIND_HUDDLE_PARTICIPANT_LEFT,
+  KIND_HUDDLE_STARTED,
+  KIND_JOB_ACCEPTED,
+  KIND_JOB_CANCEL,
+  KIND_JOB_ERROR,
+  KIND_JOB_PROGRESS,
+  KIND_JOB_REQUEST,
+  KIND_JOB_RESULT,
+  KIND_NIP29_DELETE_EVENT,
+  KIND_REACTION,
+  KIND_STREAM_MESSAGE,
+  KIND_STREAM_MESSAGE_DIFF,
+  KIND_STREAM_MESSAGE_EDIT,
+  KIND_STREAM_MESSAGE_V2,
+  KIND_SYSTEM_MESSAGE,
+} from "./kinds.generated.ts";
 
 // Human-visible "new content" message kinds. Used as the unread trigger set
 // (sidebar badges, catch-up queries) and as the Home-feed mention query.