@lightupai/polaris 0.0.25 → 0.0.27

package/package.json

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

package/skills/polaris/SKILL.md

@@ -2,7 +2,7 @@
 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 <project> | rename <new-name> | disconnect | (no args for status)]
+argument-hint: [join #channel | rename <new-name> | disconnect | (no args for status)]
 ---
 
 ## Polaris — Multiplayer Collaboration
@@ -13,12 +13,12 @@ Manage your connection to a Polaris collaboration session.
 
 Based on the arguments provided, do ONE of the following:
 
-**`/polaris join <project>`** — Connect to a session:
-1. Call `polaris_connect` with the given project and user identity `user:manu.bansal`
-2. A session name is auto-generated (e.g., `s-7a3f`)
+**`/polaris join #channel-name`** — Connect to a channel:
+1. Call `polaris_connect` with the given channel and user identity `user:manu.bansal`
+2. A session name is auto-generated
 3. Report the connection status including the session name
 
-**`/polaris rename <new-name>`** — Rename the current project:
+**`/polaris rename <new-name>`** — Rename the current channel:
 1. Call `polaris_rename` with the new name
 2. Report the result
 

package/src/cli/cli.ts

@@ -183,7 +183,7 @@ async function install(participantId?: string) {
 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 <project> | rename <new-name> | disconnect | (no args for status)]
+argument-hint: [join #channel | rename <new-name> | disconnect | (no args for status)]
 ---
 
 ## Polaris — Multiplayer Collaboration
@@ -194,7 +194,7 @@ Manage your connection to a Polaris collaboration session.
 
 Based on the arguments provided, do ONE of the following:
 
-**\`/polaris join <project>\`** — Connect to a session:
+**\`/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
 3. Report the connection status including the session name
@@ -315,7 +315,7 @@ async function login(appUrl: string, profileName?: string) {
 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 <project> | rename <new-name> | disconnect | (no args for status)]
+argument-hint: [join #channel | rename <new-name> | disconnect | (no args for status)]
 ---
 
 ## Polaris — Multiplayer Collaboration
@@ -326,7 +326,7 @@ Manage your connection to a Polaris collaboration session.
 
 Based on the arguments provided, do ONE of the following:
 
-**\`/polaris join <project>\`** — Connect to a session:
+**\`/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
 3. Report the connection status including the session name
@@ -533,7 +533,7 @@ switch (command) {
     }).unref?.();
     console.log("  ✓ Daemon started in background");
 
-    console.log("\nNext: restart Claude Code, then run `/polaris join <project>` in your AI agent.");
+    console.log("\nNext: restart Claude Code, then run `/polaris join #channel-name` in your AI agent.");
     break;
   }
 
@@ -579,7 +579,7 @@ switch (command) {
     }).unref?.();
     console.log("  ✓ Daemon started in background");
 
-    console.log("\nNext: restart Claude Code, then run `/polaris join <project>` in your AI agent.");
+    console.log("\nNext: restart Claude Code, then run `/polaris join #channel-name` in your AI agent.");
     break;
 
   default:

package/src/client/client.ts

