Changelog

This page summarizes public Haptique OS release changes. Use the downloads page for current installers and the rest of these docs for setup guidance.

Unreleased

The next tagged beta release will be inserted below this section.

[1.2.0] - 2026-07-23

Haptique OS 1.2.0 Beta - Core Driver Updates, Package Alignment, and Runtime Diagnostics

Added

Runtime diagnostics and performance reporting for release and operational troubleshooting.
Roku driver package support with the bundled driver manifest and update package.
Release checklist hardening for shell package publishing verification.

Changed

Packages UI labels were simplified for consumers, and package cards now show the active installed version.
Core driver update logic now follows the active package and release version state more reliably.
macOS control surfaces now publish clearer invalidation events for runtime state changes.

Fixed

Core driver updates now resolve active packages, invalidate cached catalogs, and reload driver processes during live updates.
Update checks now compare remote packages against the active or bundled version without false-positive install prompts.
Driver update archives now accept supported partial package manifests.
Release validation was hardened for HomeKit, Roku, macOS artifacts, and hosted build environments.

[1.2.0-rc.5] - 2026-07-21

Haptique OS v1.2.0-rc.5

Haptique OS 1.2.0 RC5 Release Candidate.

Added

Settings now provides an explicit Port Change choice for network configuration.
Core driver remote updates are supported through the release update flow.

Changed

Shell update handling was improved for more reliable package updates and clearer update state.
The RC5 release train now runs its TypeScript release-gate tests on Node 22.

Fixed

Fixed UI bugs across Settings, update flows, and driver management screens.

[1.2.0-rc.3] - 2026-07-12

Haptique OS Beta v1.2.0-rc.3

Added

Add support for Amazon Bedrock as an AI provider
Add custom inference provider support and free coding models retrieval
Enhance AI settings tests and update styles for improved layout handling
Add new AI capabilities and enhancements
Add sync-class truth and Music Bridge subordinate endpoint model
Authoritative queue, session, and transfer engines
Add shared provider execution truth contract and discovery health elevation
Gate placeholder and incomplete source providers, tighten Local Library and Qobuz truth surfaces
Add AI connection overlay and network settings form
Add multi-provider registry with OpenAI and Custom provider support, fix build types
Add release smoke tests, notification management, and readiness reporting
Enhance shell package updates and UI improvements

Changed

Refactor code structure for improved readability and maintainability
Prepare Haptique OS 1.2.0-rc.3
AI scroll issue fix
Bug fixes for AI setup
Bug fixes in AI settings
Add debugging support and fix test cases in AI settings flow
Fix test cases for AI settings tabs: update error context and ensure visibility of provider catalog
Add error context files for Playwright tests and new OpenCode configuration
Fixed issue after rc2
Refactor font sizes across various views to improve consistency and readability. Changed font size from 11px to 10px in multiple components including license, logical device details, matter automations, and settings. This update enhances the overall UI by standardizing text dimensions.
Remove deprecated API endpoints and associated files from Haptique OS Mobile API
Fix docker license public key bundling
Disable auto Windows builds on Feature-development

Fixed

Filter built-in players and haptique-os logical device from mobile media surface
Capture raw cloud API error body on registration failure
Route IR library proxy to production cloud and add admin credential recovery

Documentation

Complete 04-03 queue/session/transfer authority plan
Complete 04-02 provider execution truth plan

Maintenance

Harden RC3 release train runners
Fix self-hosted release checkout and Docker startup
Remove free coding models provider functionality and update related UI elements
Add sync-class and Music Bridge subordinate endpoint regression tests
Queue, session, and transfer authority regression tests
Add cross-provider regression coverage for execution truth
Add source-gating and failure-state regression coverage
Remove obsolete GitHub workflows for server builds
Revert unsupported mac workflow override
Fix self-hosted non-Windows workflow parse
Add self-hosted non-Windows release workflow
Allow manual Windows release handoff
Add self-hosted release train path
Add fallback self-hosted Windows release workflow
Add minimal local Windows release workflow
Run Windows release workflow on self-hosted runners
Allow unsigned Windows builds on Azure, add arm64 matrix

[1.1.9] - 2026-06-25

Haptique OS Beta v1.1.9

Added

Add Haptique Music and HomeKit as AppShell packages
Synchronize local playback session with server state and enhance stream handling
Update package dependencies and add postinstall script for expo cleanup
Add initial index route file for server

Changed

Refactor code structure for improved readability and maintainability; removed redundant code blocks and optimized function calls.
Add initial UI layout for mobile application in ui8.xml
Call promote script via bash directly
Make promote script executable
Fix Azure CLI install on macOS self-hosted runner
Add self-hosted runner option to promote workflow
Add missing HOS_METADATA_CLOUD_URL env var
Fix void return in releaseAssetUrl helper
Fix duplicate comingSoon property in download config
Pin actions/checkout and setup-node to @v4 for older runner compat
Refactor code structure for improved readability and maintainability

Fixed

Quote Windows cleanup fallback safely
Harden Windows runner cleanup

Documentation

Capture phase context
UI design contract

[1.1.8] - 2026-06-20

Haptique OS Beta v1.1.8

Added

Enhance MediaRadioStation with providerKey, providerId, and bitrate fields
Align cross-shell target semantics
Add command owner validation helper
Preserve Kitchen fallback UI coverage
Bind dashboard modules to shell ownership
Reuse target semantics in Mac-control music
Add shell target semantics helper
Add shell ownership registry
Add packaged route smoke coverage
Add packaged startup diagnostics
Add dashboard module update lane
Add Kitchen promotion workflow
Add verified app update lane
Gate runtime catalog overrides by activation
Stage driver app activation records
Formalize Haptique App package contract
Define protected app update boundary

Changed

