CHANGELOG.md

[1.10.0] - 2026-07-14

🚀 Features

• (mcp) [breaking] Serve skills via read_skill tool (SPEC-010)
• (filesystem) File-backed EnapterAPI adapter (SPEC-011)
• (cli) Filetree:// URL scheme for filesystem.EnapterAPI (SPEC-012)
• (fake) Programmable EnapterAPI fake (SPEC-014)
• Make agent-test suite portable and fix inverted architecture

🐛 Bug Fixes

• (mcp) Read_skill docstrings, warn on empty plugins dir
• (filesystem) Validate filetree scheme in EnapterAPI.from_url

🚜 Refactor

• Remove domain re-export of core.RuleSlugConflict, use Self annotation
• (cli) Wire fake:// scheme, remove filesystem.EnapterAPI (SPEC-015)
• (cli) Derive skills_enabled from skill_provider construction

🎨 Styling

• (mcp) Unwrap docstrings, start text after opening quotes

🧪 Testing

• Three-layer agent acceptance test suite (SPEC-013)
• Agent acceptance tests on fake.EnapterAPI (SPEC-016)

⚙️ Miscellaneous Tasks

• Use --verbose in make serve

[1.9.0] - 2026-07-09

🚀 Features

• Expose blueprint_id on devices (SPEC-004)
• Expose profile mappings on declarations (SPEC-005)
• Expose device profile membership (SPEC-006)
• Add opt-in execute_command tool (SPEC-007)
• Add opt-in rule-editing tools (SPEC-008)
• (cli) Add list_resources command
• (mcp) Serve rule-creator skill as MCP resources (SPEC-009)

🐛 Bug Fixes

• Gateway_online coercion and properties manifest filtering
• (mcp) Make rule-creator skill path explicit and required when served (SPEC-009)

💼 Other

• Bundle rule-creator skill in Docker image (SPEC-009)

🚜 Refactor

• Use list[str] consistently for per-declaration implements
• Fold DeviceDTO into domain.Device with view wrappers
• Fold SiteDTO into domain.Site with SiteStatus
• Fold RuleEngineDTO into domain.RuleEngine
• Fold RuleDTO into domain.Rule, add RuleScript, move errors
• Extract McpRuleManagementPolicy from ApplicationServer
• (mcp) Split read-only and read-write tools registration

📚 Documentation

• (specs) Add SPEC-009 serve and bundle skills

⚙️ Miscellaneous Tasks

• (release) Bump version to 1.7.0
• (release) Bump version to 1.8.0
• Add AGENTS.md
• Symlink AGENTS.md to CONTRIBUTING.md
• Make AGENTS.md explicitly reference other docs
• Use caps for mcp
• Vendor enapter-skills submodule (SPEC-009)
• (Makefile) Unify exclude patterns for linting
• (Makefile) Default rule-creator skill path for make serve
• (release) Bump version to 1.9.0

[1.6.0] - 2026-06-17

🚀 Features

• Expose Enapter authorization role for sites and devices
• Expose access_level on blueprint declarations
• Expose access control model in MCP schemas (SPEC-003)

💼 Other

• Fix update-deps to re-resolve setup.py changes
• Upgrade enapter SDK to 0.23.*

⚙️ Miscellaneous Tasks

• (release) Bump version to 1.6.0

[1.5.0] - 2026-06-10

🚀 Features

• (cli) Require Sentry environment when Sentry DSN is set

💼 Other

• Upgrade enapter SDK to 0.22.0
• Upgrade fastmcp to v3
• Tighten dependency pins in setup.py

🚜 Refactor

• (cli) Store parser in App and parse CLI args in run

🧪 Testing

• (mcp) Add JSON schema snapshot checks for server tools

⚙️ Miscellaneous Tasks

• (release) Bump version to 1.5.0

[1.4.0] - 2026-05-12

🚀 Features

• Add rule engine state to site searching
• Add support for rule engine rule discovery and reading
• Check for online gateway before attempting rule operations

🐛 Bug Fixes

• Validate regular expressions in search queries upfront

📚 Documentation

• Add rule management tools to documentation

⚡ Performance

• Fetch site context concurrently in search_sites

🎨 Styling

• Fix isort error in core/init.py

⚙️ Miscellaneous Tasks

• (Makefile) Add serve target to start the server
• Upgrade enapter SDK to v0.20.1
• Upgrade enapter SDK to v0.21.1
• (release) Bump version to 1.4.0

[1.3.1] - 2026-04-30

⚡ Performance

• (api) Implement filtering command executions by state

⚙️ Miscellaneous Tasks

• (release) Bump version to 1.3.1

[1.3.0] - 2026-04-29

🚀 Features

• (commands) Add timestamp filtering to command executions

⚡ Performance

• Optimize command search and upgrade SDK to 0.17.5

⚙️ Miscellaneous Tasks

• (.gitignore) Add opencode.json
• (release) Bump version to 1.3.0

