een-api-toolkit 0.3.60 → 0.3.67

package/.claude/agents/docs-accuracy-reviewer.md

@@ -2,7 +2,7 @@
 name: docs-accuracy-reviewer
 description: |
   Use this agent when you need to verify that project documentation accurately reflects the actual codebase, when checking for broken links in markdown files, when validating configuration examples in documentation, or when ensuring README and other docs are up-to-date with implemented features. This agent reads documentation and compares it against source code but does not modify code files.
-model: inherit
+model: sonnet
 color: purple
 ---
 
@@ -70,6 +70,7 @@ assistant: "I'll use the docs-accuracy-reviewer agent to verify the een-* agent
    - List all markdown files in the project (README.md, docs/**, CLAUDE.md, etc.)
    - **Scan ALL example directories** (`examples/*/README.md`) - do not skip any
    - **Check ALL agent files** in `.claude/agents/een-*.md` - verify function signatures and code examples against actual implementations
+   - **Check ALL skill files** in `.claude/skills/*/SKILL.md` - verify referenced scripts, npm commands, and workflows match actual implementations
    - Identify the source code structure for cross-referencing (especially `src/index.ts` exports, `src/*/service.ts` implementations, and `src/types/*.ts` definitions)
 
 2. **Analysis Phase**:
@@ -122,6 +123,17 @@ assistant: "I'll use the docs-accuracy-reviewer agent to verify the een-* agent
 - Verify .env.example matches documentation
 - Check that all required secrets are documented
 
+### For Skills (`.claude/skills/*/SKILL.md`):
+- **Script References**: Verify all referenced scripts exist in `scripts/` and are executable
+- **npm Commands**: Verify all `npm run` commands exist in `package.json` scripts
+- **Workflow Steps**: Verify described workflows match actual tool capabilities and script behavior
+- **File Paths**: Verify all referenced file paths and directories exist
+- Cross-reference the PR-and-check skill's test commands against actual `package.json` scripts
+
+### For Test Runner Agent (`.claude/agents/test-runner.md`):
+- Verify documented test commands match `package.json` scripts (e.g., `npm run test:e2e:examples` for example app E2E tests)
+- Verify the E2E test execution approach matches the actual `scripts/run-examples-e2e.sh` behavior
+
 ### For Claude Agent Files (`.claude/agents/een-*.md`):
 - **Function Signatures**: Verify all documented function signatures match actual implementations in `src/*/service.ts`
 - **Parameter Names**: Check that parameter names in examples match the actual API (e.g., `deviceId` not `cameraId`, `userId` as direct param not `{ id: userId }`)
@@ -176,9 +188,10 @@ Before completing your review:
 1. Verify you've checked ALL markdown files in the project
 2. **Confirm ALL example app READMEs were reviewed** (list them in your report)
 3. **Confirm ALL `.claude/agents/een-*.md` files were reviewed** for API accuracy
-4. Confirm each fix you made is backed by evidence from source code
-5. Re-read modified sections to ensure they're clear and accurate
-6. Check that your fixes didn't introduce new broken links or inconsistencies
+4. **Confirm ALL `.claude/skills/*/SKILL.md` files were reviewed** for script and npm command accuracy
+5. Confirm each fix you made is backed by evidence from source code
+6. Re-read modified sections to ensure they're clear and accurate
+7. Check that your fixes didn't introduce new broken links or inconsistencies
 
 ## Common Agent File Issues to Watch For
 

package/.claude/agents/een-auth-agent.md

@@ -119,7 +119,7 @@ const authStore = useAuthStore()
 authStore.token          // Current access token
 authStore.baseUrl        // EEN API base URL (region-specific)
 authStore.isAuthenticated // Computed: true if valid token exists
-authStore.isExpired      // Computed: true if token expired
+authStore.isTokenExpired // Computed: true if token expired
 ```
 
 ### authStore.initialize() - Session Restoration (CRITICAL)

package/.claude/agents/een-devices-agent.md

@@ -141,7 +141,7 @@ interface ListCamerasParams {
   status__ne?: CameraStatus      // Exclude this status
   tags__contains?: string[]      // Must have ALL these tags
   tags__any?: string[]           // Must have ANY of these tags
-  bridgeId__eq?: string          // Cameras on specific bridge
+  bridgeId__in?: string[]        // Cameras on specific bridge(s)
   q?: string                     // Full-text search
 }
 ```

package/.claude/agents/een-media-agent.md

@@ -164,8 +164,8 @@ import { getRecordedImage, formatTimestamp } from 'een-api-toolkit'
 async function fetchRecordedFrame(deviceId: string, date: Date) {
   const result = await getRecordedImage({
     deviceId,
-    timestamp: formatTimestamp(date.toISOString()),  // MUST use formatTimestamp()
-    type: 'preview'  // Optional, defaults to 'preview'
+    timestamp__gte: formatTimestamp(date.toISOString()),  // MUST use formatTimestamp()
+    type: 'preview'  // Optional
   })
 
   if (result.data) {
@@ -179,12 +179,14 @@ List recorded media intervals:
 ```typescript
 import { listMedia, formatTimestamp, type ListMediaParams } from 'een-api-toolkit'
 
-async function fetchRecordings(cameraId: string, startDate: Date, endDate: Date) {
+async function fetchRecordings(deviceId: string, startDate: Date, endDate: Date) {
   const result = await listMedia({
-    cameraId,
+    deviceId,
+    type: 'preview',                              // Stream type: 'preview' or 'main'
+    mediaType: 'video',                            // Content type: 'video' or 'image'
     startTimestamp: formatTimestamp(startDate),
     endTimestamp: formatTimestamp(endDate),
-    type: 'video'
+    include: ['hlsUrl']                            // Request HLS URLs for playback
   })
 
   if (result.data) {

package/.claude/agents/een-users-agent.md

@@ -54,8 +54,8 @@ assistant: "I'll use the een-users-agent to diagnose the user lookup issue and i
 ```typescript
 interface User {
   id: string
-  firstName?: string
-  lastName?: string
+  firstName: string
+  lastName: string
   email: string
   isActive?: boolean
   permissions?: string[]
@@ -71,9 +71,9 @@ interface UserProfile {
   firstName: string
   lastName: string
   email: string
-  accountId: string
-  permissions: string[]
-  // ... profile-specific fields
+  accountId?: string
+  timeZone?: string
+  language?: string
 }
 ```
 

package/.claude/agents/test-runner.md

@@ -2,7 +2,7 @@
 name: test-runner
 description: |
   Use this agent when you need to run the complete test suite for the project, including unit tests (Vitest) and E2E tests (Playwright). This agent is ideal after writing a logical chunk of code, before creating a PR, or when you want to verify the overall health of the codebase. The agent executes tests and reports results but does not modify any code.
-model: inherit
+model: sonnet
 color: green
 ---
 
@@ -69,14 +69,16 @@ Capture and analyze:
 - Test file locations for failures
 
 ### Step 3: Execute E2E Tests
-Run the Playwright E2E test suite:
+Run the Playwright E2E tests for all example apps:
 ```bash
-npm run test:e2e
+npm run test:e2e:examples
 ```
+This script (`scripts/run-examples-e2e.sh`) discovers all example apps with `playwright.config.ts`, frees port 3333 between runs, and stops on first failure.
+
 Capture and analyze:
-- Browser contexts tested
-- Total E2E scenarios run
-- Passed/failed counts
+- Which example apps passed/failed
+- Total E2E scenarios run across all apps
+- Passed/failed counts per app
 - Screenshots or traces for failures (if available)
 - Timeout or network-related issues
 

package/CHANGELOG.md

@@ -2,28 +2,138 @@
 
 All notable changes to this project will be documented in this file.
 
-## [0.3.60] - 2026-02-06
+## [0.3.67] - 2026-02-08
 
 ### Release Summary
 
-No PR descriptions available for this release.
+#### PR #91: feat: E2E runner script, release summary fix, agent updates
+## Summary
+
+- **feat:** Add `scripts/run-examples-e2e.sh` that dynamically discovers all example apps and runs Playwright E2E tests sequentially with port 3333 cleanup between runs
+- **fix:** Fix npm-publish workflow race condition where Release Summary was always empty — replaced `git log --merges` (which failed when checked-out develop commit didn't have production merge commits as ancestors) with `gh pr list --base production --state merged` via GitHub API
+- **fix:** Update PR-and-check skill to fetch all tags (`git fetch origin --tags`), check for in-progress release workflows before proceeding, use `npm run test:e2e:examples` script, and set 20-minute E2E timeout
+- **chore:** Update docs-accuracy-reviewer to also verify skills and agent files against actual implementations
+- **chore:** Set sonnet model for test-runner and docs-accuracy-reviewer agents
+- **fix:** Correct inaccuracies in een-auth, een-devices, een-media, een-users agent files
+
+## Version
+
+`0.3.62`
+
+## Commits
+
+- `6df59c8` chore: Set 20-minute timeout for example E2E tests in PR skill
+- `fce1f9e` feat: Add E2E runner script, fix release PR summaries, update agents
+
+## Test Results
+
+| Check | Result |
+|-------|--------|
+| Lint | Passed |
+| Unit Tests | 600 passed (22 files) |
+| Build | Passed |
+| vue-alerts-metrics E2E | 20 passed |
+| vue-automations E2E | 24 passed |
+| vue-bridges E2E | 18 passed |
+| vue-cameras E2E | 41 passed |
+| vue-event-subscriptions E2E | 15 passed |
+| vue-events E2E | 16 passed |
+| vue-feeds E2E | 12 passed |
+| vue-jobs E2E | 34 passed |
+| vue-layouts E2E | 14 passed |
+| vue-media E2E | 20 passed |
+| vue-users E2E | 14 passed (passed on retry, transient OAuth callback timeout) |
+| **Total E2E** | **228 passed across 11 apps** |
+
+## Security Review
+
+No security concerns. Changes are limited to:
+- Shell script for test orchestration (no user input, runs locally)
+- GitHub Actions workflow fix (uses `gh` CLI with existing `GH_TOKEN`)
+- Documentation/agent file corrections (markdown only)
+- No new dependencies, no API changes, no auth flow changes
+
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+#### PR #92: Release v0.3.66 - GitHub Issues Resolution & vue-feeds Fix
+## Release v0.3.66
+
+This PR merges develop into production with GitHub issue resolutions, automation improvements, and critical bug fixes.
+
+### Summary
+
+- Resolved all 7 open GitHub issues
+- Automated event data schemas documentation generation
+- Fixed vue-feeds navigation reactivity issue
+- Added camera utility functions
+- Improved accessibility with aria-labels
+
+### Changes
+
+**Closed Issues:**
+- ✅ #84 - Added aria-label to JSON viewer button for screen reader accessibility
+- ✅ #70 - Implemented getCameraStatusString() utility function
+- ✅ #71 - Implemented isStatusObject() TypeScript type guard
+- ✅ #87 - Documented auto-generated vs manually maintained files
+- ✅ #89 - Fully automated event data schemas documentation generation
+- ❌ #85 - Closed as won't-do (JSON viewer E2E tests)
+- ❌ #76 - Closed as won't-do (datetime persistence test timezone)
+
+**New Features:**
+- `src/utils/camera.ts` - Camera status utility functions with full JSDoc
+- `scripts/generate-event-data-schemas-doc.ts` - Auto-generates AI-EVENT-DATA-SCHEMAS.md from TypeScript source
+- CLAUDE.md documentation section explaining auto-generated vs manual files
+
+**Bug Fixes:**
+- Fixed vue-feeds navigation not appearing after OAuth login (computed property for reactivity)
+- Updated all example app READMEs with accurate function lists
+
+### Test Results
+
+**✅ Passed (8 of 11 apps - 148 tests):**
+- vue-alerts-metrics: 20 tests
+- vue-automations: 24 tests  
+- vue-bridges: 13 tests
+- vue-event-subscriptions: 15 tests
+- vue-events: 16 tests
+- **vue-feeds: 12 tests** ✅ (Main fix verified)
+- vue-jobs: 34 tests
+- vue-users: 14 tests
+
+**Note:** 3 apps failed due to OAuth rate limiting (vue-cameras) and test config issues (vue-layouts, vue-media) - not related to code changes.
+
+### Security Review
+
+✅ Security review completed - No vulnerabilities found
+- All file operations use safe path handling
+- No command injection risks
+- Regex patterns safe from ReDoS
+- Vue components follow framework security best practices
+
+### Version
+
+v0.3.66 (auto-incremented from 0.3.64 via Husky pre-commit hooks)
+
+---
+
+Co-Authored-By: Claude Sonnet 4.5 (1M context) <noreply@anthropic.com>
+
 
 ### Detailed Changes
 
 #### Features
-- feat: Add getCameraSettings API, simplify camera list, add Google Maps link
+- feat: Resolve all open GitHub issues with automation and utilities
 
 #### Bug Fixes
-- fix: Use as const for settingsIncludes and fix vue-media Now button E2E test
+- fix: Add computed property for auth reactivity in vue-feeds example
 
 #### Other Changes
-- test: Add E2E coverage tests and update PR skill for sequential E2E runs
-- docs: Update vue-cameras home page to reflect current features
-- chore: Resize vue-cameras screenshot to 1200px width
+- docs: Address code review feedback for camera utilities
+- docs: Update example app READMEs to accurately list all toolkit functions used
 
 ### Links
 - [npm package](https://www.npmjs.com/package/een-api-toolkit)
-- [Full Changelog](https://github.com/klaushofrichter/een-api-toolkit/compare/v0.3.55...v0.3.60)
+- [Full Changelog](https://github.com/klaushofrichter/een-api-toolkit/compare/v0.3.63...v0.3.67)
 
 ---
-*Released: 2026-02-06 21:17:36 CST*
+*Released: 2026-02-08 17:32:38 CST*