@lightupai/polaris 0.0.79 → 0.0.80

package/.github/workflows/cd.yml

@@ -1,11 +1,15 @@
 name: CD
 
-# Continuous deployment: on every push (merge) to master, SSH to the prod
-# host and run deploy.sh (git pull + docker compose build/up).
+# Continuous deployment: on every push (merge) to master:
+#   1. SSH to the prod host and run deploy.sh (git pull + docker compose build/up).
+#   2. Publish @lightupai/polaris to npm if the version in package.json has been
+#      bumped beyond what is already published (i.e. only when there are client-side
+#      changes that warrant a release).
 #
 # Required repository secrets (Settings → Secrets and variables → Actions):
 #   DEPLOY_HOST     — hostname or IP of the prod box (e.g. polaris.lightup.ai)
 #   DEPLOY_SSH_KEY  — private SSH key (OpenSSH format) for the deploy user
+#   NPM_TOKEN       — npm Automation token (bypasses OTP; create at npmjs.com)
 #
 # Optional repository secrets (deploy.sh has sensible defaults):
 #   DEPLOY_USER     — SSH user on the prod box (default: deploy)
@@ -75,3 +79,34 @@ jobs:
           DEPLOY_USER: ${{ secrets.DEPLOY_USER }}
           DEPLOY_DIR: ${{ secrets.DEPLOY_DIR }}
         run: ./deploy.sh
+
+  publish-npm:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Check if version needs publishing
+        id: version-check
+        run: |
+          LOCAL=$(node -p "require('./package.json').version")
+          PUBLISHED=$(npm view @lightupai/polaris version 2>/dev/null || echo "0.0.0")
+          echo "local=$LOCAL" >> "$GITHUB_OUTPUT"
+          echo "published=$PUBLISHED" >> "$GITHUB_OUTPUT"
+          if [ "$LOCAL" != "$PUBLISHED" ]; then
+            echo "should_publish=true" >> "$GITHUB_OUTPUT"
+            echo "Version $LOCAL differs from published $PUBLISHED — will publish."
+          else
+            echo "should_publish=false" >> "$GITHUB_OUTPUT"
+            echo "Version $LOCAL already published — skipping npm publish."
+          fi
+
+      - name: Publish to npm
+        if: steps.version-check.outputs.should_publish == 'true'
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npm publish --access public

package/docker-compose.prod.yml

@@ -46,6 +46,7 @@ services:
       SLACK_CLIENT_SECRET: ${SLACK_CLIENT_SECRET}
       SLACK_REDIRECT_URI: https://app.withpolaris.ai/slack/callback
       SIGNUP_SLACK_BOT_TOKEN: ${SIGNUP_SLACK_BOT_TOKEN:-}
+      POLARIS_API_URL: http://api:4321
     depends_on:
       postgres:
         condition: service_healthy

package/docs/signup-flow.md

@@ -10,9 +10,9 @@ A user who signs up should experience a smooth path from landing page to their f
 
 1. Choose a plan (or default to free)
 2. Sign up with Google
-3. Connect their Slack workspace
+3. Connect their Slack workspace *(optional — can be skipped and done later)*
 4. Install the CLI
-5. Join a channel and start their first session
+5. Start their first session (join a channel if Slack is connected)
 
 Each step should feel intentional, not accidental. The user should never be left wondering "what do I do next?"
 
@@ -34,17 +34,18 @@ After Google OAuth completes, the callback handler should route based on the use
 |---|---|
 | 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, no Slack | Onboarding: Connect Slack (with skip option) |
 | 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 1: Connect Slack** *(optional)*
+- Large "Connect Slack" button
+- Explain: "Share sessions with your team in real time. Connect Slack to publish your session log to a channel."
+- "Skip for now" link lets users proceed without connecting. Skip state is stored in a browser cookie (`polaris_floor_skipped`).
+- After connecting (or skipping), advance to Step 2
 
 **Step 2: Install the CLI**
 - Show `npx @lightupai/polaris` with a copy button
@@ -120,8 +121,8 @@ When a free-tier org approaches or hits their limit:
 - [ ] **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.
+- [x] **Prompt Slack connection immediately after signup**
+  Setup view shows Floor as step 1 with a "Connect Slack" button. Users can skip via "Skip for now" (cookie-based) and proceed to install the CLI and start sessions without Slack. Floor can be connected at any time from the setup or active dashboard.
 
 - [ ] **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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightupai/polaris",