Add error context files for Playwright test failures in music storage page
Fix packaged HomeKit startup runtime
Add script to create Haptique OS social media assets
Pilot Roku as bundled Haptique App
Fix mobile media and room test drift
[verified] gate packaged HomeKit runtime release artifacts
Verify Haptique app artifact signatures

Fixed

Stabilize x64 packaged smoke
Stabilize packaged smoke shutdown
Align 1.1.8 certification tests
Preserve embedded navigation links
Validate root media command routes
Enforce shell command validation at dispatch
Address shell contract review findings
Stabilize packaged runtime smoke

Documentation

Add operations guide
Add security audit
Complete phase tracking
Add clean code review report
Complete cross-shell verification plan
Add cross-shell verification summary
Document shell verification matrix
Update plan progress metadata
Complete command owner routing plan
Complete dashboard module shell boundary plan
Complete shared target semantics plan
Complete shell ownership registry plan
Add shell ownership registry summary
Add shell boundary traceability guard
Plan core app shell contract
Complete packaged route smoke plan
Complete startup diagnostics plan
Add verification evidence
Audit milestone slice
Complete dashboard module update plan
Record Wave 2 mobile root-gate debt
Complete Driver Kitchen promotion plan
Complete verified app update plan
Record Wave 1 mobile root-gate debt
Complete staged activation plan
Complete protected core boundary plan

Maintenance

Bump server to 1.1.8
Verify shell runtime interactions
Add shell duplicate action regression
Add failing cross-shell target semantics tests
Add failing command owner validation tests
Add dashboard fallback UI regression
Add dashboard shell boundary regression
Add failing Mac-control semantics coverage
Add failing test for target semantics
Add failing shell traceability guard
Add failing test for shell ownership registry
Complete UAT - 5 passed, 0 issues
Add failing dashboard module UI tests
Add failing Kitchen promotion tests
Add failing app update lane tests
Add failing runtime catalog activation gate
Add failing staged activation tests
Guard MOD traceability and protected domains
Add failing Haptique App contract tests
Add failing boundary policy tests

[1.1.7] - 2026-06-18

Haptique OS Beta v1.1.7

Added

Add Community Code of Conduct and link in documentation
Enhance mac control popover with debugging capabilities and improve AV flow handling
Add new tools and workflows for Haptique OS integration
Enhance AI settings UI with new styles and layout adjustments
Unify server version resolution across components and update version to 1.1.6
Add script to cleanup orphaned Node/Electron processes holding locks on haptique.db
Add radio directory search and featured endpoints
Enhance Home Media Handling and AI Integration
Enhance HmusicSurface and HmusicTransport for responsive UI

Changed

Add circular backgrounds to projector source icons
Replace Sony projector source icon
Refactor icon handling and improve accessibility in mac-control-popover
Add Sony projector Fleet integration
Add error context for Playwright test failures related to navigation issues
ATVworker state issue fixed
Db bug fixed
Remove invalid server surge dependency
Fix Docker image license key bundling
Align Docker docs with license-first flow
Tighten license gating and persist runtime machine IDs
Improve mobile music playback and transport layout
Fix Docker one-click bootstrap runtime
Add one-click self-hosted Docker bootstrap
Finishing Tablet Hmusic transport
Refine Haptique OS UI and integration flows
Refactor code structure for improved readability and maintainability
Preserve OTA artifact aliases for release updates
Canonicalize music titles and refine home mobile layout

Fixed

Clear released runtime licenses from local state
Centralize runtime license lifecycle through myhos client
Require signed remote access entitlement
Restrict license bypass to dev runtimes
Remove master password auth fallback
Remove runtime secret fallback bootstrap
Use canonical OTA asset names

Documentation

Complete security remote auth phase execution
Complete remove runtime auth, secret, and bypass fallbacks plan
Update wiki api surfaces

Maintenance

Allow asset-only Windows release upload
Invoke npm reliably during release certification
Run release certification tests on Windows
Certify Windows assets before release upload
Support Windows upload-only release reruns
Harden Windows release cleanup
Tighten Windows self-hosted release reruns
Omit unsupported Windows ARM64 optional BLE modules
Use embeddable Python for Windows runner
Bootstrap Windows ARM64 build tools
Install Python in Windows self-hosted release
Harden unsigned Windows self-hosted builds
Allow unsigned Windows self-hosted release builds
Route Windows release builds to self-hosted runner
Disable gha cache for self-hosted docker bump
Configure self-hosted registry auth without keychain
Use docker desktop buildx on self-hosted bump
Avoid docker desktop keychain on self-hosted bump
Skip qemu on self-hosted docker bump
Use workspace docker config for self-hosted build
Isolate docker config on self-hosted runner
Make docker owner normalization portable
Allow docker bump on self-hosted runner
Update .gitignore and .dockerignore to exclude database files and runtime states; remove obsolete database files
Update network status handling to improve module compatibility and error handling
Disable self-hosted release cache restore
Allow release publish on self-hosted runner
Fix 1.1.7 release certification expectations
Prepare Haptique OS 1.1.7 release

[1.1.6] - 2026-06-15

Haptique OS Beta v1.1.6

Added

Unify server version resolution across components and update version to 1.1.6
Add script to cleanup orphaned Node/Electron processes holding locks on haptique.db
Add radio directory search and featured endpoints
Enhance Home Media Handling and AI Integration
Enhance HmusicSurface and HmusicTransport for responsive UI

Changed

Remove invalid server surge dependency
Fix Docker image license key bundling
Align Docker docs with license-first flow
Tighten license gating and persist runtime machine IDs
Improve mobile music playback and transport layout
Fix Docker one-click bootstrap runtime
Add one-click self-hosted Docker bootstrap
Finishing Tablet Hmusic transport
Refine Haptique OS UI and integration flows
Refactor code structure for improved readability and maintainability
Preserve OTA artifact aliases for release updates
Canonicalize music titles and refine home mobile layout

