noctrace 1.2.0 → 1.3.0

package/dist/client/assets/index-DlKrxvV-.css

@@ -0,0 +1,2 @@
+/*! tailwindcss v4.2.2 | MIT License | https://tailwindcss.com */
+@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-rotate-x:initial;--tw-rotate-y:initial;--tw-rotate-z:initial;--tw-skew-x:initial;--tw-skew-y:initial;--tw-border-style:solid;--tw-font-weight:initial;--tw-tracking:initial;--tw-shadow:0 0 #0000;--tw-shadow-color:initial;--tw-shadow-alpha:100%;--tw-inset-shadow:0 0 #0000;--tw-inset-shadow-color:initial;--tw-inset-shadow-alpha:100%;--tw-ring-color:initial;--tw-ring-shadow:0 0 #0000;--tw-inset-ring-color:initial;--tw-inset-ring-shadow:0 0 #0000;--tw-ring-inset:initial;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-offset-shadow:0 0 #0000;--tw-outline-style:solid;--tw-blur:initial;--tw-brightness:initial;--tw-contrast:initial;--tw-grayscale:initial;--tw-hue-rotate:initial;--tw-invert:initial;--tw-opacity:initial;--tw-saturate:initial;--tw-sepia:initial;--tw-drop-shadow:initial;--tw-drop-shadow-color:initial;--tw-drop-shadow-alpha:100%;--tw-drop-shadow-size:initial;--tw-ease:initial}}}@layer theme{:root,:host{--font-sans:ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";--font-mono:ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;--spacing:.25rem;--text-xs:.75rem;--text-xs--line-height:calc(1 / .75);--text-sm:.875rem;--text-sm--line-height:calc(1.25 / .875);--font-weight-semibold:600;--font-weight-bold:700;--tracking-wider:.05em;--radius-sm:.25rem;--ease-in-out:cubic-bezier(.4, 0, .2, 1);--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4, 0, .2, 1);--default-font-family:var(--font-sans);--default-mono-font-family:var(--font-mono)}}@layer base{*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;tab-size:4;line-height:1.5;font-family:var(--default-font-family,ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring{outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::placeholder{opacity:1}@supports (not ((-webkit-appearance:-apple-pay-button))) or (contain-intrinsic-size:1px){::placeholder{color:currentColor}@supports (color:color-mix(in lab, red, red)){::placeholder{color:color-mix(in oklab, currentcolor 50%, transparent)}}}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}::-webkit-calendar-picker-indicator{line-height:1}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){appearance:button}::file-selector-button{appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}}@layer components;@layer utilities{.pointer-events-none{pointer-events:none}.collapse{visibility:collapse}.invisible{visibility:hidden}.visible{visibility:visible}.absolute{position:absolute}.fixed{position:fixed}.relative{position:relative}.static{position:static}.sticky{position:sticky}.start{inset-inline-start:var(--spacing)}.end{inset-inline-end:var(--spacing)}.top-1\/2{top:50%}.top-2{top:calc(var(--spacing) * 2)}.top-8{top:calc(var(--spacing) * 8)}.right-0{right:calc(var(--spacing) * 0)}.right-1\.5{right:calc(var(--spacing) * 1.5)}.right-2{right:calc(var(--spacing) * 2)}.left-0{left:calc(var(--spacing) * 0)}.left-2{left:calc(var(--spacing) * 2)}.z-10{z-index:10}.z-50{z-index:50}.row-1{grid-row:1}.container{width:100%}@media (width>=40rem){.container{max-width:40rem}}@media (width>=48rem){.container{max-width:48rem}}@media (width>=64rem){.container{max-width:64rem}}@media (width>=80rem){.container{max-width:80rem}}@media (width>=96rem){.container{max-width:96rem}}.mx-3{margin-inline:calc(var(--spacing) * 3)}.mt-0\.5{margin-top:calc(var(--spacing) * .5)}.mt-1{margin-top:calc(var(--spacing) * 1)}.mt-2{margin-top:calc(var(--spacing) * 2)}.mb-0\.5{margin-bottom:calc(var(--spacing) * .5)}.mb-1{margin-bottom:calc(var(--spacing) * 1)}.mb-2{margin-bottom:calc(var(--spacing) * 2)}.block{display:block}.contents{display:contents}.flex{display:flex}.grid{display:grid}.hidden{display:none}.inline{display:inline}.inline-block{display:inline-block}.inline-flex{display:inline-flex}.table{display:table}.h-full{height:100%}.w-full{width:100%}.min-w-0{min-width:calc(var(--spacing) * 0)}.flex-1{flex:1}.shrink-0{flex-shrink:0}.transform{transform:var(--tw-rotate-x,) var(--tw-rotate-y,) var(--tw-rotate-z,) var(--tw-skew-x,) var(--tw-skew-y,)}.resize{resize:both}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.items-start{align-items:flex-start}.items-stretch{align-items:stretch}.justify-between{justify-content:space-between}.justify-center{justify-content:center}.justify-end{justify-content:flex-end}.gap-1{gap:calc(var(--spacing) * 1)}.gap-1\.5{gap:calc(var(--spacing) * 1.5)}.gap-2{gap:calc(var(--spacing) * 2)}.gap-3{gap:calc(var(--spacing) * 3)}.gap-4{gap:calc(var(--spacing) * 4)}.truncate{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-y-auto{overflow-y:auto}.rounded{border-radius:.25rem}.rounded-sm{border-radius:var(--radius-sm)}.rounded-r{border-top-right-radius:.25rem;border-bottom-right-radius:.25rem}.border{border-style:var(--tw-border-style);border-width:1px}.p-1{padding:calc(var(--spacing) * 1)}.p-2{padding:calc(var(--spacing) * 2)}.px-1\.5{padding-inline:calc(var(--spacing) * 1.5)}.px-2{padding-inline:calc(var(--spacing) * 2)}.px-2\.5{padding-inline:calc(var(--spacing) * 2.5)}.px-3{padding-inline:calc(var(--spacing) * 3)}.px-4{padding-inline:calc(var(--spacing) * 4)}.py-0\.5{padding-block:calc(var(--spacing) * .5)}.py-1{padding-block:calc(var(--spacing) * 1)}.py-1\.5{padding-block:calc(var(--spacing) * 1.5)}.py-2{padding-block:calc(var(--spacing) * 2)}.py-3{padding-block:calc(var(--spacing) * 3)}.py-4{padding-block:calc(var(--spacing) * 4)}.pr-3{padding-right:calc(var(--spacing) * 3)}.pb-3{padding-bottom:calc(var(--spacing) * 3)}.pb-4{padding-bottom:calc(var(--spacing) * 4)}.pl-7{padding-left:calc(var(--spacing) * 7)}.text-center{text-align:center}.text-left{text-align:left}.font-mono{font-family:var(--font-mono)}.text-sm{font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height))}.text-xs{font-size:var(--text-xs);line-height:var(--tw-leading,var(--text-xs--line-height))}.font-bold{--tw-font-weight:var(--font-weight-bold);font-weight:var(--font-weight-bold)}.font-semibold{--tw-font-weight:var(--font-weight-semibold);font-weight:var(--font-weight-semibold)}.tracking-wider{--tw-tracking:var(--tracking-wider);letter-spacing:var(--tracking-wider)}.break-all{word-break:break-all}.whitespace-pre-wrap{white-space:pre-wrap}.uppercase{text-transform:uppercase}.italic{font-style:italic}.shadow-xl{--tw-shadow:0 20px 25px -5px var(--tw-shadow-color,#0000001a), 0 8px 10px -6px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.ring{--tw-ring-shadow:var(--tw-ring-inset,) 0 0 0 calc(1px + var(--tw-ring-offset-width)) var(--tw-ring-color,currentcolor);box-shadow:var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow)}.outline{outline-style:var(--tw-outline-style);outline-width:1px}.invert{--tw-invert:invert(100%);filter:var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,)}.filter{filter:var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,)}.transition{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to,opacity,box-shadow,transform,translate,scale,rotate,filter,-webkit-backdrop-filter,backdrop-filter,display,content-visibility,overlay,pointer-events;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-colors{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.ease-in-out{--tw-ease:var(--ease-in-out);transition-timing-function:var(--ease-in-out)}.select-none{-webkit-user-select:none;user-select:none}.\[file\:line\]{file:line}@media (width>=48rem){.md\:hidden{display:none}}}:root{--ctp-base:#1e1e2e;--ctp-mantle:#181825;--ctp-crust:#11111b;--ctp-surface0:#313244;--ctp-surface1:#45475a;--ctp-surface2:#585b70;--ctp-overlay0:#6c7086;--ctp-overlay1:#7f849c;--ctp-text:#cdd6f4;--ctp-subtext0:#a6adc8;--ctp-subtext1:#bac2de;--ctp-blue:#89b4fa;--ctp-green:#a6e3a1;--ctp-yellow:#f9e2af;--ctp-peach:#fab387;--ctp-mauve:#cba6f7;--ctp-teal:#94e2d5;--ctp-red:#f38ba8;--ctp-pink:#f5c2e7;--ctp-lavender:#b4befe;--ctp-sky:#89dceb;--color-read:var(--ctp-blue);--color-write:var(--ctp-green);--color-edit:var(--ctp-yellow);--color-bash:var(--ctp-peach);--color-agent:var(--ctp-mauve);--color-grep:var(--ctp-teal);--color-error:var(--ctp-red);--color-running:var(--ctp-pink);--color-monitor:var(--ctp-sky)}body{background-color:var(--ctp-base);color:var(--ctp-text);font-family:SF Mono,Cascadia Code,JetBrains Mono,Fira Code,ui-monospace,monospace}@keyframes skeleton-shimmer{0%,to{opacity:.6}50%{opacity:.3}}@keyframes pulse-edge{0%,to{opacity:.6}50%{opacity:.1}}.running-pulse{animation:1.2s ease-in-out infinite pulse-edge}@keyframes noc-pulse{0%,to{opacity:1;transform:scale(1)}50%{opacity:.4;transform:scale(.85)}}@keyframes noc-blink{0%,to{opacity:1}50%{opacity:0}}@media (width<=768px){.hidden-mobile{display:none!important}}.sidebar-panel{background-color:var(--ctp-mantle);flex-direction:column;flex-shrink:0;width:240px;display:flex;overflow:hidden}@media (width<=767px){.sidebar-panel{width:240px;transition:transform .2s;position:fixed;top:0;bottom:0;left:0;transform:translate(-100%)}.sidebar-panel[data-open=true]{transform:translate(0)}}@property --tw-rotate-x{syntax:"*";inherits:false}@property --tw-rotate-y{syntax:"*";inherits:false}@property --tw-rotate-z{syntax:"*";inherits:false}@property --tw-skew-x{syntax:"*";inherits:false}@property --tw-skew-y{syntax:"*";inherits:false}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-font-weight{syntax:"*";inherits:false}@property --tw-tracking{syntax:"*";inherits:false}@property --tw-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-shadow-color{syntax:"*";inherits:false}@property --tw-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-inset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-shadow-color{syntax:"*";inherits:false}@property --tw-inset-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-ring-color{syntax:"*";inherits:false}@property --tw-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-ring-color{syntax:"*";inherits:false}@property --tw-inset-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-ring-inset{syntax:"*";inherits:false}@property --tw-ring-offset-width{syntax:"<length>";inherits:false;initial-value:0}@property --tw-ring-offset-color{syntax:"*";inherits:false;initial-value:#fff}@property --tw-ring-offset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-outline-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-blur{syntax:"*";inherits:false}@property --tw-brightness{syntax:"*";inherits:false}@property --tw-contrast{syntax:"*";inherits:false}@property --tw-grayscale{syntax:"*";inherits:false}@property --tw-hue-rotate{syntax:"*";inherits:false}@property --tw-invert{syntax:"*";inherits:false}@property --tw-opacity{syntax:"*";inherits:false}@property --tw-saturate{syntax:"*";inherits:false}@property --tw-sepia{syntax:"*";inherits:false}@property --tw-drop-shadow{syntax:"*";inherits:false}@property --tw-drop-shadow-color{syntax:"*";inherits:false}@property --tw-drop-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-drop-shadow-size{syntax:"*";inherits:false}@property --tw-ease{syntax:"*";inherits:false}