-  "version": "0.0.79",
+  "version": "0.0.80",
   "description": "Record and stream Claude Code sessions to Slack. Like Gong for AI coding — capture every prompt, response, and tool call. Multiplayer collaboration across AI coding agents.",
   "keywords": [
     "claude-code",

package/src/client/client.ts

@@ -71,7 +71,7 @@ mcp.setRequestHandler(ListToolsRequestSchema, async () => ({
       inputSchema: {
         type: "object" as const,
         properties: {
-          channel: { type: "string", description: "Channel name (e.g., #polaris-dev). Omit to list available channels." },
+          channel: { type: "string", description: "Project workspace to join (e.g., #my-project). Becomes the Slack channel name if a floor is connected. Omit to list existing projects." },
           user: { type: "string", description: "Your participant ID (e.g., user:manu)" },
           session: { type: "string", description: "Session name (optional — auto-generated if omitted)" },
           agent: { type: "string", description: "Agent identity (optional — defaults to agent:claude)" },
@@ -97,7 +97,7 @@ mcp.setRequestHandler(ListToolsRequestSchema, async () => ({
     },
     {
       name: "polaris_reply",
-      description: "Send a message to the project floor (visible to all advisors and the Slack/WhatsApp channel).",
+      description: "Send a message to the project floor (visible to all advisors, and to the linked Slack channel if a floor is connected).",
       inputSchema: {
         type: "object" as const,
         properties: {
@@ -108,7 +108,7 @@ mcp.setRequestHandler(ListToolsRequestSchema, async () => ({
     },
     {
       name: "polaris_rename",
-      description: "Rename the current project. Also renames the Slack channel.",
+      description: "Rename the current project. Also renames the linked Slack channel if a floor is connected.",
       inputSchema: {
         type: "object" as const,
         properties: {
@@ -184,12 +184,12 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
         if (res.ok) {
           const body = await res.json() as { channels: string[] };
           if (body.channels.length === 0) {
-            return { content: [{ type: "text", text: "No channels found. Create one by joining: `/polaris join #channel-name`" }] };
+            return { content: [{ type: "text", text: "No projects found. Start one with: `/polaris join #my-project`" }] };
           }
-          return { content: [{ type: "text", text: `Available channels:\n${body.channels.map(c => `  ${c}`).join("\n")}\n\nJoin one with: /polaris join #channel-name` }] };
+          return { content: [{ type: "text", text: `Available projects:\n${body.channels.map(c => `  ${c}`).join("\n")}\n\nJoin one with: /polaris join #project-name` }] };
         }
       } catch { /* fall through */ }
-      return { content: [{ type: "text", text: "Specify a channel: `/polaris join #channel-name`" }] };
+      return { content: [{ type: "text", text: "Specify a project: `/polaris join #my-project`" }] };
     }
 
     const project = channel.replace(/^#/, ""); // strip leading # if present

package/src/daemon/daemon.ts

@@ -13,7 +13,7 @@ interface SessionMapping {
   agent: string;
   slackChannel?: string;
   ws: WebSocket | null;
-  pendingMapping?: boolean; // true until a hook event maps the real CC session ID
+  pendingMapping?: boolean; // true until the first hook event from this shell claims the mapping
 }
 
 function generateSessionName(): string {
@@ -590,19 +590,18 @@ export function startDaemon(port = Number(process.env.POLARIS_DAEMON_PORT ?? 432
           //    MCP, connected via /connect, or a previously learned alias) —
           //    always routed by that match, regardless of how many other
           //    sessions are connected. A matchable event is never dropped.
-          // 2. No match + exactly one connected session: route to it and
-          //    remember session_id as an alias of that mapping (the MCP
-          //    client's generated UUID differs from CC's hook session_id),
-          //    so later events route by rule 1 even once more sessions join.
-          // 3. No match + multiple connected sessions: truly unmatchable —
-          //    drop, but loudly (console warning + JSONL log entry).
-          // 4. No match + nothing connected: not_connected (existing).
+          // 2. No exact match + a pending session exists: the MCP client's
+          //    generated UUID differs from CC's hook session_id. The first
+          //    hook event from the shell that ran /connect claims the pending
+          //    slot and becomes the canonical alias going forward.
+          // 3. No match + no pending session: unknown hook — the shell never
+          //    ran polaris_connect. Always returns not_connected; hooks from
+          //    unjoined shells are never auto-routed to an existing session.
           let mapping = sessions.get(ccSessionId);
           if (!mapping || !mapping.project) {
             // CC session_id doesn't match any registered MCP client. The MCP
             // server uses a different UUID than CC's session_id. Match to a
-            // session with pendingMapping (most recent first); fall back to the
-            // single-connected-session heuristic when none is pending.
+            // session with pendingMapping (most recent first).
             const pending = Array.from(sessions.values()).filter((m) => m.project && m.pendingMapping);
             if (pending.length > 0) {
               // Map the CC session ID to the most recently connected pending session
@@ -618,32 +617,10 @@ export function startDaemon(port = Number(process.env.POLARIS_DAEMON_PORT ?? 432
               injectQueues.set(mapping.ccSessionId, queue);
               injectQueues.set(ccSessionId, queue);
             } else {
-              // No pending sessions — fall back to the single-session heuristic.
-              const connectedSessions = Array.from(sessions.values()).filter((m) => m.project);
-              if (connectedSessions.length === 1) {
-                // Only one active session — route to it and remember the mapping
-                mapping = connectedSessions[0];
-                sessions.set(ccSessionId, { ...mapping, ccSessionId, slackChannel: undefined });
-                // Share the inject queue (see note above).
-                const queue = injectQueues.get(mapping.ccSessionId) ?? [];
-                injectQueues.set(mapping.ccSessionId, queue);
-                injectQueues.set(ccSessionId, queue);
-              } else if (connectedSessions.length > 1) {
-                // Multiple sessions and session_id matches none of them (nor any
-                // learned alias) — can't determine which one. Drop with a clear
-                // warning, never silently.
-                const candidates = connectedSessions.map((m) => `${m.project}/${m.session}`).join(", ");
-                console.error(
-                  `polaris daemon: dropping ${String(body.hook_event_name ?? "hook")} event — ` +
-                  `session_id ${ccSessionId} matches no known mapping and ${connectedSessions.length} ` +
-                  `sessions are connected (${candidates}). ` +
-                  `Reconnect with polaris_connect in the affected Claude session to re-establish routing.`
-                );
-                await logEvent("/events", body, { status: 0, body: `dropped: ambiguous across ${connectedSessions.length} sessions (${candidates})` });
-                return json({ status: "ambiguous" });
-              } else {
-                return json({ status: "not_connected" });
-              }
+              // No pending sessions — this hook's session_id doesn't match any
+              // known mapping. Unjoined shells are never auto-routed; the user
+              // must run polaris_connect explicitly in this Claude session.
+              return json({ status: "not_connected" });
             }
           }
 

package/src/web/app.ts

@@ -1,4 +1,5 @@
 import { Hono } from "hono";
+import { getCookie, setCookie } from "hono/cookie";
 import { Google } from "arctic";
 import { createToken, verifyToken } from "../service/auth";
 import {
@@ -384,6 +385,8 @@ export function createApp(sql: Sql) {
 
     const hasConnectedSession = allSessions.length > 0;
 
+    const floorSkipped = getCookie(c, "polaris_floor_skipped") === "1";
+
     const ctx = {
       token,
       userName: payload.name,
@@ -391,6 +394,7 @@ export function createApp(sql: Sql) {
       orgSlug: org.slug,
       email: payload.email,
       slackConnected: !!org.slack_team_id,
+      floorSkipped,
       cliInstalled,
       hasConnectedSession,
       totalPrompts: Array.from(promptCounts.values()).reduce((a, b) => a + b, 0),
@@ -405,6 +409,15 @@ export function createApp(sql: Sql) {
     return layout(renderSetupView(ctx, devices), "Setup — Polaris by Lightup");
   });
 
+  // --- Skip floor setup ---
+
+  app.get("/skip/floor", async (c) => {
+    const token = c.req.query("token");
+    if (!token) return c.redirect("/login");
+    setCookie(c, "polaris_floor_skipped", "1", { path: "/", maxAge: 60 * 60 * 24 * 365, httpOnly: true, sameSite: "Lax" });
+    return c.redirect(`/dashboard?token=${token}`);
+  });
+
   // --- Profile ---
 
   app.get("/profile", async (c) => {
@@ -789,7 +802,7 @@ export function createApp(sql: Sql) {
 
   app.get("/preview", (c) => {
     const mockToken = "preview-token";
-    const base = { token: mockToken, userName: mockUser.name, orgName: mockOrg.name, orgSlug: "lightup-data" as string | null, email: mockUser.email };
+    const base = { token: mockToken, userName: mockUser.name, orgName: mockOrg.name, orgSlug: "lightup-data" as string | null, email: mockUser.email, floorSkipped: false };
 
     const mockTeam = [{ name: mockUser.name, email: mockUser.email }, { name: "Alice Chen", email: "alice@lightup.ai" }, { name: "Laura Mowry", email: "laura@lightup.ai" }];
     const mockSenders = ["user:manu.bansal", "user:alice.chen", "user:laura.mowry"];
@@ -799,10 +812,11 @@ export function createApp(sql: Sql) {
         return { date: d.toISOString().slice(0, 10), sender, count: Math.floor(Math.random() * 12) + 1 };
       })
     );
-    const fresh       = { ...base, orgSlug: null, slackConnected: false, cliInstalled: false, hasConnectedSession: false, totalPrompts: 0 };
-    const slackDone   = { ...base, slackConnected: true,  cliInstalled: false, hasConnectedSession: false, totalPrompts: 0, teamMembers: mockTeam, dailyPrompts: mockDailyPrompts };
-    const cliDone     = { ...base, slackConnected: true,  cliInstalled: true,  hasConnectedSession: false, totalPrompts: 0, teamMembers: mockTeam, dailyPrompts: mockDailyPrompts };
-    const allDone     = { ...base, slackConnected: true,  cliInstalled: true,  hasConnectedSession: true,  totalPrompts: 127, teamMembers: mockTeam, dailyPrompts: mockDailyPrompts };
+    const fresh         = { ...base, orgSlug: null, slackConnected: false, floorSkipped: false, cliInstalled: false, hasConnectedSession: false, totalPrompts: 0 };
+    const floorSkipped  = { ...base, orgSlug: null, slackConnected: false, floorSkipped: true,  cliInstalled: false, hasConnectedSession: false, totalPrompts: 0 };
+    const slackDone     = { ...base, slackConnected: true,  floorSkipped: false, cliInstalled: false, hasConnectedSession: false, totalPrompts: 0, teamMembers: mockTeam, dailyPrompts: mockDailyPrompts };
+    const cliDone       = { ...base, slackConnected: true,  floorSkipped: false, cliInstalled: true,  hasConnectedSession: false, totalPrompts: 0, teamMembers: mockTeam, dailyPrompts: mockDailyPrompts };
+    const allDone       = { ...base, slackConnected: true,  floorSkipped: false, cliInstalled: true,  hasConnectedSession: true,  totalPrompts: 127, teamMembers: mockTeam, dailyPrompts: mockDailyPrompts };
     const teamPlan    = { ...fresh, plan: "pro" };
 
     return layout(`
@@ -819,6 +833,14 @@ export function createApp(sql: Sql) {
             </div>
           </section>
 
+          <section>
+            <h2 class="text-lg font-bold text-gray-700 mb-1">Setup: floor skipped</h2>
+            <p class="text-sm text-gray-400 mb-4">User clicked "Skip for now" — floor subdued, Devices becomes active.</p>
+            <div class="border border-gray-200 rounded-xl overflow-hidden shadow-sm">
+              ${renderSetupView(floorSkipped)}
+            </div>
+          </section>
+
           <section>
             <h2 class="text-lg font-bold text-gray-700 mb-1">Setup: Slack connected</h2>
             <p class="text-sm text-gray-400 mb-4">Floor is live, CLI not installed yet.</p>

package/src/web/views.ts

@@ -17,6 +17,7 @@ interface ViewContext {
   orgSlug: string | null;
   email: string;
   slackConnected: boolean;
+  floorSkipped: boolean;
   cliInstalled: boolean;
   hasConnectedSession: boolean;
   totalPrompts: number;
@@ -276,26 +277,42 @@ function renderFloorSection(ctx: ViewContext, compact = false, state: StepState
       </div>`;
   }
 
+  if (ctx.floorSkipped) {
+    return `
+      <div class="opacity-50">
+        <div class="flex items-baseline gap-2 mb-3">
+          <h2 class="text-xs font-semibold text-gray-400 uppercase tracking-wider">Floor</h2>
+          ${statusBadge("Skipped", false)}
+        </div>
+        <div class="bg-gray-50 border border-gray-200 rounded-lg px-5 py-3 flex items-center justify-between">
+          <p class="text-sm text-gray-400">No floor connected.</p>
+          <a href="/slack/install?token=${ctx.token}" class="text-xs text-gray-400 hover:text-gray-600 transition">Connect Slack</a>
+        </div>
+      </div>`;
+  }
+
   return sectionWrap(state, `
     <div>
       <div class="flex items-baseline gap-2 mb-3">
-        <h2 class="text-xs font-semibold text-gray-400 uppercase tracking-wider">Floor</h2>
-        ${statusBadge("Not connected", false)}
+        <h2 class="text-xs font-semibold text-gray-400 uppercase tracking-wider">Floor <span class="text-[10px] font-normal normal-case text-gray-400">— optional</span></h2>
       </div>
-      <div class="bg-white border ${state === "active" ? cardClass("active") : "border-amber-200"} rounded-lg p-5">
+      <div class="bg-white border ${state === "active" ? cardClass("active") : "border-gray-200"} rounded-lg p-5">
         <div class="flex items-center gap-3">
           <div class="w-10 h-10 rounded-lg bg-gray-100 flex items-center justify-center shrink-0">
             <svg class="w-5 h-5 text-gray-400" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13.828 10.172a4 4 0 00-5.656 0l-4 4a4 4 0 105.656 5.656l1.102-1.101m-.758-4.899a4 4 0 005.656 0l4-4a4 4 0 00-5.656-5.656l-1.1 1.1"/></svg>
           </div>
           <div>
-            <p class="text-sm font-semibold text-gray-900">Slack</p>
-            <p class="text-sm text-gray-500 mt-0.5">Connect your Slack workspace to enable the floor for your team.</p>
+            <p class="text-sm font-semibold text-gray-900">Connect a floor</p>
+            <p class="text-sm text-gray-500 mt-0.5">Share sessions with your team in real time. Connect Slack to publish your session log to a channel.</p>
           </div>
         </div>
-        <a href="/slack/install?token=${ctx.token}" class="mt-3 inline-flex items-center gap-2 px-4 py-2 bg-[#4A154B] text-white text-sm font-medium rounded-lg hover:bg-[#3a1039] transition">
-          ${slackIcon}
-          Connect Slack
-        </a>
+        <div class="mt-3 flex items-center gap-4">
+          <a href="/slack/install?token=${ctx.token}" class="inline-flex items-center gap-2 px-4 py-2 bg-[#4A154B] text-white text-sm font-medium rounded-lg hover:bg-[#3a1039] transition">
+            ${slackIcon}
+            Connect Slack
+          </a>
+          <a href="/skip/floor?token=${ctx.token}" class="text-sm text-gray-400 hover:text-gray-600 transition">Skip for now</a>
+        </div>
       </div>
     </div>`);
 }
@@ -402,7 +419,10 @@ function renderProjectsSessionsSection(ctx: ViewContext, sessions: SessionFixtur
           : "Inside your AI agent (Claude Code, Cursor, etc.), run:"}</p>
         ${ctx.hasConnectedSession
           ? ""
-          : copyBlock("/polaris join #my-channel")}
+          : copyBlock("/polaris join #my-project")}
+        ${ctx.hasConnectedSession
+          ? ""
+          : `<p class="text-xs text-gray-400 mt-2">The name becomes your project workspace — and your Slack channel if a floor is connected.</p>`}
       </div>
     </div>`);
 }
@@ -474,7 +494,8 @@ function autoRefreshScript(token: string): string {
 // Same three sections, but each shows its setup prompt instead of live data.
 
 export function renderSetupView(ctx: ViewContext, devices: DeviceFixture[] = []): string {
-  const nextStep = !ctx.slackConnected ? "floor" : !ctx.cliInstalled ? "devices" : "sessions";
+  const floorDone = ctx.slackConnected || ctx.floorSkipped;
+  const nextStep = !floorDone ? "floor" : !ctx.cliInstalled ? "devices" : "sessions";
   const stepState = (step: string): "done" | "active" | "future" => {
     const order = ["floor", "devices", "sessions"];
     const nextIdx = order.indexOf(nextStep);