een-api-toolkit 0.3.20 → 0.3.22

package/CHANGELOG.md

@@ -2,62 +2,170 @@
 
 All notable changes to this project will be documented in this file.
 
-## [0.3.20] - 2026-01-19
+## [0.3.22] - 2026-01-22
 
 ### Release Summary
 
-#### PR #62: feat: Add EventSubscriptions API with SSE support and example app
+#### PR #64: Release v0.3.20: Add media buttons to event modal lightboxes
 ## Summary
-- Implement EventSubscriptions API endpoints (list, get, create, delete)
-- Add SSE connection helper `connectToEventSubscription()` for real-time events
-- Create vue-event-subscriptions example app with full CRUD and live event viewer
-- Add session refresh UI (token expiry countdown, refresh status banner)
-- Add modal window for detailed event viewing in Live Events page
+
+- Added Preview, HD Image, and Video buttons to event modal lightboxes in vue-events and vue-event-subscriptions example apps
+- Implemented proper authentication for media fetching using `getRecordedImage` and HLS player with Authorization headers
+- Created `useHlsPlayer` composable for both apps following vue-alerts-metrics pattern
 
 ## Changes
-### Toolkit (`src/eventSubscriptions/`)
-- `service.ts` - CRUD operations and SSE connection with fetch/ReadableStream
-- `types.ts` - EventSubscription, SSEConnection, SSEEvent types
-- Unit tests with 337 total tests passing
 
-### Example App (`examples/vue-event-subscriptions/`)
-- Subscriptions management (list, create, delete)
-- Live Events page with real-time SSE event display
-- Event details modal with JSON data viewer
-- Token expiry countdown and session refresh UI
+- **vue-events**: Updated EventsModal.vue with media buttons and HLS video support
+- **vue-event-subscriptions**: Updated LiveEvents.vue with media buttons and HLS video support
+- Added hls.js dependency to both example apps
+- Created composables/useHlsPlayer.ts in both apps
+
+## Test Plan
+
+- [x] Unit tests: 341 passed
+- [x] Build: successful
+- [x] E2E tests for all 8 example apps passed (123 total):
+  - vue-users: 14 passed
+  - vue-cameras: 13 passed
+  - vue-bridges: 13 passed
+  - vue-events: 16 passed
+  - vue-feeds: 12 passed
+  - vue-media: 20 passed
+  - vue-alerts-metrics: 20 passed
+  - vue-event-subscriptions: 15 passed
+
+## Version
+
+v0.3.20
+
+## Commits
+
+- 8f11b04 feat: Add media buttons to event modal lightboxes in vue-events and vue-event-subscriptions
+
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+#### PR #65: feat: Restructure AI documentation with specialized agents
+## Summary
+
+Restructures the AI documentation from a single monolithic file into domain-specific documents with specialized Claude agents for context-efficient AI assistance.
+
+### Changes
+
+**Documentation Split (7 files):**
+- `AI-CONTEXT.md` - Overview and navigation (entry point)
+- `AI-SETUP.md` - Vue 3 scaffolding, Pinia, Vite configuration
+- `AI-AUTH.md` - OAuth flow, tokens, route guards
+- `AI-USERS.md` - User management API
+- `AI-DEVICES.md` - Cameras & Bridges API
+- `AI-MEDIA.md` - Media, Feeds, Live Video, HLS
+- `AI-EVENTS.md` - Events, Alerts, Metrics, SSE subscriptions
+
+**Specialized Agents (6 new agents):**
+- `een-setup-agent` - Vue 3 project setup assistance
+- `een-auth-agent` - OAuth authentication help
+- `een-users-agent` - User management features
+- `een-devices-agent` - Camera and bridge operations
+- `een-media-agent` - Video and media troubleshooting
+- `een-events-agent` - Events and real-time streaming
+
+**CLI Tool:**
+- Added `npx een-setup-agents` command for easy agent installation
+- Copies agents to `.claude/agents/` for automatic discovery
+
+**Generation Script:**
+- Refactored to generate split files by default
+- `--single` flag for legacy monolithic output
+- Extracts examples from actual Vue components
+
+### Benefits
+
+| Metric | Before | After (typical task) |
+|--------|--------|---------------------|
+| Tokens per task | ~15-18K | ~5-8K |
+| Context preserved | Limited | Substantial |
+| Agent specialization | None | 6 domain agents |
 
 ## Test Results
