@kynetic-ai/spec 0.11.0 → 0.12.0

package/dist/schema/triage.d.ts

@@ -35,13 +35,13 @@ export declare const TriageRecordSchema: z.ZodEffects<z.ZodObject<{
     updated_at: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodString]>>;
 }, "strip", z.ZodTypeAny, {
     status: "pending" | "triaged" | "acted_on";
-    _ulid: string;
     created_at: string;
+    _ulid: string;
     inbox_ref: string;
     item_snapshot: string;
     evidence_refs: string[];
-    action?: "promote" | "delete" | "defer" | "spec-gap" | "duplicate" | undefined;
     updated_at?: string | undefined;
+    action?: "promote" | "delete" | "defer" | "spec-gap" | "duplicate" | undefined;
     reasoning?: string | undefined;
     decided_by?: string | undefined;
     override_reasoning?: string | undefined;
@@ -51,12 +51,12 @@ export declare const TriageRecordSchema: z.ZodEffects<z.ZodObject<{
     result_ref?: string | undefined;
 }, {
     status: "pending" | "triaged" | "acted_on";
-    _ulid: string;
     created_at: string;
+    _ulid: string;
     inbox_ref: string;
     item_snapshot: string;
-    action?: "promote" | "delete" | "defer" | "spec-gap" | "duplicate" | undefined;
     updated_at?: string | undefined;
+    action?: "promote" | "delete" | "defer" | "spec-gap" | "duplicate" | undefined;
     reasoning?: string | undefined;
     decided_by?: string | undefined;
     evidence_refs?: string[] | undefined;
@@ -67,13 +67,13 @@ export declare const TriageRecordSchema: z.ZodEffects<z.ZodObject<{
     result_ref?: string | undefined;
 }>, {
     status: "pending" | "triaged" | "acted_on";
-    _ulid: string;
     created_at: string;
+    _ulid: string;
     inbox_ref: string;
     item_snapshot: string;
     evidence_refs: string[];
-    action?: "promote" | "delete" | "defer" | "spec-gap" | "duplicate" | undefined;
     updated_at?: string | undefined;
+    action?: "promote" | "delete" | "defer" | "spec-gap" | "duplicate" | undefined;
     reasoning?: string | undefined;
     decided_by?: string | undefined;
     override_reasoning?: string | undefined;
@@ -83,12 +83,12 @@ export declare const TriageRecordSchema: z.ZodEffects<z.ZodObject<{
     result_ref?: string | undefined;
 }, {
     status: "pending" | "triaged" | "acted_on";
-    _ulid: string;
     created_at: string;
+    _ulid: string;
     inbox_ref: string;
     item_snapshot: string;
-    action?: "promote" | "delete" | "defer" | "spec-gap" | "duplicate" | undefined;
     updated_at?: string | undefined;
+    action?: "promote" | "delete" | "defer" | "spec-gap" | "duplicate" | undefined;
     reasoning?: string | undefined;
     decided_by?: string | undefined;
     evidence_refs?: string[] | undefined;
@@ -115,8 +115,8 @@ export declare const TriageRecordInputSchema: z.ZodObject<{
     inbox_ref: string;
     item_snapshot: string;
     status?: "pending" | "triaged" | "acted_on" | undefined;
-    _ulid?: string | undefined;
     created_at?: string | undefined;
+    _ulid?: string | undefined;
     action?: "promote" | "delete" | "defer" | "spec-gap" | "duplicate" | undefined;
     reasoning?: string | undefined;
     decided_by?: string | undefined;
@@ -125,8 +125,8 @@ export declare const TriageRecordInputSchema: z.ZodObject<{
     inbox_ref: string;
     item_snapshot: string;
     status?: "pending" | "triaged" | "acted_on" | undefined;
-    _ulid?: string | undefined;
     created_at?: string | undefined;
+    _ulid?: string | undefined;
     action?: "promote" | "delete" | "defer" | "spec-gap" | "duplicate" | undefined;
     reasoning?: string | undefined;
     decided_by?: string | undefined;
@@ -156,13 +156,13 @@ export declare const TriageFileSchema: z.ZodObject<{
         updated_at: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodString]>>;
     }, "strip", z.ZodTypeAny, {
         status: "pending" | "triaged" | "acted_on";
-        _ulid: string;
         created_at: string;
+        _ulid: string;
         inbox_ref: string;
         item_snapshot: string;
         evidence_refs: string[];
-        action?: "promote" | "delete" | "defer" | "spec-gap" | "duplicate" | undefined;
         updated_at?: string | undefined;
+        action?: "promote" | "delete" | "defer" | "spec-gap" | "duplicate" | undefined;
         reasoning?: string | undefined;
         decided_by?: string | undefined;
         override_reasoning?: string | undefined;
@@ -172,12 +172,12 @@ export declare const TriageFileSchema: z.ZodObject<{
         result_ref?: string | undefined;
     }, {
         status: "pending" | "triaged" | "acted_on";
-        _ulid: string;
         created_at: string;
+        _ulid: string;
         inbox_ref: string;
         item_snapshot: string;
-        action?: "promote" | "delete" | "defer" | "spec-gap" | "duplicate" | undefined;
         updated_at?: string | undefined;
+        action?: "promote" | "delete" | "defer" | "spec-gap" | "duplicate" | undefined;
         reasoning?: string | undefined;
         decided_by?: string | undefined;
         evidence_refs?: string[] | undefined;
@@ -188,13 +188,13 @@ export declare const TriageFileSchema: z.ZodObject<{
         result_ref?: string | undefined;
     }>, {
         status: "pending" | "triaged" | "acted_on";
-        _ulid: string;
         created_at: string;
+        _ulid: string;
         inbox_ref: string;
         item_snapshot: string;
         evidence_refs: string[];
-        action?: "promote" | "delete" | "defer" | "spec-gap" | "duplicate" | undefined;
         updated_at?: string | undefined;
+        action?: "promote" | "delete" | "defer" | "spec-gap" | "duplicate" | undefined;
         reasoning?: string | undefined;
         decided_by?: string | undefined;
         override_reasoning?: string | undefined;
@@ -204,12 +204,12 @@ export declare const TriageFileSchema: z.ZodObject<{
         result_ref?: string | undefined;
     }, {
         status: "pending" | "triaged" | "acted_on";
-        _ulid: string;
         created_at: string;
+        _ulid: string;
         inbox_ref: string;
         item_snapshot: string;
-        action?: "promote" | "delete" | "defer" | "spec-gap" | "duplicate" | undefined;
         updated_at?: string | undefined;
+        action?: "promote" | "delete" | "defer" | "spec-gap" | "duplicate" | undefined;
         reasoning?: string | undefined;
         decided_by?: string | undefined;
         evidence_refs?: string[] | undefined;
@@ -223,13 +223,13 @@ export declare const TriageFileSchema: z.ZodObject<{
     kynetic_triage: string;
     triage: {
         status: "pending" | "triaged" | "acted_on";
-        _ulid: string;
         created_at: string;
+        _ulid: string;
         inbox_ref: string;
         item_snapshot: string;
         evidence_refs: string[];
-        action?: "promote" | "delete" | "defer" | "spec-gap" | "duplicate" | undefined;
         updated_at?: string | undefined;
+        action?: "promote" | "delete" | "defer" | "spec-gap" | "duplicate" | undefined;
         reasoning?: string | undefined;
         decided_by?: string | undefined;
         override_reasoning?: string | undefined;
@@ -241,12 +241,12 @@ export declare const TriageFileSchema: z.ZodObject<{
 }, {
     triage: {
         status: "pending" | "triaged" | "acted_on";
-        _ulid: string;
         created_at: string;
+        _ulid: string;
         inbox_ref: string;
         item_snapshot: string;
-        action?: "promote" | "delete" | "defer" | "spec-gap" | "duplicate" | undefined;
         updated_at?: string | undefined;
+        action?: "promote" | "delete" | "defer" | "spec-gap" | "duplicate" | undefined;
         reasoning?: string | undefined;
         decided_by?: string | undefined;
         evidence_refs?: string[] | undefined;

package/dist/sessions/cache.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Session summary cache.
+ *
+ * In-memory cache for session metadata. Reads only session.yaml files —
+ * never reads events.jsonl. Summary stats for closed sessions come from
+ * persisted metadata fields. Active sessions get live event counts from
+ * an in-memory counter incremented on each event append.
+ *
+ * AC Coverage:
+ * - @session-summary-cache ac-cache-build: Build cache on first request
+ * - @session-summary-cache ac-cache-invalidate: Detect changes via directory listing diff
+ * - @session-summary-cache ac-cache-graceful: Skip corrupt/missing entries with warning
+ * - @session-list-pagination-api ac-metadata-only: List path reads only session.yaml
+ * - @session-summary-cache ac-active-refresh: Re-read metadata for active sessions on each request
+ * - @session-summary-cache ac-persist-on-close: Closed sessions read persisted stats from metadata
+ * - @session-summary-cache ac-live-counter: Active sessions serve event_count from in-memory counter
+ */
+import { type SessionLogSummary } from "./store.js";
+/**
+ * In-memory cache for session summaries.
+ *
+ * Usage:
+ *   const cache = new SessionSummaryCache();
+ *   const summaries = await cache.getAll(sessionsDir);
+ */
+export declare class SessionSummaryCache {
+    /** Cached summaries keyed by session ID */
+    private entries;
+    /** Set of session IDs from last directory listing, used for invalidation */
+    private knownSessionIds;
+    /** Whether the cache has been populated at least once */
+    private initialized;
+    /** In-flight promise for cache build to prevent concurrent builds */
+    private buildPromise;
+    /**
+     * Live event counters for active sessions.
+     * Incremented on each event append, served as event_count for active sessions.
+     * Discarded when a session closes (persisted value takes over).
+     * AC: @session-summary-cache ac-live-counter
+     */
+    private liveEventCounts;
+    /**
+     * Get all session summaries, using cache when possible.
+     *
+     * AC: @session-summary-cache ac-cache-build — First call builds cache from disk.
+     * AC: @session-summary-cache ac-cache-invalidate — Subsequent calls diff directory listing.
+     * AC: @session-summary-cache ac-active-refresh — Active sessions get stats recomputed.
+     */
+    getAll(sessionsDir: string): Promise<SessionLogSummary[]>;
+    /**
+     * Get a single session's full summary, including stats from events.jsonl.
+     * Always computes fresh stats (not metadata-only) for detail views.
+     */
+    get(sessionsDir: string, sessionId: string): Promise<SessionLogSummary | null>;
+    /**
+     * Invalidate a specific session's cache entry.
+     * Next access will re-read from disk.
+     */
+    invalidate(sessionId: string): void;
+    /**
+     * Clear the entire cache. Next getAll() will rebuild from disk.
+     */
+    clear(): void;
+    /**
+     * Increment the live event counter for an active session.
+     * Called when an event is appended to events.jsonl during a running invocation.
+     * AC: @session-summary-cache ac-live-counter
+     */
+    incrementEventCount(sessionId: string): void;
+    /**
+     * Discard the live event counter for a session.
+     * Called when a session closes — the persisted stats in session.yaml take over.
+     * AC: @session-summary-cache ac-live-counter
+     */
+    discardLiveCounter(sessionId: string): void;
+    /**
+     * Get the current live event count for a session (for testing/inspection).
+     */
+    getLiveEventCount(sessionId: string): number;
+    /**
+     * Build the cache from scratch by reading all session directories.
+     *
+     * AC: @session-summary-cache ac-cache-build — Reads all session.yaml files.
+     * AC: @session-summary-cache ac-cache-graceful — Skips corrupt/missing entries.
+     *
+     * Uses in-flight promise dedup to prevent concurrent builds.
+     */
+    private build;
+    private doBuild;
+    /**
+     * Refresh the cache by detecting changes since last build.
+     *
+     * AC: @session-summary-cache ac-cache-invalidate — Detects new/removed sessions
+     *     via directory listing diff and updates only affected entries.
+     * AC: @session-summary-cache ac-active-refresh — Recomputes stats for active sessions.
+     */
+    private refresh;
+    /**
+     * Get mtime of session.yaml for change detection.
+     * Returns 0 if the file doesn't exist.
+     */
+    private getMetadataMtime;
+    /**
+     * List session directories (same logic as listSessions in store.ts).
+     */
+    private listSessionDirs;
+    /**
+     * Return all cached summaries as an array.
+     * AC: @session-summary-cache ac-live-counter — Active sessions get event_count
+     * from the in-memory live counter instead of the (stale) metadata value.
+     */
+    private summaries;
+}
+/**
+ * Get (or create) a SessionSummaryCache scoped to a specific sessionsDir.
+ * Ensures multi-project daemon requests don't share cached session data.
+ */
+export declare function getSessionCache(sessionsDir: string): SessionSummaryCache;
+//# sourceMappingURL=cache.d.ts.map

package/dist/sessions/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/sessions/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EACL,KAAK,iBAAiB,EAGvB,MAAM,YAAY,CAAC;AAWpB;;;;;;GAMG;AACH,qBAAa,mBAAmB;IAC9B,2CAA2C;IAC3C,OAAO,CAAC,OAAO,CAAiC;IAEhD,4EAA4E;IAC5E,OAAO,CAAC,eAAe,CAAqB;IAE5C,yDAAyD;IACzD,OAAO,CAAC,WAAW,CAAS;IAE5B,qEAAqE;IACrE,OAAO,CAAC,YAAY,CAA8B;IAElD;;;;;OAKG;IACH,OAAO,CAAC,eAAe,CAA6B;IAEpD;;;;;;OAMG;IACG,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAU/D;;;OAGG;IACG,GAAG,CACP,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAKpC;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAInC;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;;;OAIG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAK5C;;;;OAIG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI3C;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAI5C;;;;;;;OAOG;YACW,KAAK;YAaL,OAAO;IA+BrB;;;;;;OAMG;YACW,OAAO;IA+ErB;;;OAGG;YACW,gBAAgB;IAa9B;;OAEG;YACW,eAAe;IAW7B;;;;OAIG;IACH,OAAO,CAAC,SAAS;CASlB;AAWD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,CAOxE"}

package/dist/sessions/cache.js

@@ -0,0 +1,284 @@
+/**
+ * Session summary cache.
+ *
+ * In-memory cache for session metadata. Reads only session.yaml files —
+ * never reads events.jsonl. Summary stats for closed sessions come from
+ * persisted metadata fields. Active sessions get live event counts from
+ * an in-memory counter incremented on each event append.
+ *
+ * AC Coverage:
+ * - @session-summary-cache ac-cache-build: Build cache on first request
+ * - @session-summary-cache ac-cache-invalidate: Detect changes via directory listing diff
+ * - @session-summary-cache ac-cache-graceful: Skip corrupt/missing entries with warning
+ * - @session-list-pagination-api ac-metadata-only: List path reads only session.yaml
+ * - @session-summary-cache ac-active-refresh: Re-read metadata for active sessions on each request
+ * - @session-summary-cache ac-persist-on-close: Closed sessions read persisted stats from metadata
+ * - @session-summary-cache ac-live-counter: Active sessions serve event_count from in-memory counter
+ */
+import * as path from "node:path";
+import * as fsPromises from "node:fs/promises";
+import { getSessionLogSummary, getSessionMetadataOnly, } from "./store.js";
+/**
+ * In-memory cache for session summaries.
+ *
+ * Usage:
+ *   const cache = new SessionSummaryCache();
+ *   const summaries = await cache.getAll(sessionsDir);
+ */
+export class SessionSummaryCache {
+    /** Cached summaries keyed by session ID */
+    entries = new Map();
+    /** Set of session IDs from last directory listing, used for invalidation */
+    knownSessionIds = new Set();
+    /** Whether the cache has been populated at least once */
+    initialized = false;
+    /** In-flight promise for cache build to prevent concurrent builds */
+    buildPromise = null;
+    /**
+     * Live event counters for active sessions.
+     * Incremented on each event append, served as event_count for active sessions.
+     * Discarded when a session closes (persisted value takes over).
+     * AC: @session-summary-cache ac-live-counter
+     */
+    liveEventCounts = new Map();
+    /**
+     * Get all session summaries, using cache when possible.
+     *
+     * AC: @session-summary-cache ac-cache-build — First call builds cache from disk.
+     * AC: @session-summary-cache ac-cache-invalidate — Subsequent calls diff directory listing.
+     * AC: @session-summary-cache ac-active-refresh — Active sessions get stats recomputed.
+     */
+    async getAll(sessionsDir) {
+        if (!this.initialized) {
+            await this.build(sessionsDir);
+            return this.summaries();
+        }
+        await this.refresh(sessionsDir);
+        return this.summaries();
+    }
+    /**
+     * Get a single session's full summary, including stats from events.jsonl.
+     * Always computes fresh stats (not metadata-only) for detail views.
+     */
+    async get(sessionsDir, sessionId) {
+        const summary = await getSessionLogSummary(sessionsDir, sessionId);
+        return summary;
+    }
+    /**
+     * Invalidate a specific session's cache entry.
+     * Next access will re-read from disk.
+     */
+    invalidate(sessionId) {
+        this.entries.delete(sessionId);
+    }
+    /**
+     * Clear the entire cache. Next getAll() will rebuild from disk.
+     */
+    clear() {
+        this.entries.clear();
+        this.knownSessionIds.clear();
+        this.initialized = false;
+        this.buildPromise = null;
+        this.liveEventCounts.clear();
+    }
+    /**
+     * Increment the live event counter for an active session.
+     * Called when an event is appended to events.jsonl during a running invocation.
+     * AC: @session-summary-cache ac-live-counter
+     */
+    incrementEventCount(sessionId) {
+        const current = this.liveEventCounts.get(sessionId) ?? 0;
+        this.liveEventCounts.set(sessionId, current + 1);
+    }
+    /**
+     * Discard the live event counter for a session.
+     * Called when a session closes — the persisted stats in session.yaml take over.
+     * AC: @session-summary-cache ac-live-counter
+     */
+    discardLiveCounter(sessionId) {
+        this.liveEventCounts.delete(sessionId);
+    }
+    /**
+     * Get the current live event count for a session (for testing/inspection).
+     */
+    getLiveEventCount(sessionId) {
+        return this.liveEventCounts.get(sessionId) ?? 0;
+    }
+    /**
+     * Build the cache from scratch by reading all session directories.
+     *
+     * AC: @session-summary-cache ac-cache-build — Reads all session.yaml files.
+     * AC: @session-summary-cache ac-cache-graceful — Skips corrupt/missing entries.
+     *
+     * Uses in-flight promise dedup to prevent concurrent builds.
+     */
+    async build(sessionsDir) {
+        if (this.buildPromise) {
+            return this.buildPromise;
+        }
+        this.buildPromise = this.doBuild(sessionsDir);
+        try {
+            await this.buildPromise;
+        }
+        finally {
+            this.buildPromise = null;
+        }
+    }
+    async doBuild(sessionsDir) {
+        const sessionIds = await this.listSessionDirs(sessionsDir);
+        this.knownSessionIds = new Set(sessionIds);
+        // AC: @session-list-pagination-api ac-metadata-only — Read only session.yaml, not events.jsonl
+        const results = await Promise.all(sessionIds.map(async (id) => {
+            // AC: @session-summary-cache ac-cache-graceful
+            try {
+                const summary = await getSessionMetadataOnly(sessionsDir, id);
+                const mtimeMs = await this.getMetadataMtime(sessionsDir, id);
+                return { id, summary, mtimeMs };
+            }
+            catch (err) {
+                console.warn(`[session-cache] Skipping session ${id}: ${err instanceof Error ? err.message : String(err)}`);
+                return { id, summary: null, mtimeMs: 0 };
+            }
+        }));
+        this.entries.clear();
+        for (const { id, summary, mtimeMs } of results) {
+            if (summary) {
+                this.entries.set(id, { summary, mtimeMs });
+            }
+        }
+        this.initialized = true;
+    }
+    /**
+     * Refresh the cache by detecting changes since last build.
+     *
+     * AC: @session-summary-cache ac-cache-invalidate — Detects new/removed sessions
+     *     via directory listing diff and updates only affected entries.
+     * AC: @session-summary-cache ac-active-refresh — Recomputes stats for active sessions.
+     */
+    async refresh(sessionsDir) {
+        const currentIds = await this.listSessionDirs(sessionsDir);
+        const currentSet = new Set(currentIds);
+        // Find new sessions (in current listing but not in cache)
+        const newIds = currentIds.filter((id) => !this.knownSessionIds.has(id));
+        // Find removed sessions (in cache but not in current listing)
+        const removedIds = [...this.knownSessionIds].filter((id) => !currentSet.has(id));
+        // Find active sessions that need stats refresh
+        // AC: @session-summary-cache ac-active-refresh
+        const activeIds = [...this.entries.values()]
+            .filter((entry) => entry.summary.status === "active")
+            .map((entry) => entry.summary.id);
+        // AC: @session-summary-cache ac-cache-invalidate — Detect in-place session.yaml changes
+        // Check mtime of session.yaml for all existing non-active cached sessions
+        const mtimeChangedIds = [];
+        const existingNonActiveIds = [...this.entries.entries()]
+            .filter(([, entry]) => entry.summary.status !== "active")
+            .map(([id]) => id)
+            .filter((id) => currentSet.has(id)); // still exists on disk
+        if (existingNonActiveIds.length > 0) {
+            const mtimeChecks = await Promise.all(existingNonActiveIds.map(async (id) => {
+                const currentMtime = await this.getMetadataMtime(sessionsDir, id);
+                const cached = this.entries.get(id);
+                return { id, changed: cached != null && currentMtime !== cached.mtimeMs };
+            }));
+            for (const { id, changed } of mtimeChecks) {
+                if (changed) {
+                    mtimeChangedIds.push(id);
+                }
+            }
+        }
+        // Remove deleted sessions from cache
+        for (const id of removedIds) {
+            this.entries.delete(id);
+        }
+        // AC: @session-list-pagination-api ac-metadata-only — Read only session.yaml, not events.jsonl
+        const idsToRefresh = [...new Set([...newIds, ...activeIds, ...mtimeChangedIds])];
+        if (idsToRefresh.length > 0) {
+            const results = await Promise.all(idsToRefresh.map(async (id) => {
+                // AC: @session-summary-cache ac-cache-graceful
+                try {
+                    const summary = await getSessionMetadataOnly(sessionsDir, id);
+                    const mtimeMs = await this.getMetadataMtime(sessionsDir, id);
+                    return { id, summary, mtimeMs };
+                }
+                catch (err) {
+                    console.warn(`[session-cache] Skipping session ${id}: ${err instanceof Error ? err.message : String(err)}`);
+                    return { id, summary: null, mtimeMs: 0 };
+                }
+            }));
+            for (const { id, summary, mtimeMs } of results) {
+                if (summary) {
+                    this.entries.set(id, { summary, mtimeMs });
+                }
+                else {
+                    // Remove from cache if it was there (e.g., active session that became unreadable)
+                    this.entries.delete(id);
+                }
+            }
+        }
+        // Update known session IDs
+        this.knownSessionIds = currentSet;
+    }
+    /**
+     * Get mtime of session.yaml for change detection.
+     * Returns 0 if the file doesn't exist.
+     */
+    async getMetadataMtime(sessionsDir, sessionId) {
+        try {
+            const metadataPath = path.join(sessionsDir, sessionId, "session.yaml");
+            const stat = await fsPromises.stat(metadataPath);
+            return stat.mtimeMs;
+        }
+        catch {
+            return 0;
+        }
+    }
+    /**
+     * List session directories (same logic as listSessions in store.ts).
+     */
+    async listSessionDirs(sessionsDir) {
+        try {
+            const entries = await fsPromises.readdir(sessionsDir, {
+                withFileTypes: true,
+            });
+            return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Return all cached summaries as an array.
+     * AC: @session-summary-cache ac-live-counter — Active sessions get event_count
+     * from the in-memory live counter instead of the (stale) metadata value.
+     */
+    summaries() {
+        return [...this.entries.values()].map((e) => {
+            const liveCount = this.liveEventCounts.get(e.summary.id);
+            if (e.summary.status === "active" && liveCount !== undefined) {
+                return { ...e.summary, event_count: liveCount };
+            }
+            return e.summary;
+        });
+    }
+}
+/**
+ * Per-sessionsDir cache registry.
+ *
+ * The daemon is multi-project: each request can target a different project root,
+ * each with its own sessionsDir. This registry ensures cache instances are scoped
+ * per sessionsDir to prevent cross-project session bleed.
+ */
+const cacheRegistry = new Map();
+/**
+ * Get (or create) a SessionSummaryCache scoped to a specific sessionsDir.
+ * Ensures multi-project daemon requests don't share cached session data.
+ */
+export function getSessionCache(sessionsDir) {
+    let cache = cacheRegistry.get(sessionsDir);
+    if (!cache) {
+        cache = new SessionSummaryCache();
+        cacheRegistry.set(sessionsDir, cache);
+    }
+    return cache;
+}
+//# sourceMappingURL=cache.js.map

package/dist/sessions/cache.js.map

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

package/dist/sessions/index.d.ts

@@ -8,4 +8,5 @@
  */
 export * from "./store.js";
 export * from "./types.js";
+export * from "./cache.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sessions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,YAAY,CAAC;AAE3B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sessions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,YAAY,CAAC;AAE3B,cAAc,YAAY,CAAC;AAE3B,cAAc,YAAY,CAAC"}

package/dist/sessions/index.js

@@ -10,4 +10,6 @@
 export * from "./store.js";
 // Re-export types
 export * from "./types.js";
+// Re-export cache
+export * from "./cache.js";
 //# sourceMappingURL=index.js.map

package/dist/sessions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sessions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,8BAA8B;AAC9B,cAAc,YAAY,CAAC;AAC3B,kBAAkB;AAClB,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sessions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,8BAA8B;AAC9B,cAAc,YAAY,CAAC;AAC3B,kBAAkB;AAClB,cAAc,YAAY,CAAC;AAC3B,kBAAkB;AAClB,cAAc,YAAY,CAAC"}