[1.2.0] - 2026-04-24

🚜 Refactor

• (core) Improve clarity and politeness of SearchQueryTooBroad messages

📚 Documentation

• Enrich tool docstrings to provide workflow context

⚙️ Miscellaneous Tasks

• (release) Bump version to 1.2.0

[1.1.0] - 2026-04-17

🚀 Features

• (core) Optimize alert retrieval via SDK expansion
• (mcp) Add 'has_active_alerts' parameter to search_devices tool

💼 Other

• (deps) Upgrade enapter SDK to 0.17.2

⚙️ Miscellaneous Tasks

• (git-cliff) Map merge pull requests to conventional format
• (release) Bump version to 1.1.0

[1.0.0] - 2026-04-13

🚀 Features

• (telemetry) [breaking] Require explicit aggregation function for historical telemetry

⚙️ Miscellaneous Tasks

• (.gitignore) Add .codex
• (release) Bump version to 1.0.0

[0.12.1] - 2026-04-07

🚀 Features

• Add CHILD device type

📚 Documentation

• (readme) Update usage examples for MCP submission guidelines

⚙️ Miscellaneous Tasks

• (.gitignore) Add .DS_Store to ignored files
• Bump enapter sdk to v0.17.1
• (release) Bump version to 0.12.1

[0.12.0] - 2026-03-31

🚀 Features

• Add device view types
• Support site id lookups in site search
• Narrow full device searches
• Support connectivity status filter in device search
• (mcp) Implement command execution search

🚜 Refactor

• Expose device list expansions in Enapter API
• Collapse device reads into one shape
• Make device search the primary read path
• Remove the legacy device details read
• Separate raw device transport from search reads
• Make site search the only site read path
• Drop internal site view branching
• Restore blueprint terminology
• Parse device manifests before app-layer reads
• Isolate Enapter HTTP payload mapping
• Simplify site search payload
• Isolate unavailable latest telemetry handling
• (mcp) Rename search parameters to '_regexp' to clarify regex support
• (mcp) Unify all enum values to lowercase

📚 Documentation

• (mcp) Update server instructions and tool documentation
• (readme) Add search_command_executions and refine tool list
• (readme) Add example workflows for troubleshooting and performance analysis

⚙️ Miscellaneous Tasks

• (release) Bump version to 0.12.0

[0.11.0] - 2026-03-26

🚀 Features

• Add command discovery to blueprint manifest
• Surface active alerts in device details
• Expose site-wide active alert totals

🐛 Bug Fixes

• Handle None values in telemetry and blueprint manifests

🚜 Refactor

• [breaking] Rename read_blueprint to read_blueprint_manifest
• [breaking] Unify data type definitions
• Unify latest telemetry around batched reads

📚 Documentation

• Simplify tool descriptions and consolidate instructions
• Remove redundant attribute sections from MCP models

⚙️ Miscellaneous Tasks

• (release) Bump version to 0.11.0

[0.10.0] - 2026-03-24

🚀 Features

• (mcp) Add mandatory title annotations for tool registrations
• (docker) Set 'serve' as default CMD to simplify container usage
• Add configurable CORS support for MCP server
• [breaking] Remove latest_telemetry from get_device_details

📚 Documentation

• (readme) Update guide for connecting AI applications and self-hosting
• (license) Add Apache 2.0 license and badge
• Add contributing guide and link it from README
• Add direct email contact for user support

⚙️ Miscellaneous Tasks

• Add glama.json manifest
• (release) Bump version to 0.10.0

◀️ Revert

• Chore: add glama.json manifest

[0.9.1] - 2026-03-20

⚙️ Miscellaneous Tasks

• (docker) Ensure reproducible image builds
• (release) Bump version to 0.9.1

[0.9.0] - 2026-03-20

🚀 Features

• (domain) Introduce SiteSpecification and DeviceSpecification for searches

🚜 Refactor

• Implement layered architecture to decouple core logic from MCP
• Isolate domain models from Enapter API contract using DTOs
• Rename 'Context' to 'Details' for domain models and MCP tools
• (domain) Move search matching logic into Specifications
• Decorate async generators with enapter.async_.generator

🎨 Styling

• Run black and isort to fix formatting issues

🧪 Testing

• (domain) Add unit tests for search specifications

⚙️ Miscellaneous Tasks

• (.gitignore) Drop mcp_client_config.json
• (setup) Upgrade enapter to 0.17.0
• Add git-cliff configuration and initial changelog
• (makefile) Update bump-version to generate changelog using git-cliff
• (release) Bump version to 0.9.0

[0.8.3] - 2026-03-02

🚀 Features

• (mcp) Client: proxy x-enapter-auth-user

⚙️ Miscellaneous Tasks

• (release) Bump version to 0.8.3

[0.8.2] - 2026-02-17

⚙️ Miscellaneous Tasks

