feat: @organization mentions

KNOWLEDGE_BASE.md

@@ -11,6 +11,7 @@ This file documents the platform's features, stack, and stories. Feature entries
   - [Public browsing and GitHub sign-in](#public-browsing-and-github-sign-in)
   - [First-time setup](#first-time-setup)
   - [Profiles and GitHub sync](#profiles-and-github-sync)
+  - [Organization pages](#organization-pages)
   - [Going live](#going-live)
   - [Achievement badges and XP](#achievement-badges-and-xp)
   - [Following developers and suggestions](#following-developers-and-suggestions)
@@ -106,6 +107,14 @@ Profiles also show [achievement badges and an XP-based Unix rank](#achievement-b
 
 Sources: [profile page](resources/js/pages/user/show.tsx), [profile settings](resources/js/pages/user-profile/edit.tsx), [profile sharing](resources/js/components/profile-share-button.tsx), [profile README](app/Queries/GitHubReadmeQuery.php), [identity sync](app/Actions/UpdateOrCreateUser.php).
 
+### Organization pages
+
+GitHub organizations, like `@laravel`, have a page at `/@{handle}` too, with their GitHub avatar (square, so they never pass for a person), name, description, location, website, and a link to GitHub. An organization gets its page once an approved commit mentions it, from its public GitHub profile, and the profile refreshes when commits keep mentioning it, at most once a day. Nobody signs in as an organization or edits its page: everything on it comes from GitHub.
+
+Following organizations and reading what the community commits about them are planned, not shipped yet.
+
+Sources: [organization page](resources/js/pages/organization/show.tsx), [organization lookups](app/Actions/UpdateCommitTopics.php).
+
 ### Going live
 
 Share a stream you are running from the **…** menu on your own profile: **Go live** takes a link to a YouTube or Twitch stream (on YouTube: a `/live/` link, a watch link, an embed, or one with a start time all work; on Twitch: your channel link) and how long to show it, from **1 to 12 hours** (two by default). YouTube and Twitch are supported. While you are live, your avatar gets a red ring and a **Live** marker on your profile, in logs, and in hover cards. Hovering it (or tapping it on a touch screen) shows the stream's live thumbnail with a **Watch** button; the stream itself plays on the provider in a new tab, never embedded. On your profile, the avatar links straight to the stream.
@@ -206,7 +215,7 @@ Commit and reply text supports inline code in backticks and fenced code blocks w
 
 In commits, replies, and remotes, start a line with `>` to render a quote block. Consecutive quoted lines stay together; an unquoted line ends the block. Quotes keep inline code, links, mentions, and emoji formatting. A `>` inside code or in the middle of a line stays literal.
 
-Typing **@** in a composer opens developer suggestions. Use ↑/↓ to move, Enter or Tab to select, and Esc to dismiss. A bare @ suggests people you follow; typing more searches names and usernames. In replies, matching suggestions put the direct recipient first, then the root commit author, then other visible participants in that thread, followed by ordinary suggestions. Quotes prioritize only the quoted commit author. These priorities also apply to a bare @; typing a term still filters everyone, and yourself, muted developers, and blocked developers are excluded. In an org's messages, suggestions search the loaded member list instantly and update as membership refreshes. Suggestions are limited to the org's members, but you can still type anyone's handle yourself. Mentions link to profiles and can notify the mentioned developer after approval. Email addresses and scoped packages such as `@inertiajs/react` are not treated as mentions.
+Typing **@** in a composer opens developer suggestions. Use ↑/↓ to move, Enter or Tab to select, and Esc to dismiss. A bare @ suggests people you follow; typing more searches names and usernames. In replies, matching suggestions put the direct recipient first, then the root commit author, then other visible participants in that thread, followed by ordinary suggestions. Quotes prioritize only the quoted commit author. These priorities also apply to a bare @; typing a term still filters everyone, and yourself, muted developers, and blocked developers are excluded. In an org's messages, suggestions search the loaded member list instantly and update as membership refreshes. Suggestions are limited to the org's members, but you can still type anyone's handle yourself. Mentions link to profiles and can notify the mentioned developer after approval. Mentioning a GitHub organization, like `@laravel`, links to its [organization page](#organization-pages) and notifies nobody: a known organization links right away, one mentioned for the first time once the commit is approved and GitHub confirms it is an organization. Typing @ followed by a few letters also suggests organizations that already have a page, after developers. Organization mentions only link in commits and replies, not in remotes. Email addresses and scoped packages such as `@inertiajs/react` are not treated as mentions.
 
 Typing **#123** in a composer looks up that exact issue or pull request in the /dev/null repository, `dev-null-sh/dev-null.sh`. The matching title appears beneath the number; click it or use Enter or Tab to insert its GitHub URL, just like choosing an emoji suggestion. A space or punctuation leaves the number as typed and dismisses the suggestion. Missing numbers and failed lookups leave the text unchanged. Code, URL fragments, and references qualified with another repository are not expanded.
 

PRODUCT.md

@@ -35,6 +35,7 @@ What exists, one line each (details in the knowledge base):
 - **Logs:** Following, Latest, and Trending.
 - **Engagement:** follows, stars, saved commits, pins, mentions, and pastéis (an opt-in daily allowance of pastries).
 - **Profiles:** mirrored from GitHub, with an activity graph, streaks, achievements, a Unix rank, and a live marker while you stream on YouTube.
+- **Organization pages:** GitHub organizations get a page mirrored from GitHub once an approved commit mentions them, and `@organization` mentions link to it.
 - **Remotes:** private one-to-one and group messages (orgs).
 - **Notifications:** in-app activity and on-site Remotes alerts by default; off-site browser and PWA notifications require a separate opt-in. Sound is controlled independently and plays while the site is open.
 - **Search:** developers by name, commits by meaning.
@@ -59,7 +60,7 @@ Deliberately excluded: sign-up or identity outside GitHub, editing commits, and
 - Voice: dry, terminal-literate humor. Understated wit; copy may wink at Unix and `/dev/null`, but stays clear and never obscures what an action does.
 - Lore is part of the product: Tom (everyone's first friend, after MySpace Tom), pastéis (a tribute to the pastéis de nata brought to the livestream), @world, the Unix-named achievements. Extend it with restraint, never at the expense of clarity. The stories behind it are in the knowledge base.
 - Current tagline in use: "A social network for developers."
-- Vocabulary: a post is a **commit** and a timeline is a **log**, in the UI and in code (`Commit` model, `LogController`, `/log/{log}`). A GitHub account mirrored at its `/@handle` is a **profile** (`Profile` model, as GitHub's `ProfileOwner`), and the unique name GitHub calls its login is its **handle** in code and in the API. The git metaphor stops at those two nouns, except inside Remotes, which carries its own small vocabulary: a conversation is a **remote**, sending is a **push**, a read receipt is **pulled**, a request is **fetched** until **merged** or **dropped**, archiving is **stash** and **pop**, a group is an **org** of **maintainers** and **contributors**, and **HEAD** marks where you left off. No branches, forks, diffs, or PRs. **Star** is the engagement verb, not a git ref.
+- Vocabulary: a post is a **commit** and a timeline is a **log**, in the UI and in code (`Commit` model, `LogController`, `/log/{log}`). A GitHub account mirrored at its `/@handle` is a **profile** (`Profile` model, as GitHub's `ProfileOwner`), a developer's or a GitHub **organization**'s, and the unique name GitHub calls its login is its **handle** in code and in the API. A GitHub organization is never called an org, so it is not mistaken for a Remotes group. The git metaphor stops at those two nouns, except inside Remotes, which carries its own small vocabulary: a conversation is a **remote**, sending is a **push**, a read receipt is **pulled**, a request is **fetched** until **merged** or **dropped**, archiving is **stash** and **pop**, a group is an **org** of **maintainers** and **contributors**, and **HEAD** marks where you left off. No branches, forks, diffs, or PRs. **Star** is the engagement verb, not a git ref.
 
 ## Evidence on Hand
 

app/Actions/CreateCommit.php

@@ -9,12 +9,14 @@
 use App\Enums\CommitStatus;
 use App\Jobs\CheckUserLevel;
 use App\Jobs\EmbedCommit;
+use App\Jobs\LinkCommitTopics;
 use App\Jobs\ModerateCommit;
 use App\Jobs\ReplyAsTom;
 use App\Jobs\UnfurlLink;
 use App\Models\Commit;
 use App\Models\LinkPreview;
 use App\Models\User;
+use App\Queries\MentionedOrganizationsQuery;
 use App\Queries\MentionedUsersQuery;
 use App\Queries\TomQuery;
 use App\Services\EmojiShortcodes;
@@ -36,6 +38,8 @@ public function __construct(
         private EmojiShortcodes $emojiShortcodes,
         private Urls $urls,
         private MentionedUsersQuery $mentionedUsers,
+        private MentionedOrganizationsQuery $mentionedOrganizations,
+        private CreateCommitTopics $createCommitTopics,
         private TomQuery $tomQuery,
     ) {
         //
@@ -59,10 +63,11 @@ public function handle(User $user, string $body, ?Commit $parent = null, ?Commit
             $linkPreview = $this->linkPreviewFor($url);
             $createdAt = now();
             $hasGoodReputation = $user->hasGoodReputation();
+            $mentions = $this->mentionedUsers->get($body);
 
             $commit = $user->commits()->create([
                 'body' => $this->emojiShortcodes->replace($body),
-                'mentions' => $this->mentionedUsers->get($body),
+                'mentions' => $mentions,
                 'parent_id' => $parent?->id,
                 'root_id' => $parent?->threadRootId(),
                 'status' => $user->isAdmin() || $hasGoodReputation ? CommitStatus::Approved : CommitStatus::Pending,
@@ -72,6 +77,7 @@ public function handle(User $user, string $body, ?Commit $parent = null, ?Commit
                 'created_at' => $createdAt,
             ]);
 
+            $this->createCommitTopics->handle($commit, $this->mentionedOrganizations->get($body, $mentions));
             $this->createCommitImages->handle($commit, $images, $imageDescriptions);
 
             if ($poll instanceof NewPoll) {
@@ -106,6 +112,8 @@ public function handle(User $user, string $body, ?Commit $parent = null, ?Commit
                 dispatch(new CheckUserLevel($user))->afterCommit();
             }
 
+            LinkCommitTopics::dispatchFor($commit);
+
             if ($commit->status === CommitStatus::Pending && ! $hasGoodReputation) {
                 dispatch(new ModerateCommit($commit))->afterCommit();
             }

app/Actions/CreateCommitTopics.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Actions;
+
+use App\Enums\TopicType;
+use App\Models\Commit;
+use Illuminate\Support\Facades\DB;
+
+final readonly class CreateCommitTopics
+{
+    /**
+     * Links the commit to the organizations it mentions, by the lowercase handle written in its body. A reference the
+     * commit is already linked by keeps what it was linked to. A handle of digits only is still a string reference.
+     *
+     * @param  array<string, string>  $organizations
+     */
+    public function handle(Commit $commit, array $organizations): void
+    {
+        DB::table('commit_topics')->insertOrIgnore(array_map(fn (int|string $reference, string $id): array => [
+            'commit_id' => $commit->id,
+            'reference' => (string) $reference,
+            'topic_type' => TopicType::Organization->value,
+            'topic_id' => $id,
+        ], array_keys($organizations), $organizations));
+    }
+}

app/Actions/DeleteCommitContent.php

@@ -33,6 +33,8 @@ public function handle(Commit $commit): void
 
             LinkPreview::query()->where('url', 'like', "%/commits/{$commit->id}%")->delete();
 
+            DB::table('commit_topics')->where('commit_id', $commit->id)->delete();
+
             $commit->update(['body' => '', 'mentions' => null, 'embedding' => null, 'link_preview_id' => null]);
 
             return $imagePaths;

app/Actions/DeleteOrganization.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Actions;
+
+use App\Enums\TopicType;
+use App\Models\Profile;
+use Illuminate\Support\Facades\DB;
+
+final readonly class DeleteOrganization
+{
+    /**
+     * Deletes an organization GitHub no longer has, and unlinks the commits that mention it, so none links to a page
+     * that is gone.
+     */
+    public function handle(Profile $organization): void
+    {
+        DB::transaction(function () use ($organization): void {
+            DB::table('commit_topics')
+                ->where('topic_type', TopicType::Organization->value)
+                ->where('topic_id', $organization->id)
+                ->delete();
+
+            $organization->delete();
+        });
+    }
+}

app/Actions/DeleteUser.php

@@ -43,13 +43,17 @@ public function handle(User $user): void
 
             $imagePaths = [...$this->imagePaths($user), ...$this->scheduledImagePaths($user), ...$this->messageImagePaths($user), ...$this->messageVoicePaths($user)];
 
-            $translationKeys = Commit::query()->withTrashed()
-                ->where(fn (CommitBuilder $query): CommitBuilder => $query->where('user_id', $user->id)
-                    ->orWhereIn('root_id', $user->commits()->withTrashed()->topLevel()->select('id')))
+            $translationKeys = $this->touchedCommits($user)
                 ->select(['id', 'body'])
                 ->lazyById(500)
                 ->map(resolve(CommitTranslations::class)->key(...))->unique()->all();
 
+            // Locked first, in statements of their own, so a topic lookup running meanwhile either links before this deletes its
+            // links or finds the commit erased. The threads are locked before their replies, so no reply joins them in between.
+            $user->commits()->withTrashed()->topLevel()->orderBy('id')->lockForUpdate()->pluck('id');
+            $this->touchedCommits($user)->orderBy('id')->lockForUpdate()->pluck('id');
+
+            DB::table('commit_topics')->whereIn('commit_id', $this->touchedCommits($user)->select('id'))->delete();
             $user->commits()->withTrashed()->topLevel()->forceDelete();
             CommitImage::query()->whereIn('commit_id', $this->replies($user)->select('id'))->delete();
             CommitReport::query()->whereIn('commit_id', $this->replies($user)->select('id'))->delete();
@@ -95,6 +99,16 @@ private function engagedCommitIds(User $user): array
         ];
     }
 
+    /**
+     * The user's commits and every commit in the threads they started: all the erasure deletes or leaves as a tombstone.
+     */
+    private function touchedCommits(User $user): CommitBuilder
+    {
+        return Commit::query()->withTrashed()
+            ->where(fn (CommitBuilder $query): CommitBuilder => $query->where('user_id', $user->id)
+                ->orWhereIn('root_id', $user->commits()->withTrashed()->topLevel()->select('id')));
+    }
+
     /**
      * @return HasMany<Commit, User>
      */

app/Actions/UpdateCommitStatuses.php

@@ -7,6 +7,7 @@
 use App\Enums\CommitStatus;
 use App\Enums\NotificationType;
 use App\Jobs\CheckUserLevel;
+use App\Jobs\LinkCommitTopics;
 use App\Jobs\ReplyAsTom;
 use App\Models\Commit;
 use App\Models\Notification;
@@ -84,6 +85,7 @@ public function handle(array $commitIds, CommitStatus $status, ?string $reason =
                 $this->createMentionNotifications->handle(...$commits);
 
                 $commits->each(fn (Commit $commit) => $this->createWorldReply->handle($commit));
+                LinkCommitTopics::dispatchFor(...$commits->all());
 
                 if (($tom = $this->tomQuery->get()) instanceof User) {
                     foreach ($commits as $commit) {