@hienlh/ppm 0.9.48 → 0.9.50

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.9.50] - 2026-04-07
+
+### Changed
+- **/sessions redesigned**: Filters by current project, shows pinned sessions first with 📌 icon, displays session titles (not project names), supports pagination via `/sessions 2`. Matches PPM web UI behavior.
+
+## [0.9.49] - 2026-04-07
+
+### Fixed
+- **/resume accepts session ID prefix**: `/resume fdc4ddaa` now works alongside `/resume 2` (index). Matches session by ID prefix from `/sessions` list.
+- **/restart actually restarts**: Server now exits with code 42 (restart signal) instead of 0 (clean exit). Supervisor recognizes code 42 and respawns immediately without backoff.
+- **Restart notification delivered**: Supervisor respawns after `/restart`, new server sends "PPM v0.9.49 restarted successfully." to all paired chats.
+- **/project lists all projects**: `getProjectNames()` now merges config projects + unique project names from session history. Previously returned empty when no projects in config.
+
 ## [0.9.48] - 2026-04-06
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hienlh/ppm",
-  "version": "0.9.48",
+  "version": "0.9.50",
   "description": "Personal Project Manager — mobile-first web IDE with AI assistance",
   "author": "hienlh",
   "license": "MIT",

package/src/services/db.service.ts

@@ -1022,6 +1022,13 @@ export function getRecentPPMBotSessions(
   ).all(telegramChatId, limit) as PPMBotSessionRow[];
 }
 
+export function getDistinctPPMBotProjectNames(): string[] {
+  const rows = getDb().query(
+    "SELECT DISTINCT project_name FROM clawbot_sessions ORDER BY project_name",
+  ).all() as { project_name: string }[];
+  return rows.map((r) => r.project_name);
+}
+
 // ---------------------------------------------------------------------------
 // PPMBot memory helpers
 // ---------------------------------------------------------------------------

package/src/services/ppmbot/ppmbot-service.ts

@@ -5,6 +5,7 @@ import {
   getPairingByChatId,
   createPairingRequest,
   getSessionTitles,
+  getPinnedSessionIds,
   getApprovedPairedChats,
 } from "../db.service.ts";
 import { PPMBotTelegram } from "./ppmbot-telegram.ts";
@@ -159,7 +160,7 @@ class PPMBotService {
         case "start": await this.cmdStart(chatId); break;
         case "project": await this.cmdProject(chatId, cmd.args); break;
         case "new": await this.cmdNew(chatId); break;
-        case "sessions": await this.cmdSessions(chatId); break;
+        case "sessions": await this.cmdSessions(chatId, cmd.args); break;
         case "resume": await this.cmdResume(chatId, cmd.args); break;
         case "status": await this.cmdStatus(chatId); break;
         case "stop": await this.cmdStop(chatId); break;
@@ -254,39 +255,90 @@ class PPMBotService {
     );
   }
 
