twenty-bells 1.0.0

package/README.md

@@ -0,0 +1,112 @@
+# The Bell
+
+An activity feed inside Twenty. A bell button in the top-right corner opens a side panel showing what happened in the CRM, what your team is talking about, and what is overdue on you personally.
+
+Русская версия: [README.ru.md](https://github.com/frasimah/twenty_bells/blob/main/README.ru.md).
+
+## What it does
+
+- **Change feed.** Records created and edited, read from the standard `timelineActivity` — custom objects included. Field changes render as a diff, and `SELECT` values keep the same coloured labels the record page uses.
+- **Documents.** Twenty emits no timeline event for an attachment, so the panel reads files separately and files each one into the card of the record it hangs on — a deal, a contact, a custom object. Clicking the file name opens the attachment; clicking anywhere else on the card opens the record.
+- **Buzz.** Team notes as posts with their comments underneath. Twenty has no comment object — amending a note's body is the mechanism — so each thread is reconstructed from the `note.updated` diffs, and every reply says who wrote it and when.
+- **Tasks.** Overdue first, oldest first, then everything else by due date. Done tasks are dropped. If a task belongs to a deal, the deal is on the row. The badge counts what is assigned to you and not done — asked of the server, so it is the real number rather than the length of the loaded page.
+- **Grouping.** Several events on one record collapse into a single line with a counter that expands in place. A burst of identical events — an import, a bulk edit — becomes one row like `29 × document · added`.
+- **Read / unread.** The marker is personal, stored per `userId` in the app's own object.
+- **Opens the record.** A click opens the object in Twenty's side panel without leaving the page.
+
+## What it costs to keep open
+
+Nothing at all until the bell is clicked. The panel is a side panel and Twenty loads it on demand — the renderer is not even fetched before that, and closing the panel unmounts the whole thing.
+
+Open, it polls once a minute, and every tick asks one cheap question first: the id of the newest event and the size of the window, one row without relations, about 2 KB. Unchanged means the tab already holds the truth and nothing else is fetched. Five minutes without a click, a keypress or a scroll inside the panel and it stops asking altogether, saying so in a line at the top; the next touch resumes it and refreshes at once.
+
+On a workspace of some 1,800 tasks and as many notes that comes to roughly 10 KB a minute while somebody is actually reading it.
+
+The trade is latency: a new event surfaces within a minute rather than instantly.
+
+## Requirements
+
+- Twenty server **2.23.0 or later** (declared as `engines.twenty`)
+- Node 24 and Yarn 4 for local development
+
+## Install into your Twenty
+
+```bash
+git clone https://github.com/frasimah/twenty_bells.git
+cd twenty_bells
+corepack enable
+yarn install
+```
+
+You need an API key for the target instance: in Twenty open **Settings → APIs → Create API key** and copy the value — it is shown once.
+
+```bash
+yarn twenty remote:add --as my-crm --url https://your-twenty-server.com --api-key <YOUR_KEY>
+yarn twenty remote:use my-crm
+yarn twenty apply
+```
+
+`--url` is the **server** address, not the frontend, if the two are on different ports. The key is stored in `~/.twenty/config.json` and never reaches the repository.
+
+`apply` prints the plan first, then syncs the application, its role, the technical `feedReadState` object, the front component and the command-menu button. Reload the CRM tab afterwards — the bell appears in the top-right corner.
+
+No instance of your own? `yarn twenty docker:start` brings one up on `http://localhost:2020` (`tim@apple.dev` / `tim@apple.dev`), and `remote:add --local` finds it by itself.
+
+Updating after a `git pull` is the same `yarn twenty apply`. To remove the app, `yarn twenty app:uninstall`.
+
+## Permissions
+
+The panel calls the API under the **application's** role, not under the permissions of the person who opened it. So:
+
+- on the **Organization** plan row-level permissions apply — Twenty scopes the data itself and the panel adds no filtering of its own;
+- on other plans the predicates sync but stay inert, and the panel filters client-side: by deal owner, company account owner and task assignee.
+
+Which mode is live is detected at runtime: the panel asks the server for records it should have withheld and reads the answer. When Twenty does the scoping itself, the header carries an **Access: server** badge; otherwise the panel filters on its own and says nothing.
+
+**The client-side filter is not a security boundary.** Until row-level permissions are enforced, the server hands the whole workspace to the browser. Install the app where that is acceptable.
+
+## Settings
+
+The app deliberately ships **no Settings tab**. What would be there — poll interval, page size — lives in `src/front-components/activity-feed.tsx` as constants; change one and run `yarn twenty apply`.
+
+> The reason is not minimalism. The host injects application-variable values into a front component still **encrypted** — `enc:v2:<workspace>:<blob>` — and neither `twenty-sdk` nor `twenty-client-sdk` decrypts them. Verified by printing the raw payload inside the panel: `getApplicationVariable('SHOW_ATTACHMENTS')` returned the ciphertext, not `true`, and the panel read it as "off" and hid every file. Switches an admin can move that change nothing are worse than no switches, so they are gone until Twenty decrypts them.
+>
+> This cannot be diagnosed from outside either: the metadata API refuses to read the values back — an API key gets `Cannot return null for non-nullable field Application.applicationVariables`, the application token is denied by permissions. Writing (`updateOneApplicationVariable`) does work.
+
+Application variables are workspace-wide anyway; the SDK has no per-user ones. Anything personal lives in the app's `feedReadState` object.
+
+## What the feed cannot show
+
+Limits of the source, not of the app:
+
+- **deletions** — Twenty writes no event for them at all;
+- **emails and meetings** — `message` and `calendarEvent` have no relation to `timelineActivity`;
+- **history of deleted records** — the event survives but its link breaks; those rows are marked "record deleted".
+
+## Development
+
+```bash
+yarn lint        # oxlint
+yarn typecheck   # tsgo
+yarn test:unit   # vitest, no server needed
+yarn test        # integration tests against a real instance
+```
+
+CI runs all of it on every push against a Twenty instance spawned for the job. CD is manual (`workflow_dispatch`): the scaffold's deploy-on-push targeted `http://localhost:2020`, which from a GitHub runner is the runner itself.
+
+## Publishing
+
+`Publish` (`.github/workflows/publish.yml`) publishes the package to npm with provenance via [npm trusted publishing](https://docs.npmjs.com/trusted-publishers), which is also how app ownership is claimed in a Twenty marketplace.
+
+1. On npmjs.com register this repository and `publish.yml` as a trusted publisher of the package.
+2. Bump `version` in `package.json`, then push a tag (`git tag v1.0.1 && git push --tags`) or run the workflow from the Actions tab.
+
+npm accepts provenance only from **public** repositories. To publish from a private one, set `TWENTY_APP_PUBLISH_DISABLE_PROVENANCE: 'true'` in the publish step — at the cost of the trust badge and of the marketplace ownership claim.
+
+The marketplace catalog syncs from npm hourly; `yarn twenty dev:catalog-sync` triggers it immediately.
+
+## Learn more
+
+- [Twenty Apps documentation](https://docs.twenty.com/developers/extend/apps/getting-started/quick-start)
+- [twenty-sdk CLI reference](https://www.npmjs.com/package/twenty-sdk)
+- Changes are listed in [CHANGELOG.md](https://github.com/frasimah/twenty_bells/blob/main/CHANGELOG.md).

package/manifest.json

@@ -0,0 +1,251 @@
+{
+  "application": {
+    "universalIdentifier": "95427093-8188-4051-8f40-a94930b08548",
+    "displayName": "The Bell",
+    "description": "Activity feed, team notes and overdue tasks",
+    "author": "kata",
+    "category": "Productivity",
+    "logo": "public/logo.svg",
+    "websiteUrl": "https://kata.agency",
+    "emailSupport": "hello@kata.agency",
+    "issueReportUrl": "https://github.com/frasimah/twenty_bells/issues",
+    "galleryImages": [
+      "public/gallery-1-feed.png",
+      "public/gallery-2-tasks.png",
+      "public/gallery-3-buzz.png"
+    ],
+    "defaultRoleUniversalIdentifier": "c42e0f90-a77f-41cb-af0e-60273784d211",
+    "aboutDescription": "# The Bell\n\nAn activity feed inside Twenty. A bell button in the top-right corner opens a side panel showing what happened in the CRM, what your team is talking about, and what is overdue on you personally.\n\nРусская версия: [README.ru.md](https://github.com/frasimah/twenty_bells/blob/main/README.ru.md).\n\n## What it does\n\n- **Change feed.** Records created and edited, read from the standard `timelineActivity` — custom objects included. Field changes render as a diff, and `SELECT` values keep the same coloured labels the record page uses.\n- **Documents.** Twenty emits no timeline event for an attachment, so the panel reads files separately and files each one into the card of the record it hangs on — a deal, a contact, a custom object. Clicking the file name opens the attachment; clicking anywhere else on the card opens the record.\n- **Buzz.** Team notes as posts with their comments underneath. Twenty has no comment object — amending a note's body is the mechanism — so each thread is reconstructed from the `note.updated` diffs, and every reply says who wrote it and when.\n- **Tasks.** Overdue first, oldest first, then everything else by due date. Done tasks are dropped. If a task belongs to a deal, the deal is on the row. The badge counts what is assigned to you and not done — asked of the server, so it is the real number rather than the length of the loaded page.\n- **Grouping.** Several events on one record collapse into a single line with a counter that expands in place. A burst of identical events — an import, a bulk edit — becomes one row like `29 × document · added`.\n- **Read / unread.** The marker is personal, stored per `userId` in the app's own object.\n- **Opens the record.** A click opens the object in Twenty's side panel without leaving the page.\n\n## What it costs to keep open\n\nNothing at all until the bell is clicked. The panel is a side panel and Twenty loads it on demand — the renderer is not even fetched before that, and closing the panel unmounts the whole thing.\n\nOpen, it polls once a minute, and every tick asks one cheap question first: the id of the newest event and the size of the window, one row without relations, about 2 KB. Unchanged means the tab already holds the truth and nothing else is fetched. Five minutes without a click, a keypress or a scroll inside the panel and it stops asking altogether, saying so in a line at the top; the next touch resumes it and refreshes at once.\n\nOn a workspace of some 1,800 tasks and as many notes that comes to roughly 10 KB a minute while somebody is actually reading it.\n\nThe trade is latency: a new event surfaces within a minute rather than instantly.\n\n## Requirements\n\n- Twenty server **2.23.0 or later** (declared as `engines.twenty`)\n- Node 24 and Yarn 4 for local development\n\n## Install into your Twenty\n\n```bash\ngit clone https://github.com/frasimah/twenty_bells.git\ncd twenty_bells\ncorepack enable\nyarn install\n```\n\nYou need an API key for the target instance: in Twenty open **Settings → APIs → Create API key** and copy the value — it is shown once.\n\n```bash\nyarn twenty remote:add --as my-crm --url https://your-twenty-server.com --api-key <YOUR_KEY>\nyarn twenty remote:use my-crm\nyarn twenty apply\n```\n\n`--url` is the **server** address, not the frontend, if the two are on different ports. The key is stored in `~/.twenty/config.json` and never reaches the repository.\n\n`apply` prints the plan first, then syncs the application, its role, the technical `feedReadState` object, the front component and the command-menu button. Reload the CRM tab afterwards — the bell appears in the top-right corner.\n\nNo instance of your own? `yarn twenty docker:start` brings one up on `http://localhost:2020` (`tim@apple.dev` / `tim@apple.dev`), and `remote:add --local` finds it by itself.\n\nUpdating after a `git pull` is the same `yarn twenty apply`. To remove the app, `yarn twenty app:uninstall`.\n\n## Permissions\n\nThe panel calls the API under the **application's** role, not under the permissions of the person who opened it. So:\n\n- on the **Organization** plan row-level permissions apply — Twenty scopes the data itself and the panel adds no filtering of its own;\n- on other plans the predicates sync but stay inert, and the panel filters client-side: by deal owner, company account owner and task assignee.\n\nWhich mode is live is detected at runtime: the panel asks the server for records it should have withheld and reads the answer. When Twenty does the scoping itself, the header carries an **Access: server** badge; otherwise the panel filters on its own and says nothing.\n\n**The client-side filter is not a security boundary.** Until row-level permissions are enforced, the server hands the whole workspace to the browser. Install the app where that is acceptable.\n\n## Settings\n\nThe app deliberately ships **no Settings tab**. What would be there — poll interval, page size — lives in `src/front-components/activity-feed.tsx` as constants; change one and run `yarn twenty apply`.\n\n> The reason is not minimalism. The host injects application-variable values into a front component still **encrypted** — `enc:v2:<workspace>:<blob>` — and neither `twenty-sdk` nor `twenty-client-sdk` decrypts them. Verified by printing the raw payload inside the panel: `getApplicationVariable('SHOW_ATTACHMENTS')` returned the ciphertext, not `true`, and the panel read it as \"off\" and hid every file. Switches an admin can move that change nothing are worse than no switches, so they are gone until Twenty decrypts them.\n>\n> This cannot be diagnosed from outside either: the metadata API refuses to read the values back — an API key gets `Cannot return null for non-nullable field Application.applicationVariables`, the application token is denied by permissions. Writing (`updateOneApplicationVariable`) does work.\n\nApplication variables are workspace-wide anyway; the SDK has no per-user ones. Anything personal lives in the app's `feedReadState` object.\n\n## What the feed cannot show\n\nLimits of the source, not of the app:\n\n- **deletions** — Twenty writes no event for them at all;\n- **emails and meetings** — `message` and `calendarEvent` have no relation to `timelineActivity`;\n- **history of deleted records** — the event survives but its link breaks; those rows are marked \"record deleted\".\n\n## Development\n\n```bash\nyarn lint        # oxlint\nyarn typecheck   # tsgo\nyarn test:unit   # vitest, no server needed\nyarn test        # integration tests against a real instance\n```\n\nCI runs all of it on every push against a Twenty instance spawned for the job. CD is manual (`workflow_dispatch`): the scaffold's deploy-on-push targeted `http://localhost:2020`, which from a GitHub runner is the runner itself.\n\n## Publishing\n\n`Publish` (`.github/workflows/publish.yml`) publishes the package to npm with provenance via [npm trusted publishing](https://docs.npmjs.com/trusted-publishers), which is also how app ownership is claimed in a Twenty marketplace.\n\n1. On npmjs.com register this repository and `publish.yml` as a trusted publisher of the package.\n2. Bump `version` in `package.json`, then push a tag (`git tag v1.0.1 && git push --tags`) or run the workflow from the Actions tab.\n\nnpm accepts provenance only from **public** repositories. To publish from a private one, set `TWENTY_APP_PUBLISH_DISABLE_PROVENANCE: 'true'` in the publish step — at the cost of the trust badge and of the marketplace ownership claim.\n\nThe marketplace catalog syncs from npm hourly; `yarn twenty dev:catalog-sync` triggers it immediately.\n\n## Learn more\n\n- [Twenty Apps documentation](https://docs.twenty.com/developers/extend/apps/getting-started/quick-start)\n- [twenty-sdk CLI reference](https://www.npmjs.com/package/twenty-sdk)\n- Changes are listed in [CHANGELOG.md](https://github.com/frasimah/twenty_bells/blob/main/CHANGELOG.md).\n",
+    "yarnLockChecksum": "5fdce6f28140aad07baeb584f638c172",
+    "packageJsonChecksum": "fcfb3cd67ba5ec922b68ecb390724ae6",
+    "requiredServerVersionRange": ">=2.23.0"
+  },
+  "objects": [
+    {
+      "universalIdentifier": "0f619b61-82c0-410a-83ff-c586c16f0bff",
+      "nameSingular": "feedReadState",
+      "namePlural": "feedReadStates",
+      "labelSingular": "Feed Read State",
+      "labelPlural": "Feed Read States",
+      "description": "Per-user last seen marker for the activity feed",
+      "icon": "IconEye",
+      "fields": [
+        {
+          "universalIdentifier": "10195d66-dbbe-433d-ac8a-6b4b76acbcfc",
+          "name": "userId",
+          "type": "TEXT",
+          "label": "User id",
+          "icon": "IconUser"
+        },
+        {
+          "universalIdentifier": "8bfb613d-43f5-4869-965b-8a569290a9ae",
+          "name": "lastSeenAt",
+          "type": "DATE_TIME",
+          "label": "Last seen at",
+          "icon": "IconClock"
+        },
+        {
+          "name": "name",
+          "label": "Name",
+          "description": "Name",
+          "icon": "IconAbc",
+          "isNullable": true,
+          "defaultValue": null,
+          "type": "TEXT",
+          "universalIdentifier": "fd898ce0-fac3-5c74-a697-1b74dae77dc9"
+        }
+      ],
+      "labelIdentifierFieldMetadataUniversalIdentifier": "fd898ce0-fac3-5c74-a697-1b74dae77dc9"
+    }
+  ],
+  "fields": [],
+  "indexes": [],
+  "permissionFlags": [],
+  "roles": [
+    {
+      "universalIdentifier": "c42e0f90-a77f-41cb-af0e-60273784d211",
+      "label": "The Bell default function role",
+      "description": "The Bell default function role",
+      "canReadAllObjectRecords": true,
+      "canUpdateAllObjectRecords": false,
+      "canSoftDeleteAllObjectRecords": false,
+      "canDestroyAllObjectRecords": false,
+      "objectPermissions": [
+        {
+          "objectUniversalIdentifier": "0f619b61-82c0-410a-83ff-c586c16f0bff",
+          "canReadObjectRecords": true,
+          "canUpdateObjectRecords": true,
+          "canSoftDeleteObjectRecords": false,
+          "canDestroyObjectRecords": false,
+          "universalIdentifier": "f8688503-ae7f-56fd-8df0-e32a0005230f"
+        }
+      ],
+      "rowLevelPermissionPredicates": [
+        {
+          "universalIdentifier": "7a5b1d02-6f43-4c8e-9a21-3d5e8c4b2f10",
+          "objectUniversalIdentifier": "20202020-9549-49dd-b2b2-883999db8938",
+          "fieldUniversalIdentifier": "20202020-be7e-4d1e-8e19-3d5c7c4b9f2a",
+          "operand": "IS",
+          "workspaceMemberFieldUniversalIdentifier": "d77dff76-dcfd-52a3-b352-832898b28b9d"
+        },
+        {
+          "universalIdentifier": "2c9f4b83-51ad-4e26-9f0b-6a7d1e3c8b44",
+          "objectUniversalIdentifier": "20202020-b374-4779-a561-80086cb2e17f",
+          "fieldUniversalIdentifier": "20202020-95b8-4e10-9881-edb5d4765f9d",
+          "operand": "IS",
+          "workspaceMemberFieldUniversalIdentifier": "d77dff76-dcfd-52a3-b352-832898b28b9d"
+        },
+        {
+          "universalIdentifier": "e41d7a65-9c3b-4f18-8d52-0b6e2f9a7c31",
+          "objectUniversalIdentifier": "20202020-1ba1-48ba-bc83-ef7e5990ed10",
+          "fieldUniversalIdentifier": "20202020-065a-4f42-a906-e20422c1753f",
+          "operand": "IS",
+          "workspaceMemberFieldUniversalIdentifier": "d77dff76-dcfd-52a3-b352-832898b28b9d"
+        }
+      ],
+      "fieldPermissions": [],
+      "rowLevelPermissionPredicateGroups": [],
+      "permissionFlagUniversalIdentifiers": []
+    }
+  ],
+  "skills": [],
+  "agents": [],
+  "connectionProviders": [],
+  "logicFunctions": [],
+  "frontComponents": [
+    {
+      "universalIdentifier": "f3947d6f-f605-43a3-817e-281216b367b6",
+      "name": "activity-feed",
+      "description": "Workspace activity feed built on the standard timelineActivity",
+      "componentName": "ActivityFeed",
+      "sourceComponentPath": "src/front-components/activity-feed.tsx",
+      "builtComponentPath": "src/front-components/activity-feed.mjs",
+      "builtComponentChecksum": "5d4ffce5a0105e486f4d0485a69f1664dea51e7d0ba0ea61cfdbe0c0cc26173f",
+      "isHeadless": false,
+      "usesSdkClient": false
+    }
+  ],
+  "publicAssets": [
+    {
+      "filePath": "public/gallery-1-feed.png",
+      "fileName": "gallery-1-feed.png",
+      "fileType": "png",
+      "checksum": "30085327a36506c1975f946ec43af230"
+    },
+    {
+      "filePath": "public/gallery-2-tasks.png",
+      "fileName": "gallery-2-tasks.png",
+      "fileType": "png",
+      "checksum": "d07c65079bd8345277d3a8f465ace1ca"
+    },
+    {
+      "filePath": "public/gallery-3-buzz.png",
+      "fileName": "gallery-3-buzz.png",
+      "fileType": "png",
+      "checksum": "29baaa6ede9d2a4ef018019901fdb815"
+    },
+    {
+      "filePath": "public/logo.svg",
+      "fileName": "logo.svg",
+      "fileType": "svg",
+      "checksum": "eae29937c4ff2c9103cd4b33085c92d3"
+    }
+  ],
+  "views": [],
+  "viewFields": [],
+  "navigationMenuItems": [],
+  "pageLayouts": [],
+  "pageLayoutTabs": [],
+  "commandMenuItems": [
+    {
+      "universalIdentifier": "9e1b2fb1-8ff3-4742-9358-4d425fbb769c",
+      "label": "The Bell",
+      "icon": "IconBell",
+      "shortLabel": "The Bell",
+      "isPinned": true,
+      "availabilityType": "GLOBAL",
+      "frontComponentUniversalIdentifier": "f3947d6f-f605-43a3-817e-281216b367b6"
+    }
+  ],
+  "translations": {
+    "ru-RU": {
+      "SDBm/z": "ещё 1 комментарий",
+      "/9AFM1": "ещё 1 событие по этой записи",
+      "BNg5+K": "Права: сервер",
+      "MMAUm4": "На вас и не завершено: {count}",
+      "4YE4Qc": "По сроку",
+      "H86f9p": "Свернуть",
+      "7i8j3G": "Компания",
+      "vwsXGm": "Не удалось загрузить ленту: {error}",
+      "7Zdnlq": "Документ",
+      "5oD9f/": "Ранее",
+      "8YihB7": "Всё, что изменилось в рабочем пространстве.",
+      "DBO7c2": "Лента",
+      "0clZX0": "Отметка прочтения",
+      "DFgabi": "Отметки прочтения",
+      "qKywYm": "Загрузить предыдущую страницу событий",
+      "Pwqkdw": "Загружаю…",
+      "JSxZVX": "Прочитано",
+      "stgyHs": "Отметить все события прочитанными",
+      "isRobC": "Новое",
+      "p7FfSa": "Заметок пока нет.",
+      "PBQOVr": "Открытых задач нет.",
+      "KiJn9B": "Заметка",
+      "/UWbfN": "Пока ничего не происходило. Создайте или измените любую запись — событие появится здесь.",
+      "1+Oxi9": "Открыть заметку",
+      "P2o9xF": "Открыть задачу",
+      "8FzTxb": "Открытые задачи: сначала просроченные, дальше по сроку.",
+      "cmvr2/": "Открыть: {label}",
+      "SV/iis": "Сделка",
+      "ddrz1m": "Просрочено",
+      "y3hQNM": "Просрочено: {count}",
+      "eBGNxQ": "Персональная отметка прочтения для ленты",
+      "OZdaTZ": "Контакт",
+      "w80YWM": "Запись",
+      "AxtbvG": "Row-level permissions включены: доступ ограничивает сам Twenty, панель ничего не доотфильтровывает.",
+      "+Cg9pL": "Просмотрено {loaded} из {total} обновлений рабочего пространства за последние {days} дней",
+      "fMPkxb": "Показать ещё",
+      "6edDJh": "Показать записи",
+      "fk7pBo": "Показать, к какому месту это написано",
+      "C6+ZRl": "Кто-то",
+      "Q3P/4s": "Задача",
+      "GtycJ/": "Задачи",
+      "mL/Lgk": "Заметки команды и комментарии к ним.",
+      "dxrv8L": "The Bell",
+      "INSpH5": "Автор неизвестен",
+      "wja8aL": "Без названия",
+      "ia8YsC": "Ближайшие",
+      "XTdpcb": "Обновления на паузе — панель простаивает. Нажмите, чтобы продолжить.",
+      "kdh3Fk": "добавлен",
+      "6jYXIg": "дописано: {text}",
+      "GBvSln": "массовое изменение",
+      "6yQlea": "комментарий",
+      "wn8BKW": "создана",
+      "YulJZd": "удалена",
+      "XH30C4": "документ",
+      "k4b5/X": "изменён",
+      "LfQPqi": "через {days} дн",
+      "xOTzt5": "только что",
+      "3LUngZ": "без изменений",
+      "jvRUwM": "без срока",
+      "QHiY/N": "запись удалена, не открыть",
+      "2T3/dQ": "откреплён",
+      "5XqX1f": "переписано: {text}",
+      "3b4nbV": "переписал текст",
+      "4O3LPI": "задача",
+      "bWx82j": "текст добавлен: {text}",
+      "5D2tMA": "текст удалён",
+      "v2pM8o": "текст сокращён",
+      "X0OwOB": "сегодня",
+      "x4Xp3c": "изменена",
+      "gKh0dY": "ещё {count} событий по этой записи",
+      "Froj7p": "{count} обновлений по вашим записям за неделю",
+      "FezTR0": "{count} × {object}",
+      "XWEqQj": "{days} дн",
+      "TK9yAS": "просрочено на {days} дн",
+      "dzoeuc": "ещё {hidden} комментариев",
+      "/oqig9": "{hours} ч",
+      "ZOtn9F": "{minutes} мин"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "twenty-bells",
+  "version": "1.0.0",
+  "description": "The Bell — an activity feed for Twenty: what changed in the workspace, team notes with their comments, documents, and the tasks that are overdue.",
+  "license": "MIT",
+  "author": {
+    "name": "kata",
+    "email": "hello@kata.agency",
+    "url": "https://kata.agency"
+  },
+  "homepage": "https://github.com/frasimah/twenty_bells#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/frasimah/twenty_bells.git"
+  },
+  "bugs": {
+    "url": "https://github.com/frasimah/twenty_bells/issues"
+  },
+  "engines": {
+    "node": "^24.5.0",
+    "npm": "please-use-yarn",
+    "yarn": ">=4.0.2",
+    "twenty": ">=2.23.0"
+  },
+  "keywords": [
+    "twenty-app",
+    "twenty",
+    "crm",
+    "activity-feed",
+    "notifications"
+  ],
+  "packageManager": "yarn@4.13.0",
+  "scripts": {
+    "twenty": "twenty",
+    "lint": "oxlint -c .oxlintrc.json .",
+    "lint:fix": "oxlint --fix -c .oxlintrc.json .",
+    "typecheck": "tsgo --noEmit -p tsconfig.spec.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:unit": "vitest run --config vitest.unit.config.ts"
+  },
+  "devDependencies": {
+    "@types/node": "^24.7.2",
+    "@types/react": "^19.0.0",
+    "@typescript/native-preview": "^7.0.0-dev.20260116.1",
+    "oxlint": "^0.16.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "twenty-client-sdk": "2.23.0",
+    "twenty-sdk": "2.23.0",
+    "twenty-ui": "1.0.0-alpha.1",
+    "typescript": "^5.9.3",
+    "vite-tsconfig-paths": "^4.2.1",
+    "vitest": "^4.0.0"
+  }
+}

package/public/logo.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 80 80" fill="none">
+  <rect width="80" height="80" rx="16" fill="#141414"/>
+  <g
+    transform="translate(16,16) scale(2)"
+    fill="none"
+    stroke="#FAFAFA"
+    stroke-width="1.8"
+    stroke-linecap="round"
+    stroke-linejoin="round"
+  >
+    <path d="M10 5a2 2 0 1 1 4 0a7 7 0 0 1 4 6v3a4 4 0 0 0 2 3h-16a4 4 0 0 0 2 -3v-3a7 7 0 0 1 4 -6" />
+    <path d="M9 17v1a3 3 0 0 0 6 0v-1" />
+  </g>
+</svg>