Fixed

Packaged integrations prefer unpacked resource manifests
Clear released runtime licenses from local state
Centralize runtime license lifecycle through myhos client
Require signed remote access entitlement
Restrict license bypass to dev runtimes
Remove master password auth fallback
Remove runtime secret fallback bootstrap
Use canonical OTA asset names

Documentation

Complete security remote auth phase execution
Complete remove runtime auth, secret, and bypass fallbacks plan
Update wiki api surfaces

[1.1.5] - 2026-06-11

Haptique OS Beta v1.1.5

Added

Add caching and metadata handling for Haptique Music
Add Hmusic player components and functionality
Implement global search functionality with caching and multiple providers
Implement Sonos households retrieval and token refresh logic
Update Sonos API URLs and add tests for authorization flow
Add detailed execution plan for music engine playback ownership and provider truth

Changed

Add error context files for Playwright tests and implement route tests
Add error context documentation for Playwright test failure and implement Volumio driver tests
Polished Profile screen UI, scaled text for readability, fixed tablet AV activity launcher

Fixed

Preserve canonical assets and publish handoff
Restore mac sqlite guard and docker context

[1.1.4] - 2026-06-09

Haptique OS Beta v1.1.4

Added

Add resolve_and_play_music and music_diagnostics tools
Add Haptique Music tools and functionality
Add Anthem and Onkyo integrations
Add certification process for local release artifacts

Changed

Exclude Docker build records from release assets
Keep Docker overview update from blocking releases
Make release train Windows signing optional
Disable auto Windows builds on Feature-development
Remove obsolete music and update screenshot assets
Add error context files for Playwright test failures related to OS updates
Fix OTA update bridge precedence for packaged builds
Refine OTA release verification and upload scripts
Refactor release artifact handling and enhance SQLite database recovery mechanisms
Enhance release workflows and application screens
Allow Docker workflow to build from a release ref
Restore tag-driven release train
Use canonical release artifact names
Add media library home endpoint and related functionality; improve error handling in DSP operations
Fix release workflow certification
Fix release certification blockers
Bump server release to 1.1.4
Add Playwright tests for music player and screenshot functionality
Fix HomeKit plugin catalog UI and compatibility
Fix Windows compiler define syntax
Fix Windows ARM64 native rebuild
Add Windows ARM64 release target
Fix mac linux Azure release publish
Prepare unsigned Windows x64 release 1.1.3
UI fixes
Allow explicit unsigned Windows hosted builds
Build Windows release assets on GitHub runners
Music services fixed
UI changes Server
Install Windows release dependencies from workspace root
Harden Windows local release script
Bypass execution policy in Windows workflow shell
Use Windows PowerShell for self-hosted release
Add self-hosted Windows release workflow

Fixed

Harden sonos local stream playback

Maintenance

Remove outdated debug log files and unused assets

[1.1.3] - 2026-06-06

Haptique OS Beta v1.1.3

Changed

Prepare unsigned Windows x64 release 1.1.3
Allow explicit unsigned Windows hosted builds
Build Windows release assets on GitHub runners
Install Windows release dependencies from workspace root
Harden Windows local release script
Bypass execution policy in Windows workflow shell
Use Windows PowerShell for self-hosted release
Add self-hosted Windows release workflow
UI fixes
Harden Windows local release runner
Normalize GitHub release asset names for Azure publish
Release 1.1.2 local publish tooling
Mobile UI fixes
Basic chages to Hmusic UI
Hmusic bsaic fixed and Frontend AV activity fixes
Bug fixes on OS
Enable independent Haptique music outputs
Light theme fixed

Maintenance

Add direct Haptique Music browse-mode navigation and embedded player library section tests
Add OTA release verification and Docker Hub overview sync

[1.1.2] - 2026-06-06

Haptique OS Beta v1.1.2

Changed

Split Windows out of main release workflow
Use hosted Windows runners for full release
Set up Python for Windows release builds
Avoid Bash workflow steps on Windows runner
Bypass PowerShell policy on Windows release runner
Use Windows PowerShell on self-hosted release runner
Prefer direct Apple notarization credentials
Use hosted Mac and Windows runner for full release
Fix hosted release DMG signing
Run x64 Windows release on self-hosted runner
Allow x64 release workflow to build feature branch
Load Windows signing certificate for self-hosted release
Sign Windows portable release artifacts
Fixes for releases
Install Windows release dependencies from workspace root
Harden Windows local release script
Bypass execution policy in Windows workflow shell
Use Windows PowerShell for self-hosted release
Add self-hosted Windows release workflow
UI fixes
Harden Windows local release runner
Normalize GitHub release asset names for Azure publish
Release 1.1.2 local publish tooling
Mobile UI fixes
Basic chages to Hmusic UI
Hmusic bsaic fixed and Frontend AV activity fixes
Bug fixes on OS
Enable independent Haptique music outputs
Light theme fixed

Maintenance

Add direct Haptique Music browse-mode navigation and embedded player library section tests
Add OTA release verification and Docker Hub overview sync

[1.1.1] - 2026-06-03

Haptique OS Beta v1.1.1

Changed

Update rooms screens and related tests
Fix HOS license pairing resume
Simplify HOS license activation page
Fix HOS license activation page behavior
Add cloud pairing to locked license page
Bump server release version to 1.1.1
Publish Windows x64 test build to Azure Blob
Fix compact player row actions
Remove OS live design script from runtime shell
Refine OS updater status UI
Flatten existing artifacts before release publish
Add release publish from existing artifacts workflow
Refine mobile media and discovery flows

Documentation

Add Icon Copy Restraint Rule for minimal icon-adjacent text
Preserve RS90 Apple TV Companion session-start fix and narrow protocol usage

Maintenance