• (mcp) Models: make type aliases implicit to enable dereference
• (release) Bump version to 0.8.2

[0.8.1] - 2026-02-17

🚜 Refactor

• Replace Enums with Literals using PEP 695 type aliases to fix Claude Desktop compatibility

⚙️ Miscellaneous Tasks

• (release) Bump version to 0.8.1

◀️ Revert

• Mcp: server: read_blueprint: rename section to blueprint_section

[0.8.0] - 2026-02-13

🚀 Features

• Integrate with sentry

⚙️ Miscellaneous Tasks

• (release) Bump version to 0.8.0

[0.7.2] - 2026-02-13

🚀 Features

• (mcp) Server: require JWT signing key if OAuth proxy is enabled

🚜 Refactor

• (mcp) Server: read_blueprint: rename section to blueprint_section

⚙️ Miscellaneous Tasks

• (makefile) Extend bump-version to make git commit and tag
• (release) Bump version to 0.7.2

[0.7.1] - 2026-02-12

⚙️ Miscellaneous Tasks

• (setup) Fix typo
• (release) Bump version

[0.7.0] - 2026-02-12

🚀 Features

• (mcp) Server: add read-only annotation for tools
• (mcp) Server: add optional jwt store

⚙️ Miscellaneous Tasks

• (release) Bump version

[0.6.2] - 2026-02-12

🎨 Styling

• (mcp) Server: customize logo

⚙️ Miscellaneous Tasks

• (release) Bump version

[0.6.1] - 2026-02-10

⚙️ Miscellaneous Tasks

• (cli) Serve: disable oauth proxy by default
• (release) Bump version

[0.6.0] - 2026-02-10

🚀 Features

• (mcp) Introduce server config
• (mcp) Add logging configuration
• (mcp) Server: optionally support enapter api authentication by username
• (mcp) Implement oauth proxy auth

🚜 Refactor

• (pipfile) Remove ollmcp
• (mcp) Server: use stateless http
• (mcp) Server: reuse enapter http api client

📚 Documentation

• Update README to reflect current implementation (#2)

🧪 Testing

• Add unit tests for data models with factory methods (#3)

⚙️ Miscellaneous Tasks

• (setup) Add httpx to dependencies
• (release) Bump version

◀️ Revert

• Server: print version on start

[0.5.0] - 2026-02-03

🚀 Features

• (models) Fix enum type annotation
• (models) Handle alerts data type
• (server) Implement pagination for blueprint sections
• (server) Add pagination for site and device search
• (models) Expose display_name from blueprint
• (server) Print version on start

🚜 Refactor

• (server) Rename read_blueprint_section to read_blueprint

📚 Documentation

• (server) Better instructions

⚙️ Miscellaneous Tasks

• (release) Bump version

[0.4.0] - 2026-02-02

🚀 Features

• (server) Introduce device blueprint

🧪 Testing

• (server) Remove latest telemetry tool

⚙️ Miscellaneous Tasks

• (release) Bump version

[0.3.2] - 2026-01-30

🚀 Features

• (cli) Add version command
• (server) Device context: manifest: handle empty telemetry and properties

⚙️ Miscellaneous Tasks

• Run only on python 3.14
• (setup) Fix enapter-sdk version
• (release) Bump version
• (release) Bump version

[0.3.0] - 2026-01-30

🚀 Features

• (server) Introduce site context
• (server) Introduce device context
• (server) Add timestamps to device and site contexts
• (server) Historical telemetry: set default granularity to 1h
• (cli) Call_tool: jsonify structured content
• (models) Describe device manifest

📚 Documentation

• (server) Better docstrings
• (server) Better instructions for historical telemetry

🎨 Styling

• (server) Formatting

⚙️ Miscellaneous Tasks

• (release) Bump version

[0.2.1] - 2026-01-20

🚀 Features

• (cli) Add call_tool command

📚 Documentation

• (readme) Update docker image version

⚙️ Miscellaneous Tasks

• (setup) Pin enapter sdk version
• (release) Bump version

[0.2.0] - 2026-01-20

🚀 Features

• (mcp) Add models
• (mcp) Server: add graceful shutdown timeout
• (mcp) Server: support historical telemetry
• (cli) Add list_tools command
• (mcp) Add server metadata

🚜 Refactor

• (mcp) Server: split tools into smaller ones
• (mcp) Server: move tool names and descriptions around
• (mcp) Move models to a separate package

📚 Documentation

• Initial plan
• Add comprehensive README.md
• Denser readme
• (makefile) Fix DOCKER_IMAGE_TAG usage
• (dockerfile) Configure server to listen on all interfaces by default

⚙️ Miscellaneous Tasks

• Merge pull request #1 from Enapter/copilot/create-readme-file
• (.gitignore) Add .gemini
• Pass task group to mcp server
• (release) Bump version

[0.1.0] - 2026-01-19

⚙️ Miscellaneous Tasks

• Init