opengstack 0.13.10 → 0.14.0

package/skills/benchmark/SKILL.md.tmpl

@@ -1,222 +0,0 @@
----
-name: benchmark
-preamble-tier: 1
-version: 1.0.0
-description: |
-  Performance regression detection using the browse daemon. Establishes
-  baselines for page load times, Core Web Vitals, and resource sizes.
-  Compares before/after on every PR. Tracks performance trends over time.
-  Use when: "performance", "benchmark", "page speed", "lighthouse", "web vitals",
-  "bundle size", "load time".
-allowed-tools:
-  - Bash
-  - Read
-  - Write
-  - Glob
-  - AskUserQuestion
----
-
-{{PREAMBLE}}
-
-{{BROWSE_SETUP}}
-
-# /benchmark — Performance Regression Detection
-
-You are a **Performance Engineer** who has optimized apps serving millions of requests. You know that performance doesn't degrade in one big regression — it dies by a thousand paper cuts. Each PR adds 50ms here, 20KB there, and one day the app takes 8 seconds to load and nobody knows when it got slow.
-
-Your job is to measure, baseline, compare, and alert. You use the browse daemon's `perf` command and JavaScript evaluation to gather real performance data from running pages.
-
-## User-invocable
-When the user types `/benchmark`, run this skill.
-
-## Arguments
-- `/benchmark <url>` — full performance audit with baseline comparison
-- `/benchmark <url> --baseline` — capture baseline (run before making changes)
-- `/benchmark <url> --quick` — single-pass timing check (no baseline needed)
-- `/benchmark <url> --pages /,/dashboard,/api/health` — specify pages
-- `/benchmark --diff` — benchmark only pages affected by current branch
-- `/benchmark --trend` — show performance trends from historical data
-
-## Instructions
-
-### Phase 1: Setup
-
-```bash
-eval "$(~/.claude/skills/opengstack/bin/gstack-slug 2>/dev/null || echo "SLUG=unknown")"
-mkdir -p .gstack/benchmark-reports
-mkdir -p .gstack/benchmark-reports/baselines
-
-### Phase 2: Page Discovery
-
-Same as /canary — auto-discover from navigation or use `--pages`.
-
-If `--diff` mode:
-```bash
-git diff $(gh pr view --json baseRefName -q .baseRefName 2>/dev/null || gh repo view --json defaultBranchRef -q .defaultBranchRef.name 2>/dev/null || echo main)...HEAD --name-only
-
-### Phase 3: Performance Data Collection
-
-For each page, collect comprehensive performance metrics:
-
-```bash
-$B goto <page-url>
-$B perf
-
-Then gather detailed metrics via JavaScript:
-
-```bash
-$B eval "JSON.stringify(performance.getEntriesByType('navigation')[0])"
-
-Extract key metrics:
-- **TTFB** (Time to First Byte): `responseStart - requestStart`
-- **FCP** (First Contentful Paint): from PerformanceObserver or `paint` entries
-- **LCP** (Largest Contentful Paint): from PerformanceObserver
-- **DOM Interactive**: `domInteractive - navigationStart`
-- **DOM Complete**: `domComplete - navigationStart`
-- **Full Load**: `loadEventEnd - navigationStart`
-
-Resource analysis:
-```bash
-$B eval "JSON.stringify(performance.getEntriesByType('resource').map(r => ({name: r.name.split('/').pop().split('?')[0], type: r.initiatorType, size: r.transferSize, duration: Math.round(r.duration)})).sort((a,b) => b.duration - a.duration).slice(0,15))"
-
-Bundle size check:
-```bash
-$B eval "JSON.stringify(performance.getEntriesByType('resource').filter(r => r.initiatorType === 'script').map(r => ({name: r.name.split('/').pop().split('?')[0], size: r.transferSize})))"
-$B eval "JSON.stringify(performance.getEntriesByType('resource').filter(r => r.initiatorType === 'css').map(r => ({name: r.name.split('/').pop().split('?')[0], size: r.transferSize})))"
-
-Network summary:
-```bash
-$B eval "(() => { const r = performance.getEntriesByType('resource'); return JSON.stringify({total_requests: r.length, total_transfer: r.reduce((s,e) => s + (e.transferSize||0), 0), by_type: Object.entries(r.reduce((a,e) => { a[e.initiatorType] = (a[e.initiatorType]||0) + 1; return a; }, {})).sort((a,b) => b[1]-a[1])})})()"
-
-### Phase 4: Baseline Capture (--baseline mode)
-
-Save metrics to baseline file:
-
-```json
-{
-  "url": "<url>",
-  "timestamp": "<ISO>",
-  "branch": "<branch>",
-  "pages": {
-    "/": {
-      "ttfb_ms": 120,
-      "fcp_ms": 450,
-      "lcp_ms": 800,
-      "dom_interactive_ms": 600,
-      "dom_complete_ms": 1200,
-      "full_load_ms": 1400,
-      "total_requests": 42,
-      "total_transfer_bytes": 1250000,
-      "js_bundle_bytes": 450000,
-      "css_bundle_bytes": 85000,
-      "largest_resources": [
-        {"name": "main.js", "size": 320000, "duration": 180},
-        {"name": "vendor.js", "size": 130000, "duration": 90}
-      ]
-    }
-  }
-}
-
-Write to `.gstack/benchmark-reports/baselines/baseline.json`.
-
-### Phase 5: Comparison
-
-If baseline exists, compare current metrics against it:
-
-
-PERFORMANCE REPORT — [url]
-══════════════════════════
-Branch: [current-branch] vs baseline ([baseline-branch])
-
-Page: /
-─────────────────────────────────────────────────────
-Metric              Baseline    Current     Delta    Status
-────────            ────────    ───────     ─────    ──────
-TTFB                120ms       135ms       +15ms    OK
-FCP                 450ms       480ms       +30ms    OK
-LCP                 800ms       1600ms      +800ms   REGRESSION
-DOM Interactive     600ms       650ms       +50ms    OK
-DOM Complete        1200ms      1350ms      +150ms   WARNING
-Full Load           1400ms      2100ms      +700ms   REGRESSION
-Total Requests      42          58          +16      WARNING
-Transfer Size       1.2MB       1.8MB       +0.6MB   REGRESSION
-JS Bundle           450KB       720KB       +270KB   REGRESSION
-CSS Bundle          85KB        88KB        +3KB     OK
-
-REGRESSIONS DETECTED: 3
-  [1] LCP doubled (800ms → 1600ms) — likely a large new image or blocking resource
-  [2] Total transfer +50% (1.2MB → 1.8MB) — check new JS bundles
-  [3] JS bundle +60% (450KB → 720KB) — new dependency or missing tree-shaking
-
-**Regression thresholds:**
-- Timing metrics: >50% increase OR >500ms absolute increase = REGRESSION
-- Timing metrics: >20% increase = WARNING
-- Bundle size: >25% increase = REGRESSION
-- Bundle size: >10% increase = WARNING
-- Request count: >30% increase = WARNING
-
-### Phase 6: Slowest Resources
-
-
-TOP 10 SLOWEST RESOURCES
-═════════════════════════
-#   Resource                  Type      Size      Duration
-1   vendor.chunk.js          script    320KB     480ms
-2   main.js                  script    250KB     320ms
-3   hero-image.webp          img       180KB     280ms
-4   analytics.js             script    45KB      250ms    ← third-party
-5   fonts/inter-var.woff2    font      95KB      180ms
-...
-
-RECOMMENDATIONS:
-- vendor.chunk.js: Consider code-splitting — 320KB is large for initial load
-- analytics.js: Load async/defer — blocks rendering for 250ms
-- hero-image.webp: Add width/height to prevent CLS, consider lazy loading
-
-### Phase 7: Performance Budget
-
-Check against industry budgets:
-
-
-PERFORMANCE BUDGET CHECK
-════════════════════════
-Metric              Budget      Actual      Status
-────────            ──────      ──────      ──────
-FCP                 < 1.8s      0.48s       PASS
-LCP                 < 2.5s      1.6s        PASS
-Total JS            < 500KB     720KB       FAIL
-Total CSS           < 100KB     88KB        PASS
-Total Transfer      < 2MB       1.8MB       WARNING (90%)
-HTTP Requests       < 50        58          FAIL
-
-Grade: B (4/6 passing)
-
-### Phase 8: Trend Analysis (--trend mode)
-
-Load historical baseline files and show trends:
-
-
-PERFORMANCE TRENDS (last 5 benchmarks)
-══════════════════════════════════════
-Date        FCP     LCP     Bundle    Requests    Grade
-2026-03-10  420ms   750ms   380KB     38          A
-2026-03-12  440ms   780ms   410KB     40          A
-2026-03-14  450ms   800ms   450KB     42          A
-2026-03-16  460ms   850ms   520KB     48          B
-2026-03-18  480ms   1600ms  720KB     58          B
-
-TREND: Performance degrading. LCP doubled in 8 days.
-       JS bundle growing 50KB/week. Investigate.
-
-### Phase 9: Save Report
-
-Write to `.gstack/benchmark-reports/{date}-benchmark.md` and `.gstack/benchmark-reports/{date}-benchmark.json`.
-
-## Important Rules
-
-- **Measure, don't guess.** Use actual performance.getEntries() data, not estimates.
-- **Baseline is essential.** Without a baseline, you can report absolute numbers but can't detect regressions. Always encourage baseline capture.
-- **Relative thresholds, not absolute.** 2000ms load time is fine for a complex dashboard, terrible for a landing page. Compare against YOUR baseline.
-- **Third-party scripts are context.** Flag them, but the user can't fix Google Analytics being slow. Focus recommendations on first-party resources.
-- **Bundle size is the leading indicator.** Load time varies with network. Bundle size is deterministic. Track it religiously.
-- **Read-only.** Produce the report. Don't modify code unless explicitly asked.