Add Haptique Music volume control and live status precedence tests
Add AV Flow power control and multi-flow mode tests

[1.1.0] - 2026-06-01

Haptique OS Beta v1.1.0

Changed

Disable npm cache on self-hosted macOS release build
Fix OS license claim release build
Bump server release version to 1.1.0
Refine mobile media and discovery flows
Point HOS licensing to myHOS API

[1.0.13] - 2026-06-01

Haptique OS Beta v1.0.13

Changed

Guard release tag version before builds
Bump server release version to 1.0.12

Fixed

Ship browser server OTA release path

Maintenance

Remove update URL assertions from OS updates settings spec
Add comprehensive layout and image prefetch tests for Haptique Music tablet view

[1.0.12] - 2026-05-31

Haptique OS Beta v1.0.12

Added

Use self-hosted runner for macOS ARM64 builds to save costs

Changed

Document Azure metadata cloud for beta

[1.0.11] - 2026-05-31

Haptique OS Beta v1.0.11

Added

Add keyboard navigation and accessibility to color controls
Refactor media controls and add state streaming

Changed

Bump version to 1.0.11 for OTA release
Fix AV Activity flow creation
Improve Macbar music player controls
Fix AirPlay handoff local playback ownership
Fix completed AirPlay stream health
Clarify AirPlay pairing controls
Fix AirPlay transport timeline
Fix direct AirPlay output routing
Harden music playback routing
Fix haptique music airplay pairing
Remove .kilo directory and agent workspaces
Enhance music refresh UI and update test fixtures
Remove GSD agent definitions and update code review workflow
Add OTA installer progress UX
Add browser OTA update fallback and packaged runtime protocol

Fixed

Checkout tag instead of main branch to ensure correct version
Resolve remote page UI alignment bugs and pending flows
Report AirPlay startup stream exits
Mobile auth controller transport and discovery improvements
Light theme UI fixes for music output selector and OS sidebar
Wire music endpoint update route
Enable discovered AirPlay music outputs

Documentation

Add hover states and flow builder support
Finalize verified phase plan
Create phase plan
Map implementation patterns
Record phase 1 UI-SPEC approval
Approve UI design contract
UI design contract
Research packaged runtime smoke gate
Record phase 1 context session
Capture phase context
Create roadmap (7 phases)
Define v1 requirements
Complete project research
Initialize project
Map existing codebase

Maintenance

Clean server release directory before builds across all platforms
Add retry logic for macOS notarization with 3 attempts and 30s delay
Add project config
Complete impeccable UI generation sessions and update agent rules
Update impeccable server config and enhance music player routing with AirPlay pairing
Add music services e2e controls spec, update AGENTS.md and deps
Split HMusic AirPlay worker

[1.0.10] - 2026-05-28

Haptique OS Beta v1.0.10

Added

Replace browser history navigation with sequential page navigator in web topbar
Add scroll position persistence across media tabs and forward navigation button
Redesign multiroom music players page with hero card, dashboard layout, and enhanced player cards
Remove action map integration from interface lab
Remove action maps UI from driver integration details page
Add auto-open player navigation, unified roster/candidates merge, and manage sheet improvements
Add opening device control, home recommendations, and enhanced light/device resolution
Add single playback instance guardrail and type safety
Add MusicBrainz enrichment, remote cloud fallback, and parallel processing
Add remote relay support, light UI improvements, and library filtering
Add accessibility, light device submenus, and local playback support
Add online claim code activation and Linux machine ID support
Add system prompt, noise filtering, and terminal env hardening
Public-facing developer portal for external driver authors
Public-facing developer portal — getting started, driver lifecycle, architecture, domain ref, entity types, troubleshooting, driver manifest, updated nav/sidebar, Azure SWA config
Add driver_builder_repackage_package tool for revising existing Driver Builder artifacts
Add MCP Migration Architecture Design documentation
Add shell navigation transitions
Implement UPnP/DLNA player provider and discovery
Enhance device management and testing infrastructure
Add OS launch QA report and remediation plan
Update TypeScript configuration and extend from Expo base config
Add StormAudio integration with TCP/IP control
Add StormAudio driver with comprehensive snapshot management and command catalog
Implement refresh logic for Bravia TV apps and add unit tests for adapter functionality
Enhance Bravia TV integration with app management and control features
Enhance profile and scenes screens with safe area insets and improved styles
Enhance tab sanitization to ensure unique IDs and update memory logs with new scene run entries
Add Sonos player provider implementation
Implement final design enhancements for RoomieRoomsHomeScreen
Enhance compact display for systems grid with improved button styles and layout
Enhance device filtering logic and add scene run entries to logs
Add user prompts and tool calls for YouTube on Apple TV integration
Port Feature-development OS voice updates
Add OS voice and TV app updates
Implement Apple TV voice stream pilot feature with device gating and environment configuration
Add Generic IR driver support and related functionality
Enhance HVAC control with cooling and heating threshold temperatures, add media shuffle and repeat functionality
Enhance Sonos artwork proxy handling and prioritize targets in artwork retrieval
Add AI model path configuration and enhance Samsung TV client connection handling
Enhance Samsung TV discovery and client functionality
Implement Samsung TV discovery and pairing support
Enhance HVAC support for MirAIe devices in HomeKit integration
Add VolumeSlider component for media control and integrate AI features into mobile app
Update AI model references and add Gemma 4B model support
Add LLaMA integration and AI module management
Implement AI service management and module downloading functionality & Updated Readme
Add SafeLinearGradient component for fallback handling of expo-linear-gradient
Expand API spec to cover fleet bridge and full OS API surface
Add interactive API tester powered by Scalar
Add dev setup wiki page (WIKI-06)
Write mobile app wiki page (WIKI-04)
Add API reference wiki page (WIKI-05)
Write server internals wiki page (WIKI-03)
Add HOS overview page with driver ecosystem and control flow
Add monorepo map page and configure ignoreDeadLinks
Scaffold VitePress wiki site at /wiki/
Create driver-lifecycle.md with all 5 lifecycle phases
Create troubleshooting.md for common driver errors
Create architecture.md with ASCII system diagram
Create entity-type-reference.md with all type schemas
Create getting-started.md for HOS Driver SDK
Create domain-reference.md with all 5 domains
Enhance Apple TV integration and designer features
Enhance device pairing logic and add app icon resolution for Apple TV
Add simulated device sample driver
Implement HosDriver class with WebSocket client, reconnect, and typed message builders
Scaffold /sdk/ workspace with package.json, tsconfig, types, and barrel export
Add HOS Fleet device list and detail pages with integration-detail-layout
Add HOS command dispatch method and route
Add HOSCategory export and POST /device/hos/category route
Wire HOS device routes in app router
Create HOS device controller with store and addedDevices
Create helpers/control/hos/ with hosControls router and 10 entity files
Register HOS as device source in constant.ts and category-allow.ts
Add system check script and Playwright E2E tests
Fix homebridge stability bugs and add auto-restart
Stage all in-progress work for cross-machine build compatibility
Harmonyactivity entity domain + dedicated activity widget on logical device page
Harmony hub always active, Power Off activity, now-playing support
Editable domain chips on list page
Render online/offline status block on Harmony device detail page
Pass harmonyConnectionStatus from controller to template
Restore premium Media UI with compact Apple Music card and side drawer management
Integrate fleet credentials with fallback and legacy aliases
Add fleet release manager groundwork
Patch renderPagesTree with live nav tree fallback and wire generateFromSetup
Add getNavTree API endpoint to designer controller and route
DynamicRenderer hidden node filter + SpaceDevices widget
Restructure designer left panel into Pages/Tools dual-tab layout
Mobile socket.io-client hook + Socket.IO listeners in TabConfigContext and useDesignFetch
Server Socket.IO designer channel + emit on publish
Visibility toggles and hidden preview state (DES-02, DES-05)
Add publish toast notification (DES-04)
Auto-populate on open and draft choice dialog
Add Homey Pro integration with discovery sync and control
Add IP audio drivers and StreamMagic integration
Add anthem and bluesound integrations with dirac controls
Improve logical-device UX and add integration device info
Add global button click feedback and update desktop download README
Improve sensor mapping flow and canvas publish reliability
Complete phase 2 sensor trigger conditions
Add sensor widget with live mapper and preview support
Upgrade media player card mapping and source start flow
Implement System Awareness v1 backend layer
Add strict v1 websocket typed command protocol
Refine logical device table and stabilize programs drawer interactions
Ship UI lab canvas sharing, zones, and integration UX updates
Standardize logical light controls and driver UX
Add discovery, metadata-rich integration, and core adapter wiring
Checkpoint UI, protocol, and integration manager updates
Add entity model APIs and integration-first logical device workspaces
Add projects, wizard, and responsive OS UI

