CIRISAI
diff --git a/‎CHANGELOG.md‎
Lines changed: 25 additions & 0 deletions b/‎CHANGELOG.md‎
Lines changed: 25 additions & 0 deletions
diff --git a/‎README.md‎
Lines changed: 1 addition & 1 deletion b/‎README.md‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎android/app/src/main/python/version.py‎
Lines changed: 1 addition & 1 deletion b/‎android/app/src/main/python/version.py‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎ciris_adapters/home_assistant/adapter.py‎
Lines changed: 4 additions & 0 deletions b/‎ciris_adapters/home_assistant/adapter.py‎
Lines changed: 4 additions & 0 deletions
diff --git a/‎ciris_adapters/home_assistant/tool_service.py‎
Lines changed: 14 additions & 0 deletions b/‎ciris_adapters/home_assistant/tool_service.py‎
Lines changed: 14 additions & 0 deletions
diff --git a/‎ciris_engine/constants.py‎
Lines changed: 2 additions & 2 deletions b/‎ciris_engine/constants.py‎
Lines changed: 2 additions & 2 deletions
diff --git a/‎ciris_engine/logic/adapters/api/routes/memory.py‎
Lines changed: 12 additions & 2 deletions b/‎ciris_engine/logic/adapters/api/routes/memory.py‎
Lines changed: 12 additions & 2 deletions
diff --git a/‎ciris_engine/logic/adapters/api/routes/setup/config.py‎
Lines changed: 51 additions & 27 deletions b/‎ciris_engine/logic/adapters/api/routes/setup/config.py‎
Lines changed: 51 additions & 27 deletions
diff --git a/‎ciris_engine/logic/adapters/api/routes/setup/models.py‎
Lines changed: 9 additions & 0 deletions b/‎ciris_engine/logic/adapters/api/routes/setup/models.py‎
Lines changed: 9 additions & 0 deletions
diff --git a/‎ciris_engine/logic/adapters/api/routes/system/adapters.py‎
Lines changed: 41 additions & 0 deletions b/‎ciris_engine/logic/adapters/api/routes/system/adapters.py‎
Lines changed: 41 additions & 0 deletions
@@ -5,6 +5,31 @@ All notable changes to CIRIS Agent will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.4.2] - 2026-04-10
+
+### Added
+
+- **Context Enrichment Cache Auto-Population** - Enrichment cache now auto-populates at startup and when adapters load dynamically, eliminating first-thought latency
+- **Unit Tests for Enrichment Cache** - Added comprehensive tests for startup cache population and adapter cache refresh
+
+### Fixed
+
+- **Context Enrichment Route** - Fixed 404 on `/adapters/context-enrichment` endpoint by moving it before wildcard route
+
+## [2.4.1] - 2026-04-09
+
+### Added
+
+- **WA Key Auto-Rotation** - User Wise Authority keys now auto-rotate with unit test coverage
+- **WA Signing via CIRISVerify** - Named key signing capability through CIRISVerify integration
+- **Play Integrity Reporting** - CIRISVerify v1.5.3 with Play Integrity failure reporting
+
+### Fixed
+
+- **Wallet Badge Display** - Fixed trust badge and wallet race conditions at startup
+- **Attestation Lights** - Parse CIRISVerify v1.5.x unified attestation format correctly
+- **Domain Filtering** - Fixed domain filtering and deterministic trace IDs
+
 ## [2.4.0] - 2026-04-07
 
 ### Added
 
@@ -17,7 +17,7 @@
 
 **A type-safe, auditable AI agent framework with built-in ethical reasoning**
 
-**BETA RELEASE 2.4.1-stable** | [Release Notes](CHANGELOG.md) | [Documentation Hub](docs/README.md)
+**BETA RELEASE 2.4.2-stable** | [Release Notes](CHANGELOG.md) | [Documentation Hub](docs/README.md)
 
 CIRIS lets you run AI agents that explain their decisions, defer to humans when uncertain, and maintain complete audit trails. Currently powering Discord community moderation, designed to scale to healthcare and education.
 
 
@@ -7,7 +7,7 @@
 
 # Static version - updated at build time by the Android build process
 # This avoids file-system hashing logic that doesn't work in the Android package
-__version__ = "android-2.4.1"
+__version__ = "android-2.4.2"
 
 
 def get_version() -> str:
 
@@ -140,6 +140,10 @@ async def _background_initialize(self) -> None:
                         f"[HA DISCOVERY] Found {len(entities)} entities across {len(domains)} domains: "
                         + ", ".join(f"{d}={c}" for d, c in sorted(domains.items(), key=lambda x: -x[1])[:15])
                     )
+                    # Notify tool service that HA is now initialized so it can detect Music Assistant
+                    # This is critical - without this, MA tools won't appear if tool discovery
+                    # happened before HA finished loading entities
+                    await self.tool_service.notify_ha_initialized()
                 except Exception as e:
                     logger.warning(f"[HA DISCOVERY] Entity discovery failed: {e}")
             else:
 
