Add Ultra teams, per-seat billing, and plugin access system

- Team management with Livewire (create teams, invite/remove members, add/remove seats)
- Per-seat billing via Stripe with confirmation modals and loading states
- Free official plugins for Ultra subscribers ($0 pricing, skip Stripe checkout)
- Team member plugin access (inherit owner's licenses, revoked on removal)
- Satis API support for team plugin downloads
- Team plugins section on Purchased Plugins page
- Dashboard Premium Plugins count includes team plugins
- Ultra nav link in mobile and desktop menus
- Comped subscription tracking (is_comped field + MarkCompedSubscriptions command)
- Plugin marketplace shows "Free with Ultra" badge for official plugins
- Comprehensive test coverage for all features

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: simonhamp

.cursor/rules/laravel-boost.mdc

@@ -69,6 +69,8 @@ STRIPE_PRO_PRICE_ID_EAP=
 STRIPE_MAX_PRICE_ID=
 STRIPE_MAX_PRICE_ID_MONTHLY=
 STRIPE_MAX_PRICE_ID_EAP=
+STRIPE_EXTRA_SEAT_PRICE_ID=
+STRIPE_EXTRA_SEAT_PRICE_ID_MONTHLY=
 STRIPE_FOREVER_PRICE_ID=
 STRIPE_TRIAL_PRICE_ID=
 STRIPE_MINI_PAYMENT_LINK=

.env.example

@@ -0,0 +1,125 @@
+<?php
+
+namespace App\Console\Commands;
+
+use App\Models\User;
+use Illuminate\Console\Command;
+use Laravel\Cashier\Subscription;
+
+class MarkCompedSubscriptions extends Command
+{
+    protected $signature = 'subscriptions:mark-comped
+        {file : Path to a CSV file containing email addresses (one per line or in an "email" column)}';
+
+    protected $description = 'Mark subscriptions as comped for email addresses in a CSV file';
+
+    public function handle(): int
+    {
+        $path = $this->argument('file');
+
+        if (! file_exists($path)) {
+            $this->error("File not found: {$path}");
+
+            return self::FAILURE;
+        }
+
+        $emails = $this->parseEmails($path);
+
+        if (empty($emails)) {
+            $this->error('No valid email addresses found in the file.');
+
+            return self::FAILURE;
+        }
+
+        $this->info('Found '.count($emails).' email(s) to process.');
+
+        $updated = 0;
+        $skipped = [];
+
+        foreach ($emails as $email) {
+            $user = User::where('email', $email)->first();
+
+            if (! $user) {
+                $skipped[] = "{$email} — user not found";
+
+                continue;
+            }
+
+            $subscription = Subscription::where('user_id', $user->id)
+                ->where('stripe_status', 'active')
+                ->first();
+
+            if (! $subscription) {
+                $skipped[] = "{$email} — no active subscription";
+
+                continue;
+            }
+
+            if ($subscription->is_comped) {
+                $skipped[] = "{$email} — already marked as comped";
+
+                continue;
+            }
+
+            $subscription->update(['is_comped' => true]);
+            $updated++;
+            $this->info("Marked {$email} as comped (subscription #{$subscription->id})");
+        }
+
+        if (count($skipped) > 0) {
+            $this->warn('Skipped:');
+            foreach ($skipped as $reason) {
+                $this->warn("  - {$reason}");
+            }
+        }
+
+        $this->info("Done. {$updated} subscription(s) marked as comped.");
+
+        return self::SUCCESS;
+    }
+
+    /**
+     * Parse email addresses from a CSV file.
+     * Supports: plain list (one email per line), or CSV with an "email" column header.
+     *
+     * @return array<string>
+     */
+    private function parseEmails(string $path): array
+    {
+        $handle = fopen($path, 'r');
+
+        if (! $handle) {
+            return [];
+        }
+
+        $emails = [];
+        $emailColumnIndex = null;
+        $isFirstRow = true;
+
+        while (($row = fgetcsv($handle)) !== false) {
+            if ($isFirstRow) {
+                $isFirstRow = false;
+                $headers = array_map(fn ($h) => strtolower(trim($h)), $row);
+                $emailColumnIndex = array_search('email', $headers);
+
+                // If the first row looks like an email itself (no header), treat it as data
+                if ($emailColumnIndex === false && filter_var(trim($row[0]), FILTER_VALIDATE_EMAIL)) {
+                    $emailColumnIndex = 0;
+                    $emails[] = strtolower(trim($row[0]));
+                }
+
+                continue;
+            }
+
+            $value = trim($row[$emailColumnIndex] ?? '');
+
+            if (filter_var($value, FILTER_VALIDATE_EMAIL)) {
+                $emails[] = strtolower($value);
+            }
+        }
+
+        fclose($handle);
+
+        return array_unique($emails);
+    }
+}

.github/copilot-instructions.md

@@ -14,13 +14,35 @@ enum Subscription: string
 
     public static function fromStripeSubscription(\Stripe\Subscription $subscription): self
     {
-        $priceId = $subscription->items->first()?->price->id;
+        // Iterate items, skipping extra seat prices (multi-item subscriptions)
+        foreach ($subscription->items as $item) {
+            $priceId = $item->price->id;
 
-        if (! $priceId) {
-            throw new RuntimeException('Could not resolve Stripe price id from subscription object.');
+            if (self::isExtraSeatPrice($priceId)) {
+                continue;
+            }
+
+            return self::fromStripePriceId($priceId);
         }
 
-        return self::fromStripePriceId($priceId);
+        throw new RuntimeException('Could not resolve a plan price id from subscription items.');
+    }
+
+    public static function isExtraSeatPrice(string $priceId): bool
+    {
+        return in_array($priceId, array_filter([
+            config('subscriptions.plans.max.stripe_extra_seat_price_id'),
+            config('subscriptions.plans.max.stripe_extra_seat_price_id_monthly'),
+        ]));
+    }
+
+    public static function extraSeatStripePriceId(string $interval): ?string
+    {
+        return match ($interval) {
+            'year' => config('subscriptions.plans.max.stripe_extra_seat_price_id'),
+            'month' => config('subscriptions.plans.max.stripe_extra_seat_price_id_monthly'),
+            default => null,
+        };
     }
 
     public static function fromStripePriceId(string $priceId): self

.junie/guidelines.md

@@ -151,6 +151,28 @@ protected function getAccessiblePlugins(User $user): array
             }
         }
 
