@lightupai/polaris 0.0.50 → 0.0.52

package/Makefile

@@ -17,20 +17,23 @@ dev-down:
 	docker compose down
 
 # Cloud service API (port 4321)
+# nohup so the service survives `make` exiting. A bare `&` leaves it as an
+# orphaned job that receives SIGHUP and dies (banner prints, then it's gone);
+# nohup makes it ignore SIGHUP. Logs go to /tmp/polaris-*.log.
 api:
 	@echo "Starting API server on http://localhost:4321"
-	@npx bun run src/service/server.ts 2>/tmp/polaris-api.log &
+	@nohup npx bun run src/service/server.ts >/tmp/polaris-api.log 2>&1 &
 
 # Web app (port 3000)
 web:
 	@echo "Starting web app on http://localhost:3000"
-	@npx bun --hot run src/web/serve.ts &
+	@nohup npx bun --hot run src/web/serve.ts >/tmp/polaris-web.log 2>&1 &
 
 # Local daemon (port 4322) — uses local profile token if available
 daemon:
 	@echo "Starting daemon on http://127.0.0.1:4322"
 	@TOKEN=$$(jq -r '.profiles.local.token // empty' ~/.polaris/config.json 2>/dev/null || echo ""); \
-	POLARIS_DAEMON_PORT=4322 POLARIS_SERVICE_URL=http://localhost:4321 POLARIS_AUTH_TOKEN="$$TOKEN" npx bun run src/daemon/daemon.ts &
+	POLARIS_DAEMON_PORT=4322 POLARIS_SERVICE_URL=http://localhost:4321 POLARIS_AUTH_TOKEN="$$TOKEN" nohup npx bun run src/daemon/daemon.ts >/tmp/polaris-daemon.log 2>&1 &
 
 # Slack bridge (auto-detects org from DB, needs SLACK_APP_TOKEN in .env)
 bridge:
@@ -38,7 +41,7 @@ bridge:
 	  ORG=$$(docker exec collab-polaris-postgres-1 psql -U polaris -d polaris -t -A -c "SELECT id FROM orgs WHERE slack_team_id IS NOT NULL LIMIT 1;" 2>/dev/null); \
 	  if [ -n "$$ORG" ]; then \
 	    echo "Starting Slack bridge for org $$ORG"; \
-	    npx bun run src/slack/bridge.ts $$ORG 2>/tmp/polaris-bridge.log & \
+	    nohup npx bun run src/slack/bridge.ts $$ORG >/tmp/polaris-bridge.log 2>&1 & \
 	  else echo "Skipping bridge (no Slack-connected org found)"; fi; \
 	fi
 

package/docs/signup-flow.md

