Files
haos-hacs-immich-album-watcher/CLAUDE.md
alexei.dolgolyov c29fc2fbcf
All checks were successful
Validate / Hassfest (push) Successful in 3s
Add Telegram file ID caching and reverse geocoding fields
Implement caching for Telegram file_ids to avoid re-uploading the same media.
Cached IDs are reused for subsequent sends, improving performance significantly.
Added configurable cache TTL option (1-168 hours, default 48).

Also added city, state, and country fields from Immich reverse geocoding
to asset data in events and get_assets service.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-01 03:12:05 +03:00

1.4 KiB

Project Guidelines

Version Management

Update the integration version in custom_components/immich_album_watcher/manifest.json only when changes are made to the integration content (files inside custom_components/immich_album_watcher/). IMPORTANT ALWAYS ask for version bump before doing it.

Do NOT bump version for:

  • Repository setup (hacs.json, root README.md, LICENSE, CLAUDE.md)
  • CI/CD configuration
  • Other repository-level changes

Use semantic versioning:

  • MAJOR (x.0.0): Breaking changes
  • MINOR (0.x.0): New features, backward compatible
  • PATCH (0.0.x): Bug fixes, integration documentation updates

Documentation Updates

IMPORTANT: Always keep the README.md synchronized with integration changes.

When modifying the integration interface, you MUST update the corresponding documentation:

  • Service parameters: Update parameter tables and examples in README.md
  • New events: Add event documentation with examples and field descriptions
  • New entities: Document entity types, attributes, and usage
  • Configuration options: Update configuration documentation
  • Translation files: Add translations for new parameters/entities in en.json and ru.json
  • services.yaml: Keep service definitions in sync with implementation

The README is the primary user-facing documentation and must accurately reflect the current state of the integration.