@@ -53,12 +53,12 @@ mcp.setRequestHandler(ListToolsRequestSchema, async () => ({
       inputSchema: {
         type: "object" as const,
         properties: {
-          project: { type: "string", description: "Project name" },
+          channel: { type: "string", description: "Channel name (e.g., #polaris-dev or polaris-dev)" },
           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)" },
         },
-        required: ["project", "user"],
+        required: ["channel", "user"],
       },
     },
     {
@@ -117,7 +117,8 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
   const { name, arguments: args } = req.params;
 
   if (name === "polaris_connect") {
-    const { project, user, session, agent } = args as { project: string; user: string; session?: string; agent?: string };
+    const { channel, user, session, agent } = args as { channel: string; user: string; session?: string; agent?: string };
+    const project = channel.replace(/^#/, ""); // strip leading # if present
     try {
       const res = await daemonPost("/connect", {
         ccSessionId: CC_SESSION_ID,
@@ -131,7 +132,7 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
         currentProject = body.project ?? project;
         currentSession = body.session ?? session ?? "";
         currentUser = user;
-        return { content: [{ type: "text", text: `Connected to ${currentProject}/${currentSession} as ${user}.` }] };
+        return { content: [{ type: "text", text: `Connected to #${currentProject}/${currentSession} as ${user}.` }] };
       }
       return { content: [{ type: "text", text: `Failed to connect: ${body.error ?? "unknown error"}` }] };
     } catch {

package/src/daemon/daemon.ts

@@ -13,6 +13,7 @@ interface SessionMapping {
   agent: string;
   slackChannel?: string;
   ws: WebSocket | null;
+  pendingMapping?: boolean; // true until a hook event maps the real CC session ID
 }
 
 function generateSessionName(): string {
@@ -232,6 +233,7 @@ export function startDaemon(port = Number(process.env.POLARIS_DAEMON_PORT ?? 432
             user: body.user,
             agent: agentId,
             ws: null,
+            pendingMapping: true, // waiting for hook event to map the real CC session ID
           };
           sessions.set(body.ccSessionId, mapping);
 
@@ -347,18 +349,24 @@ export function startDaemon(port = Number(process.env.POLARIS_DAEMON_PORT ?? 432
           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.
-            // Try to find the MCP session that this CC session belongs to.
-            // Heuristic: if only one connected session exists, route to it.
-            // Otherwise, drop the event — the user needs to /polaris join first.
-            const connectedSessions = Array.from(sessions.values()).filter((m) => m.project);
-            if (connectedSessions.length === 1) {
-              mapping = connectedSessions[0];
-              // Remember this mapping for future events from this CC session
+            // Match to a 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
+              mapping = pending[pending.length - 1];
+              mapping.pendingMapping = false;
+              // Register under the real CC session ID for future events
               sessions.set(ccSessionId, { ...mapping, ccSessionId });
+              console.error(`[daemon] Mapped CC session ${ccSessionId.slice(0, 8)} → ${mapping.project}/${mapping.session}`);
             } else {
-              // Multiple or zero sessions — can't determine which one.
-              // Drop silently; events will flow once /polaris join maps the session.
-              return json({ status: connectedSessions.length > 0 ? "ambiguous" : "not_connected" });
+              // No pending sessions — try single-session fallback
+              const connectedSessions = Array.from(sessions.values()).filter((m) => m.project);
+              if (connectedSessions.length === 1) {
+                mapping = connectedSessions[0];
+                sessions.set(ccSessionId, { ...mapping, ccSessionId });
+              } else {
+                return json({ status: connectedSessions.length > 0 ? "ambiguous" : "not_connected" });
+              }
             }
           }
 

package/src/web/views.ts

@@ -208,7 +208,7 @@ function renderProjectsSessionsSection(ctx: ViewContext, sessions: SessionFixtur
           <summary class="text-xs text-polaris-700 hover:text-polaris-800 font-medium cursor-pointer select-none">+ Join another session</summary>
           <div class="mt-2 bg-white border border-gray-200 rounded-lg p-4">
             <p class="text-sm text-gray-500">Inside your AI agent, run:</p>
-            ${copyBlock("/polaris join &lt;project&gt;")}
+            ${copyBlock("/polaris join #channel-name")}
           </div>
         </details>
         <div class="space-y-4">
@@ -231,7 +231,7 @@ function renderProjectsSessionsSection(ctx: ViewContext, sessions: SessionFixtur
           : "Inside your AI agent (Claude Code, Cursor, etc.), run:"}</p>
         ${ctx.hasConnectedSession
           ? ""
-          : copyBlock("/polaris join my-project")}
+          : copyBlock("/polaris join #my-channel")}
       </div>
     </div>`);
 }

package/tests/web.test.ts

@@ -38,7 +38,7 @@ describe("renderSetupView", () => {
     // Install CLI command is present
     expect(html).toContain("npx @lightupai/polaris");
     // Connect session command is present
-    expect(html).toContain("/polaris join my-project");
+    expect(html).toContain("/polaris join #my-channel");
   });
 
   test("slack done: floor shows connected, devices is highlighted, sessions grayed", () => {
@@ -66,7 +66,7 @@ describe("renderSetupView", () => {
     const lastHighlight = html.lastIndexOf("border-polaris-300");
     expect(lastHighlight).toBeGreaterThan(sessIdx);
     // Connect session command present
-    expect(html).toContain("/polaris join my-project");
+    expect(html).toContain("/polaris join #my-channel");
   });
 
   test("includes nav with user info", () => {