@@ -0,0 +1,167 @@
+# Signup Flow — Design & Todos
+
+## Current State
+
+User clicks "Get started" on the landing page → Google OAuth → user/org created in DB → redirect to dashboard. No plan differentiation, no onboarding, no Slack connection prompt. New users land on an empty dashboard with no guidance.
+
+## Target State
+
+A user who signs up should experience a smooth path from landing page to their first live session:
+
+1. Choose a plan (or default to free)
+2. Sign up with Google
+3. Connect their Slack workspace
+4. Install the CLI
+5. Join a channel and start their first session
+
+Each step should feel intentional, not accidental. The user should never be left wondering "what do I do next?"
+
+---
+
+## Design
+
+### Plan Selection → Signup
+
+The pricing cards on the landing page link to `/signup?plan=free` or `/signup?plan=team`. Enterprise goes to `mailto:support@withpolaris.ai`. The plan parameter is stored in the OAuth state, survives the Google redirect, and is persisted on the org record after signup.
+
+If no plan is specified (e.g., user clicks the nav "Sign up" button), default to `free`.
+
+### Post-Signup Routing
+
+After Google OAuth completes, the callback handler should route based on the user's state:
+
+| Scenario | Route to |
+|---|---|
+| Existing user (login) | Dashboard |
+| New user, existing org | Dashboard (org already set up) |
+| New user, new org, no Slack | Onboarding: Connect Slack |
+| New user, new org, Slack connected | Onboarding: Install CLI |
+
+### Onboarding Flow
+
+A dedicated onboarding page replaces the empty dashboard for new orgs. Three steps, shown as a checklist:
+
+**Step 1: Connect Slack**
+- Large "Add to Slack" button
+- Explain: "Polaris uses Slack as the collaboration layer. Connect your workspace to get started."
+- After connecting, auto-advance to Step 2
+
+**Step 2: Install the CLI**
+- Show `npx @lightupai/polaris` with a copy button
+- Explain: "Run this on your machine to set up hooks and log in."
+- A "I've installed it" button to advance (or auto-detect via CLI auth callback)
+
+**Step 3: Start a session**
+- Show `/polaris join #your-channel` with a copy button
+- Explain: "Run this in Claude Code to start streaming your session."
+- Link to dashboard
+
+The existing `renderWelcomePage` and `renderSetupView` functions can be repurposed for this flow.
+
+### Welcome Email
+
+After a new user signs up, send a welcome email to their address from `hello@withpolaris.ai`:
+
+- Welcome to Polaris
+- Quick start: Connect Slack → Install CLI → Join a channel
+- Link to community (GitHub Discussions)
+- Link to support (support@withpolaris.ai)
+
+Requires an email sending service (Resend, SendGrid, or Postmark). Cloudflare email routing only handles inbound — outbound needs a transactional email provider.
+
+### Plan Enforcement
+
+Plans are stored on the org record. Limits are enforced at the event ingestion layer:
+
+| | Free | Team | Enterprise |
+|---|---|---|---|
+| Users | Unlimited | Unlimited | Unlimited |
+| Prompts/month | 1,000 | 10,000 | Custom |
+| Data captured | 5 GB | 50 GB | Custom |
+| Retention | 7 days | 90 days | Custom |
+
+**Enforcement approach:**
+- Count user prompts per org per calendar month (query events table)
+- Track cumulative data volume per org per month
+- Run a daily cleanup job to delete events beyond the retention window
+- When a limit is reached, soft-block: stop capturing new events but keep Slack streaming active. Show upgrade prompt in dashboard and optionally in Slack.
+
+### Upgrade Flow
+
+When a free-tier org approaches or hits their limit:
+
+1. Dashboard shows a usage bar with current/max for prompts and data
+2. At 80%, show a yellow warning: "You've used 80% of your free prompts this month"
+3. At 100%, show upgrade prompt: "You've reached your free plan limit. Upgrade to Team for 10x capacity."
+4. Upgrade button links to Stripe Checkout for the $49/mo Team plan
+5. After successful payment, Stripe webhook updates the org's plan to `team`
+
+### Billing (Stripe)
+
+**Setup needed:**
+- Stripe product: "Polaris Team"
+- Stripe price: $49/month, recurring
+- Checkout session: created when user clicks "Upgrade" or selects Team plan during signup
+- Webhook endpoint: `/stripe/webhook` to handle `checkout.session.completed`, `customer.subscription.deleted`, `invoice.payment_failed`
+- Org record fields: `stripe_customer_id`, `stripe_subscription_id`, `plan`, `plan_status`
+
+**Downgrade:**
+- User cancels in Stripe customer portal
+- Webhook fires `customer.subscription.deleted`
+- Org plan reverts to `free`
+- Free plan limits take effect at next billing cycle
+
+---
+
+## Todos
+
+### Phase 1: Foundation (do first)
+
+- [ ] **Store selected plan on org record**
+  Add a `plan` column to the orgs table (free/team/enterprise, default 'free'). Populate from the `?plan` query param during signup. Show current plan on the dashboard.
+
+- [ ] **Prompt Slack connection immediately after signup**
+  For new orgs without Slack connected, route to setup view with prominent "Add to Slack" button instead of empty dashboard. Ensure the flow from signup → setup is seamless.
+
+- [ ] **Post-signup onboarding flow**
+  After a brand new org signup, redirect to onboarding page (not dashboard). Three steps: Connect Slack → Install CLI → Join a channel. Repurpose existing `renderWelcomePage`/`renderSetupView`. Auto-advance when each step is completed.
+
+### Phase 2: Billing
+
+- [ ] **Stripe integration for Team plan billing**
+  Stripe product/price setup, checkout session on Team plan selection, webhook handler for payment events, store subscription status on org. Handle both new signups selecting Team and existing free users upgrading.
+
+- [ ] **Enforce free tier usage limits**
+  Prompt counter per org per month, data volume tracking, auto-cleanup of events beyond retention window. Soft-block at limits (stop capture, keep streaming, show upgrade prompt).
+
+- [ ] **Upgrade prompt when limits are reached**
+  Usage bars on dashboard, warning at 80%, upgrade prompt at 100%. Link to Stripe checkout. Also notify in Slack when org approaches limit.
+
+- [ ] **Plan management page in dashboard**
+  Show current plan, usage stats (prompts, data, retention), upgrade/downgrade buttons, Stripe customer portal link. Accessible from profile dropdown.
+
+### Phase 3: Polish
+
+- [ ] **Welcome email on signup**
+  Pick a transactional email service (Resend recommended — simple API, good deliverability, free tier). Send welcome email with quick-start steps and community link. Send from hello@withpolaris.ai.
+
+---
+
+## Dependencies
+
+```
+Store plan on org ──→ Enforce limits ──→ Upgrade prompt
+                 ──→ Stripe billing ──→ Plan management page
+                 ──→ Onboarding flow
+
+Prompt Slack connection ──→ Onboarding flow
+
+Welcome email (independent — needs email service selection)
+```
+
+## Open Questions
+
+- Should we allow plan changes mid-month, or only at billing cycle boundaries?
+- Should free-tier users who hit limits lose access to existing session data, or just stop capturing new data?
+- Do we want a 14-day free trial of Team, or keep it strictly free-then-pay?
+- Should the CLI install step in onboarding auto-detect completion (via the `/auth/cli` callback), or require manual confirmation?

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightupai/polaris",
-  "version": "0.0.50",
+  "version": "0.0.52",
   "type": "module",
   "bin": {
     "polaris": "bin/polaris",

package/src/web/app.ts

@@ -36,13 +36,14 @@ import {
 
 const SIGNUP_CHANNEL = "#alerts-mql-stream";
 
-function notifySignup(opts: { name: string; email: string; domain: string; orgName: string; isNewOrg: boolean }): void {
+function notifySignup(opts: { name: string; email: string; domain: string; orgName: string; isNewOrg: boolean; plan?: string }): void {
   const botToken = process.env.SIGNUP_SLACK_BOT_TOKEN;
   if (!botToken) return;
 
   const emoji = opts.isNewOrg ? ":tada:" : ":wave:";
   const action = opts.isNewOrg ? "signed up (new org)" : "joined";
-  const text = `${emoji} *${opts.name}* (${opts.email}) ${action} — ${opts.orgName} (${opts.domain})`;
+  const planTag = opts.plan ? ` [${opts.plan}]` : "";
+  const text = `${emoji} *${opts.name}* (${opts.email}) ${action} — ${opts.orgName} (${opts.domain})${planTag}`;
 
   fetch("https://slack.com/api/chat.postMessage", {
     method: "POST",
@@ -91,7 +92,7 @@ function getGoogle(): Google {
   );
 }
 
-const oauthStates = new Map<string, { type: "login" | "signup"; codeVerifier: string; timestamp: number }>();
+const oauthStates = new Map<string, { type: "login" | "signup"; codeVerifier: string; timestamp: number; plan?: string }>();
 const cliCallbackPorts = new Map<string, number>(); // state → CLI local server port
 
 // If this auth flow was initiated by the CLI, redirect the token to the CLI's local server.
@@ -128,11 +129,12 @@ export function createApp(sql: Sql) {
 
   // --- Auth: single Google SSO flow for both signup and login ---
 
-  function startGoogleAuth(c: { redirect: (url: string) => Response }) {
+  function startGoogleAuth(c: { req: { query: (k: string) => string | undefined }; redirect: (url: string) => Response }) {
     const google = getGoogle();
     const state = crypto.randomUUID();
     const codeVerifier = crypto.randomUUID();
-    oauthStates.set(state, { type: "login", codeVerifier, timestamp: Date.now() });
+    const plan = c.req.query("plan");
+    oauthStates.set(state, { type: "login", codeVerifier, timestamp: Date.now(), plan });
     const url = google.createAuthorizationURL(state, codeVerifier, ["openid", "email", "profile"]);
     return c.redirect(url.toString());
   }
@@ -195,7 +197,7 @@ export function createApp(sql: Sql) {
       }).catch(() => {});
 
       // Notify internal team
-      notifySignup({ name, email, domain, orgName: existingOrg.name, isNewOrg: false });
+      notifySignup({ name, email, domain, orgName: existingOrg.name, isNewOrg: false, plan: stateData.plan });
 
       const token = await createToken({ sub: userId, email, name, org_id: existingOrg.id, participant_id: participantId });
       return authRedirect(c, state, token);
@@ -214,7 +216,7 @@ export function createApp(sql: Sql) {
     await createUser(sql, userId, email, name, orgId, participantId);
 
     // Notify internal team
-    notifySignup({ name, email, domain, orgName, isNewOrg: true });
+    notifySignup({ name, email, domain, orgName, isNewOrg: true, plan: stateData.plan });
 
     const token = await createToken({ sub: userId, email, name, org_id: orgId, participant_id: participantId });
     return authRedirect(c, state, token);

package/src/web/pages.ts

@@ -375,7 +375,7 @@ export function renderLandingPage(): string {
               <span class="text-gray-500 text-sm ml-1">forever</span>
             </div>
             <p class="mt-2 text-sm text-gray-500">For individuals and small teams getting started.</p>
-            <a href="/signup" class="mt-6 block w-full text-center px-4 py-2.5 bg-gray-900 text-white text-sm font-medium rounded-lg hover:bg-gray-800 transition">Get started</a>
+            <a href="/signup?plan=free" class="mt-6 block w-full text-center px-4 py-2.5 bg-gray-900 text-white text-sm font-medium rounded-lg hover:bg-gray-800 transition">Get started</a>
             <ul class="mt-6 space-y-3 text-sm text-gray-700">
               <li class="flex items-start gap-2"><svg class="w-4 h-4 text-green-500 mt-0.5 shrink-0" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M5 13l4 4L19 7"/></svg>Unlimited users</li>
               <li class="flex items-start gap-2"><svg class="w-4 h-4 text-green-500 mt-0.5 shrink-0" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M5 13l4 4L19 7"/></svg><span><strong>1,000</strong> prompts / month</span></li>
@@ -393,7 +393,7 @@ export function renderLandingPage(): string {
               <span class="text-gray-500 text-sm ml-1">/month</span>
             </div>
             <p class="mt-2 text-sm text-gray-500">For teams that need more capacity, history, and search.</p>
-            <a href="/signup" class="mt-6 block w-full text-center px-4 py-2.5 bg-polaris-700 text-white text-sm font-medium rounded-lg hover:bg-polaris-800 transition">Get started</a>
+            <a href="/signup?plan=team" class="mt-6 block w-full text-center px-4 py-2.5 bg-polaris-700 text-white text-sm font-medium rounded-lg hover:bg-polaris-800 transition">Get started</a>
             <ul class="mt-6 space-y-3 text-sm text-gray-700">
               <li class="flex items-start gap-2"><svg class="w-4 h-4 text-green-500 mt-0.5 shrink-0" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M5 13l4 4L19 7"/></svg>Unlimited users</li>
               <li class="flex items-start gap-2"><svg class="w-4 h-4 text-green-500 mt-0.5 shrink-0" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M5 13l4 4L19 7"/></svg><span><strong>10,000</strong> prompts / month</span></li>
@@ -410,7 +410,7 @@ export function renderLandingPage(): string {
               <span class="text-4xl font-bold text-gray-900">Custom</span>
             </div>
             <p class="mt-2 text-sm text-gray-500">For organizations with compliance and scale needs.</p>
-            <a href="mailto:hello@withpolaris.ai" class="mt-6 block w-full text-center px-4 py-2.5 bg-white border border-gray-300 text-gray-700 text-sm font-medium rounded-lg hover:bg-gray-50 transition">Contact us</a>
+            <a href="mailto:support@withpolaris.ai?subject=Enterprise%20plan%20inquiry" class="mt-6 block w-full text-center px-4 py-2.5 bg-white border border-gray-300 text-gray-700 text-sm font-medium rounded-lg hover:bg-gray-50 transition">Contact us</a>
             <ul class="mt-6 space-y-3 text-sm text-gray-700">
               <li class="flex items-start gap-2"><svg class="w-4 h-4 text-green-500 mt-0.5 shrink-0" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M5 13l4 4L19 7"/></svg>Everything in Team</li>
               <li class="flex items-start gap-2"><svg class="w-4 h-4 text-green-500 mt-0.5 shrink-0" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M5 13l4 4L19 7"/></svg>Custom usage limits</li>