@bakapiano/ccsm 0.5.0 → 0.6.0

package/lib/config.js

@@ -22,6 +22,7 @@ const DEFAULTS = {
   terminal: 'wt',
   commandShell: 'pwsh',
   autoFocusOnLaunch: true,
+  focusMovesToCenter: false,
   // 'app'  — Edge/Chrome --app=<url> chromeless window (looks like a desktop app)
   // 'tab'  — open in default browser as a normal tab
   // 'none' — don't open anything

package/lib/focus.js

@@ -32,6 +32,7 @@ using System;
 using System.Collections.Generic;
 using System.Runtime.InteropServices;
 using System.Text;
+using System.Threading;
 public class CcsmWin {
     [DllImport("user32.dll")] public static extern bool SetForegroundWindow(IntPtr h);
     [DllImport("user32.dll")] public static extern void SwitchToThisWindow(IntPtr h, bool t);
@@ -46,8 +47,27 @@ public class CcsmWin {
     [DllImport("user32.dll")] public static extern bool EnumWindows(EnumWindowsProc cb, IntPtr p);
     [DllImport("user32.dll", CharSet=CharSet.Auto)] public static extern int GetWindowText(IntPtr h, StringBuilder s, int max);
     [DllImport("user32.dll")] public static extern int GetWindowTextLength(IntPtr h);
+    [DllImport("user32.dll")] public static extern bool GetWindowRect(IntPtr h, out RECT rect);
+    [DllImport("user32.dll")] public static extern bool SetWindowPos(IntPtr h, IntPtr after, int x, int y, int cx, int cy, uint flags);
+    [DllImport("user32.dll")] public static extern bool GetCursorPos(out POINT lpPoint);
+    [DllImport("user32.dll")] public static extern IntPtr MonitorFromPoint(POINT pt, uint dwFlags);
+    [DllImport("user32.dll")] public static extern bool GetMonitorInfo(IntPtr hMonitor, ref MONITORINFO mi);
+    [DllImport("user32.dll")] public static extern bool MoveWindow(IntPtr h, int x, int y, int w, int hgt, bool repaint);
     public delegate bool EnumWindowsProc(IntPtr h, IntPtr p);
 
+    [StructLayout(LayoutKind.Sequential)]
+    public struct RECT { public int Left, Top, Right, Bottom; }
+    [StructLayout(LayoutKind.Sequential)]
+    public struct POINT { public int X, Y; }
+    [StructLayout(LayoutKind.Sequential)]
+    public struct MONITORINFO {
+        public uint cbSize;
+        public RECT rcMonitor;
+        public RECT rcWork;
+        public uint dwFlags;
+    }
+    const uint MONITOR_DEFAULTTONEAREST = 0x00000002;
+
     public static List<object> EnumVisibleTopLevel() {
         var results = new List<object>();
         EnumWindows((h, l) => {
@@ -64,7 +84,54 @@ public class CcsmWin {
         return results;
     }
 
-    public static bool Activate(IntPtr h) {
+    // SWP flags
+    const uint SWP_NOSIZE = 0x0001;
+    const uint SWP_NOZORDER = 0x0004;
+    const uint SWP_NOACTIVATE = 0x0010;
+    const uint SWP_ASYNCWINDOWPOS = 0x4000;
+    const uint SWP_FLAGS = SWP_NOSIZE | SWP_NOZORDER | SWP_NOACTIVATE | SWP_ASYNCWINDOWPOS;
+
+    // Horizontal shake — small left/right offsets so the user's eye snaps
+    // to the activated window. ~220ms total.
+    public static void Jiggle(IntPtr h) {
+        RECT rc;
+        if (!GetWindowRect(h, out rc)) return;
+        int x = rc.Left;
+        int y = rc.Top;
+        int[] dx = new int[] { 8, -8, 6, -6, 0 };
+        foreach (int d in dx) {
+            SetWindowPos(h, IntPtr.Zero, x + d, y, 0, 0, SWP_FLAGS);
+            Thread.Sleep(38);
+        }
+    }
+
+    // Move the window to the center of whichever monitor the cursor is on.
+    // Preserves window size. Returns true if it moved.
+    public static bool MoveToCursorScreenCenter(IntPtr h) {
+        RECT wr;
+        if (!GetWindowRect(h, out wr)) return false;
+        int ww = wr.Right - wr.Left;
+        int wh = wr.Bottom - wr.Top;
+
+        POINT cursor;
+        if (!GetCursorPos(out cursor)) return false;
+        IntPtr hMon = MonitorFromPoint(cursor, MONITOR_DEFAULTTONEAREST);
+        if (hMon == IntPtr.Zero) return false;
+
+        MONITORINFO mi = new MONITORINFO();
+        mi.cbSize = (uint)Marshal.SizeOf(typeof(MONITORINFO));
+        if (!GetMonitorInfo(hMon, ref mi)) return false;
+
+        // Use the work area (excludes taskbar) so a centered window isn't
+        // pushed under the taskbar.
+        int sw = mi.rcWork.Right - mi.rcWork.Left;
+        int sh = mi.rcWork.Bottom - mi.rcWork.Top;
+        int nx = mi.rcWork.Left + (sw - ww) / 2;
+        int ny = mi.rcWork.Top + (sh - wh) / 2;
+        return MoveWindow(h, nx, ny, ww, wh, true);
+    }
+
+    public static bool Activate(IntPtr h, bool moveToCenter) {
         if (IsIconic(h)) ShowWindowAsync(h, 9);
         keybd_event(0x12, 0, 0, UIntPtr.Zero);
         keybd_event(0x12, 0, 0x0002, UIntPtr.Zero);
@@ -77,6 +144,8 @@ public class CcsmWin {
         bool ok = SetForegroundWindow(h);
         SwitchToThisWindow(h, true);
         if (attached) AttachThreadInput(c, t, false);
+        if (moveToCenter) MoveToCursorScreenCenter(h);
+        Jiggle(h);
         return ok;
     }
 }
@@ -84,6 +153,7 @@ public class CcsmWin {
 
 $mode = $env:CCSM_FOCUS_MODE
 $arg  = $env:CCSM_FOCUS_ARG
+$moveToCenter = $env:CCSM_FOCUS_CENTER -eq '1'
 
 if ($mode -eq 'list') {
     $procName = $arg -replace '\.exe$',''
@@ -109,7 +179,7 @@ if ($mode -eq 'list') {
 if ($mode -eq 'focus-hwnd') {
     $hwndInt = [int64]$arg
     $hwnd = [IntPtr]::new($hwndInt)
-    $ok = [CcsmWin]::Activate($hwnd)
+    $ok = [CcsmWin]::Activate($hwnd, $moveToCenter)
     Write-Output (ConvertTo-Json @{ ok = $true; activated = $ok; hwnd = $hwndInt } -Compress)
     exit 0
 }
@@ -132,7 +202,7 @@ if ($mode -eq 'focus-pid') {
         Write-Output (ConvertTo-Json @{ ok = $false; error = "no window handle found for pid $arg"; chain = $chain } -Compress -Depth 5)
         exit 1
     }
-    $activated = [CcsmWin]::Activate($hwnd)
+    $activated = [CcsmWin]::Activate($hwnd, $moveToCenter)
     Write-Output (ConvertTo-Json @{
         ok = $true; activated = $activated
         hwnd = $hwnd.ToInt64()
@@ -148,7 +218,7 @@ Write-Output (ConvertTo-Json @{ ok = $false; error = "unknown CCSM_FOCUS_MODE: $
 exit 1
 `;
 
-function runPsHelper(mode, arg) {
+function runPsHelper(mode, arg, opts = {}) {
   return new Promise((resolve, reject) => {
     const encoded = Buffer.from(FOCUS_HELPER_PS, 'utf16le').toString('base64');
     const child = spawn(
@@ -156,7 +226,12 @@ function runPsHelper(mode, arg) {
       ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-EncodedCommand', encoded],
       {
         windowsHide: true,
-        env: { ...process.env, CCSM_FOCUS_MODE: mode, CCSM_FOCUS_ARG: String(arg) },
+        env: {
+          ...process.env,
+          CCSM_FOCUS_MODE: mode,
+          CCSM_FOCUS_ARG: String(arg),
+          CCSM_FOCUS_CENTER: opts.moveToCenter ? '1' : '0',
+        },
       }
     );
     let out = '';
@@ -186,10 +261,10 @@ function runPsHelper(mode, arg) {
 
 // ---- public API ----
 
-async function focusByPid(pid) {
+async function focusByPid(pid, opts = {}) {
   const n = Number(pid);
   if (!Number.isInteger(n) || n <= 0) throw new Error(`focusByPid: invalid pid ${pid}`);
-  return await runPsHelper('focus-pid', n);
+  return await runPsHelper('focus-pid', n, opts);
 }
 
 // Strip the leading wt status glyph + whitespace ("✳ ", "⠐ ", "⠠ " etc) so
@@ -205,9 +280,10 @@ function cleanWtTitle(t) {
 // window regardless of which tab the session is actually in. Instead we
 // list all wt windows and match by tab title against the session's AI
 // title / cwd basename.
-async function focusBySession({ pid, sessionId, title, cwd }) {
+async function focusBySession({ pid, sessionId, title, cwd, moveToCenter = false }) {
   const procName = 'WindowsTerminal.exe';
   const cands = await listWindowsOf(procName);
+  const opts = { moveToCenter };
 
   const cleanedTitle = title ? cleanWtTitle(title) : '';
   const cwdBase = cwd ? require('node:path').basename(cwd) : '';
@@ -216,7 +292,7 @@ async function focusBySession({ pid, sessionId, title, cwd }) {
   if (cleanedTitle) {
     const exact = cands.filter((w) => cleanWtTitle(w.title) === cleanedTitle);
     if (exact.length === 1) {
-      const r = await focusByHwnd(exact[0].hwnd);
+      const r = await focusByHwnd(exact[0].hwnd, opts);
       return { ...r, matchedBy: 'title-exact', hwnd: exact[0].hwnd, windowTitle: exact[0].title };
     }
   }
@@ -225,7 +301,7 @@ async function focusBySession({ pid, sessionId, title, cwd }) {
   if (cleanedTitle) {
     const subs = cands.filter((w) => w.title.includes(cleanedTitle));
     if (subs.length === 1) {
-      const r = await focusByHwnd(subs[0].hwnd);
+      const r = await focusByHwnd(subs[0].hwnd, opts);
       return { ...r, matchedBy: 'title-substring', hwnd: subs[0].hwnd, windowTitle: subs[0].title };
     }
   }
@@ -234,7 +310,7 @@ async function focusBySession({ pid, sessionId, title, cwd }) {
   if (cwdBase) {
     const byCwd = cands.filter((w) => w.title.includes(cwdBase));
     if (byCwd.length === 1) {
-      const r = await focusByHwnd(byCwd[0].hwnd);
+      const r = await focusByHwnd(byCwd[0].hwnd, opts);
       return { ...r, matchedBy: 'cwd-basename', hwnd: byCwd[0].hwnd, windowTitle: byCwd[0].title };
     }
   }
@@ -243,14 +319,14 @@ async function focusBySession({ pid, sessionId, title, cwd }) {
   //    canonical MainWindowHandle — may be the wrong window when wt is
   //    multi-window single-process, but better than nothing).
   if (pid) {
-    const r = await focusByPid(pid);
+    const r = await focusByPid(pid, opts);
     return { ...r, matchedBy: 'pid-fallback', ambiguous: true };
   }
   return { ok: false, error: 'no match by title/cwd and no pid given', matchedBy: 'none' };
 }
 
-async function focusByHwnd(hwnd) {
-  return await runPsHelper('focus-hwnd', hwnd);
+async function focusByHwnd(hwnd, opts = {}) {
+  return await runPsHelper('focus-hwnd', hwnd, opts);
 }
 
 async function listWindowsOf(processName) {

package/lib/labels.js

@@ -0,0 +1,49 @@
+'use strict';
+
+// User-defined display titles for sessions. Stored as a flat JSON object
+// keyed by sessionId at $DATA_DIR/labels.json. Frontend overlays the label
+// on top of the AI-generated title when rendering live / recent / favorites.
+
+const fs = require('node:fs/promises');
+const path = require('node:path');
+const { DATA_DIR } = require('./config');
+
+const LABELS_PATH = path.join(DATA_DIR, 'labels.json');
+const MAX_LEN = 200;
+
+async function loadLabels() {
+  try {
+    const raw = await fs.readFile(LABELS_PATH, 'utf8');
+    const obj = JSON.parse(raw);
+    return obj && typeof obj === 'object' && !Array.isArray(obj) ? obj : {};
+  } catch (e) {
+    if (e.code === 'ENOENT') return {};
+    throw e;
+  }
+}
+
+async function saveLabels(labels) {
+  await fs.writeFile(LABELS_PATH, JSON.stringify(labels, null, 2));
+}
+
+async function setLabel(sessionId, label) {
+  if (!sessionId) throw new Error('setLabel: sessionId required');
+  const trimmed = String(label || '').trim().slice(0, MAX_LEN);
+  if (!trimmed) {
+    return removeLabel(sessionId);
+  }
+  const labels = await loadLabels();
+  labels[sessionId] = trimmed;
+  await saveLabels(labels);
+  return trimmed;
+}
+
+async function removeLabel(sessionId) {
+  const labels = await loadLabels();
+  if (!(sessionId in labels)) return false;
+  delete labels[sessionId];
+  await saveLabels(labels);
+  return true;
+}
+
+module.exports = { loadLabels, saveLabels, setLabel, removeLabel, LABELS_PATH };

package/lib/workspace.js

@@ -191,10 +191,14 @@ async function cloneRepoInto({ workspacePath, repo, onProgress, onLine }) {
       `Target ${target} exists but is not a git clone — refusing to overwrite`
     );
   }
-  await runGit(['clone', '--progress', repo.url, repo.name], workspacePath, {
-    onProgress,
-    onLine,
-  });
+  // -c core.longpaths=true defeats Windows' default 260-char MAX_PATH so deep
+  // repo trees (e.g. nested doc / .github skill paths) can check out
+  // successfully. The flag only applies to this single git invocation.
+  await runGit(
+    ['-c', 'core.longpaths=true', 'clone', '--progress', repo.url, repo.name],
+    workspacePath,
+    { onProgress, onLine }
+  );
   return { repo: repo.name, action: 'cloned', path: target };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bakapiano/ccsm",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Claude Code Session Manager — Windows web UI to manage many concurrent claude sessions: live list, snapshot/restore, focus existing window, new session in an isolated workspace with repo clones",
   "license": "MIT",
   "main": "server.js",