-  private async cmdSessions(chatId: string): Promise<void> {
-    const sessions = this.sessions.listRecentSessions(chatId, 10);
-    if (sessions.length === 0) {
-      await this.telegram!.sendMessage(Number(chatId), "No recent sessions.");
+  private async cmdSessions(chatId: string, args: string): Promise<void> {
+    const PAGE_SIZE = 8;
+    const page = Math.max(1, parseInt(args, 10) || 1);
+
+    const active = this.sessions.getActiveSession(chatId);
+    const project = active?.projectName;
+
+    // Fetch all sessions for this chat (enough for pagination)
+    const allSessions = this.sessions.listRecentSessions(chatId, 50);
+    // Filter by current project if one is active
+    const filtered = project
+      ? allSessions.filter((s) => s.project_name === project)
+      : allSessions;
+
+    if (filtered.length === 0) {
+      await this.telegram!.sendMessage(Number(chatId), "No sessions yet. Send a message to start.");
       return;
     }
 
-    // Fetch titles for all sessions
-    const titles = getSessionTitles(sessions.map((s) => s.session_id));
+    // Enrich with titles and pin status
+    const titles = getSessionTitles(filtered.map((s) => s.session_id));
+    const pinnedIds = getPinnedSessionIds();
+
+    // Sort: pinned first, then by last_message_at desc
+    const sorted = [...filtered].sort((a, b) => {
+      const aPin = pinnedIds.has(a.session_id) ? 1 : 0;
+      const bPin = pinnedIds.has(b.session_id) ? 1 : 0;
+      if (aPin !== bPin) return bPin - aPin;
+      return b.last_message_at - a.last_message_at;
+    });
+
+    const totalPages = Math.ceil(sorted.length / PAGE_SIZE);
+    const start = (page - 1) * PAGE_SIZE;
+    const pageItems = sorted.slice(start, start + PAGE_SIZE);
+
+    if (pageItems.length === 0) {
+      await this.telegram!.sendMessage(Number(chatId), `No sessions on page ${page}.`);
+      return;
+    }
 
-    let text = "<b>Recent Sessions</b>\n\n";
-    sessions.forEach((s, i) => {
-      const active = s.is_active ? " ⬤" : "";
-      const title = titles[s.session_id]?.replace(/^\[PPM\]\s*/, "") || "";
-      const preview = title ? ` — ${escapeHtml(title.slice(0, 40))}` : "";
+    const header = project ? escapeHtml(project) : "All Projects";
+    let text = `<b>Sessions — ${header}</b>`;
+    if (totalPages > 1) text += ` <i>(${page}/${totalPages})</i>`;
+    text += "\n\n";
+
+    pageItems.forEach((s, i) => {
+      const pin = pinnedIds.has(s.session_id) ? "📌 " : "";
+      const activeDot = s.is_active ? " ⬤" : "";
+      const rawTitle = titles[s.session_id]?.replace(/^\[PPM\]\s*/, "") || "";
+      const title = rawTitle
+        ? escapeHtml(rawTitle.slice(0, 45))
+        : "<i>untitled</i>";
       const date = new Date(s.last_message_at * 1000).toLocaleString(undefined, {
         month: "short", day: "numeric", hour: "2-digit", minute: "2-digit",
       });
       const sid = s.session_id.slice(0, 8);
-      text += `${i + 1}. <b>${escapeHtml(s.project_name)}</b>${preview}${active}\n`;
+      const num = start + i + 1;
+
+      text += `${pin}${num}. ${title}${activeDot}\n`;
       text += `   <code>${sid}</code> · ${date}\n\n`;
     });
-    text += "Resume: /resume &lt;number&gt;";
+
+    text += "Resume: /resume &lt;n&gt; or /resume &lt;id&gt;";
+    if (totalPages > 1 && page < totalPages) {
+      text += `\nNext: /sessions ${page + 1}`;
+    }
+
     await this.telegram!.sendMessage(Number(chatId), text);
   }
 
   private async cmdResume(chatId: string, args: string): Promise<void> {
-    const index = parseInt(args, 10);
-    if (!index || index < 1) {
-      await this.telegram!.sendMessage(Number(chatId), "Usage: /resume &lt;number&gt;");
+    if (!args.trim()) {
+      await this.telegram!.sendMessage(Number(chatId), "Usage: /resume &lt;number or session-id&gt;");
       return;
     }
-    const session = await this.sessions.resumeSessionById(chatId, index);
+
+    // Support both index (e.g. "2") and session ID prefix (e.g. "fdc4ddaa")
+    const index = parseInt(args, 10);
+    const isIndex = !isNaN(index) && index >= 1 && String(index) === args.trim();
+
+    const session = isIndex
+      ? await this.sessions.resumeSessionById(chatId, index)
+      : await this.sessions.resumeSessionByIdPrefix(chatId, args.trim());
+
     if (!session) {
       await this.telegram!.sendMessage(Number(chatId), "Session not found.");
       return;
@@ -368,8 +420,8 @@ class PPMBotService {
       const markerPath = join(homedir(), ".ppm", "restart-notify.json");
       writeFileSync(markerPath, JSON.stringify({ chatIds, ts: Date.now() }));
 
-      console.log("[ppmbot] Restart requested via Telegram, exiting...");
-      process.exit(0);
+      console.log("[ppmbot] Restart requested via Telegram, exiting with code 42...");
+      process.exit(42);
     }, 500);
   }
 
@@ -420,8 +472,8 @@ class PPMBotService {
 /start — Greeting + list projects
 /project &lt;name&gt; — Switch/list projects
 /new — Fresh session (current project)
-/sessions — List recent sessions
-/resume &lt;n&gt; — Resume session #n
+/sessions [page] — List sessions (current project)
+/resume &lt;n or id&gt; — Resume session
 /status — Current project/session info
 /stop — End current session
 /memory — Show project memories

package/src/services/ppmbot/ppmbot-session.ts

@@ -9,6 +9,7 @@ import {
   deactivatePPMBotSession,
   touchPPMBotSession,
   getRecentPPMBotSessions,
+  getDistinctPPMBotProjectNames,
   setSessionTitle,
 } from "../db.service.ts";
 import type { PPMBotActiveSession, PPMBotSessionRow } from "../../types/ppmbot.ts";
@@ -93,6 +94,23 @@ export class PPMBotSessionManager {
     return this.resumeFromDb(chatId, target, project);
   }
 
+  /** Resume a session by session ID prefix match */
+  async resumeSessionByIdPrefix(
+    chatId: string,
+    prefix: string,
+  ): Promise<PPMBotActiveSession | null> {
+    const sessions = getRecentPPMBotSessions(chatId, 20);
+    const target = sessions.find((s) => s.session_id.startsWith(prefix));
+    if (!target) return null;
+
+    await this.closeSession(chatId);
+
+    const project = this.resolveProject(target.project_name);
+    if (!project) return null;
+
+    return this.resumeFromDb(chatId, target, project);
+  }
+
   /**
    * Resolve a project name against configured projects.
    * Case-insensitive, supports prefix matching.
@@ -119,10 +137,12 @@ export class PPMBotSessionManager {
     setSessionTitle(sessionId, title);
   }
 
-  /** Get list of available project names (for /start greeting) */
+  /** Get list of available project names (config + sessions history) */
   getProjectNames(): string[] {
-    const projects = configService.get("projects") as ProjectConfig[];
-    return projects?.map((p) => p.name) ?? [];
+    const configured = (configService.get("projects") as ProjectConfig[])?.map((p) => p.name) ?? [];
+    const fromSessions = getDistinctPPMBotProjectNames();
+    const merged = new Set([...configured, ...fromSessions]);
+    return [...merged].sort();
   }
 
   // ── Private ─────────────────────────────────────────────────────

package/src/services/supervisor.ts

@@ -130,11 +130,17 @@ export async function spawnServer(
   const exitCode = await serverChild.exited;
   serverChild = null;
 
-  if (exitCode === 0 || shuttingDown) {
+  if (exitCode === 0 && shuttingDown) {
     log("INFO", `Server exited cleanly (code ${exitCode})`);
     return;
   }
 
+  // Exit code 42 = restart requested (e.g. /restart from Telegram)
+  if (exitCode === 42 || (exitCode === 0 && !shuttingDown)) {
+    log("INFO", `Server restart requested (code ${exitCode}), respawning immediately`);
+    return spawnServer(serverArgs, logFd);
+  }
+
   // SIGUSR2 restart — skip backoff, respawn immediately
   if (serverRestartRequested) {
     serverRestartRequested = false;