@lightupai/polaris 0.0.101 → 0.0.103

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightupai/polaris",
-  "version": "0.0.101",
+  "version": "0.0.103",
   "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/skills/polaris/SKILL.md

@@ -1,8 +1,8 @@
 ---
 name: polaris
 description: Connect to a Polaris multiplayer collaboration session
-allowed-tools: polaris_connect polaris_disconnect polaris_status polaris_reply polaris_context polaris_rename polaris_backfill polaris_team
-argument-hint: [join #channel | tag [name] | backfill [duration] | rename <new-name> | disconnect | (no args for status)]
+allowed-tools: polaris_connect polaris_disconnect polaris_status polaris_reply polaris_context polaris_rename polaris_rename_session polaris_backfill polaris_team
+argument-hint: [join #channel [session-name] | tag [name] | backfill [duration] | rename <new-name> | rename-session <name> | disconnect | (no args for status)]
 ---
 
 ## Polaris — Multiplayer Collaboration
@@ -13,8 +13,8 @@ Manage your connection to a Polaris collaboration session.
 
 Based on the arguments provided, do ONE of the following:
 
-**`/polaris join #channel-name`** — Connect to an existing project, or create a new one:
-1. Call `polaris_connect` with the given channel and user identity `user:manu.bansal`
+**`/polaris join #channel-name [session-name]`** — Connect to an existing project, or create a new one:
+1. Call `polaris_connect` with the given channel, user identity `user:manu.bansal`, and optional `session` name (e.g. `auth-feature`, `bugfix-154`)
 2. If the response is `project_not_found`:
    - Show the list of existing projects from the response
    - Ask the user: "Project '#channel-name' doesn't exist. Create it? [y/N]"
@@ -22,10 +22,14 @@ Based on the arguments provided, do ONE of the following:
    - If no: stop and show the existing project list so they can pick one
 3. Report the connection status including the session name
 
-**`/polaris rename <new-name>`** — Rename the current channel:
+**`/polaris rename <new-name>`** — Rename the current **project** (and its Slack channel):
 1. Call `polaris_rename` with the new name
 2. Report the result
 
+**`/polaris rename-session <new-name>`** — Rename this **session thread** only (not the project):
+1. Call `polaris_rename_session` with the new name
+2. Report the result
+
 **`/polaris tag [name]`** — Tag a teammate on Slack:
 1. Call `polaris_team` to get the team list with Slack identities
 2. If a name was given, find the matching member. If no name, present a numbered list for the user to pick.

package/src/cli/cli.ts

@@ -428,8 +428,8 @@ async function install(participantId?: string) {
   const skillContent = `---
 name: polaris
 description: Connect to a Polaris multiplayer collaboration session
-allowed-tools: polaris_connect polaris_disconnect polaris_status polaris_reply polaris_context polaris_rename
-argument-hint: [join #channel | rename <new-name> | disconnect | (no args for status)]
+allowed-tools: polaris_connect polaris_disconnect polaris_status polaris_reply polaris_context polaris_rename polaris_rename_session
+argument-hint: [join #channel [session-name] | rename <new-name> | rename-session <name> | disconnect | (no args for status)]
 ---
 
 ## Polaris — Multiplayer Collaboration
@@ -440,15 +440,19 @@ Manage your connection to a Polaris collaboration session.
 
 Based on the arguments provided, do ONE of the following:
 
-**\`/polaris join #channel-name\`** — Connect to a channel:
-1. Call \`polaris_connect\` with the given project and user identity ${identity}
-2. A session name is auto-generated
+**\`/polaris join #channel-name [session-name]\`** — Connect to a channel:
+1. Call \`polaris_connect\` with the given project, user identity ${identity}, and optional \`session\` name (e.g. \`auth-feature\`, \`bugfix-154\`)
+2. A session name is auto-generated if not provided
 3. Report the connection status including the session name
 
-**\`/polaris rename <new-name>\`** — Rename the current project:
+**\`/polaris rename <new-name>\`** — Rename the current **project** (and its Slack channel):
 1. Call \`polaris_rename\` with the new name
 2. Report the result
 
+**\`/polaris rename-session <new-name>\`** — Rename this **session thread** only (not the project):
+1. Call \`polaris_rename_session\` with the new name
+2. Report the result
+
 **\`/polaris disconnect\`** — Disconnect:
 1. Call \`polaris_disconnect\`
 2. Confirm disconnection
@@ -567,8 +571,8 @@ async function login(appUrl: string, profileName?: string, loginHint?: string) {
   const skillContent = `---
 name: polaris
 description: Connect to a Polaris multiplayer collaboration session
-allowed-tools: polaris_connect polaris_disconnect polaris_status polaris_reply polaris_context polaris_rename
-argument-hint: [join #channel | rename <new-name> | disconnect | (no args for status)]
+allowed-tools: polaris_connect polaris_disconnect polaris_status polaris_reply polaris_context polaris_rename polaris_rename_session
+argument-hint: [join #channel [session-name] | rename <new-name> | rename-session <name> | disconnect | (no args for status)]
 ---
 
 ## Polaris — Multiplayer Collaboration
@@ -579,15 +583,19 @@ Manage your connection to a Polaris collaboration session.
 
 Based on the arguments provided, do ONE of the following:
 
-**\`/polaris join #channel-name\`** — Connect to a channel:
-1. Call \`polaris_connect\` with the given project and user identity ${identity}
-2. A session name is auto-generated
+**\`/polaris join #channel-name [session-name]\`** — Connect to a channel:
+1. Call \`polaris_connect\` with the given project, user identity ${identity}, and optional \`session\` name (e.g. \`auth-feature\`, \`bugfix-154\`)
+2. A session name is auto-generated if not provided
 3. Report the connection status including the session name
 
-**\`/polaris rename <new-name>\`** — Rename the current project:
+**\`/polaris rename <new-name>\`** — Rename the current **project** (and its Slack channel):
 1. Call \`polaris_rename\` with the new name
 2. Report the result
 
+**\`/polaris rename-session <new-name>\`** — Rename this **session thread** only (not the project):
+1. Call \`polaris_rename_session\` with the new name
+2. Report the result
+
 **\`/polaris disconnect\`** — Disconnect:
 1. Call \`polaris_disconnect\`
 2. Confirm disconnection

package/src/client/client.ts

@@ -156,7 +156,7 @@ mcp.setRequestHandler(ListToolsRequestSchema, async () => ({
     },
     {
       name: "polaris_rename",
-      description: "Rename the current project. Also renames the linked Slack channel if a floor is connected.",
+      description: "Rename the current PROJECT (and its linked Slack channel). To rename just this session thread, use polaris_rename_session instead.",
       inputSchema: {
         type: "object" as const,
         properties: {
@@ -165,6 +165,17 @@ mcp.setRequestHandler(ListToolsRequestSchema, async () => ({
         required: ["name"],
       },
     },
+    {
+      name: "polaris_rename_session",
+      description: "Rename this session thread (e.g. from 's-3f95' to 'auth-feature'). Does not affect the project or other sessions.",
+      inputSchema: {
+        type: "object" as const,
+        properties: {
+          name: { type: "string", description: "New session name (e.g. 'auth-feature', 'bugfix-154')" },
+        },
+        required: ["name"],
+      },
+    },
     {
       name: "polaris_context",
       description: "Fetch activity from a sibling session in this project. Use this to see what other drivers have been doing.",
@@ -192,6 +203,7 @@ mcp.setRequestHandler(ListToolsRequestSchema, async () => ({
         properties: {
           duration: { type: "string", description: "Time range to backfill (e.g., '2h', '30m', '1d'). Auto-detects if omitted." },
           from: { type: "string", description: "ISO timestamp to backfill from. Overrides duration." },
+          dry_run: { type: "boolean", description: "If true, report how many events would be sent without actually sending them." },
         },
       },
     },
@@ -339,6 +351,26 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
     }
   }
 
+  if (name === "polaris_rename_session") {
+    if (!currentProject) {
+      return { content: [{ type: "text", text: "Not connected to a Polaris session. Use polaris_connect first." }] };
+    }
+    const newName = (args as { name: string }).name;
+    try {
+      const res = await daemonPost("/rename-session", { ccSessionId: CC_SESSION_ID, newName });
+      const body = await res.json() as { status?: string; oldName?: string; newName?: string; error?: string };
+      if (res.ok) {
+        const oldName = currentSession;
+        currentSession = newName;
+        await saveSessionState(currentProject, currentSession, currentUser, currentProfile);
+        return { content: [{ type: "text", text: `Renamed session "${oldName}" to "${newName}".` }] };
+      }
+      return { content: [{ type: "text", text: `Failed to rename session: ${body.error ?? "unknown error"}` }] };
+    } catch {
+      return { content: [{ type: "text", text: "Failed to rename session — is the Polaris daemon running?" }] };
+    }
+  }
+
   if (name === "polaris_context") {
     if (!currentProject) {
       return { content: [{ type: "text", text: "Not connected to a Polaris session. Use polaris_connect first." }] };
@@ -397,16 +429,20 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
     if (!currentProject) {
       return { content: [{ type: "text", text: "Not connected to a Polaris session. Use polaris_connect first." }] };
     }
-    const { duration, from } = (args ?? {}) as { duration?: string; from?: string };
+    const { duration, from, dry_run } = (args ?? {}) as { duration?: string; from?: string; dry_run?: boolean };
     try {
       const res = await daemonPost("/backfill", {
         ccSessionId: CC_SESSION_ID,
         ...(duration ? { duration } : {}),
         ...(from ? { from } : {}),
+        ...(dry_run ? { dry_run: true } : {}),
       });
-      const body = await res.json() as { recovered: number; source: string; gaps: string[] };
+      const body = await res.json() as { recovered: number; would_recover?: number; source: string; gaps: string[] };
       if (res.ok) {
         const gapInfo = body.gaps.length > 0 ? `\nGaps: ${body.gaps.join(", ")}` : "";
+        if (dry_run) {
+          return { content: [{ type: "text", text: `Dry run: ${body.would_recover ?? 0} events in daemon log would be sent.${gapInfo}` }] };
+        }
         return { content: [{ type: "text", text: `Backfill complete: ${body.recovered} events recovered from ${body.source}.${gapInfo}` }] };
       }
       return { content: [{ type: "text", text: `Backfill failed: ${(body as unknown as { error?: string }).error ?? "unknown error"}` }] };
@@ -460,6 +496,34 @@ async function main() {
     }
   }
 
+  // Heartbeat: check every 60s whether the daemon still has our session mapped.
+  // If not (dropped WS, daemon restart, compaction), silently re-connect so
+  // activity reaches the channel without a manual /polaris join.
+  setInterval(async () => {
+    if (!currentProject) return; // not connected — nothing to heartbeat
+    try {
+      const res = await daemonGet(`/status/${CC_SESSION_ID}`);
+      const body = await res.json() as { connected?: boolean; project?: string; session?: string };
+      if (body.connected) return; // all good
+      // Daemon lost the mapping — attempt to reconnect to the same session
+      const reconnectRes = await daemonPost("/connect", {
+        ccSessionId: CC_SESSION_ID,
+        project: currentProject,
+        session: currentSession,
+        user: currentUser,
+        profile: currentProfile,
+      });
+      if (reconnectRes.ok) {
+        console.error(`Polaris: session dropped; auto-reconnected to #${currentProject}/${currentSession}`);
+      } else {
+        console.error(`Polaris: session dropped and reconnect failed. Run /polaris to check status.`);
+        currentProject = "";
+        currentSession = "";
+        currentUser = "";
+      }
+    } catch { /* daemon unreachable — will retry next heartbeat */ }
+  }, 60_000);
+
   // inject delivery is handled via the UserPromptSubmit hook (see daemon injectQueues); claude/channel push deferred
 
   const transport = new StdioServerTransport();

package/src/daemon/daemon.ts

@@ -15,6 +15,7 @@ interface SessionMapping {
   slackChannel?: string;
   ws: WebSocket | null;
   pendingMapping?: boolean; // true until the first hook event from this shell claims the mapping
+  closingIntentionally?: boolean; // set before deliberate ws.close() so onclose can distinguish drops
 }
 
 function generateSessionName(): string {
@@ -164,14 +165,18 @@ function connectCloudWs(mapping: SessionMapping) {
   };
 
   ws.onclose = () => {
-    // Reconnect if still registered
-    if (sessions.has(mapping.ccSessionId) && sessions.get(mapping.ccSessionId)!.project === mapping.project) {
+    const m = sessions.get(mapping.ccSessionId);
+    if (m && m.project === mapping.project && mapping.project !== "" && !m.closingIntentionally) {
+      // Unexpected cloud WS drop — log it so the user has a record
+      void logSessionChange("ws-drop", mapping.ccSessionId, mapping.project, mapping.session, mapping.user, mapping.agent);
       setTimeout(() => {
-        if (sessions.has(mapping.ccSessionId)) {
-          connectCloudWs(sessions.get(mapping.ccSessionId)!);
+        const current = sessions.get(mapping.ccSessionId);
+        if (current && current.project) {
+          connectCloudWs(current);
         }
       }, 3000);
     }
+    if (m) m.closingIntentionally = false;
   };
 
   ws.onerror = () => {
@@ -184,6 +189,7 @@ function connectCloudWs(mapping: SessionMapping) {
 function disconnectCloudWs(ccSessionId: string) {
   const mapping = sessions.get(ccSessionId);
   if (mapping?.ws) {
+    mapping.closingIntentionally = true;
     mapping.ws.close();
     mapping.ws = null;
   }
@@ -310,7 +316,7 @@ async function scanOutbox(): Promise<void> {
 
 const SESSION_HISTORY_FILE = join(homedir(), ".polaris", "session-history.jsonl");
 
-async function logSessionChange(action: "connect" | "disconnect", ccSessionId: string, project: string, session: string, user: string, agent: string): Promise<void> {
+async function logSessionChange(action: "connect" | "disconnect" | "ws-drop", ccSessionId: string, project: string, session: string, user: string, agent: string): Promise<void> {
   try {
     await ensureLogDir();
     const entry = JSON.stringify({ t: new Date().toISOString(), action, ccSessionId, project, session, user, agent });
@@ -320,7 +326,7 @@ async function logSessionChange(action: "connect" | "disconnect", ccSessionId: s
 
 // --- Backfill: recover lost events from daemon log ---
 
-async function backfill(mapping: SessionMapping, duration?: string, from?: string): Promise<{ recovered: number; source: string; gaps: string[] }> {
+async function backfill(mapping: SessionMapping, duration?: string, from?: string, dryRun = false): Promise<{ recovered: number; would_recover?: number; source: string; gaps: string[] }> {
   const now = new Date();
   let since: Date;
 
@@ -389,6 +395,11 @@ async function backfill(mapping: SessionMapping, duration?: string, from?: strin
     return { recovered: 0, source: "daemon_log", gaps: [`no log entries found since ${since.toISOString()}`] };
   }
 
+  // Dry-run: report how many events would be sent without actually sending
+  if (dryRun) {
+    return { recovered: 0, would_recover: logEntries.length, source: "daemon_log", gaps: [] };
+  }
+
   // Replay events to the API
   let recovered = 0;
   const serviceUrl = getServiceUrlForProfile(mapping.profile);
@@ -766,6 +777,36 @@ export function startDaemon(port = Number(process.env.POLARIS_DAEMON_PORT ?? 432
         }
       }
 
+      // POST /rename-session — rename the current session (not the project)
+      if (method === "POST" && pathname === "/rename-session") {
+        try {
+          const body = (await req.json()) as { ccSessionId: string; newName: string };
+          if (!body.ccSessionId || !body.newName) return error("ccSessionId and newName required", 400);
+          const mapping = sessions.get(body.ccSessionId);
+          if (!mapping || !mapping.project) return error("Not connected", 400);
+
+          const serviceUrl = getServiceUrlForProfile(mapping.profile);
+          const res = await fetch(
+            `${serviceUrl}/projects/${mapping.project}/sessions/${mapping.session}/rename`,
+            {
+              method: "POST",
+              headers: await authHeadersForProfile(mapping.profile),
+              body: JSON.stringify({ name: body.newName }),
+            }
+          );
+          if (!res.ok) {
+            const err = await res.text();
+            return new Response(err, { status: res.status });
+          }
+
+          const oldName = mapping.session;
+          mapping.session = body.newName;
+          return json({ status: "renamed", oldName, newName: body.newName });
+        } catch {
+          return error("Invalid JSON", 400);
+        }
+      }
+
       // POST /channel-update — bridge pushes channel rename notifications
       if (method === "POST" && pathname === "/channel-update") {
         try {
@@ -929,12 +970,12 @@ export function startDaemon(port = Number(process.env.POLARIS_DAEMON_PORT ?? 432
       // POST /backfill — recover lost events from daemon log
       if (method === "POST" && pathname === "/backfill") {
         try {
-          const body = (await req.json()) as { ccSessionId: string; duration?: string; from?: string };
+          const body = (await req.json()) as { ccSessionId: string; duration?: string; from?: string; dry_run?: boolean };
           if (!body.ccSessionId) return error("ccSessionId required", 400);
           const mapping = sessions.get(body.ccSessionId);
           if (!mapping || !mapping.project) return error("Not connected", 400);
 
-          const result = await backfill(mapping, body.duration, body.from);
+          const result = await backfill(mapping, body.duration, body.from, body.dry_run ?? false);
           return json(result);
         } catch {
           return error("Invalid JSON", 400);

package/src/service/db.ts

@@ -311,6 +311,15 @@ export async function createProject(sql: Sql, orgId: string, name: string): Prom
   return rowToProject(row);
 }
 
+export async function renameSession(sql: Sql, orgId: string, project: string, oldName: string, newName: string): Promise<void> {
+  const result = await sql`
+    UPDATE sessions SET name = ${newName}
+    WHERE org_id = ${orgId} AND name = ${oldName}
+      AND project_id = (SELECT id FROM projects WHERE org_id = ${orgId} AND name = ${project})
+  `;
+  if (result.count === 0) throw new Error(`Session not found: ${project}/${oldName}`);
+}
+
 export async function renameProject(sql: Sql, orgId: string, oldName: string, newName: string): Promise<void> {
   await sql`
     UPDATE projects SET name = ${newName}, slack_channel_name = ${newName}

package/src/service/server.ts

@@ -9,6 +9,7 @@ import {
   listProjects,
   getProject,
   renameProject,
+  renameSession,
   createSession,
   getSession,
   setDriver,
@@ -378,6 +379,18 @@ export async function startServer(opts: {
         return json({ status: "renamed", oldName: params.proj, newName: body.name });
       }
 
+      params = matchRoute(method, pathname, "/projects/:proj/sessions/:sess/rename", "POST");
+      if (params) {
+        const body = await req.json() as { name?: string };
+        if (!body.name) return error("name is required", 400);
+        try {
+          await renameSession(sql, orgId, params.proj, params.sess, body.name);
+        } catch (e) {
+          return error((e as Error).message, 404);
+        }
+        return json({ status: "renamed", oldName: params.sess, newName: body.name });
+      }
+
       // --- Project ACL endpoints (visibility & members) ---
 
       params = matchRoute(method, pathname, "/projects/:proj/visibility", "POST");