@jacques-ai/core 0.0.7-alpha.1

package/dist/project/aggregator.js

@@ -0,0 +1,218 @@
+/**
+ * Project Aggregator
+ *
+ * Aggregates data from multiple sources to build project statistics
+ * and session lists for the dashboard.
+ *
+ * Sources:
+ * - Live sessions (from WebSocket/Session registry)
+ * - Saved sessions (.jacques/index.json)
+ * - Archived sessions (~/.jacques/archive/manifests/)
+ * - Handoffs (.jacques/handoffs/)
+ * - Plans (.jacques/index.json plans array)
+ */
+import { promises as fs } from "fs";
+import { basename, join } from "path";
+import { getDefaultStatistics } from "./types.js";
+import { readProjectIndex } from "../context/indexer.js";
+import { listManifestsByProject, } from "../archive/archive-store.js";
+import { getHandoffsDir } from "../handoff/catalog.js";
+/**
+ * Count handoff files in a project
+ */
+async function countHandoffs(projectPath) {
+    try {
+        const handoffsDir = getHandoffsDir(projectPath);
+        const files = await fs.readdir(handoffsDir);
+        return files.filter((f) => f.endsWith("-handoff.md")).length;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Get the project slug (basename) from a path
+ */
+function getProjectSlug(projectPath) {
+    return basename(projectPath);
+}
+/**
+ * Aggregate statistics for a project
+ *
+ * @param projectPath - Full path to the project directory
+ * @param liveSessions - Currently active sessions from the server
+ */
+export async function aggregateProjectStatistics(projectPath, liveSessions) {
+    const stats = getDefaultStatistics();
+    const projectSlug = getProjectSlug(projectPath);
+    // 1. Count live sessions for this project
+    const projectLiveSessions = liveSessions.filter((s) => s.project === projectSlug || s.cwd === projectPath);
+    stats.activeSessions = projectLiveSessions.length;
+    // Aggregate live session metrics
+    for (const session of projectLiveSessions) {
+        if (session.context_metrics) {
+            stats.totalInputTokens += session.context_metrics.total_input_tokens || 0;
+            stats.totalOutputTokens +=
+                session.context_metrics.total_output_tokens || 0;
+        }
+        if (session.model?.display_name) {
+            const modelName = session.model.display_name;
+            stats.modelUsage[modelName] = (stats.modelUsage[modelName] || 0) + 1;
+        }
+    }
+    // 2. Load saved sessions from .jacques/index.json
+    try {
+        const index = await readProjectIndex(projectPath);
+        stats.savedSessions = index.sessions.length;
+        stats.totalPlans = index.plans.length;
+        // Aggregate saved session metrics
+        for (const session of index.sessions) {
+            stats.totalDurationMinutes += session.durationMinutes || 0;
+        }
+    }
+    catch {
+        // No local index yet
+    }
+    // 3. Load archived manifests for this project
+    try {
+        const manifestsByProject = await listManifestsByProject();
+        const projectManifests = manifestsByProject.get(projectSlug) || [];
+        stats.archivedSessions = projectManifests.length;
+        // Aggregate archive metrics (avoid double-counting with saved)
+        const savedIds = new Set();
+        try {
+            const index = await readProjectIndex(projectPath);
+            for (const s of index.sessions) {
+                savedIds.add(s.id);
+            }
+        }
+        catch {
+            // No index
+        }
+        for (const manifest of projectManifests) {
+            // Only add duration if not already counted from saved
+            if (!savedIds.has(manifest.id)) {
+                stats.totalDurationMinutes += manifest.durationMinutes || 0;
+            }
+            // Count tool calls and messages (only from archive, saved doesn't have this)
+            stats.totalAgentCalls += manifest.subagents?.count || 0;
+        }
+    }
+    catch {
+        // No archive
+    }
+    // 4. Count handoffs
+    stats.totalHandoffs = await countHandoffs(projectPath);
+    // 5. Calculate total sessions (deduplicated)
+    // Live + saved + archived (with overlap consideration)
+    stats.totalSessions =
+        stats.activeSessions + stats.savedSessions + stats.archivedSessions;
+    return stats;
+}
+/**
+ * Build a unified list of sessions for display
+ *
+ * Combines live, saved, and archived sessions, sorted by date (newest first).
+ * Deduplicates sessions that appear in multiple sources.
+ *
+ * @param projectPath - Full path to the project directory
+ * @param liveSessions - Currently active sessions from the server
+ * @param focusedSessionId - ID of the currently focused session
+ */
+export async function buildProjectSessionList(projectPath, liveSessions, focusedSessionId) {
+    const items = [];
+    const seenIds = new Set();
+    const projectSlug = getProjectSlug(projectPath);
+    // 1. Add live sessions first (highest priority)
+    const projectLiveSessions = liveSessions.filter((s) => s.project === projectSlug || s.cwd === projectPath);
+    for (const session of projectLiveSessions) {
+        seenIds.add(session.session_id);
+        items.push({
+            id: session.session_id,
+            title: session.session_title || "Untitled Session",
+            source: "live",
+            date: new Date(session.registered_at).toISOString(),
+            durationMinutes: Math.round((Date.now() - session.registered_at) / 60000),
+            model: session.model?.display_name,
+            contextPercent: session.context_metrics?.used_percentage,
+            isActive: session.status === "active" || session.status === "working",
+            isFocused: session.session_id === focusedSessionId,
+        });
+    }
+    // 2. Add saved sessions from .jacques/index.json
+    try {
+        const index = await readProjectIndex(projectPath);
+        for (const session of index.sessions) {
+            if (seenIds.has(session.id))
+                continue;
+            seenIds.add(session.id);
+            items.push({
+                id: session.id,
+                title: session.title,
+                source: "saved",
+                date: session.endedAt || session.savedAt,
+                durationMinutes: session.durationMinutes,
+                model: undefined, // Not stored in saved sessions
+                contextPercent: undefined,
+                isActive: false,
+                isFocused: false,
+            });
+        }
+    }
+    catch {
+        // No local index
+    }
+    // 3. Add archived sessions (only if not already in saved)
+    try {
+        const manifestsByProject = await listManifestsByProject();
+        const projectManifests = manifestsByProject.get(projectSlug) || [];
+        for (const manifest of projectManifests) {
+            if (seenIds.has(manifest.id))
+                continue;
+            seenIds.add(manifest.id);
+            items.push({
+                id: manifest.id,
+                title: manifest.title,
+                source: "archived",
+                date: manifest.endedAt || manifest.archivedAt,
+                durationMinutes: manifest.durationMinutes,
+                model: undefined, // Could extract from technologies
+                contextPercent: undefined,
+                isActive: false,
+                isFocused: false,
+            });
+        }
+    }
+    catch {
+        // No archive
+    }
+    // Sort by date (newest first)
+    items.sort((a, b) => new Date(b.date).getTime() - new Date(a.date).getTime());
+    return items;
+}
+/**
+ * Get plans for a project
+ */
+export async function getProjectPlans(projectPath) {
+    try {
+        const index = await readProjectIndex(projectPath);
+        // Sort by updatedAt (newest first)
+        return [...index.plans].sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Read the content of a local plan file from .jacques/
+ */
+export async function readLocalPlanContent(projectPath, plan) {
+    try {
+        const planPath = join(projectPath, ".jacques", plan.path);
+        return await fs.readFile(planPath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=aggregator.js.map

package/dist/project/aggregator.js.map

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

package/dist/project/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Project Module
+ *
+ * Data aggregation for the project dashboard view.
+ */
+export type { ProjectStatistics, ProjectSessionItem } from "./types.js";
+export { getDefaultStatistics } from "./types.js";
+export { aggregateProjectStatistics, buildProjectSessionList, getProjectPlans, readLocalPlanContent, } from "./aggregator.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/project/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlD,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,eAAe,EACf,oBAAoB,GACrB,MAAM,iBAAiB,CAAC"}

package/dist/project/index.js

@@ -0,0 +1,9 @@
+/**
+ * Project Module
+ *
+ * Data aggregation for the project dashboard view.
+ */
+export { getDefaultStatistics } from "./types.js";
+// Aggregator
+export { aggregateProjectStatistics, buildProjectSessionList, getProjectPlans, readLocalPlanContent, } from "./aggregator.js";
+//# sourceMappingURL=index.js.map

package/dist/project/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/project/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,aAAa;AACb,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,eAAe,EACf,oBAAoB,GACrB,MAAM,iBAAiB,CAAC"}

package/dist/project/types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Project Dashboard Types
+ *
+ * Type definitions for the project dashboard view.
+ * Aggregates data from live sessions, saved sessions, and archive.
+ */
+/**
+ * Aggregated statistics for a project
+ */
+export interface ProjectStatistics {
+    /** Total sessions (live + saved + archived) */
+    totalSessions: number;
+    /** Currently active/live sessions */
+    activeSessions: number;
+    /** Saved sessions in .jacques/ */
+    savedSessions: number;
+    /** Archived sessions in global archive */
+    archivedSessions: number;
+    /** Total input tokens used across all sessions */
+    totalInputTokens: number;
+    /** Total output tokens used across all sessions */
+    totalOutputTokens: number;
+    /** Total agent/subagent calls */
+    totalAgentCalls: number;
+    /** Total web searches performed */
+    totalWebSearches: number;
+    /** Total auto-compacts that occurred */
+    totalAutoCompacts: number;
+    /** Total handoff documents created */
+    totalHandoffs: number;
+    /** Total plans created */
+    totalPlans: number;
+    /** Total duration across all sessions (minutes) */
+    totalDurationMinutes: number;
+    /** Model usage: model name -> session count */
+    modelUsage: Record<string, number>;
+}
+/**
+ * A session item for display in the dashboard
+ */
+export interface ProjectSessionItem {
+    /** Session ID */
+    id: string;
+    /** Session title */
+    title: string;
+    /** Source: live (active), saved (in .jacques), or archived (global) */
+    source: "live" | "saved" | "archived";
+    /** Display date (ISO string) */
+    date: string;
+    /** Duration in minutes */
+    durationMinutes: number;
+    /** Model used (if known) */
+    model?: string;
+    /** Context percentage (only for live sessions) */
+    contextPercent?: number;
+    /** Is this session currently active? */
+    isActive: boolean;
+    /** Is this the focused session? */
+    isFocused: boolean;
+}
+/**
+ * Default empty statistics
+ */
+export declare function getDefaultStatistics(): ProjectStatistics;
+//# sourceMappingURL=types.d.ts.map

package/dist/project/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/project/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,gBAAgB,EAAE,MAAM,CAAC;IAEzB,kDAAkD;IAClD,gBAAgB,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,iBAAiB,EAAE,MAAM,CAAC;IAE1B,iCAAiC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,iBAAiB,EAAE,MAAM,CAAC;IAE1B,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IAEnB,mDAAmD;IACnD,oBAAoB,EAAE,MAAM,CAAC;IAE7B,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iBAAiB;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;IACtC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,mCAAmC;IACnC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,CAgBxD"}

package/dist/project/types.js

@@ -0,0 +1,27 @@
+/**
+ * Project Dashboard Types
+ *
+ * Type definitions for the project dashboard view.
+ * Aggregates data from live sessions, saved sessions, and archive.
+ */
+/**
+ * Default empty statistics
+ */
+export function getDefaultStatistics() {
+    return {
+        totalSessions: 0,
+        activeSessions: 0,
+        savedSessions: 0,
+        archivedSessions: 0,
+        totalInputTokens: 0,
+        totalOutputTokens: 0,
+        totalAgentCalls: 0,
+        totalWebSearches: 0,
+        totalAutoCompacts: 0,
+        totalHandoffs: 0,
+        totalPlans: 0,
+        totalDurationMinutes: 0,
+        modelUsage: {},
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/project/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/project/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+DH;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,cAAc,EAAE,CAAC;QACjB,aAAa,EAAE,CAAC;QAChB,gBAAgB,EAAE,CAAC;QACnB,gBAAgB,EAAE,CAAC;QACnB,iBAAiB,EAAE,CAAC;QACpB,eAAe,EAAE,CAAC;QAClB,gBAAgB,EAAE,CAAC;QACnB,iBAAiB,EAAE,CAAC;QACpB,aAAa,EAAE,CAAC;QAChB,UAAU,EAAE,CAAC;QACb,oBAAoB,EAAE,CAAC;QACvB,UAAU,EAAE,EAAE;KACf,CAAC;AACJ,CAAC"}

package/dist/session/detector.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Session Detector
+ *
+ * Detects the current Claude Code session JSONL file.
+ * Claude Code stores session history at:
+ *   ~/.claude/projects/[encoded-directory-path]/[session-uuid].jsonl
+ *
+ * Encoding rule: Replace '/' with '-' (e.g., /Users/gole/Desktop/project → -Users-gole-Desktop-project)
+ *
+ * IMPORTANT: Claude Code encodes BOTH '/' AND '_' as '-', making naive
+ * string-based reversal impossible. Use decodeProjectPath() which reads
+ * the authoritative originalPath from sessions-index.json.
+ */
+export interface SessionFile {
+    /** Full path to the JSONL file */
+    filePath: string;
+    /** Session UUID (extracted from filename) */
+    sessionId: string;
+    /** Last modification time */
+    modifiedAt: Date;
+    /** File size in bytes */
+    sizeBytes: number;
+}
+export interface DetectorOptions {
+    /** Working directory to detect session for (defaults to process.cwd()) */
+    cwd?: string;
+    /** Path to Claude projects directory (defaults to ~/.claude/projects) */
+    claudeProjectsDir?: string;
+}
+/**
+ * Get the Claude projects directory path.
+ *
+ * Resolution order:
+ *   1. CLAUDE_CONFIG_DIR env var + /projects
+ *   2. rootPath from ~/.jacques/config.json + /projects
+ *   3. Default: ~/.claude/projects
+ *
+ * Works cross-platform: macOS, Linux, and Windows.
+ */
+export declare function getClaudeProjectsDir(): string;
+/**
+ * Get the Claude settings.json path.
+ * Uses the same resolution logic as getClaudeProjectsDir().
+ */
+export declare function getClaudeSettingsPath(): string;
+/**
+ * Encode a directory path to Claude's format.
+ * Replaces path separators with '-' (keeps leading dash).
+ * Example: /Users/gole/Desktop/project -> -Users-gole-Desktop-project
+ *
+ * Cross-platform: handles both '/' (Unix) and '\' (Windows) separators.
+ * On Windows, also strips the drive letter colon (C:\foo → -C-foo).
+ * TODO: verify encoding on actual Windows Claude Code installation
+ */
+export declare function encodeProjectPath(dirPath: string): string;
+/**
+ * Naive decode: replace all dashes with slashes.
+ * This is WRONG for paths containing dashes or underscores, but serves
+ * as a fallback when sessions-index.json is unavailable.
+ */
+export declare function decodeProjectPathNaive(encodedDir: string): string;
+/**
+ * Decode an encoded project directory name to the real filesystem path.
+ *
+ * Resolution order:
+ *   1. sessions-index.json originalPath (authoritative, written by Claude Code)
+ *   2. cwd field from first JSONL entry (reliable, written at session start)
+ *   3. Naive decode: replace all dashes with slashes (last resort, often wrong)
+ */
+export declare function decodeProjectPath(encodedDir: string, claudeProjectsDir?: string): Promise<string>;
+/**
+ * Detect the current Claude session JSONL file.
+ * Returns the most recently modified .jsonl file in the project directory.
+ */
+export declare function detectCurrentSession(options?: DetectorOptions): Promise<SessionFile | null>;
+/**
+ * List all session files for a project.
+ * Returns sessions sorted by modification time (most recent first).
+ */
+export declare function listProjectSessions(options?: DetectorOptions): Promise<SessionFile[]>;
+/**
+ * Get the expected project directory path for a given working directory.
+ * Useful for debugging and testing.
+ */
+export declare function getProjectDirPath(cwd: string, claudeProjectsDir?: string): string;
+/**
+ * Subagent file info
+ */
+export interface SubagentFile {
+    /** Full path to the subagent JSONL file */
+    filePath: string;
+    /** Agent ID extracted from filename (e.g., "a0323e0") */
+    agentId: string;
+    /** Last modification time */
+    modifiedAt: Date;
+    /** File size in bytes */
+    sizeBytes: number;
+}
+/**
+ * List all subagent JSONL files for a given session.
+ * Claude Code stores subagent conversations in:
+ *   {session-id}/subagents/agent-{agentId}.jsonl
+ *
+ * @param sessionFilePath Path to the main session JSONL file
+ * @returns Array of subagent files found
+ */
+export declare function listSubagentFiles(sessionFilePath: string): Promise<SubagentFile[]>;
+/**
+ * Find a session file by session ID across all project directories.
+ * This is useful when the cwd is incorrect but we know the session ID.
+ */
+export declare function findSessionById(sessionId: string, claudeProjectsDir?: string): Promise<SessionFile | null>;
+//# sourceMappingURL=detector.d.ts.map

package/dist/session/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../src/session/detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,UAAU,EAAE,IAAI,CAAC;IACjB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAM7C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAM9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMzD;AAiED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAKjE;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAwD7B;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,WAAW,EAAE,CAAC,CAuCxB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,iBAAiB,CAAC,EAAE,MAAM,GACzB,MAAM,CAIR;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,UAAU,EAAE,IAAI,CAAC;IACjB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC,CA2CzB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAkC7B"}