package/dist/client/index.html

@@ -7,8 +7,8 @@
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;600;700&display=swap" rel="stylesheet" />
-    <script type="module" crossorigin src="/assets/index-C0dmCjnv.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-DYum71Dc.css">
+    <script type="module" crossorigin src="/assets/index-BGW0xA7n.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-DlKrxvV-.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/server/server/rollup.js

@@ -1,12 +1,15 @@
 /**
  * Cross-session Patterns rollup orchestrator.
- * Lists session JSONL files, applies mtime pre-filter, parses + caches each,
+ * Iterates registered providers, calls listSessions + readSession for each,
  * and folds results into a PatternsResponse.
+ *
+ * Phase B: uses the Provider registry instead of walking ~/.claude/projects/ directly.
  */
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import os from 'node:os';
-import { parseJsonlContent } from '../shared/parser.js';
+import { listProviders } from '../shared/providers/index.js';
+import { createClaudeCodeProvider } from '../shared/providers/claude-code.js';
 import { buildSessionSummaryFromContent, } from '../shared/session-summary.js';
 // ---------------------------------------------------------------------------
 // Window math
@@ -112,56 +115,6 @@ function deslugify(slug, username) {
     }
     return '/' + parts.join('/');
 }
-/** List all *.jsonl session files under projectsDir with their mtime. */
-async function listSessionFiles(projectsDir) {
-    const result = [];
-    let slugs;
-    try {
-        slugs = await fs.readdir(projectsDir);
-    }
-    catch {
-        // Directory doesn't exist — graceful degradation
-        return result;
-    }
-    for (const slug of slugs) {
-        const slugPath = path.join(projectsDir, slug);
-        let slugStat;
-        try {
-            slugStat = await fs.stat(slugPath);
-        }
-        catch {
-            continue;
-        }
-        if (!slugStat.isDirectory())
-            continue;
-        let files;
-        try {
-            files = await fs.readdir(slugPath);
-        }
-        catch {
-            continue;
-        }
-        for (const file of files) {
-            if (!file.endsWith('.jsonl'))
-                continue;
-            const filePath = path.join(slugPath, file);
-            let fstat;
-            try {
-                fstat = await fs.stat(filePath);
-            }
-            catch {
-                continue;
-            }
-            result.push({
-                filePath,
-                slug,
-                sessionId: file.replace(/\.jsonl$/, ''),
-                mtimeMs: fstat.mtimeMs,
-            });
-        }
-    }
-    return result;
-}
 // ---------------------------------------------------------------------------
 // Main export
 // ---------------------------------------------------------------------------