package/skills/browse/SKILL.md.tmpl

@@ -1,131 +0,0 @@
----
-name: browse
-preamble-tier: 1
-version: 1.1.0
-description: |
-  Fast headless browser for QA testing and site dogfooding. Navigate any URL, interact with
-  elements, verify page state, diff before/after actions, take annotated screenshots, check
-  responsive layouts, test forms and uploads, handle dialogs, and assert element states.
-  ~100ms per command. Use when you need to test a feature, verify a deployment, dogfood a
-  user flow, or file a bug with evidence. Use when asked to "open in browser", "test the
-  site", "take a screenshot", or "dogfood this".
-allowed-tools:
-  - Bash
-  - Read
-  - AskUserQuestion
-
----
-
-{{PREAMBLE}}
-
-# browse: QA Testing & Dogfooding
-
-Persistent headless Chromium. First call auto-starts (~3s), then ~100ms per command.
-State persists between calls (cookies, tabs, login sessions).
-
-{{BROWSE_SETUP}}
-
-## Core QA Patterns
-
-### 1. Verify a page loads correctly
-```bash
-$B goto https://yourapp.com
-$B text                          # content loads?
-$B console                       # JS errors?
-$B network                       # failed requests?
-$B is visible ".main-content"    # key elements present?
-
-### 2. Test a user flow
-```bash
-$B goto https://app.com/login
-$B snapshot -i                   # see all interactive elements
-$B fill @e3 "user@test.com"
-$B fill @e4 "password"
-$B click @e5                     # submit
-$B snapshot -D                   # diff: what changed after submit?
-$B is visible ".dashboard"       # success state present?
-
-### 3. Verify an action worked
-```bash
-$B snapshot                      # baseline
-$B click @e3                     # do something
-$B snapshot -D                   # unified diff shows exactly what changed
-
-### 4. Visual evidence for bug reports
-```bash
-$B snapshot -i -a -o /tmp/annotated.png   # labeled screenshot
-$B screenshot /tmp/bug.png                # plain screenshot
-$B console                                # error log
-
-### 5. Find all clickable elements (including non-ARIA)
-```bash
-$B snapshot -C                   # finds divs with cursor:pointer, onclick, tabindex
-$B click @c1                     # interact with them
-
-### 6. Assert element states
-```bash
-$B is visible ".modal"
-$B is enabled "#submit-btn"
-$B is disabled "#submit-btn"
-$B is checked "#agree-checkbox"
-$B is editable "#name-field"
-$B is focused "#search-input"
-$B js "document.body.textContent.includes('Success')"
-
-### 7. Test responsive layouts
-```bash
-$B responsive /tmp/layout        # mobile + tablet + desktop screenshots
-$B viewport 375x812              # or set specific viewport
-$B screenshot /tmp/mobile.png
-
-### 8. Test file uploads
-```bash
-$B upload "#file-input" /path/to/file.pdf
-$B is visible ".upload-success"
-
-### 9. Test dialogs
-```bash
-$B dialog-accept "yes"           # set up handler
-$B click "#delete-button"        # trigger dialog
-$B dialog                        # see what appeared
-$B snapshot -D                   # verify deletion happened
-
-### 10. Compare environments
-```bash
-$B diff https://staging.app.com https://prod.app.com
-
-### 11. Show screenshots to the user
-After `$B screenshot`, `$B snapshot -a -o`, or `$B responsive`, always use the Read tool on the output PNG(s) so the user can see them. Without this, screenshots are invisible.
-
-## User Handoff
-
-When you hit something you can't handle in headless mode (CAPTCHA, complex auth, multi-factor
-login), hand off to the user:
-
-```bash
-# 1. Open a visible Chrome at the current page
-$B handoff "Stuck on CAPTCHA at login page"
-
-# 2. Tell the user what happened (via AskUserQuestion)
-#    "I've opened Chrome at the login page. Please solve the CAPTCHA
-#     and let me know when you're done."
-
-# 3. When user says "done", re-snapshot and continue
-$B resume
-
-**When to use handoff:**
-- CAPTCHAs or bot detection
-- Multi-factor authentication (SMS, authenticator app)
-- OAuth flows that require user interaction
-- Complex interactions the AI can't handle after 3 attempts
-
-The browser preserves all state (cookies, localStorage, tabs) across the handoff.
-After `resume`, you get a fresh snapshot of wherever the user left off.
-
-## Snapshot Flags
-
-{{SNAPSHOT_FLAGS}}
-
-## Full Command List
-
-{{COMMAND_REFERENCE}}

package/skills/browse/bin/find-browse

@@ -1,21 +0,0 @@
-#!/bin/bash
-# Shim: delegates to compiled find-browse binary, falls back to basic discovery.
-# The compiled binary handles git root detection for workspace-local installs.
-DIR="$(cd "$(dirname "$0")/.." && pwd)/dist"
-if test -x "$DIR/find-browse"; then
-  exec "$DIR/find-browse" "$@"
-fi
-# Fallback: basic discovery with priority chain
-ROOT=$(git rev-parse --show-toplevel 2>/dev/null)
-for MARKER in .codex .agents .claude; do
-  if [ -n "$ROOT" ] && test -x "$ROOT/$MARKER/skills/gstack/browse/dist/browse"; then
-    echo "$ROOT/$MARKER/skills/gstack/browse/dist/browse"
-    exit 0
-  fi
-  if test -x "$HOME/$MARKER/skills/gstack/browse/dist/browse"; then
-    echo "$HOME/$MARKER/skills/gstack/browse/dist/browse"
-    exit 0
-  fi
-done
-echo "ERROR: browse binary not found. Run: cd <skill-dir> && ./setup" >&2
-exit 1

package/skills/browse/bin/remote-slug

@@ -1,14 +0,0 @@
-#!/usr/bin/env bash
-# Output the remote slug (owner-repo) for the current git repo.
-# Used by SKILL.md files to derive project-specific paths in ~/.gstack/projects/.
-set -e
-URL=$(git remote get-url origin 2>/dev/null || true)
-if [ -n "$URL" ]; then
-  # Strip trailing .git if present, then extract owner/repo
-  URL="${URL%.git}"
-  # Handle both SSH (git@host:owner/repo) and HTTPS (https://host/owner/repo)
-  OWNER_REPO=$(echo "$URL" | sed -E 's#.*[:/]([^/]+)/([^/]+)$#\1-\2#')
-  echo "$OWNER_REPO"
-else
-  basename "$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
-fi

package/skills/browse/scripts/build-node-server.sh

@@ -1,48 +0,0 @@
-#!/usr/bin/env bash
-# Build a Node.js-compatible server bundle for Windows.
-#
-# On Windows, Bun can't launch or connect to Playwright's Chromium
-# (oven-sh/bun#4253, #9911). This script produces a server bundle
-# that runs under Node.js with Bun API polyfills.
-
-set -e
-
-GSTACK_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
-SRC_DIR="$GSTACK_DIR/browse/src"
-DIST_DIR="$GSTACK_DIR/browse/dist"
-
-echo "Building Node-compatible server bundle..."
-
-# Step 1: Transpile server.ts to a single .mjs bundle (externalize runtime deps)
-bun build "$SRC_DIR/server.ts" \
-  --target=node \
-  --outfile "$DIST_DIR/server-node.mjs" \
-  --external playwright \
-  --external playwright-core \
-  --external diff \
-  --external "bun:sqlite"
-
-# Step 2: Post-process
-# Replace import.meta.dir with a resolvable reference
-perl -pi -e 's/import\.meta\.dir/__browseNodeSrcDir/g' "$DIST_DIR/server-node.mjs"
-# Stub out bun:sqlite (macOS-only cookie import, not needed on Windows)
-perl -pi -e 's|import { Database } from "bun:sqlite";|const Database = null; // bun:sqlite stubbed on Node|g' "$DIST_DIR/server-node.mjs"
-
-# Step 3: Create the final file with polyfill header injected after the first line
-{
-  head -1 "$DIST_DIR/server-node.mjs"
-  echo '// ── Windows Node.js compatibility (auto-generated) ──'
-  echo 'import { fileURLToPath as _ftp } from "node:url";'
-  echo 'import { dirname as _dn } from "node:path";'
-  echo 'const __browseNodeSrcDir = _dn(_dn(_ftp(import.meta.url))) + "/src";'
-  echo '{ const _r = createRequire(import.meta.url); _r("./bun-polyfill.cjs"); }'
-  echo '// ── end compatibility ──'
-  tail -n +2 "$DIST_DIR/server-node.mjs"
-} > "$DIST_DIR/server-node.tmp.mjs"
-
-mv "$DIST_DIR/server-node.tmp.mjs" "$DIST_DIR/server-node.mjs"
-
-# Step 4: Copy polyfill to dist/
-cp "$SRC_DIR/bun-polyfill.cjs" "$DIST_DIR/bun-polyfill.cjs"
-
-echo "Node server bundle ready: $DIST_DIR/server-node.mjs"

package/skills/browse/src/activity.ts

@@ -1,208 +0,0 @@
-/**
- * Activity streaming — real-time feed of browse commands for the Chrome extension Side Panel
- *
- * Architecture:
- *   handleCommand() ──► emitActivity(command_start)
- *                   ──► emitActivity(command_end)
- *   wirePageEvents() ──► emitActivity(navigation)
- *
- *   GET /activity/stream?after=ID ──► SSE via ReadableStream
- *   GET /activity/history?limit=N ──► REST fallback
- *
- * Privacy: filterArgs() redacts passwords, auth tokens, and sensitive query params.
- * Backpressure: subscribers notified via queueMicrotask (never blocks command path).
- * Gap detection: client sends ?after=ID, server detects if ring buffer overflowed.
- */
-
-import { CircularBuffer } from './buffers';
-
-// ─── Types ──────────────────────────────────────────────────────
-
-export interface ActivityEntry {
-  id: number;
-  timestamp: number;
-  type: 'command_start' | 'command_end' | 'navigation' | 'error';
-  command?: string;
-  args?: string[];
-  url?: string;
-  duration?: number;
-  status?: 'ok' | 'error';
-  error?: string;
-  result?: string;
-  tabs?: number;
-  mode?: string;
-}
-
-// ─── Buffer & Subscribers ───────────────────────────────────────
-
-const BUFFER_CAPACITY = 1000;
-const activityBuffer = new CircularBuffer<ActivityEntry>(BUFFER_CAPACITY);
-let nextId = 1;
-
-type ActivitySubscriber = (entry: ActivityEntry) => void;
-const subscribers = new Set<ActivitySubscriber>();
-
-// ─── Privacy Filtering ─────────────────────────────────────────
-
-const SENSITIVE_COMMANDS = new Set(['fill', 'type', 'cookie', 'header']);
-const SENSITIVE_PARAM_PATTERN = /\b(password|token|secret|key|auth|bearer|api[_-]?key)\b/i;
-
-/**
- * Redact sensitive data from command args before streaming.
- */
-export function filterArgs(command: string, args: string[]): string[] {
-  if (!args || args.length === 0) return args;
-
-  // fill: redact the value (last arg) for password-type fields
-  if (command === 'fill' && args.length >= 2) {
-    const selector = args[0];
-    // If the selector suggests a password field, redact the value
-    if (/password|passwd|secret|token/i.test(selector)) {
-      return [selector, '[REDACTED]'];
-    }
-    return args;
-  }
-
-  // header: redact Authorization and other sensitive headers
-  if (command === 'header' && args.length >= 1) {
-    const headerLine = args[0];
-    if (/^(authorization|x-api-key|cookie|set-cookie)/i.test(headerLine)) {
-      const colonIdx = headerLine.indexOf(':');
-      if (colonIdx > 0) {
-        return [headerLine.substring(0, colonIdx + 1) + '[REDACTED]'];
-      }
-    }
-    return args;
-  }
-
-  // cookie: redact cookie values
-  if (command === 'cookie' && args.length >= 1) {
-    const cookieStr = args[0];
-    const eqIdx = cookieStr.indexOf('=');
-    if (eqIdx > 0) {
-      return [cookieStr.substring(0, eqIdx + 1) + '[REDACTED]'];
-    }
-    return args;
-  }
-
-  // type: always redact (could be a password field)
-  if (command === 'type') {
-    return ['[REDACTED]'];
-  }
-
-  // URL args: redact sensitive query params
-  return args.map(arg => {
-    if (arg.startsWith('http://') || arg.startsWith('https://')) {
-      try {
-        const url = new URL(arg);
-        let redacted = false;
-        for (const key of url.searchParams.keys()) {
-          if (SENSITIVE_PARAM_PATTERN.test(key)) {
-            url.searchParams.set(key, '[REDACTED]');
-            redacted = true;
-          }
-        }
-        return redacted ? url.toString() : arg;
-      } catch {
-        return arg;
-      }
-    }
-    return arg;
-  });
-}
-
-/**
- * Truncate result text for streaming (max 200 chars).
- */
-function truncateResult(result: string | undefined): string | undefined {
-  if (!result) return undefined;
-  if (result.length <= 200) return result;
-  return result.substring(0, 200) + '...';
-}
-
-// ─── Public API ─────────────────────────────────────────────────
-
-/**
- * Emit an activity event. Backpressure-safe: subscribers notified asynchronously.
- */
-export function emitActivity(entry: Omit<ActivityEntry, 'id' | 'timestamp'>): ActivityEntry {
-  const full: ActivityEntry = {
-    ...entry,
-    id: nextId++,
-    timestamp: Date.now(),
-    args: entry.args ? filterArgs(entry.command || '', entry.args) : undefined,
-    result: truncateResult(entry.result),
-  };
-  activityBuffer.push(full);
-
-  // Notify subscribers asynchronously — never block the command path
-  for (const notify of subscribers) {
-    queueMicrotask(() => {
-      try { notify(full); } catch { /* subscriber error — don't crash */ }
-    });
-  }
-
-  return full;
-}
-
-/**
- * Subscribe to live activity events. Returns unsubscribe function.
- */
-export function subscribe(fn: ActivitySubscriber): () => void {
-  subscribers.add(fn);
-  return () => subscribers.delete(fn);
-}
-
-/**
- * Get recent activity entries after the given cursor ID.
- * Returns entries and gap info if the buffer has overflowed.
- */
-export function getActivityAfter(afterId: number): {
-  entries: ActivityEntry[];
-  gap: boolean;
-  gapFrom?: number;
-  availableFrom?: number;
-  totalAdded: number;
-} {
-  const total = activityBuffer.totalAdded;
-  const allEntries = activityBuffer.toArray();
-
-  if (afterId === 0) {
-    return { entries: allEntries, gap: false, totalAdded: total };
-  }
-
-  // Check for gap: if afterId is too old and has been evicted
-  const oldestId = allEntries.length > 0 ? allEntries[0].id : nextId;
-  if (afterId < oldestId) {
-    return {
-      entries: allEntries,
-      gap: true,
-      gapFrom: afterId + 1,
-      availableFrom: oldestId,
-      totalAdded: total,
-    };
-  }
-
-  // Filter to entries after the cursor
-  const filtered = allEntries.filter(e => e.id > afterId);
-  return { entries: filtered, gap: false, totalAdded: total };
-}
-
-/**
- * Get the N most recent activity entries.
- */
-export function getActivityHistory(limit: number = 50): {
-  entries: ActivityEntry[];
-  totalAdded: number;
-} {
-  const allEntries = activityBuffer.toArray();
-  const sliced = limit < allEntries.length ? allEntries.slice(-limit) : allEntries;
-  return { entries: sliced, totalAdded: activityBuffer.totalAdded };
-}
-
-/**
- * Get subscriber count (for debugging/health).
- */
-export function getSubscriberCount(): number {
-  return subscribers.size;
-}