-- **Lint**: Passed (1 warning)
-- **Unit Tests**: 337 passed
-- **Build**: Passed
-- **E2E Tests**: vue-event-subscriptions passed (15 tests)
-  - Other example apps had port conflict issues (pre-existing infrastructure issue)
+
+- **Lint:** ✅ Passed (1 pre-existing warning)
+- **Unit Tests:** ✅ 341 passed
+- **Build:** ✅ Successful
+- **E2E Tests:** ✅ 70 passed across 8 example apps
 
 ## Version
-`0.3.17`
+
+`0.3.20`
 
 ## Commits
-- 6aa1332 feat: Add EventSubscriptions API with SSE support and example app
+
+- `8e1cc78` feat: Restructure AI documentation into domain-specific files with specialized agents
 
 ---
-🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+🤖 Generated with [Claude Code](https://claude.ai/code)
+
+#### PR #66: Release v0.3.20: AI Documentation Restructure
+## Summary
+
+This release restructures the AI documentation for improved context efficiency:
+
+- **Split AI-CONTEXT.md** into 7 domain-specific documents (~2-4K tokens each vs 15K+ monolithic)
+- **Added 6 specialized Claude agents** for domain-specific assistance
+- **New CLI tool**: `npx een-setup-agents` for easy agent installation in consumer projects
+- **Code quality fixes** addressing Gemini code review feedback
+
+## Changes
+
+### New Files
+- `.claude/agents/` - 6 specialized agents (auth, users, devices, media, events, setup)
+- `docs/ai-reference/` - 6 domain-specific AI reference documents
+- `scripts/setup-agents.ts` - CLI tool for agent installation
+
+### Modified
+- `docs/AI-CONTEXT.md` - Now serves as overview with navigation
+- `scripts/generate-ai-context.ts` - Rewritten to support split file generation
+- `package.json` - Added bin entry and updated files array
+- `CLAUDE.md` - Added agent documentation section
+
+### Commits
+- `8e1cc78` feat: Restructure AI documentation into domain-specific files with specialized agents
+- `407db5f` fix: Address Gemini code review feedback
+- `ecd6cfd` Merge pull request #65
+
+## Test Results
+
+- **Lint**: ✅ Passed (1 pre-existing warning)
+- **Unit Tests**: ✅ 341 passed
+- **Build**: ✅ Successful
+- **E2E Tests**: ✅ 70 passed across 8 example apps
+
+## Version
+
+`0.3.20`
+
+---
+
+🤖 Generated with [Claude Code](https://claude.ai/code)
 
 
 ### Detailed Changes
 
 #### Features
-- feat: Add EventSubscriptions API with SSE support and example app
+- feat: Restructure AI documentation into domain-specific files with specialized agents
+- feat: Add media buttons to event modal lightboxes in vue-events and vue-event-subscriptions
 
 #### Bug Fixes
-- fix: Address code review feedback from PR #63
-- fix: Address code review recommendations from PR #62
+- fix: Add XSS protection for SVG overlays in events agent
+- fix: Address Gemini code review feedback
+- fix: Address code review feedback from PR #64
 
 #### Other Changes
-- docs: Add EventSubscriptions to documentation and fix Pinia version
+- chore: Bump version to 0.3.21 and update Husky triggers
+- refactor: Move media session state from module-level to Pinia store
 
 ### Links
 - [npm package](https://www.npmjs.com/package/een-api-toolkit)
-- [Full Changelog](https://github.com/klaushofrichter/een-api-toolkit/compare/v0.3.16...v0.3.20)
+- [Full Changelog](https://github.com/klaushofrichter/een-api-toolkit/compare/v0.3.20...v0.3.22)
 
 ---
-*Released: 2026-01-19 05:31:27 CST*
+*Released: 2026-01-22 19:45:17 CST*