@@ -1298,6 +1298,20 @@ def get_service_metadata(self) -> Dict[str, Any]:
         """Return service metadata for DSAR and data source discovery."""
         return {"data_source": False, "service_type": "device_control"}
 
+    async def notify_ha_initialized(self) -> None:
+        """Called after HA background initialization completes.
+
+        This triggers Music Assistant detection now that entities are available.
+        Without this, MA tools might not appear if tool discovery happened
+        before HA finished loading entities.
+        """
+        logger.info("[HA TOOLS] HA initialized - checking for Music Assistant")
+        ma_detected = await self._check_ma_available()
+        if ma_detected:
+            logger.info("[HA TOOLS] Music Assistant tools now available")
+        else:
+            logger.debug("[HA TOOLS] Music Assistant not detected after HA init")
+
     async def get_available_tools(self) -> List[str]:
         """Get available tool names. Used by system snapshot tool collection."""
         tools = list(self.TOOL_DEFINITIONS.keys())
 
@@ -3,11 +3,11 @@
 from pathlib import Path
 
 # Version information
-CIRIS_VERSION = "2.4.1-stable"
+CIRIS_VERSION = "2.4.2-stable"
 ACCORD_VERSION = "1.2-Beta"
 CIRIS_VERSION_MAJOR = 2
 CIRIS_VERSION_MINOR = 4
-CIRIS_VERSION_PATCH = 1
+CIRIS_VERSION_PATCH = 2
 CIRIS_VERSION_BUILD = 0
 CIRIS_VERSION_STAGE = "stable"
 CIRIS_CODENAME = "Context Engineering"  # Codename for this release
 
@@ -434,7 +434,8 @@ async def forget_memory(
     request: Request,
     auth: AuthAdminDep,
     memory_service: MemoryServiceDep,
-    node_id: str = Path(..., description="Node ID to forget"),
+    node_id: Annotated[str, Path(description="Node ID to forget")],
+    scope: Annotated[Optional[str], Query(description="Graph scope (local, environment, community)")] = None,
 ) -> SuccessResponse[MemoryOpResult[GraphNode]]:
     """
     Forget a specific memory node (FORGET).
@@ -447,10 +448,19 @@ async def forget_memory(
         # The forget method will look up the full node internally
         from ciris_engine.schemas.services.graph_core import GraphNode, GraphScope, NodeType
 
+        # Parse scope from query param, default to LOCAL for backwards compatibility
+        graph_scope = GraphScope.LOCAL
+        if scope:
+            scope_lower = scope.lower()
+            if scope_lower == "environment":
+                graph_scope = GraphScope.ENVIRONMENT
+            elif scope_lower == "community":
+                graph_scope = GraphScope.COMMUNITY
+
         node_to_forget = GraphNode(
             id=node_id,
             type=NodeType.CONCEPT,  # Default type, will be looked up by forget method
-            scope=GraphScope.LOCAL,  # Default scope
+            scope=graph_scope,
             attributes={},
         )
 
 
@@ -264,43 +264,60 @@ def _detect_api_key_set(provider: str) -> bool:
 router = APIRouter()
 
 
-@router.get("/config", responses=RESPONSES_401_500)
-async def get_current_config(request: Request) -> SuccessResponse[SetupConfigResponse]:
-    """Get current configuration.
+async def _require_auth_if_configured(request: Request) -> None:
+    """Require authentication if setup is already completed."""
+    if _is_setup_allowed_without_auth():
+        return
 
