@qiaolei81/copilot-session-viewer 0.3.3 → 0.3.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qiaolei81/copilot-session-viewer",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "Web UI for viewing GitHub Copilot CLI session logs",
   "author": "Lei Qiao <qiaolei81@gmail.com>",
   "license": "MIT",
@@ -84,5 +84,28 @@
     "nyc": "^17.1.0",
     "supertest": "^7.2.2",
     "v8-to-istanbul": "^9.3.0"
-  }
+  },
+  "files": [
+    "bin/",
+    "server.js",
+    "lib/",
+    "src/app.js",
+    "src/config/",
+    "src/controllers/",
+    "src/middleware/",
+    "src/models/",
+    "src/routes/",
+    "src/schemas/",
+    "src/services/",
+    "src/telemetry.js",
+    "src/utils/",
+    "!src/**/__tests__/",
+    "!src/**/*.test.js",
+    "views/",
+    "public/css/",
+    "public/js/*.min.js",
+    "public/img/",
+    "LICENSE",
+    "README.md"
+  ]
 }

package/.nycrc

@@ -1,29 +0,0 @@
-{
-  "all": true,
-  "include": [
-    "server.js",
-    "src/**/*.js",
-    "public/**/*.js"
-  ],
-  "exclude": [
-    "**/*.test.js",
-    "**/__tests__/**",
-    "**/node_modules/**",
-    "coverage/**",
-    ".nyc_output/**",
-    "test-results/**",
-    "scripts/**",
-    "**/*.spec.js"
-  ],
-  "reporter": [
-    "text",
-    "text-summary",
-    "html",
-    "lcov"
-  ],
-  "report-dir": "./coverage/combined",
-  "temp-dir": "./.nyc_output",
-  "cache": true,
-  "sourceMap": false,
-  "instrument": false
-}

package/AGENTS.md