@@ -170,47 +123,88 @@ async function listSessionFiles(projectsDir) {
  *
  * @param window  - 'today' | '7d' | '30d'
  * @param cache   - mtime-invalidated summary cache
- * @param claudeHome - defaults to CLAUDE_HOME env or ~/.claude
+ * @param claudeHome - optional override; when provided a temporary claude-code
+ *   provider is created for that home directory (used in tests)
  * @param now     - injectable for tests; defaults to Date.now()
  */
 export async function computeRollup(window, cache, claudeHome, now) {
     const nowMs = now ?? Date.now();
     const home = claudeHome ?? (process.env['CLAUDE_HOME'] ?? path.join(os.homedir(), '.claude'));
-    const projectsDir = path.join(home, 'projects');
     const username = os.userInfo().username;
     const bounds = computeWindow(window, nowMs);
     const { startMs, endMs, prevStartMs, prevEndMs } = bounds;
     const MS_PER_DAY = 86_400_000;
-    // List all session files
-    const allFiles = await listSessionFiles(projectsDir);
-    // Pre-filter by mtime: include files whose mtime is within window + 1-day slack
-    // This is a fast pre-filter; we still check session startMs after parsing.
-    const preFilterStart = prevStartMs - MS_PER_DAY;
-    const currentCandidates = allFiles.filter((f) => f.mtimeMs >= preFilterStart && f.mtimeMs <= endMs + MS_PER_DAY);
-    // Parse + cache each file
+    // Use a provider scoped to the requested claudeHome when an override is provided
+    // (tests pass a tmpHome); otherwise use the global registry.
+    const providers = claudeHome
+        ? [createClaudeCodeProvider(claudeHome)]
+        : listProviders();
+    // Collect session records from all providers
+    // We use a wider window for listing so the pre-filter + previous window both work.
+    const listWindow = {
+        startMs: prevStartMs - MS_PER_DAY,
+        endMs: endMs + MS_PER_DAY,
+    };
+    const allRecords = [];
+    for (const provider of providers) {
+        let sessions;
+        try {
+            sessions = await provider.listSessions(listWindow);
+        }
+        catch {
+            // If a provider fails to list, skip it gracefully
+            continue;
+        }
+        for (const meta of sessions) {
+            // Derive the file path from rawSlug for Claude Code cache-key purposes.
+            // rawSlug format: '<projectSlug>/<sessionId>'
+            const slashIdx = meta.rawSlug.indexOf('/');
+            if (slashIdx === -1)
+                continue;
+            const slug = meta.rawSlug.slice(0, slashIdx);
+            const sessionId = meta.rawSlug.slice(slashIdx + 1);
+            const filePath = path.join(home, 'projects', slug, `${sessionId}.jsonl`);
+            const mtimeMs = meta.endMs ?? meta.startMs;
+            allRecords.push({
+                cacheKey: `${provider.id}:${meta.rawSlug}`,
+                filePath,
+                rawSlug: meta.rawSlug,
+                slug,
+                sessionId,
+                mtimeMs,
+                provider,
+            });
+        }
+    }
+    // Parse + cache each session
     const errors = [];
-    const parsed = await runChunked(currentCandidates.map((sf) => async () => {
-        const { summary, error } = await cache.getOrBuild(sf.filePath, async () => {
-            let content;
+    const parsed = await runChunked(allRecords.map((sr) => async () => {
+        // Use the file path as cache key for mtime-based invalidation.
+        // The build function reads the file and delegates to the provider for parsing.
+        const { summary, error } = await cache.getOrBuild(sr.filePath, async () => {
+            // Read raw content for accurate compaction boundary counting.
+            let rawContent;
             try {
-                content = await fs.readFile(sf.filePath, 'utf8');
+                rawContent = await fs.readFile(sr.filePath, 'utf8');
             }
             catch (err) {
                 throw new Error(err instanceof Error ? err.message : String(err));
             }
-            const rows = parseJsonlContent(content);
-            return buildSessionSummaryFromContent(rows, sf.sessionId, sf.slug, content);
+            // Use the provider to parse into WaterfallRow[] for consistency.
+            const session = await sr.provider.readSession(sr.rawSlug);
+            const rows = session.native;
+            return buildSessionSummaryFromContent(rows, sr.sessionId, sr.slug, rawContent);
         });
-        return { sf, summary, error };
+        return { sr, summary, error };
     }), 20);
     // Collect errors and filter out failed parses
     const summaries = [];
     for (const item of parsed) {
         if (item.error && item.summary === null) {
-            errors.push({ path: item.sf.filePath, reason: item.error });
+            errors.push({ path: item.sr.filePath, reason: item.error });
         }
         else if (item.summary !== null) {
-            summaries.push({ sf: item.sf, summary: item.summary });
+            summaries.push({ sr: item.sr, summary: item.summary });
         }
     }
     // Separate current vs previous window by session start time

package/dist/server/server/routes/api.js

@@ -1,18 +1,22 @@
 /**
  * REST API routes for project and session data.
- * All data is read from JSONL files on disk — no in-memory caching.
+ * All data is read from JSONL files on disk via the Provider registry.
+ * Phase B: session reads are routed through getProvider() instead of calling
+ * parseJsonlContent directly. Raw file content is still read separately for
+ * enrichments not yet in the Provider interface (compaction, drift, tips, etc.).
  */
 import express, { Router } from 'express';
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { WebSocket } from 'ws';
-import { parseJsonlContent, parseCompactionBoundaries, extractSessionId, extractSessionTitle, extractAgentIds, parseSubAgentContent, parseInstructionsLoaded, } from '../../shared/parser.js';
+import { parseCompactionBoundaries, extractSessionId, extractSessionTitle, extractAgentIds, parseSubAgentContent, parseInstructionsLoaded, } from '../../shared/parser.js';
 import { parseSessionResultMetrics, parseInitContext } from '../../shared/session-metadata.js';
 import { computeContextHealth } from '../../shared/health.js';
 import { parseAssistantTurns, computeDrift } from '../../shared/drift.js';
 import { attachEfficiencyTips } from '../../shared/tips.js';
 import { attachSecurityTips } from '../../shared/security-tips.js';
 import { sessionToOtlp } from '../../shared/otlp-export.js';
+import { createClaudeCodeProvider } from '../../shared/providers/claude-code.js';
 /**
  * Read ~/.claude/sessions/*.json and return a Set of sessionIds
  * whose PID is still a running claude process.
@@ -63,13 +67,19 @@ function assertWithinBase(resolved, base) {
 /**
  * Build the Express router, scoped to a given Claude home directory.
  * `wss` is the WebSocketServer instance used to broadcast hook events to
- * all connected browser clients.
+ * all connected browser clients. Optional in tests that only exercise
+ * non-WebSocket endpoints.
  */
 export function buildApiRouter(claudeHome, wss) {
     const router = Router();
     const projectsDir = path.join(claudeHome, 'projects');
     const teamsDir = path.join(claudeHome, 'teams');
     const tasksDir = path.join(claudeHome, 'tasks');
+    /**
+     * Provider scoped to this router's claudeHome.
+     * Used by session-read endpoints to route through the Provider abstraction.
+     */
+    const sessionProvider = createClaudeCodeProvider(claudeHome);
     /**
      * In-memory registry of MCP-registered session paths.
      * Populated by POST /api/sessions/register; cleared on unregister or server restart.
@@ -80,6 +90,8 @@ export function buildApiRouter(claudeHome, wss) {
     const dockerHeartbeats = new Map();
     /** Broadcast a message to all connected WebSocket clients. */
     function broadcast(msg) {
+        if (!wss)
+            return;
         const payload = JSON.stringify(msg);
         for (const client of wss.clients) {
             if (client.readyState === WebSocket.OPEN) {
@@ -420,15 +432,18 @@ export function buildApiRouter(claudeHome, wss) {
             return;
         }
         try {
+            // Use the provider to read session rows; fall back to 404 when not found.
+            let rows;
             let content;
             try {
                 content = await fs.readFile(filePath, 'utf8');
+                const session = await sessionProvider.readSession(`${slug}/${id}`);
+                rows = session.native;
             }
             catch {
                 res.status(404).json({ error: `Session not found: ${slug}/${id}` });
                 return;
             }
-            const rows = parseJsonlContent(content);
             const sessionId = extractSessionId(content) ?? id;
             const otlp = sessionToOtlp(rows, sessionId);
             res.setHeader('Content-Type', 'application/json');
@@ -457,15 +472,19 @@ export function buildApiRouter(claudeHome, wss) {
             return;
         }
         try {
+            // Use the provider to read session rows; fall back to 404 when not found.
+            let rows;
             let content;
             try {
+                // Read raw content for compaction/drift/tips analysis (not in Provider interface yet)
                 content = await fs.readFile(filePath, 'utf8');
+                const session = await sessionProvider.readSession(`${slug}/${id}`);
+                rows = session.native;
             }
             catch {
                 res.status(404).json({ error: `Session not found: ${slug}/${id}` });
                 return;
             }
-            const rows = parseJsonlContent(content);
             const boundaries = parseCompactionBoundaries(content);
             const health = computeContextHealth(rows, boundaries.length);
             const sessionId = extractSessionId(content) ?? id;
@@ -669,7 +688,7 @@ export function buildApiRouter(claudeHome, wss) {
             };
             // For SubagentStart events, broadcast a separate message type
             // so the client can show an in-progress agent row immediately
-            if (event.hook_event_name === 'SubagentStart' && event.agent_id) {
+            if (event.hook_event_name === 'SubagentStart' && event.agent_id && wss) {
                 const subagentMsg = {
                     type: 'subagent-start',
                     agentId: event.agent_id,
@@ -685,9 +704,11 @@ export function buildApiRouter(claudeHome, wss) {
             }
             const message = { type: 'hook-event', event };
             const payload = JSON.stringify(message);
-            for (const client of wss.clients) {
-                if (client.readyState === WebSocket.OPEN) {
-                    client.send(payload);
+            if (wss) {
+                for (const client of wss.clients) {
+                    if (client.readyState === WebSocket.OPEN) {
+                        client.send(payload);
+                    }
                 }
             }
             res.json({ ok: true });

package/dist/server/server/ws.js

@@ -1,6 +1,11 @@
 /**
  * WebSocket handler for real-time session event streaming.
  * Mounts at /ws. One watcher per connection, cleaned up on disconnect.
+ *
+ * Phase B: the top-level directory watcher that broadcasts session-created
+ * events is now driven by provider.watch() from the Provider registry.
+ * Per-connection file watchers (watchSession / watchSubAgent) remain as-is
+ * since they do incremental row parsing not yet part of the Provider interface.
  */
 import { WebSocketServer, WebSocket } from 'ws';
 import { spawn } from 'node:child_process';
@@ -9,6 +14,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { watchSession, watchSubAgent } from './watcher.js';
 import { extractAgentIds } from '../shared/parser.js';
+import { createClaudeCodeProvider } from '../shared/providers/claude-code.js';
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
@@ -54,22 +60,16 @@ export function setupWebSocket(server, claudeHome) {
     });
     // Suppress unhandled WSS errors during port retry (EADDRINUSE propagates here)
     wss.on('error', () => { });
-    // Watch the projects directory for new .jsonl session files.
-    // When a new file appears, broadcast to all connected clients so they
-    // can refresh their session list without a manual page reload.
-    const projectsBase = path.join(claudeHome, 'projects');
-    const dirWatcher = chokidar.watch(projectsBase, {
-        persistent: true,
-        ignoreInitial: true,
-        depth: 1,
-    });
-    dirWatcher.on('add', (filePath) => {
-        if (!filePath.endsWith('.jsonl'))
+    // Watch the projects directory via the provider's watch() interface.
+    // session-added events map to session-created WebSocket broadcasts.
+    const dirProvider = createClaudeCodeProvider(claudeHome);
+    const unsubscribeDir = dirProvider.watch((event) => {
+        if (event.kind !== 'session-added')
             return;
-        // Derive the project slug from the parent directory name
-        const relative = path.relative(projectsBase, filePath);
-        const slug = path.dirname(relative);
-        if (!slug || slug === '.')
+        // sessionId for claude-code is '<projectSlug>/<fileId>'
+        const slashIdx = event.sessionId.indexOf('/');
+        const slug = slashIdx !== -1 ? event.sessionId.slice(0, slashIdx) : event.sessionId;
+        if (!slug)
             return;
         const msg = { type: 'session-created', slug };
         const payload = JSON.stringify(msg);
@@ -79,11 +79,8 @@ export function setupWebSocket(server, claudeHome) {
             }
         }
     });
-    dirWatcher.on('error', (err) => {
-        console.warn('[noctrace] dir watcher error:', err instanceof Error ? err.message : String(err));
-    });
     wss.on('close', () => {
-        dirWatcher.close().catch(() => { });
+        unsubscribeDir();
     });
     wss.on('connection', (ws, _req) => {
         let stopWatcher = null;