-    Returns current setup configuration for editing.
-    Requires authentication if setup is already completed.
-    """
-    # If not first-run, require authentication
-    if not _is_setup_allowed_without_auth():
-        # Manually get auth context from request
-        try:
-            from ...dependencies.auth import get_auth_context, get_auth_service
-
-            # Extract authorization header and auth service manually since we're not using Depends()
-            authorization = request.headers.get("Authorization")
-            auth_service = get_auth_service(request)
-            auth = await get_auth_context(request, authorization, auth_service)
-            if auth is None:
-                raise HTTPException(status_code=status.HTTP_401_UNAUTHORIZED, detail="Authentication required")
-        except HTTPException:
-            raise
-        except Exception as e:
-            logger.warning(f"Authentication failed for /setup/config: {e}")
+    from ...dependencies.auth import get_auth_context, get_auth_service
+
+    try:
+        authorization = request.headers.get("Authorization")
+        auth_service = get_auth_service(request)
+        auth = await get_auth_context(request, authorization, auth_service)
+        if auth is None:
             raise HTTPException(status_code=status.HTTP_401_UNAUTHORIZED, detail="Authentication required")
+    except HTTPException:
+        raise
+    except Exception as e:
+        logger.warning(f"Authentication failed for /setup/config: {e}")
+        raise HTTPException(status_code=status.HTTP_401_UNAUTHORIZED, detail="Authentication required")
+
 
-    # Get template from CLI flag (via runtime config) or environment variable
-    # CLI --template flag takes precedence on first-run before .env exists
+def _get_template_id(request: Request) -> str:
+    """Get template ID from CLI flag or environment variable."""
     template_id = os.getenv("CIRIS_TEMPLATE")
     if not template_id:
         runtime = getattr(request.app.state, "runtime", None)
         if runtime and hasattr(runtime, "essential_config") and runtime.essential_config:
             template_id = getattr(runtime.essential_config, "default_template", None)
-    if not template_id:
-        template_id = "default"
+    return template_id or "default"
+
+
+def _parse_float_env(env_var: str) -> Optional[float]:
+    """Parse a float from environment variable, returning None if invalid."""
+    value = os.getenv(env_var)
+    if not value:
+        return None
+    try:
+        return float(value)
+    except ValueError:
+        return None
+
+
+@router.get("/config", responses=RESPONSES_401_500)
+async def get_current_config(request: Request) -> SuccessResponse[SetupConfigResponse]:
+    """Get current configuration.
+
+    Returns current setup configuration for editing.
+    Requires authentication if setup is already completed.
+    """
+    await _require_auth_if_configured(request)
 
-    # Detect LLM provider using same logic as LLM service
+    template_id = _get_template_id(request)
     llm_provider = _detect_llm_provider(request)
+    latitude = _parse_float_env("CIRIS_USER_LATITUDE")
+    longitude = _parse_float_env("CIRIS_USER_LONGITUDE")
 
     config = SetupConfigResponse(
         llm_provider=llm_provider,
@@ -313,6 +330,13 @@ async def get_current_config(request: Request) -> SuccessResponse[SetupConfigRes
         template_id=template_id,
         enabled_adapters=os.getenv("CIRIS_ADAPTER", "api").split(","),
         agent_port=int(os.getenv("CIRIS_API_PORT", "8080")),
+        location_country=os.getenv("CIRIS_USER_COUNTRY"),
+        location_region=os.getenv("CIRIS_USER_REGION"),
+        location_city=os.getenv("CIRIS_USER_CITY"),
+        location_latitude=latitude,
+        location_longitude=longitude,
+        timezone=os.getenv("CIRIS_USER_TIMEZONE"),
+        has_coordinates=latitude is not None and longitude is not None,
     )
 
     return SuccessResponse(data=config)
 
@@ -378,6 +378,15 @@ class SetupConfigResponse(BaseModel):
     # Application
     agent_port: int = Field(default=8080, description="Current agent port")
 
+    # User Location (from setup)
+    location_country: Optional[str] = Field(None, description="User's country")
+    location_region: Optional[str] = Field(None, description="User's region/state")
+    location_city: Optional[str] = Field(None, description="User's city")
+    location_latitude: Optional[float] = Field(None, description="Latitude in decimal degrees")
+    location_longitude: Optional[float] = Field(None, description="Longitude in decimal degrees")
+    timezone: Optional[str] = Field(None, description="IANA timezone")
+    has_coordinates: bool = Field(False, description="Whether lat/long are available")
+
 
 class CreateUserRequest(BaseModel):
     """Request to create initial admin user."""
 
@@ -713,6 +713,45 @@ def _get_loaded_count(module_id: str) -> int:
         raise HTTPException(status_code=500, detail=str(e))
 
 
+@router.get(
+    "/adapters/context-enrichment",
+    responses={500: {"description": "Failed to get context enrichment data"}},
+)
+async def get_context_enrichment_cache(
+    request: Request,
+    auth: Annotated[AuthContext, Depends(require_observer)],
+) -> SuccessResponse[Dict[str, Any]]:
+    """
+    Get context enrichment cache data from adapters.
+
+    Returns cached results from adapter tools that have context_enrichment=True,
+    along with cache statistics. This data is ephemeral and refreshed periodically.
+    """
+    from ciris_engine.logic.context.system_snapshot_helpers import get_enrichment_cache
+
+    try:
+        cache = get_enrichment_cache()
+        enrichment_data = cache.get_all_entries()
+        cache_stats = cache.stats
+
+        return SuccessResponse(
+            data={
+                "entries": enrichment_data,
+                "stats": {
+                    "entry_count": cache_stats.get("entries", 0),
+                    "hits": cache_stats.get("hits", 0),
+                    "misses": cache_stats.get("misses", 0),
+                    "hit_rate_pct": cache_stats.get("hit_rate_pct", 0.0),
+                    "startup_populated": cache_stats.get("startup_populated", False),
+                },
+            }
+        )
+
+    except Exception as e:
+        logger.error(f"Error getting context enrichment cache: {e}")
+        raise HTTPException(status_code=500, detail=str(e))
+
+
 @router.get("/adapters/{adapter_id}", responses=RESPONSES_ADAPTER_STATUS)
 async def get_adapter_status(
     adapter_id: str,
@@ -964,3 +1003,5 @@ async def reload_adapter(
     except Exception as e:
         logger.error(f"Error reloading adapter: {e}")
         raise HTTPException(status_code=500, detail=str(e))
+
+