@@ -1,109 +0,0 @@
-# AGENTS.md
-
-## Project overview
-Web UI for viewing and analyzing GitHub Copilot CLI session logs. Built with Express.js, EJS templates, and vanilla JavaScript (Vue 3 for session detail view).
-
-## Setup commands
-- Install deps: `npm install`
-- Start server: `npm start`
-- Dev mode (auto-reload): `npm run dev`
-- Run all tests: `npm run test:all`
-- Lint code: `npm run lint`
-- Fix lint issues: `npm run lint:fix`
-
-## Code style
-- JavaScript (Node.js 22+)
-- Single quotes for strings
-- No unused variables (prefix with `_` if intentionally unused in catch blocks)
-- Error handling: always include `{ cause }` when re-throwing errors
-- ESLint enforced (no errors, warnings acceptable)
-
-## File structure
-```
-server.js                    # Main Express app
-src/
-  config.js                  # Configuration constants
-  session.js                 # Session data model
-  sessionRepository.js       # Session loading/caching
-  insightService.js          # Copilot-based analysis
-  processManager.js          # Background process tracking
-  fileUtils.js              # File operations
-  helpers.js                # Utility functions
-views/
-  index.ejs                 # Session list (main page)
-  session-vue.ejs           # Session detail (Vue 3)
-  time-analyze.ejs          # Timeline analysis
-__tests__/                  # Jest unit tests
-__tests__/e2e/              # Playwright e2e tests
-```
-
-## Testing instructions
-- **Unit tests**: `npm test` (Jest)
-- **E2E tests**: `npm run test:e2e` (Playwright)
-- **Coverage**: `npm run test:coverage`
-- Always run `npm run lint` before committing
-- E2E tests expect server running on port 3838
-- Tests use `~/.copilot/session-state/` by default
-
-## Common tasks
-
-### Adding a new route
-1. Add route handler in `server.js`
-2. Create corresponding view in `views/`
-3. Add E2E test in `__tests__/e2e/`
-4. Update README if user-facing
-
-### Modifying session parsing
-1. Edit `src/session.js` or `src/fileUtils.js`
-2. Run unit tests: `npm test`
-3. Test with real sessions from `~/.copilot/session-state/`
-
-### UI changes
-- Main page: edit `views/index.ejs` (vanilla JS)
-- Session detail: edit `views/session-vue.ejs` (Vue 3 CDN)
-- Time analysis: edit `views/time-analyze.ejs` (vanilla JS)
-- Restart server to see changes: `npm run dev` (auto-reload)
-
-## Important constraints
-
-### Security
-- No authentication (local-only tool)
-- Helmet.js for basic security headers
-- Rate limiting on upload endpoint
-- Input validation on file paths
-- CORS restricted to localhost origins
-
-### Dependencies
-- **copilot CLI** must be in PATH (used by insightService)
-- Node.js 22+ (uses native fetch, improved performance)
-- Session files: `~/.copilot/session-state/` (configurable via SESSION_DIR env)
-
-### Performance
-- Session list caches for 30 seconds
-- Virtual scrolling for large event lists (vue-recycle-scroller)
-- Compression enabled (gzip)
-- Static assets served via Express
-
-## Debugging tips
-- Check server logs: `tail -f /tmp/copilot-session-viewer.log` (if running via nohup)
-- Inspect session files: `cat ~/.copilot/session-state/<session-id>/events.jsonl`
-- Browser DevTools console for client-side issues
-- Use `DEBUG=*` env var for verbose logging (if implemented)
-
-## Commit guidelines
-- Use conventional commits: `feat:`, `fix:`, `refactor:`, `docs:`, `test:`, `chore:`
-- Run `npm run lint:fix` before committing
-- All tests must pass: `npm run test:all`
-- Keep commits atomic and focused
-
-## Known gotchas
-- Vue 3 templates auto-unwrap refs - don't use `.value` in templates
-- `filteredEvents` vs `flatEvents` - use correct one for virtual scroller indices
-- Platform-specific paths: always rely on system PATH, never hardcode `/opt/homebrew` etc.
-- EJS escaping: use `<%- %>` for trusted HTML, `<%= %>` for user input
-
-## PR instructions
-- Title format: `<type>: <description>` (e.g., `feat: add brand colors for model badges`)
-- Link related issues if any
-- Include screenshots for UI changes
-- Verify all tests pass locally before pushing

package/CHANGELOG.md

