@jacques-ai/server 0.0.7-alpha.1

package/dist/mcp/search-tool.js

@@ -0,0 +1,176 @@
+/**
+ * MCP Search Tool
+ *
+ * Implements the search_conversations tool for the MCP server.
+ */
+import { z } from "zod";
+import { promises as fs } from "fs";
+import * as path from "path";
+import { homedir } from "os";
+// ============================================================
+// Tool Schema
+// ============================================================
+export const searchConversationsSchema = z.object({
+    query: z.string().describe("Keywords to search for in archived conversations"),
+    project: z.string().optional().describe("Filter by project slug (e.g., 'my-project')"),
+    dateFrom: z.string().optional().describe("Filter conversations from this date (ISO format: YYYY-MM-DD)"),
+    dateTo: z.string().optional().describe("Filter conversations up to this date (ISO format: YYYY-MM-DD)"),
+    technologies: z.array(z.string()).optional().describe("Filter by technologies (e.g., ['react', 'typescript'])"),
+    limit: z.number().min(1).max(50).default(10).describe("Maximum number of results (default: 10, max: 50)"),
+    offset: z.number().min(0).default(0).describe("Pagination offset (default: 0)"),
+});
+// ============================================================
+// Constants
+// ============================================================
+const GLOBAL_ARCHIVE_PATH = path.join(homedir(), ".jacques", "archive");
+const STOP_WORDS = new Set([
+    "a", "an", "and", "are", "as", "at", "be", "been", "by", "for", "from",
+    "has", "he", "in", "is", "it", "its", "of", "on", "that", "the", "to",
+    "was", "will", "with", "this", "but", "they", "have", "had", "what",
+    "when", "where", "who", "which", "why", "how", "all", "would", "there",
+    "their", "or", "if", "can", "may", "could", "should", "might", "must",
+    "do", "does", "did", "done", "doing", "i", "you", "we", "them", "your",
+    "our", "my", "not", "just", "about", "here", "first", "create", "make",
+    "let", "me", "see", "also", "so", "then", "now", "new", "get", "use",
+    "want", "need", "please", "thanks", "help", "like", "know", "think", "look",
+]);
+// ============================================================
+// Helper Functions
+// ============================================================
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .split(/\W+/)
+        .filter((w) => w.length >= 2 && w.length <= 50)
+        .filter((w) => !STOP_WORDS.has(w))
+        .filter((w) => !/^\d+$/.test(w));
+}
+async function readIndex() {
+    try {
+        const indexPath = path.join(GLOBAL_ARCHIVE_PATH, "index.json");
+        const content = await fs.readFile(indexPath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return {
+            version: "1.0.0",
+            lastUpdated: new Date().toISOString(),
+            keywords: {},
+            projects: {},
+            metadata: { totalConversations: 0, totalKeywords: 0 },
+        };
+    }
+}
+async function readManifest(id) {
+    try {
+        const manifestPath = path.join(GLOBAL_ARCHIVE_PATH, "manifests", `${id}.json`);
+        const content = await fs.readFile(manifestPath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+function searchIndexKeywords(index, query) {
+    const queryKeywords = tokenize(query);
+    if (queryKeywords.length === 0) {
+        return [];
+    }
+    const scores = new Map();
+    for (const keyword of queryKeywords) {
+        const refs = index.keywords[keyword];
+        if (!refs)
+            continue;
+        for (const ref of refs) {
+            const currentScore = scores.get(ref.id) || 0;
+            scores.set(ref.id, currentScore + ref.score);
+        }
+    }
+    const results = [];
+    for (const [id, score] of scores) {
+        results.push({ id, score });
+    }
+    return results.sort((a, b) => b.score - a.score);
+}
+// ============================================================
+// Main Search Function
+// ============================================================
+export async function searchConversations(input) {
+    const index = await readIndex();
+    // Get initial results from index
+    const indexResults = searchIndexKeywords(index, input.query);
+    // Load manifests and apply filters
+    const filteredResults = [];
+    for (const { id, score } of indexResults) {
+        const manifest = await readManifest(id);
+        if (!manifest)
+            continue;
+        // Apply filters (support both projectId and projectSlug for backward compat)
+        if (input.project && manifest.projectId !== input.project && manifest.projectSlug !== input.project) {
+            continue;
+        }
+        if (input.dateFrom && manifest.endedAt < input.dateFrom) {
+            continue;
+        }
+        if (input.dateTo && manifest.endedAt > input.dateTo) {
+            continue;
+        }
+        if (input.technologies && input.technologies.length > 0) {
+            const hasTech = input.technologies.some((t) => manifest.technologies.includes(t.toLowerCase()));
+            if (!hasTech)
+                continue;
+        }
+        filteredResults.push({ manifest, score });
+    }
+    // Apply pagination
+    const limit = Math.min(input.limit || 10, 50);
+    const offset = input.offset || 0;
+    const totalMatches = filteredResults.length;
+    const paginatedResults = filteredResults.slice(offset, offset + limit);
+    // Transform to SearchResult format
+    const results = paginatedResults.map(({ manifest, score }, idx) => ({
+        rank: offset + idx + 1,
+        id: manifest.id,
+        score,
+        title: manifest.title,
+        project: manifest.projectSlug,
+        date: manifest.endedAt.split("T")[0],
+        preview: manifest.userQuestions[0] || "",
+        filesModified: manifest.filesModified.slice(0, 5),
+        technologies: manifest.technologies,
+        messageCount: manifest.messageCount,
+        durationMinutes: manifest.durationMinutes,
+    }));
+    return {
+        query: input.query,
+        filters: {
+            project: input.project,
+            dateFrom: input.dateFrom,
+            dateTo: input.dateTo,
+            technologies: input.technologies,
+        },
+        totalMatches,
+        showing: {
+            from: totalMatches > 0 ? offset + 1 : 0,
+            to: Math.min(offset + limit, totalMatches),
+        },
+        hasMore: offset + limit < totalMatches,
+        results,
+    };
+}
+// ============================================================
+// Tool Handler
+// ============================================================
+export async function handleSearchConversations(args) {
+    // Parse and validate input
+    const parsed = searchConversationsSchema.safeParse(args);
+    if (!parsed.success) {
+        return JSON.stringify({
+            error: "Invalid input",
+            details: parsed.error.issues,
+        });
+    }
+    const result = await searchConversations(parsed.data);
+    return JSON.stringify(result, null, 2);
+}
+//# sourceMappingURL=search-tool.js.map

package/dist/mcp/search-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-tool.js","sourceRoot":"","sources":["../../src/mcp/search-tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * Jacques MCP Server
+ *
+ * Provides cross-project search over archived Claude Code conversations.
+ * Communicates via stdio using the Model Context Protocol.
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}

package/dist/mcp/server.js

@@ -0,0 +1,152 @@
+#!/usr/bin/env node
+/**
+ * Jacques MCP Server
+ *
+ * Provides cross-project search over archived Claude Code conversations.
+ * Communicates via stdio using the Model Context Protocol.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { searchConversationsSchema, handleSearchConversations, } from "./search-tool.js";
+// ============================================================
+// Server Setup
+// ============================================================
+const server = new McpServer({
+    name: "jacques-archive",
+    version: "0.1.0",
+});
+// ============================================================
+// Tool Registration
+// ============================================================
+server.tool("search_conversations", "Search across all archived Claude Code conversations. Returns matching sessions with metadata including title, project, date, modified files, and technologies. Claude Code provides semantic analysis on the search results.", searchConversationsSchema.shape, async (args) => {
+    const result = await handleSearchConversations(args);
+    return {
+        content: [
+            {
+                type: "text",
+                text: result,
+            },
+        ],
+    };
+});
+// ============================================================
+// Resource Registration
+// ============================================================
+server.resource("archive-stats", "jacques://archive/stats", async () => {
+    const { promises: fs } = await import("fs");
+    const { homedir } = await import("os");
+    const path = await import("path");
+    const archivePath = path.join(homedir(), ".jacques", "archive");
+    const indexPath = path.join(archivePath, "index.json");
+    try {
+        const content = await fs.readFile(indexPath, "utf-8");
+        const index = JSON.parse(content);
+        return {
+            contents: [
+                {
+                    uri: "jacques://archive/stats",
+                    mimeType: "application/json",
+                    text: JSON.stringify({
+                        totalConversations: index.metadata.totalConversations,
+                        totalKeywords: index.metadata.totalKeywords,
+                        totalProjects: Object.keys(index.projects).length,
+                        projects: Object.entries(index.projects).map(([slug, info]) => ({
+                            slug,
+                            conversationCount: info.conversationCount,
+                            lastActivity: info.lastActivity,
+                        })),
+                        lastUpdated: index.lastUpdated,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch {
+        return {
+            contents: [
+                {
+                    uri: "jacques://archive/stats",
+                    mimeType: "application/json",
+                    text: JSON.stringify({
+                        totalConversations: 0,
+                        totalKeywords: 0,
+                        totalProjects: 0,
+                        projects: [],
+                        lastUpdated: null,
+                        note: "Archive not initialized. Save a conversation using Jacques dashboard first.",
+                    }),
+                },
+            ],
+        };
+    }
+});
+// ============================================================
+// Prompt Registration
+// ============================================================
+server.prompt("search-guide", "Guide for searching conversation archives effectively", () => {
+    return {
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `# Jacques Archive Search Guide
+
+## How to Search
+
+Use the \`search_conversations\` tool to find past Claude Code conversations across all projects.
+
+## Search Tips
+
+1. **Keywords**: Search for specific topics, technologies, or concepts
+   - "authentication JWT" finds sessions about JWT auth
+   - "react hooks" finds sessions about React hooks
+
+2. **Filter by Project**: Use the \`project\` parameter to limit to a specific project
+   - project: "my-app"
+
+3. **Filter by Date**: Use \`dateFrom\` and \`dateTo\` for time ranges
+   - dateFrom: "2026-01-01"
+   - dateTo: "2026-01-31"
+
+4. **Filter by Technology**: Use \`technologies\` array
+   - technologies: ["typescript", "react"]
+
+## Example Searches
+
+- "database migration prisma" - Find sessions about Prisma migrations
+- "bug fix authentication" - Find sessions where auth bugs were fixed
+- "refactor component" - Find refactoring sessions
+
+## Understanding Results
+
+Each result includes:
+- **title**: Claude's summary of the session
+- **project**: Which project the session was in
+- **date**: When the session ended
+- **preview**: First user question
+- **filesModified**: Key files that were changed
+- **technologies**: Detected tech stack
+- **messageCount**: Conversation length
+- **durationMinutes**: Session duration
+
+Use these results to find relevant context for your current work!`,
+                },
+            },
+        ],
+    };
+});
+// ============================================================
+// Start Server
+// ============================================================
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr so it doesn't interfere with stdio protocol
+    console.error("Jacques MCP server started");
+}
+main().catch((error) => {
+    console.error("Failed to start MCP server:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}

package/dist/process-scanner.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Process Scanner
+ *
+ * Cross-platform scanner for detecting running Claude Code sessions.
+ * Supports macOS, Linux, and Windows.
+ *
+ * ## How It Works
+ *
+ * 1. Enumerate all running Claude processes with their PIDs and TTYs
+ * 2. Get working directory (CWD) for each process
+ * 3. Map CWD to Claude's project directory (~/.claude/projects/{encoded-path})
+ * 4. Find ALL active JSONL files in that directory (not just most recent)
+ * 5. Parse each for sessionId, gitBranch, context metrics
+ * 6. Return all detected sessions
+ *
+ * ## Platform Support
+ *
+ * - macOS/Linux: Uses pgrep, ps, lsof
+ * - Windows: Uses PowerShell (Get-Process, Get-WmiObject)
+ *
+ * ## Multi-Session Detection
+ *
+ * Multiple Claude processes can run in the same directory. We detect all of them by:
+ * - Finding all JSONL files modified within ACTIVE_SESSION_THRESHOLD_MS
+ * - Using TTY to create unique terminal keys for each process
+ * - Matching processes to sessions by recency when exact match isn't possible
+ */
+import type { ContextMetrics, SessionMode } from "./types.js";
+export type { DetectedProcess } from "./connection/process-detection.js";
+/**
+ * A session detected from a running Claude process
+ */
+export interface DetectedSession {
+    /** Session ID from the JSONL file */
+    sessionId: string;
+    /** Working directory of the Claude process */
+    cwd: string;
+    /** Path to the session transcript JSONL file */
+    transcriptPath: string;
+    /** Git branch if detected */
+    gitBranch: string | null;
+    /** Git worktree name (basename of worktree dir, only set for worktrees) */
+    gitWorktree: string | null;
+    /** Canonical git repo root path (main worktree root, shared across all worktrees) */
+    gitRepoRoot: string | null;
+    /** Context metrics from parsing the transcript */
+    contextMetrics: ContextMetrics | null;
+    /** Last modification time of the transcript */
+    lastActivity: number;
+    /** Session title extracted from transcript */
+    title: string | null;
+    /** Process ID */
+    pid: number;
+    /** TTY of the process */
+    tty: string;
+    /** Project name derived from CWD */
+    project: string;
+    /** Terminal type (iTerm2, Windows Terminal, etc.) */
+    terminalType?: string;
+    /** Terminal session ID for unique identification */
+    terminalSessionId?: string;
+    /** Session mode: planning if EnterPlanMode was called, execution if started with plan trigger */
+    mode?: SessionMode;
+    /** Whether the process was launched with --dangerously-skip-permissions */
+    isBypass?: boolean;
+}
+/**
+ * Scan for active Claude Code sessions
+ *
+ * Detects running Claude processes, matches them to session files,
+ * and extracts metadata for registration.
+ *
+ * ## Catalog-First Strategy
+ *
+ * Uses Jacques session index (from @jacques-ai/core/cache) for pre-extracted metadata:
+ * - Session titles (from summary or first user message)
+ * - Git info (branch, worktree, repo root)
+ * - Token usage stats
+ *
+ * Falls back to JSONL parsing only for sessions not in the catalog.
+ *
+ * ## Multi-Session Support
+ *
+ * When multiple Claude processes run in the same directory:
+ * - Finds ALL recently modified JSONL files (within 1 minute)
+ * - Creates unique terminal keys using TTY + PID
+ * - Returns one DetectedSession per active session file
+ *
+ * ## Platform Support
+ *
+ * - macOS/Linux: Uses pgrep, ps, lsof
+ * - Windows: Uses PowerShell (Get-Process, Get-WmiObject)
+ */
+export declare function scanForActiveSessions(): Promise<DetectedSession[]>;
+export { getPlatformInfo } from "./connection/process-detection.js";
+//# sourceMappingURL=process-scanner.d.ts.map

package/dist/process-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-scanner.d.ts","sourceRoot":"","sources":["../src/process-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAa9D,YAAY,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,cAAc,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,2EAA2E;IAC3E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qFAAqF;IACrF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,kDAAkD;IAClD,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iGAAiG;IACjG,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AASD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAkJxE;AAGD,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/process-scanner.js

@@ -0,0 +1,194 @@
+/**
+ * Process Scanner
+ *
+ * Cross-platform scanner for detecting running Claude Code sessions.
+ * Supports macOS, Linux, and Windows.
+ *
+ * ## How It Works
+ *
+ * 1. Enumerate all running Claude processes with their PIDs and TTYs
+ * 2. Get working directory (CWD) for each process
+ * 3. Map CWD to Claude's project directory (~/.claude/projects/{encoded-path})
+ * 4. Find ALL active JSONL files in that directory (not just most recent)
+ * 5. Parse each for sessionId, gitBranch, context metrics
+ * 6. Return all detected sessions
+ *
+ * ## Platform Support
+ *
+ * - macOS/Linux: Uses pgrep, ps, lsof
+ * - Windows: Uses PowerShell (Get-Process, Get-WmiObject)
+ *
+ * ## Multi-Session Detection
+ *
+ * Multiple Claude processes can run in the same directory. We detect all of them by:
+ * - Finding all JSONL files modified within ACTIVE_SESSION_THRESHOLD_MS
+ * - Using TTY to create unique terminal keys for each process
+ * - Matching processes to sessions by recency when exact match isn't possible
+ */
+import * as path from "path";
+import { getSessionIndex, } from "@jacques-ai/core/cache";
+import { CATALOG_CACHE_MAX_AGE_MS } from "./connection/constants.js";
+import { findActiveSessionFiles, findMostRecentSessionFile, findRecentSessionFiles, } from "./connection/session-discovery.js";
+import { getClaudeProcesses, } from "./connection/process-detection.js";
+// Process detection delegated to connection/process-detection.ts
+// Session discovery delegated to connection/session-discovery.ts
+// ============================================================
+// Main Scanner Function
+// ============================================================
+/**
+ * Scan for active Claude Code sessions
+ *
+ * Detects running Claude processes, matches them to session files,
+ * and extracts metadata for registration.
+ *
+ * ## Catalog-First Strategy
+ *
+ * Uses Jacques session index (from @jacques-ai/core/cache) for pre-extracted metadata:
+ * - Session titles (from summary or first user message)
+ * - Git info (branch, worktree, repo root)
+ * - Token usage stats
+ *
+ * Falls back to JSONL parsing only for sessions not in the catalog.
+ *
+ * ## Multi-Session Support
+ *
+ * When multiple Claude processes run in the same directory:
+ * - Finds ALL recently modified JSONL files (within 1 minute)
+ * - Creates unique terminal keys using TTY + PID
+ * - Returns one DetectedSession per active session file
+ *
+ * ## Platform Support
+ *
+ * - macOS/Linux: Uses pgrep, ps, lsof
+ * - Windows: Uses PowerShell (Get-Process, Get-WmiObject)
+ */
+export async function scanForActiveSessions() {
+    const processes = await getClaudeProcesses();
+    if (processes.length === 0) {
+        return [];
+    }
+    // Load existing session metadata from Jacques catalog
+    // Use a short maxAge since we want fresh data but can tolerate recent cache
+    let catalogMap = new Map();
+    try {
+        const sessionIndex = await getSessionIndex({ maxAge: CATALOG_CACHE_MAX_AGE_MS });
+        catalogMap = new Map(sessionIndex.sessions.map(s => [s.id, s]));
+    }
+    catch {
+        // Catalog unavailable, will fall back to JSONL parsing for all sessions
+    }
+    const sessions = [];
+    const processedSessionIds = new Set();
+    // Group processes by CWD
+    const processesByCwd = new Map();
+    for (const proc of processes) {
+        const existing = processesByCwd.get(proc.cwd) || [];
+        existing.push(proc);
+        processesByCwd.set(proc.cwd, existing);
+    }
+    // Process each unique CWD
+    for (const [cwd, cwdProcesses] of processesByCwd) {
+        // Find all active session files for this CWD (uses catalog when available)
+        let sessionFiles = await findActiveSessionFiles(cwd, catalogMap);
+        // If no active sessions found, fall back to most recent
+        if (sessionFiles.length === 0) {
+            const mostRecent = await findMostRecentSessionFile(cwd, catalogMap);
+            if (mostRecent) {
+                sessionFiles = [mostRecent];
+            }
+        }
+        if (sessionFiles.length === 0) {
+            continue;
+        }
+        // Match processes to session files
+        // Strategy: If N processes and M sessions, pair them by recency
+        const numPairs = Math.min(cwdProcesses.length, sessionFiles.length);
+        const project = path.basename(cwd) || "Unknown";
+        for (let i = 0; i < numPairs; i++) {
+            const proc = cwdProcesses[i];
+            const sessionFile = sessionFiles[i];
+            // Skip if we already registered this session ID
+            if (processedSessionIds.has(sessionFile.sessionId)) {
+                continue;
+            }
+            processedSessionIds.add(sessionFile.sessionId);
+            sessions.push({
+                sessionId: sessionFile.sessionId,
+                cwd,
+                transcriptPath: sessionFile.filePath,
+                gitBranch: sessionFile.gitBranch,
+                gitWorktree: sessionFile.gitWorktree,
+                gitRepoRoot: sessionFile.gitRepoRoot,
+                contextMetrics: sessionFile.contextMetrics,
+                lastActivity: sessionFile.modifiedAt.getTime(),
+                title: sessionFile.title,
+                pid: proc.pid,
+                tty: proc.tty,
+                project,
+                terminalType: proc.terminalType,
+                terminalSessionId: proc.terminalSessionId,
+                mode: sessionFile.mode,
+                isBypass: proc.isBypass,
+            });
+        }
+        // If more session files than processes, register remaining sessions
+        // with synthetic process info (they might be from recently closed terminals)
+        for (let i = numPairs; i < sessionFiles.length; i++) {
+            const sessionFile = sessionFiles[i];
+            if (processedSessionIds.has(sessionFile.sessionId)) {
+                continue;
+            }
+            processedSessionIds.add(sessionFile.sessionId);
+            sessions.push({
+                sessionId: sessionFile.sessionId,
+                cwd,
+                transcriptPath: sessionFile.filePath,
+                gitBranch: sessionFile.gitBranch,
+                gitWorktree: sessionFile.gitWorktree,
+                gitRepoRoot: sessionFile.gitRepoRoot,
+                contextMetrics: sessionFile.contextMetrics,
+                lastActivity: sessionFile.modifiedAt.getTime(),
+                title: sessionFile.title,
+                pid: 0, // Unknown PID
+                tty: "?",
+                project,
+                mode: sessionFile.mode,
+            });
+        }
+        // If more processes than session files, look for idle sessions
+        // (JSONL files not modified within the active threshold but still belonging to running processes)
+        if (cwdProcesses.length > sessionFiles.length) {
+            const excessCount = cwdProcesses.length - sessionFiles.length;
+            const recentFiles = await findRecentSessionFiles(cwd, catalogMap, excessCount, processedSessionIds);
+            for (let i = 0; i < recentFiles.length; i++) {
+                const sessionFile = recentFiles[i];
+                // Pair with remaining unmatched processes
+                const procIndex = sessionFiles.length + i;
+                const proc = procIndex < cwdProcesses.length ? cwdProcesses[procIndex] : null;
+                processedSessionIds.add(sessionFile.sessionId);
+                sessions.push({
+                    sessionId: sessionFile.sessionId,
+                    cwd,
+                    transcriptPath: sessionFile.filePath,
+                    gitBranch: sessionFile.gitBranch,
+                    gitWorktree: sessionFile.gitWorktree,
+                    gitRepoRoot: sessionFile.gitRepoRoot,
+                    contextMetrics: sessionFile.contextMetrics,
+                    lastActivity: sessionFile.modifiedAt.getTime(),
+                    title: sessionFile.title,
+                    pid: proc?.pid ?? 0,
+                    tty: proc?.tty ?? "?",
+                    project,
+                    terminalType: proc?.terminalType,
+                    terminalSessionId: proc?.terminalSessionId,
+                    mode: sessionFile.mode,
+                    isBypass: proc?.isBypass,
+                });
+            }
+        }
+    }
+    return sessions;
+}
+// getPlatformInfo re-exported from connection/process-detection
+export { getPlatformInfo } from "./connection/process-detection.js";
+//# sourceMappingURL=process-scanner.js.map