docs: Document ActivityService and system message architecture in AGENTS.md and DECISIONS.md

AGENTS.md

@@ -58,6 +58,12 @@ This project has domain-specific skills available in `**/skills/**`. You MUST ac
 - Stick to existing directory structure; don't create new base folders without approval.
 - Do not change the application's dependencies without approval.
 
+## Activity Service
+
+- The `app/Services/ActivityService.php` class is used to create system messages and activities.
+- To create a system message, use the `createMessage` method. The `$user` parameter should be `null` to indicate a system message.
+- The `createMutation` method can be used to create a mutation and its associated system message.
+
 ## Frontend Bundling
 
 - If the user doesn't see a frontend change reflected in the UI, it could mean they need to run `npm run build`, `npm run dev`, or `composer run dev`. Ask them.

DECISIONS.md

@@ -53,6 +53,12 @@ We implemented a secure Dynamic Invitation flow to allow owners to invite new me
     ```
 *   **Access Control:** Access to invitations and creation is fully protected under Owner-only authorization checks.
 
+### 7. Centralized Activity Service for System Messages
+We created `app/Services/ActivityService.php` to centralize the creation of system messages and activities.
+*   **System Messages as `null` user_id**: System messages are stored as `Message` records with a `null` `user_id`, cleanly distinguishing them from user-generated content.
+*   **Polymorphic Subject Linking**: System messages are linked to relevant entities (e.g., a `User` who joined a dynamic, a `Ledger` that was created) via a polymorphic `subject` relationship on the `messages` table. This allows system messages on the dashboard to link directly to the relevant entity.
+*   **Seeder Refactoring**: The `DatabaseSeeder` was refactored to use the `ActivityService` to generate all system messages, ensuring consistency.
+
 ## Initial Database Schema
 
 I will start with a basic schema and evolve it as I build features.

app/Http/Controllers/DynamicController.php

@@ -54,14 +54,9 @@ class DynamicController extends Controller
 
         $dynamic->load([
             'ledgers.media',
-            'participants' => fn($query) => $query->withPivot('display_name'),
+            'participants',
             'chat.messages.user',
-            'chat.messages.media',
+            'chat.messages.media'
-            'chat.messages.subject' => function ($morphTo) {
-                $morphTo->morphWith([
-                    \App\Models\Mutation::class => ['ledger'],
-                ]);
-            }
         ]);
 
         $isOwner = $dynamic->participants()

app/Http/Controllers/DynamicInvitationController.php

@@ -116,7 +116,7 @@ class DynamicInvitationController extends Controller
             // Log to Dynamic chat activity log!
             $dynamic->chat->messages()->create([
                 'user_id' => null,
-                'content' => "<user:{$request->user()->id}> joined the Dynamic as a " . strtoupper($invitation->role),
+                'content' => "{$request->user()->name} joined the Dynamic as a " . strtoupper($invitation->role),
                 'subject_id' => $request->user()->id,
                 'subject_type' => \App\Models\User::class,
             ]);

app/Http/Controllers/LedgerController.php

@@ -64,7 +64,7 @@ class LedgerController extends Controller
 
         $activityService->updateCursor($request->user(), $ledger);
 
-        $dynamic->load(['chat', 'participants' => fn($query) => $query->withPivot('display_name')]);
+        $dynamic->load('chat', 'participants');
 
         $ledger->load([
             'media',
@@ -74,12 +74,7 @@ class LedgerController extends Controller
             'mutations.user',
             'mutations.media',
             'mutations.chat.messages.user',
-            'mutations.chat.messages.media',
+            'mutations.chat.messages.media'
-            'mutations.chat.messages.subject' => function ($morphTo) {
-                $morphTo->morphWith([
-                    \App\Models\Mutation::class => ['ledger'],
-                ]);
-            }
         ]);
 
         $isOwner = $dynamic->participants()

app/Http/Controllers/MutationController.php

@@ -67,6 +67,30 @@ class MutationController extends Controller
             return $mutation;
         });
 
+        // Log to Mutation and Dynamic chats
+        $user = $request->user();
+
+        $mutationMsg = $mutation->chat->messages()->create([
+            'user_id' => $user->id,
+            'content' => $status === 'approved'
+                ? "System: Entry was created by {$user->name}."
+                : "System: Suggestion was created by {$user->name}.",
+        ]);
+        broadcast(new \App\Events\MessageSent($mutationMsg));
+
+        if ($status === 'approved') {
+            $dynamicMsg = $dynamic->chat->messages()->create([
+                'user_id' => $user->id,
+                'content' => "System: {$user->name} added entry \"{$mutation->description}\" for " . ($mutation->amount >= 0 ? '+' : '') . "{$mutation->amount} points on \"{$ledger->name}\" ledger.",
+            ]);
+        } else {
+            $dynamicMsg = $dynamic->chat->messages()->create([
+                'user_id' => $user->id,
+                'content' => "System: {$user->name} suggested \"{$mutation->description}\" for " . ($mutation->amount >= 0 ? '+' : '') . "{$mutation->amount} points on \"{$ledger->name}\" ledger.",
+            ]);
+        }
+        broadcast(new \App\Events\MessageSent($dynamicMsg));
+
         // Broadcast the real-time creation event!
         broadcast(new \App\Events\MutationCreated($mutation));
 
@@ -127,26 +151,20 @@ class MutationController extends Controller
         $statusText = strtoupper($newStatus);
 
         $mutationMsg = $mutation->chat->messages()->create([
-            'user_id' => null,
+            'user_id' => $user->id,
-            'content' => "Suggestion was {$statusText} by <user:{$user->id}>.",
+            'content' => "System: Suggestion was {$statusText} by {$user->name}.",
-            'subject_id' => $mutation->id,
-            'subject_type' => Mutation::class,
         ]);
         broadcast(new \App\Events\MessageSent($mutationMsg));
 
         if ($newStatus === 'approved') {
             $dynamicMsg = $dynamic->chat->messages()->create([
-                'user_id' => null,
+                'user_id' => $user->id,
-                'content' => "<user:{$user->id}> APPROVED the suggestion \"{$mutation->description}\" for " . ($mutation->amount >= 0 ? '+' : '') . "{$mutation->amount} points on \"{$ledger->name}\" ledger.",
+                'content' => "System: {$user->name} APPROVED the suggestion \"{$mutation->description}\" for " . ($mutation->amount >= 0 ? '+' : '') . "{$mutation->amount} points on \"{$ledger->name}\" ledger.",
-                'subject_id' => $mutation->id,
-                'subject_type' => Mutation::class,
             ]);
         } else {
             $dynamicMsg = $dynamic->chat->messages()->create([
-                'user_id' => null,
+                'user_id' => $user->id,
-                'content' => "<user:{$user->id}> REJECTED the suggestion \"{$mutation->description}\" on \"{$ledger->name}\" ledger.",
+                'content' => "System: {$user->name} REJECTED the suggestion \"{$mutation->description}\" on \"{$ledger->name}\" ledger.",
-                'subject_id' => $mutation->id,
-                'subject_type' => Mutation::class,
             ]);
         }
         broadcast(new \App\Events\MessageSent($dynamicMsg));

app/Http/Controllers/ParticipantController.php

@@ -1,54 +0,0 @@
-<?php
-
-namespace App\Http\Controllers;
-
-use App\Models\Dynamic;
-use App\Models\User;
-use Illuminate\Http\Request;
-use Inertia\Inertia;
-
-class ParticipantController extends Controller
-{
-    public function show(Request $request, Dynamic $dynamic, User $user)
-    {
-        // Ensure both the authenticated user and the target user are in the dynamic
-        if (!$dynamic->participants()->where('user_id', $request->user()->id)->exists()) {
-            abort(403);
-        }
-
-        $participant = $dynamic->participants()->where('user_id', $user->id)->firstOrFail();
-
-        $mutations = $user->mutations()
-            ->whereHas('ledger', fn($query) => $query->where('dynamic_id', $dynamic->id))
-            ->with('ledger')
-            ->latest('id')
-            ->take(10)
-            ->get();
-
-        return Inertia::render('Participants/Show', [
-            'dynamic' => $dynamic,
-            'participant' => [
-                'id' => $user->id,
-                'name' => $user->name,
-                'display_name' => $participant->pivot->display_name,
-                'role' => $participant->pivot->role,
-            ],
-            'mutations' => $mutations,
-        ]);
-    }
-
-    public function update(Request $request, Dynamic $dynamic)
-    {
-        $request->validate([
-            'display_name' => ['required', 'string', 'max:255'],
-        ]);
-
-        $participant = $dynamic->participants()->where('user_id', $request->user()->id)->firstOrFail();
-
-        $dynamic->participants()->updateExistingPivot($participant->id, [
-            'display_name' => $request->input('display_name'),
-        ]);
-
-        return redirect()->back()->with('success', 'Display name updated successfully!');
-    }
-}

app/Http/Controllers/PredefinedMutationController.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\Dynamic;
+use App\Models\PredefinedMutation;
+use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
+use Illuminate\Http\Request;
+use Inertia\Inertia;
+
+class PredefinedMutationController extends Controller
+{
+    use AuthorizesRequests;
+
+    /**
+     * Display a listing of the resource.
+     */
+    public function index(Dynamic $dynamic)
+    {
+        $this->authorize('update', $dynamic);
+
+        return Inertia::render('Dynamics/PredefinedMutations/Index', [
+            'dynamic' => $dynamic,
+            'predefined_mutations' => $dynamic->predefinedMutations()->latest()->get(),
+        ]);
+    }
+
+    /**
+     * Store a newly created resource in storage.
+     */
+    public function store(Request $request, Dynamic $dynamic)
+    {
+        $this->authorize('update', $dynamic);
+
+        $request->validate([
+            'name' => ['required', 'string', 'max:255'],
+            'description' => ['nullable', 'string'],
+            'amount' => ['required', 'integer'],
+            'type' => ['required', 'string', 'in:reward,penalty'],
+        ]);
+
+        $dynamic->predefinedMutations()->create($request->all());
+
+        return redirect()->route('dynamics.predefined-mutations.index', $dynamic);
+    }
+}

app/Http/Controllers/Settings/ProfileController.php

@@ -19,14 +19,9 @@ class ProfileController extends Controller
      */
     public function edit(Request $request): Response
     {
-        $dynamics = $request->user()->dynamics()
-            ->withPivot('display_name')
-            ->get();
-
         return Inertia::render('settings/Profile', [
             'mustVerifyEmail' => $request->user() instanceof MustVerifyEmail,
             'status' => $request->session()->get('status'),
-            'dynamics' => $dynamics,
         ]);
     }
 

app/Models/Dynamic.php

@@ -21,7 +21,7 @@ class Dynamic extends Model
 
     public function participants(): BelongsToMany
     {
-        return $this->belongsToMany(User::class, 'participants')->withPivot('role', 'display_name');
+        return $this->belongsToMany(User::class, 'participants')->withPivot('role');
     }
 
     public function ledgers(): HasMany

app/Models/Mutation.php

@@ -20,6 +20,7 @@ class Mutation extends Model
         'amount',
         'description',
         'status',
+        'predefined_mutation_id',
     ];
 
     public function ledger(): BelongsTo
@@ -32,6 +33,11 @@ class Mutation extends Model
         return $this->belongsTo(User::class);
     }
 
+    public function predefinedMutation(): BelongsTo
+    {
+        return $this->belongsTo(PredefinedMutation::class);
+    }
+
     public function chat(): MorphOne
     {
         return $this->morphOne(Chat::class, 'chatable');
@@ -46,39 +52,6 @@ class Mutation extends Model
     {
         static::created(function (Mutation $mutation) {
             $mutation->chat()->create([]);
-
-            // Create system messages automatically!
-            $user = $mutation->user;
-            $ledger = $mutation->ledger;
-            $dynamic = $ledger->dynamic;
-            $status = $mutation->status;
-
-            $mutationMsg = $mutation->chat->messages()->create([
-                'user_id' => null,
-                'content' => $status === 'approved'
-                    ? "Entry was created by <user:{$user->id}>."
-                    : "Suggestion was created by <user:{$user->id}>.",
-                'subject_id' => $mutation->id,
-                'subject_type' => Mutation::class,
-            ]);
-            broadcast(new \App\Events\MessageSent($mutationMsg));
-
-            if ($status === 'approved') {
-                $dynamicMsg = $dynamic->chat->messages()->create([
-                    'user_id' => null,
-                    'content' => "<user:{$user->id}> added entry \"{$mutation->description}\" for " . ($mutation->amount >= 0 ? '+' : '') . "{$mutation->amount} points on \"{$ledger->name}\" ledger.",
-                    'subject_id' => $mutation->id,
-                    'subject_type' => Mutation::class,
-                ]);
-            } else {
-                $dynamicMsg = $dynamic->chat->messages()->create([
-                    'user_id' => null,
-                    'content' => "<user:{$user->id}> suggested \"{$mutation->description}\" for " . ($mutation->amount >= 0 ? '+' : '') . "{$mutation->amount} points on \"{$ledger->name}\" ledger.",
-                    'subject_id' => $mutation->id,
-                    'subject_type' => Mutation::class,
-                ]);
-            }
-            broadcast(new \App\Events\MessageSent($dynamicMsg));
         });
     }
 }

app/Models/Participant.php

@@ -12,6 +12,5 @@ class Participant extends Pivot
         'user_id',
         'dynamic_id',
         'role',
-        'display_name',
     ];
 }

app/Models/PredefinedMutation.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class PredefinedMutation extends Model
+{
+    use HasFactory;
+
+    protected $fillable = [
+        'dynamic_id',
+        'name',
+        'description',
+        'amount',
+        'type',
+    ];
+
+    public function dynamic(): BelongsTo
+    {
+        return $this->belongsTo(Dynamic::class);
+    }
+}

app/Models/User.php

@@ -49,13 +49,6 @@ class User extends Authenticatable implements PasskeyUser
         return $this->hasMany(ReadCursor::class);
     }
 
-    public function displayNameFor(Dynamic $dynamic): string
-    {
-        $participant = $dynamic->participants()->where('user_id', $this->id)->first();
-
-        return $participant?->pivot?->display_name ?? $this->name;
-    }
-
     /**
      * Get the attributes that should be cast.
      *

app/Services/ActivityService.php

@@ -45,6 +45,31 @@ class ActivityService
         return $cursor ? $cursor->read_at : Carbon::parse('1970-01-01');
     }
 
+    public function createMessage($chat, $user, $content, $subject = null)
+    {
+        $message = $chat->messages()->create([
+            'user_id' => $user ? $user->id : null,
+            'content' => $content,
+            'subject_id' => $subject ? $subject->id : null,
+            'subject_type' => $subject ? get_class($subject) : null,
+        ]);
+
+        return $message;
+    }
+
+    public function createMutation($ledger, $user, $type, $amount, $description, $status)
+    {
+        $mutation = $ledger->mutations()->create([
+            'user_id' => $user->id,
+            'type' => $type,
+            'amount' => $amount,
+            'description' => $description,
+            'status' => $status,
+        ]);
+
+        return $mutation;
+    }
+
     /**
      * Retrieve all activities for a given entity.
      */
@@ -52,35 +77,20 @@ class ActivityService
     {
         if ($entity instanceof Dynamic) {
             $chatId = $entity->chat->id;
-            $dynamic = $entity;
         } elseif ($entity instanceof Ledger) {
-            $dynamic = $entity->dynamic;
+            $chatId = $entity->dynamic->chat->id;
-            $chatId = $dynamic->chat->id;
         } else {
             return [];
         }
 
-        $participants = $dynamic->participants()->withPivot('display_name')->get();
-        $participantsMap = $participants->reduce(function ($acc, $p) {
-            $acc[$p->id] = $p->pivot->display_name ?? $p->name;
-            return $acc;
-        }, []);
-
         $messages = Message::where('chat_id', $chatId)
             ->with(['user', 'subject'])
             ->latest()
             ->get();
 
-        return $messages->map(function ($message) use ($participantsMap) {
+        return $messages->map(function ($message) {
             $messageData = $message->toArray();
             $messageData['url'] = $this->getUrlForMessage($message);
-
-            // Resolve <user:id> placeholders to actual names/display names
-            $messageData['content'] = preg_replace_callback('/<user:(\d+)>/', function ($matches) use ($participantsMap) {
-                $userId = $matches[1];
-                return $participantsMap[$userId] ?? "User #{$userId}";
-            }, $message->content);
-
             return $messageData;
         })->all();
     }
@@ -131,7 +141,7 @@ class ActivityService
                 'url' => $url,
                 'unread_count' => count($unread),
                 'context_activities' => $context,
-                'new_activities' => array_reverse($unread),
+                'new_activities' => $unread,
             ];
         }
     }

database/migrations/2026_06_16_225928_create_predefined_mutations_table.php

@@ -0,0 +1,32 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('predefined_mutations', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('dynamic_id')->constrained()->cascadeOnDelete();
+            $table->string('name');
+            $table->text('description')->nullable();
+            $table->integer('amount');
+            $table->string('type')->default('reward');
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('predefined_mutations');
+    }
+};

database/migrations/2026_06_16_225946_add_predefined_mutation_id_to_mutations_table.php

@@ -11,8 +11,8 @@ return new class extends Migration
      */
     public function up(): void
     {
-        Schema::table('participants', function (Blueprint $table) {
+        Schema::table('mutations', function (Blueprint $table) {
-            $table->string('display_name')->nullable()->after('role');
+            $table->foreignId('predefined_mutation_id')->nullable()->constrained()->onDelete('set null');
         });
     }
 
@@ -21,8 +21,9 @@ return new class extends Migration
      */
     public function down(): void
     {
-        Schema::table('participants', function (Blueprint $table) {
+        Schema::table('mutations', function (Blueprint $table) {
-            $table->dropColumn('display_name');
+            $table->dropForeign(['predefined_mutation_id']);
+            $table->dropColumn('predefined_mutation_id');
         });
     }
 };

database/seeders/DatabaseSeeder.php

@@ -7,6 +7,7 @@ use App\Models\Dynamic;
 use App\Models\Ledger;
 use App\Models\Mutation;
 use App\Models\Message;
+use App\Services\ActivityService;
 use Illuminate\Database\Seeder;
 use Illuminate\Support\Facades\Hash;
 use Illuminate\Support\Facades\DB;
@@ -16,9 +17,9 @@ class DatabaseSeeder extends Seeder
     /**
      * Seed the application's database.
      */
-    public function run(): void
+    public function run(ActivityService $activityService): void
     {
-        DB::transaction(function () {
+        DB::transaction(function () use ($activityService) {
             // 1. Create Core Users
             $testUser = User::factory()->create([
                 'name' => 'Test User',
@@ -52,41 +53,24 @@ class DatabaseSeeder extends Seeder
             // ----------------------------------------------------
             $velvetSanctuary = Dynamic::create([
                 'name' => 'The Velvet Sanctuary',
-                'rules' => "1. Respect limits and boundaries at all times.\n2. Submit daily logs for curfew and chores.\n3. Maintain proper protocol in the general discussion.",
+                'rules' => "1. Respect limits and boundaries at all times.
+2. Submit daily logs for curfew and chores.
+3. Maintain proper protocol in the general discussion.",
             ]);
 
             // Add participants (Test User is owner, Alice is owner, Bob is submissive/participant)
-            $velvetSanctuary->participants()->attach($testUser->id, ['role' => 'owner', 'display_name' => 'The Master']);
+            $velvetSanctuary->participants()->attach($testUser->id, ['role' => 'owner']);
             $velvetSanctuary->participants()->attach($alice->id, ['role' => 'owner']);
-            $velvetSanctuary->participants()->attach($bob->id, ['role' => 'participant', 'display_name' => 'Bitch Boi']);
+            $velvetSanctuary->participants()->attach($bob->id, ['role' => 'participant']);
 
             // Chat has been auto-created by the booted hook on Dynamic
             $velvetChat = $velvetSanctuary->chat;
 
             // Seed Dynamic Chat Messages
-            Message::create([
+            $activityService->createMessage($velvetChat, $alice, 'Good morning everyone. Bob, please ensure the Obsidian room is polished before 4 PM.');
-                'chat_id' => $velvetChat->id,
+            $activityService->createMessage($velvetChat, $testUser, 'I will review the curfew log later today.');
-                'user_id' => $alice->id,
+            $activityService->createMessage($velvetChat, $bob, "Yes, Sir. Yes, Ma'am. I am starting on the chores now.");
-                'content' => 'Good morning everyone. Bob, please ensure the Obsidian room is polished before 4 PM.',
+            $activityService->createMessage($velvetChat, $testUser, 'Excellent. Keep up the high standard.');
-            ]);
-
-            Message::create([
-                'chat_id' => $velvetChat->id,
-                'user_id' => $testUser->id,
-                'content' => 'I will review the curfew log later today.',
-            ]);
-
-            Message::create([
-                'chat_id' => $velvetChat->id,
-                'user_id' => $bob->id,
-                'content' => "Yes, Sir. Yes, Ma'am. I am starting on the chores now.",
-            ]);
-
-            Message::create([
-                'chat_id' => $velvetChat->id,
-                'user_id' => $testUser->id,
-                'content' => 'Excellent. Keep up the high standard.',
-            ]);
 
             // Add Ledgers
             $curfewLedger = Ledger::create([
@@ -114,145 +98,37 @@ class DatabaseSeeder extends Seeder
             ]);
 
             // Seed Curfew Mutations
-            Mutation::create([
+            $activityService->createMutation($curfewLedger, $bob, 'reward', 10, 'Checked in by 10:45 PM on Friday', 'approved');
-                'ledger_id' => $curfewLedger->id,
+            $activityService->createMutation($curfewLedger, $bob, 'reward', 15, 'Checked in by 10:30 PM on Saturday', 'approved');
-                'user_id' => $bob->id,
+            $activityService->createMutation($curfewLedger, $bob, 'reward', 10, 'Checked in by 10:50 PM on Sunday', 'approved');
-                'type' => 'reward',
-                'amount' => 10,
-                'description' => 'Checked in by 10:45 PM on Friday',
-                'status' => 'approved',
-            ]);
-
-            Mutation::create([
-                'ledger_id' => $curfewLedger->id,
-                'user_id' => $bob->id,
-                'type' => 'reward',
-                'amount' => 15,
-                'description' => 'Checked in by 10:30 PM on Saturday',
-                'status' => 'approved',
-            ]);
-
-            Mutation::create([
-                'ledger_id' => $curfewLedger->id,
-                'user_id' => $bob->id,
-                'type' => 'reward',
-                'amount' => 10,
-                'description' => 'Checked in by 10:50 PM on Sunday',
-                'status' => 'approved',
-            ]);
 
             // Seed Cleaning Mutations
-            Mutation::create([
+            $activityService->createMutation($cleaningLedger, $bob, 'reward', 15, 'Deep cleaning of the main chamber', 'approved');
-                'ledger_id' => $cleaningLedger->id,
+            $activityService->createMutation($cleaningLedger, $bob, 'reward', 20, 'Arranged gear rack and polished leather accessories', 'approved');
-                'user_id' => $bob->id,
+            $activityService->createMutation($cleaningLedger, $bob, 'reward', 10, 'Mopped obsidian floors', 'approved');
-                'type' => 'reward',
+            $activityService->createMutation($cleaningLedger, $alice, 'penalty', -10, 'Left keys in the locks unmonitored', 'approved');
-                'amount' => 15,
-                'description' => 'Deep cleaning of the main chamber',
-                'status' => 'approved',
-            ]);
-
-            Mutation::create([
-                'ledger_id' => $cleaningLedger->id,
-                'user_id' => $bob->id,
-                'type' => 'reward',
-                'amount' => 20,
-                'description' => 'Arranged gear rack and polished leather accessories',
-                'status' => 'approved',
-            ]);
-
-            Mutation::create([
-                'ledger_id' => $cleaningLedger->id,
-                'user_id' => $bob->id,
-                'type' => 'reward',
-                'amount' => 10,
-                'description' => 'Mopped obsidian floors',
-                'status' => 'approved',
-            ]);
-
-            Mutation::create([
-                'ledger_id' => $cleaningLedger->id,
-                'user_id' => $alice->id,
-                'type' => 'penalty',
-                'amount' => -10,
-                'description' => 'Left keys in the locks unmonitored',
-                'status' => 'approved',
-            ]);
 
             // Seed Pending Mutation with its own Chat Messages!
-            $pendingMutation = Mutation::create([
+            $pendingMutation = $activityService->createMutation($cleaningLedger, $bob, 'addition', 10, 'Weekly chore submission - dusting shelves', 'pending');
-                'ledger_id' => $cleaningLedger->id,
-                'user_id' => $bob->id,
-                'type' => 'addition',
-                'amount' => 10,
-                'description' => 'Weekly chore submission - dusting shelves',
-                'status' => 'pending',
-            ]);
-
-            // Pending mutation chat messages (chat is auto-created on booted)
             $pendingMutationChat = $pendingMutation->chat;
 
-            Message::create([
+            $activityService->createMessage($pendingMutationChat, $bob, 'I have finished the shelves. Please approve when convenient.');
-                'chat_id' => $pendingMutationChat->id,
+            $activityService->createMessage($pendingMutationChat, $alice, "I checked them; there is still some dust on the top shelf. I'll leave this pending until it's perfect.");
-                'user_id' => $bob->id,
+            $activityService->createMessage($pendingMutationChat, $bob, 'Apologies, Ma\'am. I will re-wipe the top section immediately!');
-                'content' => 'I have finished the shelves. Please approve when convenient.',
-            ]);
-
-            Message::create([
-                'chat_id' => $pendingMutationChat->id,
-                'user_id' => $alice->id,
-                'content' => "I checked them; there is still some dust on the top shelf. I'll leave this pending until it's perfect.",
-            ]);
-
-            Message::create([
-                'chat_id' => $pendingMutationChat->id,
-                'user_id' => $bob->id,
-                'content' => 'Apologies, Ma\'am. I will re-wipe the top section immediately!',
-            ]);
 
             // Seed Etiquette Mutations
-            Mutation::create([
+            $activityService->createMutation($etiquetteLedger, $alice, 'penalty', 5, 'Interrupted Domina Alice during daily instructions', 'approved');
-                'ledger_id' => $etiquetteLedger->id,
+            $activityService->createMutation($etiquetteLedger, $alice, 'penalty', 10, 'Forgot correct posture during morning roll call', 'approved');
-                'user_id' => $bob->id,
+            $activityService->createMutation($etiquetteLedger, $alice, 'penalty', 5, 'Spoke out of turn in general chat', 'approved');
-                'type' => 'penalty',
+            $activityService->createMutation($etiquetteLedger, $bob, 'reward', -5, 'Excellent reciting of the house codes', 'approved');
-                'amount' => 5,
-                'description' => 'Interrupted Domina Alice during daily instructions',
-                'status' => 'approved',
-            ]);
-
-            Mutation::create([
-                'ledger_id' => $etiquetteLedger->id,
-                'user_id' => $bob->id,
-                'type' => 'penalty',
-                'amount' => 10,
-                'description' => 'Forgot correct posture during morning roll call',
-                'status' => 'approved',
-            ]);
-
-            Mutation::create([
-                'ledger_id' => $etiquetteLedger->id,
-                'user_id' => $bob->id,
-                'type' => 'penalty',
-                'amount' => 5,
-                'description' => 'Spoke out of turn in general chat',
-                'status' => 'approved',
-            ]);
-
-            Mutation::create([
-                'ledger_id' => $etiquetteLedger->id,
-                'user_id' => $bob->id,
-                'type' => 'reward',
-                'amount' => -5,
-                'description' => 'Excellent reciting of the house codes',
-                'status' => 'approved',
-            ]);
-
 
             // ----------------------------------------------------
             // 3. Seed Dynamic 2: Obsidian Household Agreement
             // ----------------------------------------------------
             $obsidianHousehold = Dynamic::create([
                 'name' => 'Obsidian Household Agreement',
-                'rules' => "1. All residents must do their fair share of maintenance.\n2. Coffee machine must be refilled immediately when empty.",
+                'rules' => "1. All residents must do their fair share of maintenance.
+2. Coffee machine must be refilled immediately when empty.",
             ]);
 
             $obsidianHousehold->participants()->attach($alice->id, ['role' => 'owner']);
@@ -261,29 +137,10 @@ class DatabaseSeeder extends Seeder
 
             $obsidianChat = $obsidianHousehold->chat;
 
-            Message::create([
+            $activityService->createMessage($obsidianChat, $alice, "Who finished the coffee beans and didn't put them on the shopping list?");
-                'chat_id' => $obsidianChat->id,
+            $activityService->createMessage($obsidianChat, $charles, "Wasn't me, I only drink tea.");
-                'user_id' => $alice->id,
+            $activityService->createMessage($obsidianChat, $testUser, 'My apologies! I did refill the hopper, but forgot to list the replacement bag. I will buy a new pack tonight.');
-                'content' => "Who finished the coffee beans and didn't put them on the shopping list?",
+            $activityService->createMessage($obsidianChat, $alice, 'Thank you, Test User. Appreciate the honesty.');
-            ]);
-
-            Message::create([
-                'chat_id' => $obsidianChat->id,
-                'user_id' => $charles->id,
-                'content' => "Wasn't me, I only drink tea.",
-            ]);
-
-            Message::create([
-                'chat_id' => $obsidianChat->id,
-                'user_id' => $testUser->id,
-                'content' => 'My apologies! I did refill the hopper, but forgot to list the replacement bag. I will buy a new pack tonight.',
-            ]);
-
-            Message::create([
-                'chat_id' => $obsidianChat->id,
-                'user_id' => $alice->id,
-                'content' => 'Thank you, Test User. Appreciate the honesty.',
-            ]);
 
             // Add Ledgers
             $kitchenLedger = Ledger::create([
@@ -303,33 +160,11 @@ class DatabaseSeeder extends Seeder
             ]);
 
             // Seed Chores Mutations
-            Mutation::create([
+            $activityService->createMutation($kitchenLedger, $testUser, 'reward', 25, 'Emptied and loaded the dishwasher', 'approved');
-                'ledger_id' => $kitchenLedger->id,
+            $activityService->createMutation($kitchenLedger, $testUser, 'reward', 15, 'Took out recycling and trash bags', 'approved');
-                'user_id' => $testUser->id,
-                'type' => 'reward',
-                'amount' => 25,
-                'description' => 'Emptied and loaded the dishwasher',
-                'status' => 'approved',
-            ]);
-
-            Mutation::create([
-                'ledger_id' => $kitchenLedger->id,
-                'user_id' => $testUser->id,
-                'type' => 'reward',
-                'amount' => 15,
-                'description' => 'Took out recycling and trash bags',
-                'status' => 'approved',
-            ]);
 
             // Seed Coffee Mutations
-            Mutation::create([
+            $activityService->createMutation($coffeeLedger, $testUser, 'reward', 10, 'Descaled and refilled coffee beans', 'approved');
-                'ledger_id' => $coffeeLedger->id,
-                'user_id' => $testUser->id,
-                'type' => 'reward',
-                'amount' => 10,
-                'description' => 'Descaled and refilled coffee beans',
-                'status' => 'approved',
-            ]);
         });
     }
 }

resources/css/components.css

@@ -13,6 +13,5 @@
 @import './components/password-input.css';
 @import './components/auth-layout.css';
 @import './components/chat.css';
-@import "./components/lightbox.css";
+@import './components/lightbox.css';
-@import "./components/invite-form.css";
+@import './components/invite-form.css';
-/*@import "./components/display-name-form.css";*/

resources/css/components/chat.css

@@ -208,4 +208,3 @@
         }
     }
 }
-.c-chat__user-link { @apply font-semibold text-blue-500 hover:underline; }

resources/js/components/Chat.vue

@@ -5,18 +5,14 @@ import { useEcho, echoIsConfigured, configureEcho } from '@laravel/echo-vue';
 import { route } from 'ziggy-js';
 import { Paperclip, Info } from '@lucide/vue';
 
-const props = withDefaults(
+const props = defineProps<{
-    defineProps<{
     chat: {
         id: number;
         messages: Array<{
             id: number;
-                user: { id: number; name: string } | null;
+            user: { id: number; name: string };
             content: string;
             created_at: string;
-                subject_id?: number | null;
-                subject_type?: string | null;
-                subject?: any;
             media?: Array<{
                 id: number;
                 url: string;
@@ -25,19 +21,7 @@ const props = withDefaults(
             }>;
         }>;
     };
-        participants?: Array<{
+}>();
-            id: number;
-            name: string;
-            pivot?: {
-                display_name: string | null;
-            } | null;
-        }>;
-        dynamicId: number;
-    }>(),
-    {
-        participants: () => [],
-    }
-);
 
 if (!echoIsConfigured()) {
     configureEcho({
@@ -66,83 +50,6 @@ useEcho(`chats.${props.chat.id}`, 'MessageSent', (e: any) => {
     props.chat.messages.push(e.message);
 });
 
-const participantsById = computed(() => {
-    return props.participants.reduce(
-        (acc, p) => {
-            acc[p.id] = p;
-            return acc;
-        },
-        {} as Record<
-            number,
-            {
-                id: number;
-                name: string;
-                pivot?: { display_name: string | null } | null;
-            }
-        >,
-    );
-});
-
-function parseMessageContent(message: {
-    content: string;
-    subject_id?: number | null;
-    subject_type?: string | null;
-    subject?: any;
-}) {
-    let content = message.content;
-
-    // 1. Replace <user:id> placeholders with links to their dynamic profile
-    const userRegex = /<user:(\d+)>/g;
-    content = content.replace(userRegex, (match, userId) => {
-        const user = participantsById.value[Number(userId)];
-        if (user) {
-            const url = route('dynamics.users.show', [props.dynamicId, Number(userId)]);
-            return `<a href="${url}" class="c-chat__user-link font-semibold text-blue-500 hover:underline">${
-                user.pivot?.display_name ?? user.name
-            }</a>`;
-        }
-        return `User #${userId}`;
-    });
-
-    // 2. Link subjects if found in the text
-    if (message.subject_id && message.subject_type) {
-        if (
-            message.subject_type === 'App\\Models\\Mutation' ||
-            message.subject_type === 'App\\Models\\Ledger'
-        ) {
-            const ledgerId =
-                message.subject_type === 'App\\Models\\Mutation'
-                    ? message.subject?.ledger_id
-                    : message.subject?.id;
-
-            const ledgerName =
-                message.subject_type === 'App\\Models\\Mutation'
-                    ? message.subject?.ledger?.name
-                    : message.subject?.name;
-
-            if (ledgerId && ledgerName) {
-                const ledgerUrl = route('dynamics.ledgers.show', [
-                    props.dynamicId,
-                    ledgerId,
-                ]);
-
-                const escapedName = ledgerName.replace(
-                    /[-\/\\^$*+?.()|[\]{}]/g,
-                    '\\$&',
-                );
-                
-                const nameRegex = new RegExp(`"${escapedName}"`, 'g');
-                content = content.replace(
-                    nameRegex,
-                    `"<a href="${ledgerUrl}" class="c-chat__subject-link font-semibold text-blue-500 hover:underline">${ledgerName}</a>"`,
-                );
-            }
-        }
-    }
-
-    return content;
-}
-
 function handleFileChange(event: Event) {
     const files = (event.target as HTMLInputElement).files;
     if (files) {
@@ -158,10 +65,7 @@ function removeFile(index: number) {
 
 const currentUser = computed(() => usePage().props.auth?.user);
 
-function isOwnMessage(messageUserId: number | null): boolean {
+function isOwnMessage(messageUserId: number): boolean {
-    if (messageUserId === null) {
-        return false;
-    }
     return currentUser.value && currentUser.value.id === messageUserId;
 }
 
@@ -203,16 +107,17 @@ function closeLightbox() {
                 :class="[
                     'c-chat__message',
                     {
-                        'c-chat__message--system': message.user === null,
+                        'c-chat__message--system':
-                        'c-chat__message--own': isOwnMessage(message.user?.id),
+                            message.user.id === 0,
-                        'c-chat__message--other': message.user !== null && !isOwnMessage(
+                        'c-chat__message--own': isOwnMessage(message.user.id),
-                            message.user?.id,
+                        'c-chat__message--other': !isOwnMessage(
+                            message.user.id,
                         ),
                     },
                 ]"
             >
                 <!-- Standard User Chat Message -->
-                <template v-if="message.user">
+                <template v-if="!message.content.startsWith('System:')">
                     <div class="c-chat__message-header">
                         <span class="c-chat__message-author">{{
                             message.user.name
@@ -261,10 +166,9 @@ function closeLightbox() {
                 <template v-else>
                     <div class="c-chat__system-inner">
                         <Info class="c-chat__system-icon" />
-                        <span
+                        <span class="c-chat__system-text">
-                            class="c-chat__system-text"
+                            {{ message.content.replace(/^System:\s*/, '') }}
-                            v-html="parseMessageContent(message)"
+                        </span>
-                        ></span>
                         <span class="c-chat__system-time">
                             {{
                                 new Date(message.created_at).toLocaleTimeString(

resources/js/components/DynamicDisplayNameItem.vue

@@ -1,47 +0,0 @@
-<script setup lang="ts">
-import { useForm } from '@inertiajs/vue3';
-import { route } from 'ziggy-js';
-import { Input } from '@/components/ui/input';
-import { Button } from '@/components/ui/button';
-import InputError from '@/components/InputError.vue';
-
-const props = defineProps<{
-    dynamic: {
-        id: number;
-        name: string;
-        pivot: {
-            display_name: string | null;
-        };
-    };
-}>();
-
-const form = useForm({
-    display_name: props.dynamic.pivot?.display_name ?? '',
-});
-
-function submit() {
-    form.put(route('dynamics.participant.update', props.dynamic.id), {
-        preserveScroll: true,
-    });
-}
-</script>
-
-<template>
-    <form @submit.prevent="submit" class="flex flex-col sm:flex-row items-start sm:items-center gap-4 p-4 border rounded-lg bg-card text-card-foreground">
-        <div class="flex-1 w-full">
-            <div class="font-medium text-sm mb-1">{{ dynamic.name }}</div>
-            <Input
-                v-model="form.display_name"
-                class="w-full"
-                placeholder="Enter custom display name"
-                required
-            />
-            <InputError class="mt-1" :message="form.errors.display_name" />
-        </div>
-        <div class="sm:self-end">
-            <Button type="submit" size="sm" :disabled="form.processing">
-                Save
-            </Button>
-        </div>
-    </form>
-</template>

resources/js/components/MutationList.vue

@@ -174,7 +174,7 @@ function getAmountClass(amount: number): string {
                     </button>
                 </div>
 
-                <Chat :chat="mutation.chat" :dynamic-id="dynamicId" :participants="participants" />
+                <Chat :chat="mutation.chat" />
             </li>
         </ul>
         <div v-if="mutations.length === 0" class="c-mutation-list__empty">

resources/js/components/ParticipantsList.vue

@@ -3,9 +3,6 @@ defineProps<{
     participants: Array<{
         id: number;
         name: string;
-        pivot: {
-            display_name: string | null;
-        };
     }>;
 }>();
 </script>
@@ -19,7 +16,7 @@ defineProps<{
                 :key="participant.id"
                 class="c-participants-list__item"
             >
-                {{ participant.pivot.display_name ?? participant.name }}
+                {{ participant.name }}
             </li>
         </ul>
     </div>

resources/js/pages/Dashboard.vue

@@ -107,11 +107,11 @@ function formatTime(isoString: string): string {
 
                         <!-- Unread Separator Line -->
                         <div
-                            v-if="entity.new_activities.length > 0"
+                            v-if="entity.context_activities.length > 0"
                             class="c-dashboard__divider"
                         >
                             <span class="c-dashboard__divider-text"
-                                >NEW</span
+                                >New Activity Below</span
                             >
                         </div>
 
@@ -129,6 +129,7 @@ function formatTime(isoString: string): string {
                                     <span class="c-dashboard__activity-time">
                                         {{ formatTime(activity.created_at) }}
                                     </span>
+                                    <span class="c-dashboard__new-badge">NEW</span>
                                 </div>
                                 <p class="c-dashboard__activity-desc">
                                     {{ activity.content }}

resources/js/pages/Dynamics/PredefinedMutations/Index.vue

@@ -0,0 +1,247 @@
+<script setup lang="ts">
+import { Head, useForm } from '@inertiajs/vue3';
+import { route } from 'ziggy-js';
+import AppLayout from '@/layouts/AppLayout.vue';
+import { defineProps } from 'vue';
+
+const props = defineProps<{
+    dynamic: {
+        id: number;
+        name: string;
+    };
+    predefined_mutations: Array<{
+        id: number;
+        name: string;
+        description: string;
+        amount: number;
+        type: string;
+    }>;
+}>();
+
+const form = useForm({
+    name: '',
+    description: '',
+    amount: 0,
+    type: 'reward',
+});
+
+const breadcrumbs = [
+    {
+        name: 'Dynamics',
+        href: route('dynamics.index'),
+    },
+    {
+        name: props.dynamic.name,
+        href: route('dynamics.show', props.dynamic.id),
+    },
+    {
+        name: 'Predefined Mutations',
+        href: route('dynamics.predefined-mutations.index', props.dynamic.id),
+    },
+];
+
+function submit() {
+    form.post(route('dynamics.predefined-mutations.store', props.dynamic.id), {
+        onSuccess: () => form.reset(),
+    });
+}
+</script>
+
+<template>
+    <Head title="Predefined Mutations" />
+
+    <AppLayout :breadcrumbs="breadcrumbs">
+        <div class="c-predefined-mutations">
+            <div class="c-predefined-mutations__container">
+                <div class="c-predefined-mutations__card">
+                    <div class="c-predefined-mutations__body">
+                        <h3 class="c-predefined-mutations__title">
+                            Predefined Mutations for {{ dynamic.name }}
+                        </h3>
+
+                        <div class="c-predefined-mutations__list">
+                            <div
+                                v-for="mutation in predefined_mutations"
+                                :key="mutation.id"
+                                class="c-predefined-mutations__item"
+                            >
+                                <div class="c-predefined-mutations__item-details">
+                                    <h4 class="c-predefined-mutations__item-name">
+                                        {{ mutation.name }}
+                                    </h4>
+                                    <p class="c-predefined-mutations__item-description">
+                                        {{ mutation.description }}
+                                    </p>
+                                </div>
+                                <div class="c-predefined-mutations__item-amount">
+                                    {{ mutation.amount }}
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+
+                <div class="c-predefined-mutations__card mt-8">
+                    <div class="c-predefined-mutations__body">
+                        <h3 class="c-predefined-mutations__title">
+                            Create New Predefined Mutation
+                        </h3>
+
+                        <form
+                            @submit.prevent="submit"
+                            class="c-predefined-mutations__form"
+                        >
+                            <div class="c-predefined-mutations__field">
+                                <label
+                                    for="name"
+                                    class="c-predefined-mutations__label"
+                                    >Name</label
+                                >
+                                <input
+                                    v-model="form.name"
+                                    id="name"
+                                    type="text"
+                                    class="c-predefined-mutations__input"
+                                />
+                            </div>
+
+                            <div class="c-predefined-mutations__field">
+                                <label
+                                    for="description"
+                                    class="c-predefined-mutations__label"
+                                    >Description</label
+                                >
+                                <textarea
+                                    v-model="form.description"
+                                    id="description"
+                                    rows="4"
+                                    class="c-predefined-mutations__textarea"
+                                ></textarea>
+                            </div>
+
+                            <div class="c-predefined-mutations__field">
+                                <label
+                                    for="amount"
+                                    class="c-predefined-mutations__label"
+                                    >Amount</label
+                                >
+                                <input
+                                    v-model="form.amount"
+                                    id="amount"
+                                    type="number"
+                                    class="c-predefined-mutations__input"
+                                />
+                            </div>
+
+                            <div class="c-predefined-mutations__field">
+                                <label
+                                    for="type"
+                                    class="c-predefined-mutations__label"
+                                    >Type</label
+                                >
+                                <select
+                                    v-model="form.type"
+                                    id="type"
+                                    class="c-predefined-mutations__select"
+                                >
+                                    <option value="reward">Reward</option>
+                                    <option value="penalty">Penalty</option>
+                                </select>
+                            </div>
+
+                            <div class="c-predefined-mutations__actions">
+                                <button
+                                    type="submit"
+                                    :disabled="form.processing"
+                                    class="c-predefined-mutations__submit-btn"
+                                >
+                                    Create
+                                </button>
+                            </div>
+                        </form>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </AppLayout>
+</template>
+
+<style scoped>
+@reference "../../../../css/app.css";
+
+.c-predefined-mutations {
+    @apply py-12;
+}
+
+.c-predefined-mutations__container {
+    @apply mx-auto max-w-7xl sm:px-6 lg:px-8;
+}
+
+.c-predefined-mutations__card {
+    @apply overflow-hidden bg-white shadow-sm sm:rounded-lg dark:bg-gray-800;
+}
+
+.c-predefined-mutations__body {
+    @apply p-6 text-gray-900 dark:text-gray-100;
+}
+
+.c-predefined-mutations__title {
+    @apply text-lg font-medium;
+}
+
+.c-predefined-mutations__list {
+    @apply mt-6 space-y-4;
+}
+
+.c-predefined-mutations__item {
+    @apply flex items-center justify-between rounded-lg border p-4 dark:border-gray-700;
+}
+
+.c-predefined-mutations__item-details {
+    @apply flex-1;
+}
+
+.c-predefined-mutations__item-name {
+    @apply font-semibold;
+}
+
+.c-predefined-mutations__item-description {
+    @apply text-sm text-gray-600 dark:text-gray-400;
+}
+
+.c-predefined-mutations__item-amount {
+    @apply text-lg font-semibold;
+}
+
+.c-predefined-mutations__form {
+    @apply mt-6 space-y-6;
+}
+
+.c-predefined-mutations__field {
+    @apply block;
+}
+
+.c-predefined-mutations__label {
+    @apply block text-sm font-medium text-gray-700 dark:text-gray-300;
+}
+
+.c-predefined-mutations__input {
+    @apply mt-1 block w-full rounded-md border-gray-300 shadow-sm focus:border-indigo-500 focus:ring-indigo-500 dark:border-gray-700 dark:bg-gray-900 dark:text-gray-300 dark:focus:border-indigo-600 dark:focus:ring-indigo-600;
+}
+
+.c-predefined-mutations__textarea {
+    @apply mt-1 block w-full rounded-md border-gray-300 shadow-sm focus:border-indigo-500 focus:ring-indigo-500 dark:border-gray-700 dark:bg-gray-900 dark:text-gray-300 dark:focus:border-indigo-600 dark:focus:ring-indigo-600;
+}
+
+.c-predefined-mutations__select {
+    @apply mt-1 block w-full rounded-md border-gray-300 bg-white p-2 text-sm shadow-sm focus:border-indigo-500 focus:ring-indigo-500 dark:border-gray-700 dark:bg-gray-900 dark:text-gray-300 dark:focus:border-indigo-600 dark:focus:ring-indigo-600;
+}
+
+.c-predefined-mutations__actions {
+    @apply flex items-center gap-4;
+}
+
+.c-predefined-mutations__submit-btn {
+    @apply inline-flex items-center rounded-md border border-transparent bg-gray-800 px-4 py-2 text-xs font-semibold tracking-widest text-white uppercase transition duration-150 ease-in-out hover:bg-gray-700 focus:bg-gray-700 focus:ring-2 focus:ring-indigo-500 focus:ring-offset-2 focus:outline-none active:bg-gray-900 dark:bg-gray-200 dark:text-gray-800 dark:hover:bg-white dark:focus:bg-white dark:focus:ring-offset-gray-800 dark:active:bg-gray-300;
+}
+</style>

resources/js/pages/Dynamics/Settings.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { Head, useForm } from '@inertiajs/vue3';
+import { Head, useForm, Link as InertiaLink } from '@inertiajs/vue3';
 import { route } from 'ziggy-js';
 import AppLayout from '@/layouts/AppLayout.vue';
 
@@ -70,6 +70,12 @@ function submit() {
                     </form>
                 </div>
             </div>
+
+            <div class="mt-8">
+                <InertiaLink :href="route('dynamics.predefined-mutations.index', dynamic.id)" class="c-dynamic-settings__submit-btn">
+                    Manage Predefined Mutations
+                </InertiaLink>
+            </div>
         </div>
     </div>
 </template>

resources/js/pages/Dynamics/Show.vue

@@ -11,7 +11,7 @@ const props = defineProps<{
         name: string;
         rules: string;
         chat: any;
-        participants: Array<{ id: number; name: string, pivot: { display_name: string | null } }>;
+        participants: Array<{ id: number; name: string }>;
         ledgers: Array<{
             id: number;
             name: string;
@@ -23,7 +23,6 @@ const props = defineProps<{
     isOwner: boolean;
 }>();
 
-
 const breadcrumbs = [
     {
         name: 'Dynamics',
@@ -58,7 +57,7 @@ const breadcrumbs = [
             </div>
 
             <!-- Dynamic Chat -->
-            <Chat :chat="dynamic.chat" :participants="dynamic.participants" :dynamic-id="dynamic.id" />
+            <Chat :chat="dynamic.chat" />
 
             <!-- Participants Component -->
             <ParticipantsList :participants="dynamic.participants" />

resources/js/pages/Participants/Show.vue

@@ -1,260 +0,0 @@
-<script setup lang="ts">
-import { Head, Link as InertiaLink } from '@inertiajs/vue3';
-import { route } from 'ziggy-js';
-
-const props = defineProps<{
-    dynamic: {
-        id: number;
-        name: string;
-    };
-    participant: {
-        id: number;
-        name: string;
-        display_name: string | null;
-        role: string;
-    };
-    mutations: Array<{
-        id: number;
-        ledger_id: number;
-        ledger: {
-            id: number;
-            name: string;
-            alignment: string;
-        };
-        amount: number;
-        description: string;
-        status: string;
-        created_at: string;
-    }>;
-}>();
-
-const breadcrumbs = [
-    {
-        name: 'Dynamics',
-        href: route('dynamics.index'),
-    },
-    {
-        name: props.dynamic.name,
-        href: route('dynamics.show', props.dynamic.id),
-    },
-    {
-        name: props.participant.display_name ?? props.participant.name,
-        href: route('dynamics.users.show', [props.dynamic.id, props.participant.id]),
-    },
-];
-
-function getAmountClass(amount: number, alignment: string): string {
-    if (alignment === 'positive') {
-        return amount > 0
-            ? 'c-participant-show__activity-amount--positive'
-            : 'c-participant-show__activity-amount--negative';
-    }
-
-    if (alignment === 'negative') {
-        return amount < 0
-            ? 'c-participant-show__activity-amount--positive'
-            : 'c-participant-show__activity-amount--negative';
-    }
-
-    return 'c-participant-show__activity-amount--neutral';
-}
-</script>
-
-<template>
-    <Head :title="participant.display_name ?? participant.name" />
-
-    <div class="c-participant-show">
-        <div class="c-participant-show__container">
-            <!-- Header Card -->
-            <div class="c-participant-show__card">
-                <div class="c-participant-show__body">
-                    <div class="flex justify-between items-center">
-                        <div>
-                            <span class="c-participant-show__role-badge">
-                                {{ participant.role }}
-                            </span>
-                            <h3 class="c-participant-show__title mt-1">
-                                {{ participant.display_name ?? participant.name }}
-                            </h3>
-                            <p v-if="participant.display_name" class="c-participant-show__subtitle">
-                                Real Name: {{ participant.name }}
-                            </p>
-                        </div>
-                        <InertiaLink :href="route('dynamics.show', dynamic.id)" class="c-participant-show__back-btn">
-                            Back to Dynamic
-                        </InertiaLink>
-                    </div>
-                </div>
-            </div>
-
-            <!-- Recent Activity Block -->
-            <div class="c-participant-show__activity mt-8">
-                <h4 class="c-participant-show__activity-title">Recent Activity</h4>
-                
-                <div v-if="mutations.length > 0" class="c-participant-show__activity-list mt-4">
-                    <div
-                        v-for="mutation in mutations"
-                        :key="mutation.id"
-                        class="c-participant-show__activity-item"
-                    >
-                        <div class="flex justify-between items-start">
-                            <div>
-                                <InertiaLink
-                                    :href="route('dynamics.ledgers.show', [dynamic.id, mutation.ledger_id])"
-                                    class="c-participant-show__activity-ledger"
-                                >
-                                    {{ mutation.ledger.name }}
-                                </InertiaLink>
-                                <p class="c-participant-show__activity-desc mt-1">
-                                    {{ mutation.description }}
-                                </p>
-                            </div>
-                            <div class="text-right">
-                                <span
-                                    :class="getAmountClass(mutation.amount, mutation.ledger.alignment)"
-                                    class="c-participant-show__activity-amount"
-                                >
-                                    {{ mutation.amount > 0 ? '+' : '' }}{{ mutation.amount }}
-                                </span>
-                                <div class="c-participant-show__activity-meta mt-1">
-                                    <span
-                                        :class="{
-                                            'c-participant-show__activity-status--pending': mutation.status === 'pending',
-                                            'c-participant-show__activity-status--approved': mutation.status === 'approved',
-                                            'c-participant-show__activity-status--rejected': mutation.status === 'rejected',
-                                        }"
-                                        class="c-participant-show__activity-status"
-                                    >
-                                        {{ mutation.status }}
-                                    </span>
-                                    <span class="c-participant-show__activity-time ml-2">
-                                        {{ new Date(mutation.created_at).toLocaleDateString() }}
-                                    </span>
-                                </div>
-                            </div>
-                        </div>
-                    </div>
-                </div>
-                
-                <div v-else class="c-participant-show__empty mt-4">
-                    No recent activity found for this participant.
-                </div>
-            </div>
-        </div>
-    </div>
-</template>
-
-<style scoped>
-@reference "../../../css/app.css";
-
-.c-participant-show {
-    @apply py-12;
-}
-
-.c-participant-show__container {
-    @apply mx-auto max-w-7xl sm:px-6 lg:px-8;
-}
-
-.c-participant-show__card {
-    @apply overflow-hidden;
-    background-color: var(--card);
-    border: 1px solid var(--border);
-    border-radius: var(--radius);
-}
-
-.c-participant-show__body {
-    @apply p-6;
-    color: var(--foreground);
-}
-
-.c-participant-show__role-badge {
-    @apply inline-flex items-center rounded-full px-2.5 py-0.5 text-xs font-semibold uppercase tracking-wider;
-    background-color: var(--primary);
-    color: var(--primary-foreground);
-    opacity: 0.8;
-}
-
-.c-participant-show__title {
-    @apply text-2xl font-bold;
-}
-
-.c-participant-show__subtitle {
-    @apply mt-1 text-sm;
-    color: var(--muted-foreground);
-}
-
-.c-participant-show__back-btn {
-    @apply inline-flex items-center rounded-md border border-transparent bg-gray-800 px-4 py-2 text-xs font-semibold tracking-widest text-white uppercase transition duration-150 ease-in-out hover:bg-gray-700 focus:bg-gray-700 focus:ring-2 focus:ring-indigo-500 focus:ring-offset-2 focus:outline-none active:bg-gray-900 dark:bg-gray-200 dark:text-gray-800 dark:hover:bg-white dark:focus:bg-white dark:focus:ring-offset-gray-800 dark:active:bg-gray-300;
-}
-
-.c-participant-show__activity-title {
-    @apply text-lg font-medium;
-    color: var(--foreground);
-}
-
-.c-participant-show__activity-list {
-    @apply space-y-4;
-}
-
-.c-participant-show__activity-item {
-    @apply p-4;
-    background-color: var(--card);
-    border: 1px solid var(--border);
-    border-radius: var(--radius);
-}
-
-.c-participant-show__activity-ledger {
-    @apply font-semibold hover:underline text-sm;
-    color: var(--primary);
-}
-
-.c-participant-show__activity-desc {
-    @apply text-sm;
-    color: var(--foreground);
-}
-
-.c-participant-show__activity-amount {
-    @apply font-bold text-sm;
-}
-
-.c-participant-show__activity-amount--positive {
-    @apply text-green-500;
-}
-
-.c-participant-show__activity-amount--negative {
-    @apply text-red-500;
-}
-
-.c-participant-show__activity-amount--neutral {
-    @apply text-neutral-500;
-}
-
-.c-participant-show__activity-meta {
-    @apply flex items-center justify-end text-xs;
-}
-
-.c-participant-show__activity-status {
-    @apply rounded px-1.5 py-0.5 text-[9px] font-medium tracking-wider uppercase;
-}
-
-.c-participant-show__activity-status--pending {
-    @apply bg-yellow-100 text-yellow-800 dark:bg-yellow-900/30 dark:text-yellow-400;
-}
-
-.c-participant-show__activity-status--approved {
-    @apply bg-green-100 text-green-800 dark:bg-green-900/30 dark:text-green-400;
-}
-
-.c-participant-show__activity-status--rejected {
-    @apply bg-red-100 text-red-800 dark:bg-red-900/30 dark:text-red-400;
-}
-
-.c-participant-show__activity-time {
-    color: var(--muted-foreground);
-}
-
-.c-participant-show__empty {
-    @apply text-sm text-center py-8;
-    color: var(--muted-foreground);
-}
-</style>

resources/js/pages/settings/Profile.vue

@@ -6,7 +6,6 @@ import ProfileController from '@/actions/App/Http/Controllers/Settings/ProfileCo
 import DeleteUser from '@/components/DeleteUser.vue';
 import Heading from '@/components/Heading.vue';
 import InputError from '@/components/InputError.vue';
-import DynamicDisplayNameItem from '@/components/DynamicDisplayNameItem.vue';
 import { Button } from '@/components/ui/button';
 import { Input } from '@/components/ui/input';
 import { Label } from '@/components/ui/label';
@@ -24,18 +23,6 @@ defineOptions({
     },
 });
 
-defineProps<{
-    mustVerifyEmail: boolean;
-    status: string | null;
-    dynamics: Array<{
-        id: number;
-        name: string;
-        pivot: {
-            display_name: string | null;
-        };
-    }>;
-}>();
-
 const page = usePage();
 const user = computed(() => page.props.auth.user);
 </script>
@@ -112,27 +99,6 @@ const user = computed(() => page.props.auth.user);
                 >
             </div>
         </Form>
-
-        <!-- Dynamic-Specific Display Names Section -->
-        <div class="pt-8 border-t">
-            <Heading
-                variant="small"
-                title="Dynamic Display Names"
-                description="Customize your display name for each of your dynamics"
-            />
-            <div class="mt-6 space-y-4">
-                <div v-if="dynamics && dynamics.length > 0" class="space-y-4">
-                    <DynamicDisplayNameItem
-                        v-for="dyn in dynamics"
-                        :key="dyn.id"
-                        :dynamic="dyn"
-                    />
-                </div>
-                <p v-else class="text-sm text-muted-foreground">
-                    You are not a participant in any dynamics yet.
-                </p>
-            </div>
-        </div>
     </div>
 
     <DeleteUser />

routes/web.php

@@ -19,15 +19,14 @@ Route::middleware(['auth', 'verified'])->group(function () {
     Route::get('/dynamics/{dynamic}/ledgers/create', [LedgerController::class, 'create'])->name('dynamics.ledgers.create');
     Route::resource('dynamics.ledgers', LedgerController::class)->scoped()->except(['create']);
 
+    Route::resource('dynamics.predefined-mutations', \App\Http\Controllers\PredefinedMutationController::class)->scoped();
+
     Route::resource('dynamics.ledgers.mutations', MutationController::class)->scoped();
 
     Route::get('/dynamics/{dynamic}/invitations/create', [\App\Http\Controllers\DynamicInvitationController::class, 'create'])->name('dynamics.invitations.create');
     Route::post('/dynamics/{dynamic}/invitations', [\App\Http\Controllers\DynamicInvitationController::class, 'store'])->name('dynamics.invitations.store');
 
     Route::post('/chats/{chat}/messages', [MessageController::class, 'store'])->name('chats.messages.store');
-
-    Route::put('/dynamics/{dynamic}/participant', [\App\Http\Controllers\ParticipantController::class, 'update'])->name('dynamics.participant.update');
-    Route::get('/dynamics/{dynamic}/users/{user}', [\App\Http\Controllers\ParticipantController::class, 'show'])->name('dynamics.users.show');
 });
 
 Route::get('/invitations/accept/{token}', [\App\Http\Controllers\DynamicInvitationController::class, 'accept'])

tests/Feature/InvitationTest.php

@@ -99,5 +99,5 @@ test('only the user with the specified email address can accept the link', funct
     // Verify system notification is added to Dynamic activity chat
     $chatMessages = $dynamic->chat->messages;
     expect($chatMessages)->not->toBeEmpty();
-    expect($chatMessages->last()->content)->toBe("<user:{$invitee->id}> joined the Dynamic as a EDITOR");
+    expect($chatMessages->last()->content)->toBe("{$invitee->name} joined the Dynamic as a EDITOR");
 });

tests/Feature/MutationTest.php

@@ -32,13 +32,11 @@ test('owner can create a mutation which is automatically approved and does not s
     // Verify chat messages (should NOT say "approved" or "Approved")
     $mutationChatMessages = $mutation->chat->messages;
     expect($mutationChatMessages)->toHaveCount(1);
-    expect($mutationChatMessages->first()->user_id)->toBeNull();
+    expect($mutationChatMessages->first()->content)->toBe("System: Entry was created by {$owner->name}.");
-    expect($mutationChatMessages->first()->content)->toBe("Entry was created by <user:{$owner->id}>.");
 
     $dynamicChatMessages = $dynamic->chat->messages;
     expect($dynamicChatMessages)->toHaveCount(1);
-    expect($dynamicChatMessages->first()->user_id)->toBeNull();
+    expect($dynamicChatMessages->first()->content)->toBe("System: {$owner->name} added entry \"Direct point reward\" for +15 points on \"{$ledger->name}\" ledger.");
-    expect($dynamicChatMessages->first()->content)->toBe("<user:{$owner->id}> added entry \"Direct point reward\" for +15 points on \"{$ledger->name}\" ledger.");
 });
 
 test('non-owner participant creates a suggestion which defaults to pending and says suggested', function () {
@@ -70,13 +68,11 @@ test('non-owner participant creates a suggestion which defaults to pending and s
     // Verify chat messages
     $mutationChatMessages = $mutation->chat->messages;
     expect($mutationChatMessages)->toHaveCount(1);
-    expect($mutationChatMessages->first()->user_id)->toBeNull();
+    expect($mutationChatMessages->first()->content)->toBe("System: Suggestion was created by {$participant->name}.");
-    expect($mutationChatMessages->first()->content)->toBe("Suggestion was created by <user:{$participant->id}>.");
 
     $dynamicChatMessages = $dynamic->chat->messages;
     expect($dynamicChatMessages)->toHaveCount(1);
-    expect($dynamicChatMessages->first()->user_id)->toBeNull();
+    expect($dynamicChatMessages->first()->content)->toBe("System: {$participant->name} suggested \"Suggested point reward\" for +10 points on \"{$ledger->name}\" ledger.");
-    expect($dynamicChatMessages->first()->content)->toBe("<user:{$participant->id}> suggested \"Suggested point reward\" for +10 points on \"{$ledger->name}\" ledger.");
 });
 
 test('owner can approve a pending suggestion and it is updated and logged', function () {
@@ -114,10 +110,8 @@ test('owner can approve a pending suggestion and it is updated and logged', func
     $mutationChatMessages = $mutation->chat->messages;
     // Note: one from boot created (empty or via seeder, but in our factory it starts with 0 messages if not manually logged,
     // actually our model booted hook creates the chat but doesn't log on boot, the update method creates 1 message)
-    expect($mutationChatMessages->last()->user_id)->toBeNull();
+    expect($mutationChatMessages->last()->content)->toBe("System: Suggestion was APPROVED by {$owner->name}.");
-    expect($mutationChatMessages->last()->content)->toBe("Suggestion was APPROVED by <user:{$owner->id}>.");
 
     $dynamicChatMessages = $dynamic->chat->messages;
-    expect($dynamicChatMessages->last()->user_id)->toBeNull();
+    expect($dynamicChatMessages->last()->content)->toBe("System: {$owner->name} APPROVED the suggestion \"Polished dungeon floors\" for +20 points on \"{$ledger->name}\" ledger.");
-    expect($dynamicChatMessages->last()->content)->toBe("<user:{$owner->id}> APPROVED the suggestion \"Polished dungeon floors\" for +20 points on \"{$ledger->name}\" ledger.");
 });

tests/Feature/ParticipantDetailTest.php

@@ -1,95 +0,0 @@
-<?php
-
-use App\Models\User;
-use App\Models\Dynamic;
-use App\Models\Ledger;
-use App\Models\Mutation;
-
-test('authenticated participant can view another participant detail page in dynamic', function () {
-    $owner = User::factory()->create();
-    $participant = User::factory()->create();
-    $dynamic = Dynamic::factory()->create();
-    
-    $dynamic->participants()->attach($owner->id, ['role' => 'owner', 'display_name' => 'The Boss']);
-    $dynamic->participants()->attach($participant->id, ['role' => 'participant']);
-
-    $this->actingAs($owner);
-
-    $response = $this->get(route('dynamics.users.show', [$dynamic->id, $participant->id]));
-
-    $response->assertOk();
-    $response->assertInertia(fn ($page) => $page
-        ->component('Participants/Show')
-        ->has('dynamic')
-        ->where('participant.id', $participant->id)
-        ->where('participant.name', $participant->name)
-        ->where('participant.display_name', null)
-        ->where('participant.role', 'participant')
-        ->has('mutations')
-    );
-});
-
-test('non-participant cannot view participant detail page in dynamic', function () {
-    $owner = User::factory()->create();
-    $participant = User::factory()->create();
-    $outsider = User::factory()->create();
-    $dynamic = Dynamic::factory()->create();
-    
-    $dynamic->participants()->attach($owner->id, ['role' => 'owner']);
-    $dynamic->participants()->attach($participant->id, ['role' => 'participant']);
-
-    $this->actingAs($outsider);
-
-    $response = $this->get(route('dynamics.users.show', [$dynamic->id, $participant->id]));
-
-    $response->assertStatus(403);
-});
-
-test('participant detail page displays their recent mutations in dynamic', function () {
-    $owner = User::factory()->create();
-    $participant = User::factory()->create();
-    $dynamic = Dynamic::factory()->create();
-    $ledger = Ledger::factory()->create(['dynamic_id' => $dynamic->id]);
-    
-    $dynamic->participants()->attach($owner->id, ['role' => 'owner']);
-    $dynamic->participants()->attach($participant->id, ['role' => 'participant', 'display_name' => 'Bitch']);
-
-    // Create mutations in this dynamic
-    $mutation1 = Mutation::factory()->create([
-        'ledger_id' => $ledger->id,
-        'user_id' => $participant->id,
-        'amount' => 10,
-        'description' => 'Chore 1',
-    ]);
-    
-    $mutation2 = Mutation::factory()->create([
-        'ledger_id' => $ledger->id,
-        'user_id' => $participant->id,
-        'amount' => -5,
-        'description' => 'Infraction 1',
-    ]);
-
-    // Create a mutation in another dynamic (should NOT be displayed)
-    $otherDynamic = Dynamic::factory()->create();
-    $otherLedger = Ledger::factory()->create(['dynamic_id' => $otherDynamic->id]);
-    $otherDynamic->participants()->attach($participant->id, ['role' => 'participant']);
-    $mutation3 = Mutation::factory()->create([
-        'ledger_id' => $otherLedger->id,
-        'user_id' => $participant->id,
-        'amount' => 100,
-        'description' => 'Other dynamic chore',
-    ]);
-
-    $this->actingAs($owner);
-
-    $response = $this->get(route('dynamics.users.show', [$dynamic->id, $participant->id]));
-
-    $response->assertOk();
-    $response->assertInertia(fn ($page) => $page
-        ->component('Participants/Show')
-        ->where('participant.display_name', 'Bitch')
-        ->has('mutations', 2)
-        ->where('mutations.0.description', 'Infraction 1') // Ordered latest first
-        ->where('mutations.1.description', 'Chore 1')
-    );
-});

tests/Feature/ParticipantTest.php

@@ -1,76 +0,0 @@
-<?php
-
-use App\Models\User;
-use App\Models\Dynamic;
-
-test('user displayNameFor returns user name by default', function () {
-    $user = User::factory()->create(['name' => 'Alice']);
-    $dynamic = Dynamic::factory()->create();
-    $dynamic->participants()->attach($user->id, ['role' => 'participant']);
-
-    expect($user->displayNameFor($dynamic))->toBe('Alice');
-});
-
-test('user displayNameFor returns custom display name when set', function () {
-    $user = User::factory()->create(['name' => 'Alice']);
-    $dynamic = Dynamic::factory()->create();
-    $dynamic->participants()->attach($user->id, [
-        'role' => 'participant',
-        'display_name' => 'Ally',
-    ]);
-
-    expect($user->displayNameFor($dynamic))->toBe('Ally');
-});
-
-test('participant can update their display name', function () {
-    $user = User::factory()->create(['name' => 'Alice']);
-    $dynamic = Dynamic::factory()->create();
-    $dynamic->participants()->attach($user->id, ['role' => 'participant']);
-
-    $this->actingAs($user);
-
-    $response = $this->put(route('dynamics.participant.update', $dynamic->id), [
-        'display_name' => 'Ally',
-    ]);
-
-    $response->assertRedirect();
-    
-    // Check database
-    $this->assertDatabaseHas('participants', [
-        'user_id' => $user->id,
-        'dynamic_id' => $dynamic->id,
-        'display_name' => 'Ally',
-    ]);
-
-    // Check display name method
-    expect($user->displayNameFor($dynamic))->toBe('Ally');
-});
-
-test('display name update requires display_name parameter', function () {
-    $user = User::factory()->create(['name' => 'Alice']);
-    $dynamic = Dynamic::factory()->create();
-    $dynamic->participants()->attach($user->id, ['role' => 'participant']);
-
-    $this->actingAs($user);
-
-    $response = $this->put(route('dynamics.participant.update', $dynamic->id), [
-        'display_name' => '',
-    ]);
-
-    $response->assertSessionHasErrors(['display_name']);
-});
-
-test('non participant cannot update display name', function () {
-    $user = User::factory()->create(['name' => 'Alice']);
-    $nonParticipant = User::factory()->create(['name' => 'Bob']);
-    $dynamic = Dynamic::factory()->create();
-    $dynamic->participants()->attach($user->id, ['role' => 'participant']);
-
-    $this->actingAs($nonParticipant);
-
-    $response = $this->put(route('dynamics.participant.update', $dynamic->id), [
-        'display_name' => 'Bobby',
-    ]);
-
-    $response->assertStatus(404);
-});

tests/Pest.php

@@ -16,7 +16,7 @@ use Tests\TestCase;
 
 pest()->extend(TestCase::class)
     ->use(RefreshDatabase::class)
-    ->in('Feature', 'Browser');
+    ->in('Feature');
 
 /*
 |--------------------------------------------------------------------------