+        // Plugins accessible via team membership
+        $teamOwner = $user->getTeamOwner();
+
+        if ($teamOwner) {
+            $teamPlugins = $teamOwner->pluginLicenses()
+                ->active()
+                ->with('plugin:id,name')
+                ->get()
+                ->pluck('plugin')
+                ->filter()
+                ->unique('id');
+
+            foreach ($teamPlugins as $plugin) {
+                if (! collect($plugins)->contains('name', $plugin->name)) {
+                    $plugins[] = [
+                        'name' => $plugin->name,
+                        'access' => 'team',
+                    ];
+                }
+            }
+        }
+
         return $plugins;
     }
 }

AGENTS.md

@@ -2,8 +2,10 @@
 
 namespace App\Http\Controllers;
 
+use App\Models\Cart;
 use App\Models\Plugin;
 use App\Models\PluginBundle;
+use App\Models\PluginLicense;
 use App\Models\Product;
 use App\Services\CartService;
 use Illuminate\Http\JsonResponse;
@@ -264,6 +266,11 @@ public function checkout(Request $request): RedirectResponse
         // Refresh prices
         $this->cartService->refreshPrices($cart);
 
+        // If total is $0, skip Stripe entirely and create licenses directly
+        if ($cart->getSubtotal() === 0) {
+            return $this->processFreeCheckout($cart, $user);
+        }
+
         try {
             $session = $this->createMultiItemCheckoutSession($cart, $user);
 
@@ -285,6 +292,22 @@ public function checkout(Request $request): RedirectResponse
 
     public function success(Request $request): View|RedirectResponse
     {
+        if ($request->query('free')) {
+            $user = Auth::user();
+
+            $cart = Cart::where('user_id', $user->id)
+                ->whereNotNull('completed_at')
+                ->latest('completed_at')
+                ->with('items.plugin', 'items.pluginBundle.plugins', 'items.product')
+                ->first();
+
+            return view('cart.success', [
+                'sessionId' => null,
+                'isFreeCheckout' => true,
+                'cart' => $cart,
+            ]);
+        }
+
         $sessionId = $request->query('session_id');
 
         // Validate session ID exists and looks like a real Stripe session ID
@@ -297,6 +320,51 @@ public function success(Request $request): View|RedirectResponse
 
         return view('cart.success', [
             'sessionId' => $sessionId,
+            'isFreeCheckout' => false,
+            'cart' => null,
+        ]);
+    }
+
+    protected function processFreeCheckout(Cart $cart, $user): RedirectResponse
+    {
+        $cart->load('items.plugin', 'items.pluginBundle.plugins', 'items.product');
+
+        foreach ($cart->items as $item) {
+            if ($item->isBundle()) {
+                foreach ($item->pluginBundle->plugins as $plugin) {
+                    $this->createFreePluginLicense($user, $plugin);
+                }
+            } elseif (! $item->isProduct() && $item->plugin) {
+                $this->createFreePluginLicense($user, $item->plugin);
+            }
+        }
+
+        $cart->markAsCompleted();
+
+        $user->getPluginLicenseKey();
+
+        Log::info('Free checkout completed', [
+            'cart_id' => $cart->id,
+            'user_id' => $user->id,
+            'item_count' => $cart->items->count(),
+        ]);
+
+        return to_route('cart.success', ['free' => 1]);
+    }
+
+    protected function createFreePluginLicense($user, Plugin $plugin): void
+    {
+        if ($user->pluginLicenses()->forPlugin($plugin)->active()->exists()) {
+            return;
+        }
+
+        PluginLicense::create([
+            'user_id' => $user->id,
+            'plugin_id' => $plugin->id,
+            'price_paid' => 0,
+            'currency' => 'USD',
+            'is_grandfathered' => false,
+            'purchased_at' => now(),
         ]);
     }