@@ -1,313 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [0.3.3] - 2026-03-13
-
-### Added
-- **Frontend Build Pipeline** - esbuild-based build system (`scripts/build.mjs`) extracts inline JS from EJS templates into standalone minified bundles
-- **Application Insights Telemetry** - Backend telemetry via `applicationinsights@2.9.8` (11 custom events, 3 metrics); frontend telemetry via CDN SDK (13 interaction events)
-- **Browser Telemetry Snippet** - `views/telemetry-snippet.ejs` partial for consistent frontend telemetry injection
-- **Tarball Verification in CI** - E2E tests now run against `npx`-installed tgz package, verifying the published artifact works end-to-end
-- **npm Publish Smoke Test** - Pre-publish step installs tgz, starts server, and verifies HTTP 200
-
-### Changed
-- **Frontend Architecture** - 4642 lines of inline JS extracted from 3 EJS templates into 4 standalone bundles (net -3370 lines)
-  - `src/frontend/homepage.js` → `public/js/homepage.min.js` (9.7K)
-  - `src/frontend/session-detail.js` → `public/js/session-detail.min.js` (45.5K)
-  - `src/frontend/time-analyze.js` → `public/js/time-analyze.min.js` (54.6K)
-  - `src/frontend/telemetry-browser.js` → `public/js/telemetry-browser.min.js` (1.5K)
-- **Server Data Bridge** - EJS templates pass server data to external bundles via `window.__PAGE_DATA`
-- **CI Pipeline** - E2E tests run against packed tgz via `npx` (not source); telemetry disabled in all CI steps
-- **npm Package** - Source files (`src/frontend/`) excluded via `.npmignore`; only `.min.js` bundles shipped
-
-### Fixed
-- **Missing Runtime Dependency** - `adm-zip` moved from devDependencies to dependencies (was causing `MODULE_NOT_FOUND` when installed from npm)
-- **ESLint Config** - Added frontend globals (Vue, marked, DOMPurify), excluded `public/js/*.min.js` from linting, fixed unused vars and eqeqeq warnings
-
-## [0.3.2] - 2026-03-08
-
-### Fixed
-- **VSCode Session Duration** - Duration now uses the last `terminalCommandState.timestamp` (when the agent actually executed a command) instead of a `toolCount × 3500ms` heuristic. Long-running agentic sessions that span multiple hours are now measured correctly
-- **VSCode Multi-Workspace Dedup** - `_findVsCodeSession` now collects candidates from all matching workspace hashes and returns the one with the latest effective end time (most complete data), instead of returning the first match found
-- **Session `createdAt` in CI** - `Session.fromDirectory` now reads `startTime`/`endTime` from `workspace.yaml` (in addition to `created_at`/`updated_at`), fixing `createdAt` being undefined in environments where `stats.birthtime` is unavailable
-
-### Refactored
-- **`_buildVsCodeSession()`** - Extracted shared VSCode session construction logic into a single method used by both the main scan loop and `_findVsCodeSession`, eliminating duplicate `effectiveEnd2`/`toolCount2` variables
-
-## [0.3.1] - 2026-03-07
-
-### Fixed
-- **Session Deduplication** - VSCode sessions with the same ID across multiple workspaces are now deduplicated (keeps most recently updated)
-- **WIP Status Accuracy** - VSCode agentic sessions now also check file mtime for WIP detection; threshold increased from 5 to 15 minutes
-- **Timeline Bar Positioning** - UserReq rows with 0 tools no longer render at the start of the timeline
-- **Tag Isolation** - Tags now use filePath-based storage to prevent shared directory collisions (Claude, Pi-Mono, Copilot CLI)
-- **Per-Session Insight Files** - Agent review files use `{sessionId}.agent-review.md` naming to avoid collisions
-- **Export All Sources** - Session export works for all sources including VSCode; file-based exports include `.tags.json`
-- **Inline References in Markdown** - VSCode `inlineReference` items (file/folder links) now rendered as code references instead of being silently dropped, fixing broken markdown tables
-
-### Performance
-- **60s Cache + Request Dedup** - `SessionRepository.findAll()` results cached for 60 seconds with concurrent request deduplication, reducing TTFB from ~11s to <100ms on cache hit
-
-## [0.3.0] - 2026-03-07
-
-### Added
-- **VSCode Copilot Chat Support** - Full support for VSCode Copilot Chat sessions as a new source (`vscode`)
-  - Session cards show model badge + repo basename
-  - Copilot Chat extension version badge
-  - WIP badge for active sessions
-  - SubAgent name badges on assistant messages (replaces generic ASSISTANT badge)
-  - UserReq rows in Gantt timeline
-  - Turn divider shows start time + duration
-- **Dynamic Source Path Hints** - Clicking filter pills shows the source directory path (cross-platform)
-- **Multi-Tool Branding** - Homepage wording updated to reflect multi-tool support (Copilot CLI, Claude Code, Pi-Mono, Copilot Chat)
-
-### Changed
-- **Source Display Names** - `copilot` → "Copilot CLI", `vscode` → "Copilot Chat"
-- **Session Info Layout** - Shows Model + Repo basename instead of CWD hash path
-- **Tool Input Display** - URI objects simplified to filename only; edits collapsed to count
-- **Tool Call Width** - Truncation increased to 200 chars with flex-wrap
-- **SubAgent Badge** - Shows name only (no emoji prefix)
-- **System Messages** - System-sourced `user.message` converted to `system.notification` type with SYSTEM badge
-
-### Fixed
-- Claude `tool_result` user messages filtered from display
-- VSCode parser: `resultDetails` iteration crash, request timestamps for subagent events
-- VSCode subagent dedup by `subAgentId` instead of name
-- VSCode `findById` uses `selectedModel` + `resolveWorkspacePath`
-- VSCode duration estimation fix
-- Session detail repo dedup, skill table width
-- SESSION INFO duplicate Model/label
-- SubAgent badge uses `agentName` from `toolSpecificData`
-- Source path hints from server (cross-platform Windows/macOS/Linux)
-
-## [0.2.7] - 2026-03-05
-
-### Added
-- **Session Tagging** - Add, remove, and filter sessions by custom tags from the session list and detail pages
-- **Unit Tests for Tagging** - 70 new tests covering `tagService` and `tagController` (608 total)
-- **E2E Tests for Tagging** - Playwright tests covering tagging API and UI flows
-
-## [0.2.6] - 2026-03-05
-
-### Fixed
-- **304 Caching on Live Sessions** - Disabled ETag on events API (`Cache-Control: no-store`) so active/WIP sessions always return fresh data on page refresh
-- **Updated Time Inaccuracy** - Session detail page now shows last event timestamp as "Updated" time instead of file mtime
-- **E2E CI Stability** - `#loading-indicator` is always in DOM regardless of session count; removed conditional session count check that caused false negatives
-
-## [0.2.5] - 2026-03-04
-
-### Fixed
-- **Flaky Unit Tests** - Upload directory now isolated per test via `UPLOAD_DIR` env var to prevent cross-test pollution
-- **Timing Variance in Tests** - `ageMs` threshold relaxed from `>= 0` to `>= -100` to tolerate clock precision on fast CI runners
-
-## [0.2.4] - 2026-03-04
-
-### Fixed
-- **E2E Skip on Empty Environment** - Tests now skip gracefully when no sessions exist in CI (no `~/.copilot/session-state/` data)
-- **VSCode Filter Pill** - Temporarily hidden in UI (feature in progress)
-
-## [0.2.3] - 2026-03-04
-
-### Fixed
-- **Lint Errors** - Fixed unused variable warnings in `vscode-parser.js` (`canParse`, `agentName`, `itemIdx`) and `sessionRepository.js` (unused `VsCodeParser` import)
-- **Stale Unit Tests** - Updated test expectations to match current API signatures (`getPaginatedSessions(1, 20, "copilot")`)
-
-## [0.2.2] - 2026-02-27
-
-### Fixed
-- **ETag Cache Bug** - `session.updated`/`session.created` field name typo (should be `updatedAt`/`createdAt`) caused ETag to always be `md5("sessionId-undefined")`, resulting in permanent 304 Not Modified responses — frontend never saw new events for WIP sessions
-
-## [0.2.1] - 2026-02-25
-
-### Changed
-- `.nyc_output/` and `coverage/` directories now properly ignored in `.gitignore`
-
-### Removed
-- NYC coverage intermediate files (`.nyc_output/`, 1.6 MB) from repository
-- Removed 28 coverage data files that should not be committed
-
-### Docs
-- Translated `lib/parsers/README.md` from Chinese to English for international contributors
-
-## [0.2.0] - 2026-02-25
-
-### Added
-- **Multi-Tool Support** - Full support for **Pi-Mono** sessions (now supports 3 tools: Copilot CLI, Claude Code, Pi-Mono)
-- **Agent Review for All Tools** - AI-powered session analysis now works for all 3 supported tools
-- **Pi-Mono Parser** - New `PiMonoSessionParser` with full strategy pattern implementation
-- **Unified Event Format** - All 3 tools now use consistent event schema across backend and frontend
-- **Backend-Generated Display Metadata** - Badge labels, source names, and display data generated in backend for consistency
-
-### Changed
-- **Default Filter to Copilot** - Homepage now defaults to Copilot filter instead of "All" (matches user behavior)
-- **Removed "All" Filter** - Simplified UI by removing the "All" filter option
-- **Type Transformation Strategy** - Backend now transforms event types for unified schema (Pi-Mono `message` → `assistant.message`)
-- **Tool Result Merging** - Pi-Mono tool results now properly merged into parent assistant messages
-- **Badge Logic Moved to Backend** - Frontend no longer generates badge labels (single source of truth)
-
-### Fixed
-- **Pi-Mono Agent Review Accuracy** - Fixed incorrect session data by explicitly specifying target file in prompt
-- **Timeline Rendering for Old Copilot Sessions** - Old CLI format now properly expands to `assistant.message` events for timeline
-- **Architecture Consistency** - Unified type transformation across all sources (no more "按了葫芦起了瓢")
-- **CI Upload Directory Race Condition** - Tests now create directories defensively before file operations
-- **Event Expansion Test Coverage** - Tests now verify `assistant.message` generation (frontend dependency)
-
-### Docs
-- **README Multi-Tool Emphasis** - Updated subtitle and descriptions to highlight multi-tool support
-- **lib/parsers Documentation** - Translated Chinese README to English for international contributors
-- **Project Cleanup** - Removed backup files (`time-analyze-v2.ejs`, `*.bak`) and 30 failed E2E test screenshot directories
-
-### Performance
-- **Agent Review Session Isolation** - Simplified from temporary directory approach to prompt-based file specification (6 lines vs 58 lines)
-
-### Architecture
-- **Strategy Pattern Complete** - All 3 parsers follow unified `BaseSessionParser` interface
-- **Backend Normalization** - `eventNormalizer.js` handles all format differences, frontend renders uniformly
-- **No Frontend Source Checks** - Frontend doesn't check `source` field, only renders normalized data
-
-## [0.1.7] - 2026-02-16
-
-### Changed
-- WIP status badge moved from sidebar info table to inline with the page title on session detail page, matching the time analysis page's pattern for better visibility and consistency
-
-### Fixed
-- npm provenance signing now explicitly checks out the release tag so the `SourceRepositoryRef` is available during `npm publish --provenance`
-
-### Docs
-- Added screenshots to README (homepage, session detail, time analysis)
-- Sensitive info (session IDs, workspace paths, repo names) masked in screenshots
-- Switched screenshot references to absolute GitHub raw URLs for npmjs.org compatibility
-- Removed broken placeholder image and hardcoded version from README
-
-## [0.1.6] - 2026-02-16
-
-### Added
-- "Copy as Mermaid Gantt" button on analysis timeline for easy sharing
-- Sub-Agents summary card with status breakdown (completed/failed/incomplete), wall-clock time, and tool counts
-- WIP session status indicator — sessions without `session.end` and recent activity show a 🔄 WIP badge
-- WIP session cards highlighted with amber border on homepage
-
-### Fixed
-- Subagent Gantt chart links now navigate to the correct occurrence when the same subagent runs multiple times
-- Total subagent duration no longer exceeds session duration (overlapping intervals are now merged)
-- Subagent tool counts no longer double-count tools from nested subagents
-- Mermaid sanitize function hardened against backtick/newline injection
-- ESLint errors in `insightService.js` (emoji regex `u` flag, regex double-spaces)
-- ESLint error in `sessionRepository.js` (strict equality check)
-- Unit test `session.test.js` updated for `sessionStatus` field
-- E2E API response time thresholds relaxed for CI environments
-
-### Performance
-- Created shared `sortedEvents` computed property — eliminated 7 redundant O(n log n) array sorts
-- Optimized subagent tool counting with merged intervals and binary search (O(n log k) down from O(m×n))
-
-## [0.1.5] - 2026-02-16
-
-### Fixed
-- EPIPE crash when copilot process exits before events file is fully piped to stdin
-- Server no longer crashes with uncaught exception during concurrent insight generation
-
-## [0.1.4] - 2026-02-16
-
-### Fixed
-- Rate limiting configuration for insight operations - resolved 429 "Too Many Requests" errors
-- Removed rate limiting from insight status checks (GET requests) - status checks are now unlimited
-- Improved rate limiting differentiation: strict for generation (POST), lenient for access (DELETE)
-- Fixed "Age: NaNs" timestamp display issue in insight generation progress
-- Added missing `ageMs` calculation to backend insight service responses
-- ESLint configuration migration from deprecated `.eslintignore` to modern flat config
-- Minimal `.npmignore` configuration for optimized package publishing (82% size reduction)
-
-### Changed
-- Insight output file renamed from `insight-report.md` to `copilot-insight.md`
-- Insight prompt rewritten to enforce ≤500 character output (down from ~2000 words)
-- Insight now focuses on three essentials: health score, top issue, key recommendation
-- Insight generation rate limiting: 3 requests per 5 minutes (more user-friendly window)
-- Insight access operations: 50 requests per minute (very lenient for status checks)
-- Package size optimized from 298kB to 52kB for npm publishing
-
-### Removed
-- Deprecated `.eslintignore` file in favor of `eslint.config.mjs` ignores property
-- Verbose `.npmignore` entries - simplified to essential exclusions only
-
-## [0.1.3] - 2026-02-16
-
-### Added
-- Infinite scroll functionality for homepage session list
-- "Load More Sessions" button for manual session loading
-- Seamless scroll-triggered loading when approaching bottom of page
-- API endpoint `/api/sessions/load-more` for paginated session loading
-- Comprehensive e2e test suite expansion (45 total tests, up from 17)
-- New test files: `api-pagination.spec.js`, `infinite-scroll.spec.js`, `core-functionality.spec.js`
-
-### Changed
-- Replaced traditional pagination with infinite scroll on homepage
-- Homepage now loads initial 20 sessions instead of all sessions
-- Session count display removed from homepage for cleaner UI
-- Updated JavaScript to handle dynamic session loading and rendering
-
-### Removed
-- Session count display "(showing X of Y)" from homepage header
-- Unused logger utility (`src/utils/logger.js`) - dead code cleanup
-- Pagination parameters from homepage (legacy support maintained in API)
-
-### Fixed
-- Updated unit tests to reflect infinite scroll functionality
-- Improved performance for sites with large numbers of sessions
-- Memory usage optimization by loading sessions progressively
-- E2E test reliability improvements - achieved 100% pass rate (45/45 tests)
-- Fixed selector issues in session detail page tests
-- Improved test resilience with better error handling and fallback selectors
-
-## [0.1.2] - 2026-02-15
-
-### Fixed
-- Content Security Policy configuration (removed unsafe-inline and unsafe-eval)
-- Missing repository URL in README installation instructions
-- Version inconsistencies across documentation files
-
-### Added
-- Session pagination support for better performance with large session counts
-- API endpoint pagination with backward compatibility
-
-## [0.1.1] - 2026-02-15
-
-### Internal
-- Project improvements and bug fixes
-
-## [0.1.0] - 2026-02-15
-
-### Added
-- Initial release of Copilot Session Viewer
-- Web UI for viewing GitHub Copilot CLI session logs
-- Session list with search, filtering, and sorting
-- Detailed session view with Vue 3 and virtual scrolling
-- Time analysis view with sub-agents, turns, and tool breakdown
-- Copilot Insight feature (AI-generated analysis)
-- Model badge colors (Claude, GPT, Gemini)
-- E2E and unit test coverage (17 Playwright + 20 Jest tests)
-- AGENTS.md for AI coding agents
-- Security headers (Helmet.js)
-- Rate limiting for uploads
-- Compression middleware
-
-### Security
-- Input validation for session IDs
-- XSS prevention with proper escaping
-- CORS restricted to localhost
-- File upload size limits (50MB)
-
-[0.2.6]: https://github.com/qiaolei81/copilot-session-viewer/releases/tag/v0.2.6
-[0.2.5]: https://github.com/qiaolei81/copilot-session-viewer/releases/tag/v0.2.5
-[0.2.4]: https://github.com/qiaolei81/copilot-session-viewer/releases/tag/v0.2.4
-[0.2.3]: https://github.com/qiaolei81/copilot-session-viewer/releases/tag/v0.2.3
-[0.1.7]: https://github.com/qiaolei81/copilot-session-viewer/releases/tag/v0.1.7
-[0.1.6]: https://github.com/qiaolei81/copilot-session-viewer/releases/tag/v0.1.6
-[0.1.3]: https://github.com/qiaolei81/copilot-session-viewer/releases/tag/v0.1.3
-[0.1.2]: https://github.com/qiaolei81/copilot-session-viewer/releases/tag/v0.1.2
-[0.1.1]: https://github.com/qiaolei81/copilot-session-viewer/releases/tag/v0.1.1
-[0.1.0]: https://github.com/qiaolei81/copilot-session-viewer/releases/tag/v0.1.0