Changed

Modify npm install command to ignore scripts
Restore music transport waveform and controls
Use Linux source packaging for branch Windows build
Fix branch Windows workflow checkout on Windows
Add branch-scoped Windows server build workflow
Add lightweight HOS EJS shell navigation
Fix React music services UI wiring
Split large code files - Mobile
Fix routine API endpoints and add monthly trigger support with improved parameter validation
Add Gemini CLI inference provider and OS Builder destructive action confirmation gates
Add Gemini inference provider and OS Builder Chat preview-only mode with approval gates
Remove sensors navigation links and duplicate sensor routes, add save icons to buttons
Redesign fleet releases page with compact table layout and bulk submission
Add macOS menu bar dashboard panel with music player controls and device management
Fix admin device list user display and pagination, add profile link in header
Wiim integration add (cherry-picked from RatanDG/cantata)
Add macOS menu bar helper app and enhance Mac controls with audio quality display
Render markdown in AI driver builder chat
Complete music services phase 7 control surface
Enhance Mac control popover device controls
Add opt-in Mac control popover
Improve music service group transfer handling
Add controlled web sources to AI driver builder
Update Music Services Phase 6 execution plan with v2 authoritative reads and queue playlist features
Add queue shuffle/repeat controls and save queue as playlist feature
Clarify AI Driver Builder MCP architecture and add parentArtifactId to repackage tool
Add AI chat MCP development mode
Enhance RoomDashboard styling with environment indicators and add humidity display
Add floor and location fields to RoomTile, RoomDashboard, and space management components, sensor display on RoomScreen
Refactor code structure for improved readability and maintainability - Rooms list improved.
Update HOS branding across server assets and views
Add comprehensive guide for Haptique OS Music Services usage
Generate iOS project in TestFlight workflow
Add mobile TestFlight upload workflow
Add Roon-class replacement research document for Haptique OS Music Services
Add manual x64 server DMG publisher
Use macos-14 for x64 release DMG
Find release DMG artifacts recursively
Publish server DMGs without desktop zip jobs
Use legacy peer deps in release installs
Split release builds by architecture
Harden license public key prep paths
Track server license public key source
Make license key prep path explicit
Limit tagged releases to macOS assets
Prepare 1.0.6 release with bundled licensing
Add manual server DMG publish workflow
Publish server notarized DMGs in releases
Track server macOS signing assets
Fix notarized build signing identity
Fix macOS notarized server workflow install
Tizen power power fixed
Samsung Tizen is now solid.
Add new logo and home icon images for iOS simulator
Refactor code structure for improved readability and maintainability
Fleet Release device list and status change api
Remote. Response chnages and Mobile Device list changes
Generic IR token fixed
Refactor HVAC Control Screen and HomeKit Bridge Service
Update AI provider configuration and enhance Sonos adapter tests
Add OpenRouter provider configuration for AI integration
Improve rooms home favorites panel wiring and coverage
Refactor HaptiqueContext and related components for improved performance and readability
Fixed_broken frontend loading
Home page issues solved
Apple TV fixed
Fleet sorted
Zones and Actions out
Phone home layout fixed
Tablet home page solid work
Enhance home scene tap animations
Fix home favorite device persistence
Refine mobile home dashboard favorites
Major UI change on the Mobile App
App development phase 2
UI alignment and loading solved
Matter Bridge added
Bump version, add CHANGELOG, HOS fleet UI + Android TV driver
Fleet submit improved
HOS device category
API response(fleet) fixed
Fix infinite render loop in RoomsDataContext
Redesign light controls, room dashboard, and media player UX
Restructure into monorepo with apps/server, apps/mobile, packages/shared
Save current workspace changes
Add GitHub Actions workflow for quality and security checks
Restore browser dashboard opening and fix driver integration view
Add spaces room dashboards across OS API and UI
Tighten mobile media-player target filtering
Refine Canvas media player card
Fix Sonos seek command resolution
Tighten media service logical device filtering
UI Lab: enable free section move/resize with persistent canvas layout
Fix light-theme rendering and restore H logo assets
Refactor interface lab into partials and fix light view contrast
Add remote custom-ui APIs and fix light-group filtering
Harden driver websocket session lifecycle
Add x64 Ubuntu AppImage artifact
Stabilize mac menubar beta app and update docs
Refine Programmer UI history timeline with compact snapshots
Fix remote pairing PIN flow and ownership checks
Add legacy app API compatibility and enforce strict JWT auth
New OS driver features, fix for current Admin
Add driver upload flow, integrations, and Docker/dev docs
Self-hosted mode + docker setup + update check-only
Live
Rf device add and add in extender
Message add
Clone sequence
Home Assistant add multiple integration
Sequence command delete
Sequence sorting api
Changes
Mqtt config add
Backup
Trinnov device add
Ir library key suggestion make unique
Sequence name make unique
Clear invalid fcm tokens, and module wise notification send; web publish button fix and status show
Ir extender device details api and message add
Ir extender list add in remote api, make ir library public private
Ir extender list add in remote api
Ir extender remove from device
Admin fire base notification
Ir extender add sequence details
Ir extender device add and room add in extender
Mute unmute keymapping fix
Env modify
Import changes with shorthand
Env common make
Icon folders change
Icons changes
Ac key mapping revise
Ac key mapping complete
Live move
Key mapping change
Ac command grouping
Android tv add brand based commands value, irlibrary add ac device data
Ir library api count add
Custom url change
Version issue fix
Set live
New bluetooth device add
Remote software update
Key mapping ”_” remove refactor
Apple-tv device add
User ir library module
Merge for live
Message backup
New icon add and web pages
Web hook cb screen re design
Move to live
Homey integration add
Yamaha integration and device edit add
Ir extender allow for all users
Live merge
Ir extender device add and key mapping
Live upload
Fire tv remove
Android tv command refactor
Custom url remove reset room and quick buttons
Android tv add command
Devices add in default room
Changes backup
Home assistant add automation device; ad room images
Dummy remote connect for store demo
Ios update, room default background image list add
Ios update
Remote name rename
Multiple remote support
Remote config api
Sequence add command execution delay
Portuguese language add
Custom urls icons list apis; add update custom urls
Reset remote; sequence name update; mobile dashboard : app update popup info
App live
Socket fix
Project live
Media box category add and key mapping
Phone remove merge
Fixing and new predefine sequence add
Keymapping details add in sequence details api
Sequence create collect remote key mapping and update; source and device icon add in category
Predefine activities list and details; ac expand key make
Ac timer key mapping
Fan keys add
Key changes
Integration and device source name change
If key mapping add DVD, projector, avr, lamp
Ir data socket changes; denon device add give already exist
Denon device direct add without integration
Denon integration list; device details update with access details; delete singe integration device
Refactor partial complete
Device add refactor on process
Ir device add api with refactor
Social login fix
Ir chines data logic scrap
Ir kookong integration start
Log add
Key mapping update api
Predefined activities steps object prepared
Remote and sonos key change
Remote - config integration filter
Sonos - added devices ids, sonos integration details update api
Sonos add devices
Sonos create web hook and generate token
Philips integration create
Avr ir data add
Remote api add integration key details
Integration details add in remote api
Philips list api added devices; integration delete remove all devices refactor
Phillips device add and integration merge with old integration
Add phillips integration and remove
Remote key add
Room and sequence icons add
Home assistant device merge at add time
Widget list api add selected widget
Tasmota switch and light multiple add
Facebook login fix
Facebook login email optional
Remote category add; nodemon change
Demo app merge
App account delete api
Volume and chanel key swipe
Move in live
HA media player add
Other devices add and changes
Denon third party device add
New ir device add
Change
Custom device key change
Implement ir db custom device
Spotify fix
Server restart fix;facebook login account delete; and success lending html
Sonos add; other icons add
Remove button type and position from control
Home asst key changes
Home asst complete
Backup before home asst restore
Remote response add key source; integration get api; spotify refresh token api;
Spotify auth integration on progress
Spotify integration start
Demo app create api connect remote
Third party device key mapping
Admin app upload add validation check
Admin app upload add validation
Admin app upload fixing
Admin app upload change
Changes make live
App & remote api add dynamic app update config
Admin add app update setting develop; remote api add app update; set opacity in room api
App update data inc config api
Particular room details reset api
Changes live
Config change
Add en and fr messages
Language translate add in api and socket
Update auth.ts for local field issue
Language message method implement
Add local option in auth module
Reset all device api send otp and opt verification
Reset all device api
Reset room api
Projector key map change
Power key grouping for all categories
Commands filter unused commands
Ir change with live data; add device light color grouping add; filter commands
Ir change with live data
Remote details add favourite controls
Bin controls comment
Device favourite channel list set and get
Third party device source wise listing
Third party device add update method
Ir command grouping; ac create separate temperature
Remote add profile details api
Key map add data
Data ser refactor
Ir device control data set prepared; set key map
Remote disconnect api and remote disconnect socket remove
Socket device ir data test socket
Room list ordering
Icon compress added
Icons add compress; remote details add device config; integration add validation
Icons add
Icons folder refactoring
Third party changes
_id refactor with id; socket multiple remote connect disabled
Seeder make
Device name edit api
App room details api add quick button details
Remote room list with in details
Ir category language translate fixing; socket connect remote add access token
Device category and model list add google translate
Third party integration set & get api; sequence get command list & command device list
Env and validate env update
Dashboard add room count
Remove device clear from sequence and room
Existing ir device ir data copy module
Room change action name and icon option add; room action icon list add;
S3 bucket connection validation; room details changes
Icon add
Room details; third party device icon list; third party device add;
Room add layout type
S3 store image
Room set details api; room set actions api; room list api; room details api;
Ir device find and get existing control with update keys
Ir device find and get existing control
Air-conditioning IR data command generate,using loop
Sequence device list api; sequence device details api; sequence icon list api;
Icon remove
Admin dashboard add room count
Dashboard device count chart
Admin device status filter
Admin data able search highlight
Admin data table add no record found
Connected remote list api;
Remote list; device list; image preview
User details; user device list; disconnect remote;
Admin logout
Admin middleware; dashboard add count
Setup flash message
Users datatable pagination and apply filters; login page design
Admin sb-admin setup; dashboard & user data table design
Admin material ui backup
Device control command array to string convert
Ir data add on/off ir data dynamic; pair device add model id;
Ir data add on/off ir data dynamic
Dashboard add device count, ir devise test data api, ir device generate controls
Dashboard add device count
Add ir device, device list
Device category, brand, model, api
Dashboard remote list add
Remote disconnect socket api for remote & app
Dashboard connected remote list add on progress
Models add row data formatter, created data cleaner
Encrypt decrypt helper, country details update api, phone number update api, profile details update api, socket remote pairing update
Profile set locality api
Integration make hub auth details store
Home Assistant auth token end point
Device remove
Sequence delete then remove froom room
Remote room list
Device details
Macro layout add edit details delete list
Sequence add, edit, details, list; add sequence icon list
Add device; device list
Ir data icon add
Remote connect socket complete
Config api
Dashboard
Login with google
Register, login, logout api
Basic app setup and helpers create
Init

