@lightupai/polaris 0.0.102 → 0.0.104

package/Makefile

@@ -18,7 +18,7 @@ dev: dev-up css api web daemon bridge
 
 # Postgres
 dev-up:
-	docker compose up -d
+	docker compose up -d --wait
 
 dev-down:
 	docker compose down

package/docker-compose.yml

@@ -9,6 +9,11 @@ services:
       - "5432:5432"
     volumes:
       - polaris-pgdata:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U polaris -d polaris"]
+      interval: 5s
+      timeout: 5s
+      retries: 10
 
 volumes:
   polaris-pgdata:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightupai/polaris",
-  "version": "0.0.102",
+  "version": "0.0.104",
   "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.",
@@ -340,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." }] };

package/src/daemon/daemon.ts

@@ -777,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 {

package/src/service/db.ts

@@ -34,8 +34,39 @@ export interface ProjectMember {
 // --- Schema ---
 
 export async function createDb(connectionString?: string): Promise<Sql> {
-  const sql = postgres(connectionString ?? process.env.DATABASE_URL ?? "postgres://polaris:polaris@localhost:5432/polaris");
-  await ensureSchema(sql);
+  const connStr = connectionString ?? process.env.DATABASE_URL ?? "postgres://polaris:polaris@localhost:5432/polaris";
+  const sql = postgres(connStr);
+  // Retry on transient startup errors (ECONNREFUSED, "starting up" 57P03).
+  // Fail fast on auth/role/database errors — retrying won't help.
+  const TRANSIENT_CODES = new Set(["57P03", "ECONNREFUSED"]);
+  const FATAL_CODES = new Set(["28000", "28P01", "3D000"]);
+  const MAX_ATTEMPTS = 10;
+  const RETRY_DELAY_MS = 1000;
+  for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
+    try {
+      await ensureSchema(sql);
+      return sql;
+    } catch (err: unknown) {
+      const code = (err as { code?: string }).code ?? "";
+      if (FATAL_CODES.has(code)) {
+        throw new Error(
+          `Database connection failed (${code}): ${(err as Error).message}\n` +
+          `Hint: the role/password/database may not exist. ` +
+          `Try: docker compose down -v && docker compose up -d --wait`
+        );
+      }
+      if (!TRANSIENT_CODES.has(code) && attempt === MAX_ATTEMPTS) {
+        throw err;
+      }
+      if (attempt < MAX_ATTEMPTS) {
+        console.error(`[db] connection attempt ${attempt}/${MAX_ATTEMPTS} failed (${code}), retrying in ${RETRY_DELAY_MS}ms...`);
+        await new Promise((r) => setTimeout(r, RETRY_DELAY_MS));
+      } else {
+        throw err;
+      }
+    }
+  }
+  // unreachable
   return sql;
 }
 
@@ -311,6 +342,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");