package/CONTRIBUTING.md

@@ -1,104 +0,0 @@
-# Contributing to Copilot Session Viewer
-
-Thank you for your interest in contributing! This document provides guidelines for contributing to the project.
-
-## Code of Conduct
-
-By participating in this project, you agree to maintain a respectful and collaborative environment.
-
-## How to Contribute
-
-### Reporting Bugs
-
-Before creating bug reports, please check existing issues. When creating a bug report, include:
-
-- **Clear title and description**
-- **Steps to reproduce** the behavior
-- **Expected vs actual behavior**
-- **Environment details** (Node.js version, OS, browser)
-- **Session file examples** (if applicable, sanitize sensitive data)
-
-### Suggesting Enhancements
-
-Enhancement suggestions are tracked as GitHub issues. When creating an enhancement suggestion, include:
-
-- **Use case** - What problem does this solve?
-- **Proposed solution** - How should it work?
-- **Alternatives considered** - What other approaches did you think about?
-
-### Pull Requests
-
-1. **Fork** the repository
-2. **Create a branch** from `main`:
-   ```bash
-   git checkout -b feature/your-feature-name
-   ```
-3. **Make your changes** following the code style guidelines
-4. **Write or update tests** - maintain or improve test coverage
-5. **Run all tests**:
-   ```bash
-   npm run lint:fix
-   npm run test:all
-   ```
-6. **Commit** using [Conventional Commits](https://www.conventionalcommits.org/):
-   ```
-   feat: add new feature
-   fix: resolve bug in session parsing
-   docs: update README
-   test: add e2e test for filtering
-   ```
-7. **Push** to your fork:
-   ```bash
-   git push origin feature/your-feature-name
-   ```
-8. **Submit a pull request** to the `main` branch
-
-**Note for fork contributors:**
-- CI tests will run automatically on your PR
-- You don't need access to secrets (NPM_TOKEN) - only maintainers publish releases
-- Your PR will be labeled `external-contribution` automatically
-
-
-### Code Style Guidelines
-
-- **JavaScript**: Single quotes, no unused variables
-- **Error handling**: Always include `{ cause }` when re-throwing
-- **Vue 3**: Don't use `.value` in templates (auto-unwrapped)
-- **Comments**: Explain *why*, not *what*
-- **ESLint**: Zero errors, warnings acceptable
-
-### Testing Requirements
-
-- **Unit tests** for all new logic in `src/`
-- **E2E tests** for user-facing features
-- **All tests must pass** before merging
-
-### Development Workflow
-
-```bash
-# Install dependencies
-npm install
-
-# Run dev server (auto-reload)
-npm run dev
-
-# Run tests
-npm run test:all
-
-# Lint and fix
-npm run lint:fix
-```
-
-### Project Structure
-
-See `AGENTS.md` for detailed architecture and common tasks.
-
-### Need Help?
-
-- Check `AGENTS.md` for development guidelines
-- Review existing issues and pull requests
-- Ask questions in issue discussions
-
-## License
-
-By contributing, you agree that your contributions will be licensed under the MIT License.