Fixed

Run OTA publish script via bash
Use supported macOS Intel runner
Avoid MSYS path conversion for MSVC define
Require serialport for release builds
Stage Windows release artifacts
Stabilize release artifact workflow
Add @scalar/api-reference dep, wiki tsconfig, Node 22, checkout@v4
Remove invalid-path zip from git, add libudev-dev to Linux CI, fix Swift concurrency capture
Add wiki-scoped tsconfig to prevent expo/tsconfig.base resolution error in VitePress build
Remove runtime npm install - esbuild bundles all deps into index.js
Set Docker build context to repo root for monorepo workspace resolution
Use monorepo root context to resolve @haptique/shared workspace dep
Clarify Node.js only needed for TS/JS SDK, point Python users to Driver Manifest
Consolidate Node.js prereq to top of getting-started
Remove all dead links to removed contributor pages
Remove Contributor Docs from nav and sidebar
Remove all internal repo structure references from public pages
Resolve merge conflict markers in wiki docs
Restore Apple TV AV contrast and ON-state highlight
Harden homebridge runtime recovery
Use listTypedCommands() instead of LogicalDevice.commands — property does not exist on type
Device.store() fetches OS commands and populates HOS controls
Revise plans based on checker feedback
Suppress MaxListenersExceededWarning on HomeKitBridgeService
Correct isIntegrated for Apple TV & Hue; suppress IR proxy forward logs
Fix Harmony state never reaching Home app; surface dispatch errors
Scope activity dropdown to Harmony activities only; hide App/Content for smarthubs
Move online/offline status into Device Info block, remove extra bar
Revise 02-02-PLAN based on checker feedback
Fix tab bar scroll, add-tab creates linked screen
Compact section render and improve mobile viewport handling
Refresh favicon assets and stabilize sidebar toggle

