noctrace 1.1.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-D3XepZ5e.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-DwPuae45.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/index.js

@@ -7,6 +7,7 @@ import { createServer } from 'node:http';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { buildApiRouter } from './routes/api.js';
+import { buildPatternsRouter } from './routes/patterns.js';
 import { setupWebSocket } from './ws.js';
 import { getClaudeHome } from './config.js';
 const BASE_PORT = parseInt(process.env['PORT'] ?? '4117', 10);
@@ -22,6 +23,7 @@ export function startServer() {
     app.use(express.json());
     const wss = setupWebSocket(server, claudeHome);
     app.use('/api', buildApiRouter(claudeHome, wss));
+    app.use('/api/patterns', buildPatternsRouter(claudeHome));
     app.get('/api/health', (_req, res) => {
         res.json({ status: 'ok' });
     });

package/dist/server/server/rollup.js

@@ -0,0 +1,330 @@
+/**
+ * Cross-session Patterns rollup orchestrator.
+ * 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 { listProviders } from '../shared/providers/index.js';
+import { createClaudeCodeProvider } from '../shared/providers/claude-code.js';
+import { buildSessionSummaryFromContent, } from '../shared/session-summary.js';
+// ---------------------------------------------------------------------------
+// Window math
+// ---------------------------------------------------------------------------
+/** Start of the local calendar day containing `nowMs`, in local time. */
+function startOfDay(nowMs) {
+    const d = new Date(nowMs);
+    d.setHours(0, 0, 0, 0);
+    return d.getTime();
+}
+/** Compute window bounds using calendar semantics in server-local time. */
+function computeWindow(kind, now) {
+    const todayStart = startOfDay(now);
+    const MS_PER_DAY = 86_400_000;
+    let startMs;
+    let spanDays;
+    if (kind === 'today') {
+        startMs = todayStart;
+        spanDays = 1;
+    }
+    else if (kind === '7d') {
+        startMs = todayStart - 6 * MS_PER_DAY;
+        spanDays = 7;
+    }
+    else {
+        startMs = todayStart - 29 * MS_PER_DAY;
+        spanDays = 30;
+    }
+    const endMs = now;
+    const prevEndMs = startMs;
+    const prevStartMs = startMs - spanDays * MS_PER_DAY;
+    const label = formatDateRange(startMs, endMs);
+    return { startMs, endMs, prevStartMs, prevEndMs, label };
+}
+/** Format a date range as "Apr 7 – Apr 14, 2026". */
+function formatDateRange(startMs, endMs) {
+    const fmt = (ms, withYear) => {
+        const d = new Date(ms);
+        const months = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',
+            'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+        const base = `${months[d.getMonth()]} ${d.getDate()}`;
+        return withYear ? `${base}, ${d.getFullYear()}` : base;
+    };
+    const start = new Date(startMs);
+    const end = new Date(endMs);
+    const sameYear = start.getFullYear() === end.getFullYear();
+    return `${fmt(startMs, false)} \u2013 ${fmt(endMs, sameYear)}`;
+}
+// ---------------------------------------------------------------------------
+// Percentile helper
+// ---------------------------------------------------------------------------
+/** Compute the p-th percentile (0..100) of a numeric array via linear interpolation. */
+function percentile(arr, p) {
+    if (arr.length === 0)
+        return 0;
+    const sorted = [...arr].sort((a, b) => a - b);
+    if (p <= 0)
+        return sorted[0];
+    if (p >= 100)
+        return sorted[sorted.length - 1];
+    const idx = (p / 100) * (sorted.length - 1);
+    const lo = Math.floor(idx);
+    const hi = Math.ceil(idx);
+    if (lo === hi)
+        return sorted[lo];
+    return sorted[lo] + (idx - lo) * (sorted[hi] - sorted[lo]);
+}
+// ---------------------------------------------------------------------------
+// Bounded-concurrency parallel execution
+// ---------------------------------------------------------------------------
+/** Run `tasks` in parallel chunks of `concurrency`. */
+async function runChunked(tasks, concurrency) {
+    const results = [];
+    for (let i = 0; i < tasks.length; i += concurrency) {
+        const chunk = tasks.slice(i, i + concurrency).map((t) => t());
+        const batch = await Promise.all(chunk);
+        results.push(...batch);
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Project de-slugification
+// ---------------------------------------------------------------------------
+/**
+ * Convert a Claude project slug to a human-readable path.
+ * Algorithm: split on `-`, drop empty leading segment.
+ * If first segment is `Users` and second matches the current user's username,
+ * replace with `~`; otherwise join with `/`.
+ */
+function deslugify(slug, username) {
+    // Slugs use `-` as separator but project paths can contain hyphens too.
+    // The slug is produced by replacing `/` with `-` in the absolute path,
+    // e.g. /Users/lam/dev/noctrace → -Users-lam-dev-noctrace
+    const parts = slug.split('-');
+    // Drop the leading empty string before the first `-`
+    if (parts[0] === '')
+        parts.shift();
+    if (parts.length === 0)
+        return slug;
+    if (parts[0] === 'Users' && parts[1] === username) {
+        // Replace /Users/<user> with ~
+        return '~/' + parts.slice(2).join('/');
+    }
+    return '/' + parts.join('/');
+}
+// ---------------------------------------------------------------------------
+// Main export
+// ---------------------------------------------------------------------------
+/**
+ * Compute the cross-session Patterns rollup for the given time window.
+ *
+ * @param window  - 'today' | '7d' | '30d'
+ * @param cache   - mtime-invalidated summary cache
+ * @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 username = os.userInfo().username;
+    const bounds = computeWindow(window, nowMs);
+    const { startMs, endMs, prevStartMs, prevEndMs } = bounds;
+    const MS_PER_DAY = 86_400_000;
+    // 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(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 {
+                rawContent = await fs.readFile(sr.filePath, 'utf8');
+            }
+            catch (err) {
+                throw new Error(err instanceof Error ? err.message : String(err));
+            }
+            // 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 { 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.sr.filePath, reason: item.error });
+        }
+        else if (item.summary !== null) {
+            summaries.push({ sr: item.sr, summary: item.summary });
+        }
+    }
+    // Separate current vs previous window by session start time
+    const currentSummaries = summaries.filter(({ summary }) => summary.startMs >= startMs && summary.startMs < endMs);
+    const prevSummaries = summaries.filter(({ summary }) => summary.startMs >= prevStartMs && summary.startMs < prevEndMs);
+    // --- Health distribution ---
+    const emptyDist = () => ({ A: 0, B: 0, C: 0, D: 0, F: 0 });
+    const currentDist = emptyDist();
+    for (const { summary } of currentSummaries) {
+        if (summary.healthGrade)
+            currentDist[summary.healthGrade]++;
+    }
+    const prevDist = emptyDist();
+    for (const { summary } of prevSummaries) {
+        if (summary.healthGrade)
+            prevDist[summary.healthGrade]++;
+    }
+    const projectBuckets = new Map();
+    for (const { summary } of currentSummaries) {
+        const bucket = projectBuckets.get(summary.projectSlug);
+        if (bucket) {
+            bucket.sessions.push(summary);
+        }
+        else {
+            projectBuckets.set(summary.projectSlug, { sessions: [summary] });
+        }
+    }
+    const BAD_GRADES = new Set(['D', 'F']);
+    const rotLeaderboard = [];
+    for (const [slug, bucket] of projectBuckets) {
+        const sessions = bucket.sessions;
+        const badSessions = sessions.filter((s) => s.healthGrade && BAD_GRADES.has(s.healthGrade));
+        const bad = badSessions.length;
+        const badPct = sessions.length > 0 ? bad / sessions.length : 0;
+        const totalCompactions = sessions.reduce((sum, s) => sum + s.compactionCount, 0);
+        const avgCompactions = sessions.length > 0 ? totalCompactions / sessions.length : 0;
+        // Worst session = lowest healthScore among sessions with a score
+        let worstSessionId = null;
+        let lowestScore = Infinity;
+        for (const s of sessions) {
+            if (s.healthScore !== null && s.healthScore < lowestScore) {
+                lowestScore = s.healthScore;
+                worstSessionId = s.sessionId;
+            }
+        }
+        rotLeaderboard.push({
+            project: deslugify(slug, username),
+            rawSlug: slug,
+            sessions: sessions.length,
+            bad,
+            badPct,
+            avgCompactions,
+            worstSessionId,
+        });
+    }
+    // Sort by badPct descending, then calls descending as tiebreaker
+    rotLeaderboard.sort((a, b) => {
+        if (b.badPct !== a.badPct)
+            return b.badPct - a.badPct;
+        return b.sessions - a.sessions;
+    });
+    // --- Tool health ---
+    // Aggregate tool stats from current window
+    const toolAgg = new Map();
+    for (const { summary } of currentSummaries) {
+        for (const [tool, count] of Object.entries(summary.toolCounts)) {
+            const agg = toolAgg.get(tool) ?? { calls: 0, failures: 0, latencies: [] };
+            agg.calls += count;
+            agg.failures += summary.toolFailures[tool] ?? 0;
+            agg.latencies.push(...(summary.toolLatencies[tool] ?? []));
+            toolAgg.set(tool, agg);
+        }
+    }
+    // Aggregate call counts from previous window for delta
+    const prevToolCalls = new Map();
+    for (const { summary } of prevSummaries) {
+        for (const [tool, count] of Object.entries(summary.toolCounts)) {
+            prevToolCalls.set(tool, (prevToolCalls.get(tool) ?? 0) + count);
+        }
+    }
+    // Only include tools with >= 10 calls in current window
+    const toolHealth = [];
+    for (const [tool, agg] of toolAgg) {
+        if (agg.calls < 10)
+            continue;
+        toolHealth.push({
+            tool,
+            calls: agg.calls,
+            failures: agg.failures,
+            failPct: agg.calls > 0 ? agg.failures / agg.calls : 0,
+            p50ms: Math.round(percentile(agg.latencies, 50)),
+            p95ms: Math.round(percentile(agg.latencies, 95)),
+            callsPrev: prevToolCalls.get(tool) ?? 0,
+        });
+    }
+    // Sort by failPct descending, then calls descending
+    toolHealth.sort((a, b) => {
+        if (b.failPct !== a.failPct)
+            return b.failPct - a.failPct;
+        return b.calls - a.calls;
+    });
+    return {
+        window: {
+            kind: window,
+            startMs,
+            endMs,
+            prevStartMs,
+            prevEndMs,
+            label: bounds.label,
+        },
+        sessionCounts: {
+            current: currentSummaries.length,
+            previous: prevSummaries.length,
+        },
+        healthDist: {
+            current: currentDist,
+            previous: prevDist,
+        },
+        rotLeaderboard,
+        toolHealth,
+        errors,
+    };
+}

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/routes/patterns.js

@@ -0,0 +1,42 @@
+/**
+ * GET /api/patterns?window=today|7d|30d
+ * Returns a PatternsResponse aggregated across all sessions in the current
+ * Claude home directory within the requested time window.
+ */
+import { Router } from 'express';
+import { computeRollup } from '../rollup.js';
+import { createSummaryCache } from '../summary-cache.js';
+import { getClaudeHome } from '../config.js';
+const VALID_WINDOWS = new Set(['today', '7d', '30d']);
+// Module-level cache shared across requests (lives for the duration of the process)
+const summaryCache = createSummaryCache();
+/**
+ * Build the Express router for the patterns endpoint.
+ * Accepts an optional claudeHome override (used in tests).
+ */
+export function buildPatternsRouter(claudeHomeOverride) {
+    const router = Router();
+    /**
+     * GET /patterns
+     * Query params:
+     *   window — 'today' | '7d' | '30d' (default '7d')
+     */
+    router.get('/', async (req, res) => {
+        const raw = req.query['window'];
+        const windowKind = typeof raw === 'string' ? raw : '7d';
+        if (!VALID_WINDOWS.has(windowKind)) {
+            res.status(400).json({ error: `Invalid window "${windowKind}". Must be one of: today, 7d, 30d` });
+            return;
+        }
+        try {
+            const claudeHome = claudeHomeOverride ?? getClaudeHome();
+            const result = await computeRollup(windowKind, summaryCache, claudeHome);
+            res.json(result);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            res.status(500).json({ error: message });
+        }
+    });
+    return router;
+}

package/dist/server/server/summary-cache.js

@@ -0,0 +1,51 @@
+/**
+ * In-memory mtime-invalidated cache for per-session summaries.
+ * Stat-on-read strategy: no background watcher needed.
+ */
+import fs from 'node:fs/promises';
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+/**
+ * Create a new, empty {@link SummaryCache} instance.
+ */
+export function createSummaryCache() {
+    const store = new Map();
+    return {
+        async getOrBuild(filePath, build) {
+            // Stat the file to get current mtime
+            let statResult;
+            try {
+                statResult = await fs.stat(filePath);
+            }
+            catch {
+                // File not accessible — treat as invalidated
+                store.delete(filePath);
+                return { summary: null, error: 'stat-failed' };
+            }
+            const { mtimeMs } = statResult;
+            const cached = store.get(filePath);
+            if (cached !== undefined && cached.mtimeMs === mtimeMs) {
+                return { summary: cached.summary };
+            }
+            // Cache miss or stale — rebuild
+            let summary;
+            try {
+                summary = await build();
+            }
+            catch (err) {
+                const reason = err instanceof Error ? err.message : String(err);
+                // Do NOT cache failed builds — let the next call retry
+                return { summary: null, error: reason };
+            }
+            store.set(filePath, { mtimeMs, summary });
+            return { summary };
+        },
+        invalidate(filePath) {
+            store.delete(filePath);
+        },
+        size() {
+            return store.size;
+        },
+    };
+}