Documentation

Add Haptique Music API navigation links and reference section
Mark reachability detection task as in-progress
Add OS list layout standard, platform-specific UI rules, and integration default guidance
Add Kitchen submission MVP and automation phases with completion status
Streamline UI verification rules and remove redundant guidance sections
Add program YAML scripts guide
Expand guardrails with UI verification requirements, music playback rules, and HomeKit plugin branding
Complete API reference and dev setup wiki pages plan
Complete server internals and mobile app wiki pages
Complete VitePress wiki scaffold, monorepo map, and HOS overview plan
Research repo developer wiki phase
Evolve PROJECT.md after phase completion
Complete phase execution
Complete core developer docs plan 1 - getting-started, architecture, driver-lifecycle
Complete reference documentation plan
Create phase plan
Capture phase context
Complete sdk-scaffold-helper-library plan - HosDriver with typed WebSocket client and protocol types
Add validation strategy and phase plans
Research phase domain
Create roadmap and state
Define requirements
Initialize project
Map existing codebase
Build core driver for BlueOS integration to control BlueOS wireless speakers and also NAD AVR in the OS
Complete Bluesound and NAD AVR driver test coverage plan
Plan BlueOS and NAD AVR driver test coverage
Complete HOS Fleet UI plan automated tasks, checkpoint reached
Complete HOS command dispatch plan — checkpoint reached
Complete HOS controls fix and category route plan
Fix spacing contract — lg to 24px, freeze legacy 18px and non-4x tap targets
Fix UI-SPEC checker blocks — typography weights, font sizes, spacing lg token
UI design contract
Add validation strategy
Research HOS Fleet Manager UI Polish
Complete HOS device controller and routes plan
Complete HOS source registration and control scaffold plan
Record phase 5 context session
Capture phase context for HOS fleet integration
Complete fix-homebridge-stability-and-add-system-check plan
Add online/offline status info block for Logitech Harmony in Logical Device UI
Complete Harmony online/offline status block plan
First-run onboarding; root npm start and Turbo packageManager
Add root README and standardize app documentation
Complete designer UAT gap closure plan 02-03
Create gap closure plan 02-03
Complete mobile-integration socket push plan
Complete designer Pages/Tools panel and MDI icon preview plan
Record phase 2 context session
Complete visibility toggles and hidden preview state plan
Add execution summary for tab bar scroll fix
Build intel Mac build
Complete intel mac dmg build plan
Complete auto-populate, draft dialog, publish toast plan
Record phase 1 context session
Create roadmap (3 phases)
Define v1 requirements
Add v1.0.4 release write-up
Add linux arm64 appimage download link
Publish v1 driver handoff and updated smoke client
Add Ubuntu x64 AppImage quickstart for testers
Expand docker usage

Maintenance

Add macOS Intel (x64) and Windows arm64 build jobs to release workflow
Bump version to 1.0.10
Consolidate release — single workflow only, disable duplicate platform builds
Bump version to 1.0.9
Trigger Azure SWA wiki deployment
Add pre-build step for VitePress wiki before Azure deployment
Allow manual wiki deployment runs
Rerun wiki deployment after checkout fix
Bump version to 1.0.8
Bump version to 1.0.7, configure OTA, fix Windows build trigger
Trigger wiki deployment
Add tag-triggered Linux x64 AppImage+deb release build
Add Linux builds, OTA publishing to Azure, and Docker Hub registry support
Add tag-triggered Windows x64 EXE release build
Push image to both GHCR and Docker Hub on tag/dispatch
Add docker-compose.yml for beta testers
Revert docker image target to personal ccs777 GHCR
Push Docker image to Cantata Communication Solutions org GHCR
Trigger Docker build+push to GHCR on tag push with semver tags
Add Windows x64 build job to tag-triggered release workflows
Add generate-license workflow for on-demand .lic file generation
Add arm64 DMG individual publish workflow for testing
Add Windows x64 EXE publish workflow
Fix release-builds x64 to checkout main and use tag name as version
Fix release-builds arm64 to checkout main and use tag name as version
Fix release builds to checkout main and use tag name as version
Remove npm cache logs and add smarthome device import selection UI
Remove npm cache artifact for jest-message-util package metadata
Move contributor docs to docs/internal/, remove from public wiki
Add Azure Static Web Apps workflow file on-behalf-of: @Azure opensource@microsoft.com
Improve layout and styling of device header and quick command panels
Redesign program builder selection UI with enhanced visual hierarchy and illustrations
Replace hardcoded color values with palette tokens in driver integration and logical device views
Replace hardcoded color values with palette tokens across mobile and server views
Update package.json with Tailwind CSS and dependencies
Add mac signed build workflows and server docker build workflow
Rename RoomieRoomsHomeScreen to RemoteUI and update navigation
Optimize media fetching and reduce re-renders in HaptiqueProvider and RoomsDataProvider
Persist human verification items as UAT
Fix plan file naming convention (PLAN-01 → 01-PLAN)
Add project config
Wipe GSD planning directory — starting fresh
Remove scrapped Phase 4 mobile redesign, renumber phases
Add NAD AVR adapter unit tests
Add Bluesound adapter unit tests
Add Wave 0 test stub for HOS command dispatch
Add Wave 0 HOS category and controls test stubs
Add failing stability tests for homebridge service
Set ios bundle id to com.hos.frontend
Complete UAT - 7 passed, 0 issues
Publish stable latest asset names and bump to 1.0.4
Allow partial linux publish and bump to 1.0.3
Harden CI runners and bump to 1.0.2
Add tag-based build+publish workflow and bump to 1.0.1
Refresh desktop artifacts and compact dashboard settings
Checkpoint after docker shareable build
Track dist runtime output for release
Skip dmg notarization hook when no dmg artifact is produced
Add AppImage packaging config and libfuse compatibility check
Remove local artifacts
Sync current state

[1.0.5] - 2026-03-26

Added

HOS Fleet Manager UI (Phase 06): full web UI for managing HOS device fleet
Android TV driver: ADB-based control of Android TV and Google TV devices
Integration Release UI overhaul: redesigned driver-integration releases page
Driver test coverage: 93 unit tests across Bluesound (BluOS) and NAD AVR adapters
Fleet bridge auto-expose: automatic device exposure through fleet bridge
Mock device manager: mock-device-manager.ts for test isolation

Fixed

LogicalDevice.listTypedCommands() called correctly
Fleet submit flow improvements

Drivers

Bluesound (BluOS): HTTP API, port 11000, full command/state support
NAD AVR / Anthem AVR: TCP, port 23, Dirac Live commands
Android TV: ADB over TCP, full media + power control

[1.0.4] - 2026-03-18

Added

HOS backend dynamic device support (Phase 05)
HOS source registration and control scaffold
HOS device controller with store and addedDevices routes
Designer web UI: hidden node support, draft/publish model
Mobile integration: socket push, dynamic renderer, pages tab navigation

Fixed

Intel Mac x64 build pipeline and notarization script
Homebridge stability bugs; system check script with Playwright E2E

[1.0.3] and earlier

Older public notes may be folded into this page over time. Use the current docs and official download channel for active setup guidance.