@coffeerunhobby/mcp-ha-connect 0.8.0 → 1.0.0

package/.env.example

@@ -73,12 +73,6 @@ MCP_SERVER_STATEFUL=false
 # Default: 3000
 MCP_HTTP_PORT=3000
 
-# Transport protocol: stream or sse
-# - stream: Modern MCP protocol (recommended)
-# - sse: Legacy MCP protocol with Server-Sent Events
-# Default: stream
-MCP_HTTP_TRANSPORT=stream
-
 # Bind address (use 0.0.0.0 to listen on all interfaces)
 # Default: 127.0.0.1 (localhost only)
 MCP_HTTP_BIND_ADDR=127.0.0.1
@@ -119,43 +113,6 @@ MCP_AUTH_METHOD=none
 # Example: MCP_AUTH_TOKEN=token1,token2,token3
 # MCP_AUTH_TOKEN=your-secret-token-here
 
-# =============================================================================
-# Usage Examples
-# =============================================================================
-
-# Example 1: Claude Desktop (Stdio Mode)
-# ----------------------------------------
-# MCP_SERVER_USE_HTTP=false
-# MCP_SERVER_LOG_LEVEL=info
-# Then configure claude_desktop_config.json to run: node dist/index.js
-
-# Example 2: HTTP Server with Stream Transport (Recommended)
-# -----------------------------------------------------------
-# MCP_SERVER_USE_HTTP=true
-# MCP_HTTP_TRANSPORT=stream
-# MCP_HTTP_PORT=3000
-# MCP_HTTP_BIND_ADDR=127.0.0.1
-# Access at: http://mcpserver.10.0.0.18.nip.io:3000/mcp
-
-# Example 3: HTTP Server with SSE (Legacy Clients)
-# -------------------------------------------------
-# MCP_SERVER_USE_HTTP=true
-# MCP_HTTP_TRANSPORT=sse
-# MCP_HTTP_PORT=3000
-# Access at: http://mcpserver.10.0.0.18.nip.io:3000/sse
-
-# Example 4: Production HTTP Server
-# ----------------------------------
-# MCP_SERVER_USE_HTTP=true
-# MCP_SERVER_LOG_FORMAT=json
-# MCP_HTTP_TRANSPORT=stream
-# MCP_HTTP_PORT=3000
-# MCP_HTTP_BIND_ADDR=0.0.0.0
-# MCP_HTTP_ALLOWED_ORIGINS=https://your-app.com
-# MCP_SERVER_STATEFUL=true
-# MCP_AUTH_METHOD=bearer
-# MCP_AUTH_TOKEN=n8n-token,openwebui-token,cli-token
-
 # =============================================================================
 # Security Notes
 # =============================================================================

package/Dockerfile

@@ -1,21 +1,21 @@
 # syntax=docker/dockerfile:1.7
 
-FROM node:24-bookworm-slim AS deps
+FROM node:25-alpine AS deps
 WORKDIR /app
 COPY package*.json ./
 RUN npm install
 
-FROM node:24-bookworm-slim AS build
+FROM node:25-alpine AS build
 WORKDIR /app
 COPY --from=deps /app/node_modules ./node_modules
 COPY . .
 RUN npm run build
 
-FROM node:24-bookworm-slim AS runtime
+FROM node:25-alpine AS runtime
 
 # OCI metadata labels
-LABEL org.opencontainers.image.title="Smart HomeAssistant MCP Server"
-LABEL org.opencontainers.image.description="Smart home MCP server for Home Assistant plus Local AI integration"
+LABEL org.opencontainers.image.title="MCP-HA-Connect"
+LABEL org.opencontainers.image.description="MCP server for Home Assistant + TP-Link Omada + Local AI integration"
 LABEL org.opencontainers.image.authors="Coffee Run Hobby"
 LABEL org.opencontainers.image.url="https://github.com/coffeerunhobby/mcp-ha-connect"
 LABEL org.opencontainers.image.source="https://github.com/coffeerunhobby/mcp-ha-connect"
@@ -24,10 +24,8 @@ LABEL org.opencontainers.image.licenses="MIT"
 
 WORKDIR /app
 ENV NODE_ENV=production
-RUN apt-get update \
-  && apt-get install -y --no-install-recommends curl \
-  && rm -rf /var/lib/apt/lists/*
+RUN apk add --no-cache curl
 COPY package*.json ./
 RUN npm install --omit=dev
 COPY --from=build /app/dist ./dist
-CMD ["node", "dist/index.js"]
+CMD ["node", "--experimental-quic", "dist/index.js"]

package/README.md

@@ -5,122 +5,23 @@ A production-ready Model Context Protocol (MCP) server for Home Assistant integr
 [![npm version](https://badge.fury.io/js/%40coffeerunhobby%2Fmcp-ha-connect.svg)](https://www.npmjs.com/package/@coffeerunhobby/mcp-ha-connect)
 [![Docker](https://img.shields.io/badge/docker-ghcr.io-blue)](https://github.com/coffeerunhobby/mcp-ha-connect/pkgs/container/mcp-ha-connect)
 
-## Quick Start
-
-Choose your preferred installation method:
-
-### Option 1: npx (Recommended - No Installation Required)
-
-```json
-{
-  "mcpServers": {
-    "homeassistant": {
-      "command": "npx",
-      "args": ["-y", "@coffeerunhobby/mcp-ha-connect"],
-      "env": {
-        "HA_URL": "http://homeassistant.10.0.0.19.nip.io:8123",
-        "HA_TOKEN": "your_long_lived_access_token"
-      }
-    }
-  }
-}
-```
-
-### Option 2: Global npm Install
-
-```bash
-npm install -g @coffeerunhobby/mcp-ha-connect
-```
-
-```json
-{
-  "mcpServers": {
-    "homeassistant": {
-      "command": "mcp-ha-connect",
-      "env": {
-        "HA_URL": "http://homeassistant.10.0.0.19.nip.io:8123",
-        "HA_TOKEN": "your_token"
-      }
-    }
-  }
-}
-```
-
-### Option 3: Docker
-
-```json
-{
-  "mcpServers": {
-    "homeassistant": {
-      "command": "docker",
-      "args": [
-        "run",
-        "--rm",
-        "-i",
-        "-e", "HA_URL=http://host.docker.internal:8123",
-        "-e", "HA_TOKEN=your_token",
-        "ghcr.io/coffeerunhobby/mcp-ha-connect:latest"
-      ]
-    }
-  }
-}
-```
-
-### Option 4: Local Development
-
-```json
-{
-  "mcpServers": {
-    "homeassistant": {
-      "command": "node",
-      "args": ["C:\\workspace\\mcp-homeassistant\\dist\\index.js"],
-      "env": {
-        "HA_URL": "http://homeassistant.10.0.0.19.nip.io:8123",
-        "HA_TOKEN": "your_token"
-      }
-    }
-  }
-}
-```
-
-## Configuration Locations
-
-### Claude Desktop
-- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
-- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
-- **Linux:** `~/.config/Claude/claude_desktop_config.json`
-
-### LM Studio
-- **Windows:** `%USERPROFILE%\.lmstudio\config.json`
-- **macOS:** `~/Library/Application Support/LM Studio/config.json`
-- **Linux:** `~/.config/lmstudio/config.json`
-
-## Autonomous Safety Monitoring System
-
-1. **JS Pre-filter**: Tier A triggers + basic anomaly detection
-2. **Issue Objects**: Structured alerts (entity, area, threshold, observed, last_changed)
-3. **LLM Decision**: Single JSON verdict from local model
-4. **Smart Notifications**: Dedupe + cooldown to prevent alert fatigue
-5. **Acknowledgment**: HA notification, Telegram, mobile app action, or voice
-6. **Auto-Response**: Water/gas shutoff via HA valves/switches
-
-See [docs/SSE_API.md](docs/SSE_API.md) for complete documentation of the SSE system.
+See [docs/QUICK_START.md](docs/QUICK_START.md) for Docker, HTTP server mode, n8n integration, and more installation options.
 
 ## Key Features
 
 ### Core Functionality
 
-- **Smart Device Control**
-  - Lights: Brightness, color temperature, RGB color, transitions
-  - Climate: Temperature, HVAC modes, fan modes, humidity
-  - Covers: Position and tilt control
-  - Switches: On/off control
-  - Sensors & Contacts: State monitoring
-  - Media Players: Playback control, volume, source selection
-  - Fans: Speed, oscillation, direction
-  - Locks: Lock/unlock control
-  - Vacuums: Start, stop, return to base
-  - Cameras: Motion detection, snapshots
+- Smart Device Control
+- Lights: Brightness, color temperature, RGB color, transitions
+- Climate: Temperature, HVAC modes, fan modes, humidity
+- Covers: Position and tilt control
+- Switches: On/off control
+- Sensors & Contacts: State monitoring
+- Media Players: Playback control, volume, source selection
+- Fans: Speed, oscillation, direction
+- Locks: Lock/unlock control
+- Vacuums: Start, stop, return to base
+- Cameras: Motion detection, snapshots
 
 ### Automation Management
 
@@ -140,17 +41,20 @@ See [docs/SSE_API.md](docs/SSE_API.md) for complete documentation of the SSE sys
 - Service call support
 - Advanced entity search
 - AI-powered sensor analysis with Ollama
-- Multiple transport modes (stdio, SSE, Streamable HTTP)
+- Multiple transport modes (stdio, Streamable HTTP)
 - HTTP server with health checks
 - CORS support for browser-based clients
-- Structured logging with pino (plain, JSON, GCP-JSON formats)
+- Structured logging (plain, JSON, GCP-JSON formats)
 - Comprehensive configuration validation with Zod
 - Full type safety with TypeScript
 - Stateful and stateless session support
+- JWT authentication with role-based access control
 
-## Available Tools (37 Total)
+## Available Tools (60 Total)
 
-### State & Entity Tools
+### Home Assistant Tools (35)
+
+#### State & Entity Tools
 
 | Tool | Description |
 |------|-------------|
@@ -164,14 +68,14 @@ See [docs/SSE_API.md](docs/SSE_API.md) for complete documentation of the SSE sys
 | `getHistory` | Get historical data for an entity |
 | `listPersons` | List all household members with location state (home/away) |
 
-### Service & Control Tools
+#### Service & Control Tools
 
 | Tool | Description |
 |------|-------------|
 | `callService` | Call any Home Assistant service |
 | `entityAction` | Simple turn_on/turn_off/toggle actions |
 
-### Device Control Tools
+#### Device Control Tools
 
 | Tool | Description |
 |------|-------------|
@@ -185,7 +89,7 @@ See [docs/SSE_API.md](docs/SSE_API.md) for complete documentation of the SSE sys
 | `sendNotification` | Send notifications with full mobile app support (actions, priority, images) |
 | `listNotificationTargets` | Discover available mobile app notification targets |
 
-### Automation Tools
+#### Automation Tools
 
 | Tool | Description |
 |------|-------------|
@@ -199,7 +103,7 @@ See [docs/SSE_API.md](docs/SSE_API.md) for complete documentation of the SSE sys
 | `deleteAutomation` | Delete an automation |
 | `getAutomationTrace` | Get automation execution history |
 
-### System Tools
+#### System Tools
 
 | Tool | Description |
 |------|-------------|
@@ -207,15 +111,76 @@ See [docs/SSE_API.md](docs/SSE_API.md) for complete documentation of the SSE sys
 | `restartHomeAssistant` | Restart the Home Assistant server |
 | `getSystemLog` | Get system log entries from logbook |
 | `checkUpdates` | Check for available updates |
-| `analyzeSensors` | AI-powered sensor analysis using Ollama |
 
-### Calendar Tools
+#### Calendar Tools
 
 | Tool | Description |
 |------|-------------|
 | `listCalendars` | List all calendar entities |
 | `getCalendarEvents` | Get events from one or all calendars |
 
+### Omada Network Tools (24)
+
+#### Site Tools
+
+| Tool | Description |
+|------|-------------|
+| `omada_listSites` | List all sites configured on the Omada controller |
+
+#### Device Tools
+
+| Tool | Description |
+|------|-------------|
+| `omada_listDevices` | List all network devices (APs, switches, gateways) in a site |
+| `omada_getDevice` | Get detailed information about a specific network device |
+| `omada_searchDevices` | Search for devices globally across all sites |
+| `omada_getSwitchStackDetail` | Get detailed information about a switch stack |
+| `omada_listDevicesStats` | Get statistics for global adopted devices with filtering |
+
+#### Client Tools
+
+| Tool | Description |
+|------|-------------|
+| `omada_listClients` | List all connected clients (devices/users) in a site |
+| `omada_getClient` | Get detailed information about a specific connected client |
+| `omada_listMostActiveClients` | Get the most active clients sorted by total traffic |
+| `omada_listClientsActivity` | Get client activity statistics over time |
+| `omada_listClientsPastConnections` | Get historical client connection data |
+
+#### Rate Limit Tools
+
+| Tool | Description |
+|------|-------------|
+| `omada_getRateLimitProfiles` | Get available rate limit profiles for a site |
+| `omada_setClientRateLimit` | Set custom bandwidth limits for a client (download/upload in Kbps) |
+| `omada_setClientRateLimitProfile` | Apply a rate limit profile to a client |
+| `omada_disableClientRateLimit` | Remove bandwidth limits from a client |
+
+#### Security Tools
+
+| Tool | Description |
+|------|-------------|
+| `omada_getThreatList` | Get security threat management list |
+
+#### Network Configuration Tools
+
+| Tool | Description |
+|------|-------------|
+| `omada_getInternetInfo` | Get internet connection configuration for a site |
+| `omada_getPortForwardingStatus` | Get port forwarding rules (User or UPnP) |
+| `omada_getLanNetworkList` | Get LAN network configuration list |
+| `omada_getLanProfileList` | Get LAN profile configuration list |
+| `omada_getWlanGroupList` | Get WLAN group configuration list |
+| `omada_getSsidList` | Get SSID list for a WLAN group |
+| `omada_getSsidDetail` | Get detailed SSID configuration |
+| `omada_getFirewallSetting` | Get firewall configuration for a site |
+
+### AI Tools (1)
+
+| Tool | Description |
+|------|-------------|
+| `analyzeSensors` | Analyze sensor data using AI (Ollama) to detect issues and provide recommendations |
+
 ### MCP Resources
 
 | Resource URI | Description |
@@ -257,6 +222,7 @@ See [docs/SSE_API.md](docs/SSE_API.md) for complete documentation of the SSE sys
 
 | Variable | Default | Description |
 |----------|---------|-------------|
+| `HA_PLUGIN_ENABLED` | `true` | Enable Home Assistant plugin |
 | `HA_STRICT_SSL` | `true` | Validate SSL certificates |
 | `HA_TIMEOUT` | `30000` | API request timeout (ms) |
 
@@ -274,7 +240,6 @@ See [docs/SSE_API.md](docs/SSE_API.md) for complete documentation of the SSE sys
 | Variable | Default | Description |
 |----------|---------|-------------|
 | `MCP_HTTP_PORT` | `3000` | HTTP server port |
-| `MCP_HTTP_TRANSPORT` | `stream` | Transport: `stream` or `sse` |
 | `MCP_HTTP_BIND_ADDR` | `127.0.0.1` | Bind address |
 | `MCP_HTTP_PATH` | `/mcp` | MCP endpoint path |
 | `MCP_HTTP_ENABLE_HEALTHCHECK` | `true` | Enable health check endpoint |
@@ -302,17 +267,86 @@ See [docs/SSE_API.md](docs/SSE_API.md) for complete documentation of the SSE sys
 | Variable | Default | Description |
 |----------|---------|-------------|
 | `MCP_AUTH_METHOD` | `none` | Auth method: `none` or `bearer` |
-| `MCP_AUTH_TOKEN` | - | Bearer token(s), can be comma-separated for multiple clients |
+| `MCP_AUTH_SECRET` | - | JWT signing secret (min 32 chars, required for `bearer` method) |
+| `MCP_PERMISSIONS_CONFIG` | - | JSON config for user roles and permissions |
+
+#### JWT Authentication
+
+When `MCP_AUTH_METHOD=bearer`, clients must provide a JWT token in the Authorization header:
+
+```
+Authorization: Bearer <jwt-token>
+```
+
+Generate tokens with your `MCP_AUTH_SECRET` using HS256 algorithm. The JWT payload should include:
+- `sub` (subject): User identifier for permission lookup
+- `exp` (optional): Expiration timestamp
+
+#### Permission System
+
+The server uses role-based access control with binary permission masks:
+
+| Permission | Flag | Description |
+|------------|------|-------------|
+| `ADMIN` | 1 | System operations (restart, updates) |
+| `CONFIGURE` | 2 | Create/modify automations, scripts |
+| `CONTROL` | 4 | Control devices (lights, climate, etc.) |
+| `QUERY` | 8 | Read entity states, history, lists |
+| `NOTIFY` | 16 | Send notifications |
+| `AI` | 32 | Use AI analysis features |
+
+**Predefined Roles:**
+
+| Role | Permissions |
+|------|-------------|
+| `NONE` | No permissions |
+| `READONLY` | QUERY only |
+| `OPERATOR` | QUERY + CONTROL + NOTIFY |
+| `CONTRIBUTOR` | QUERY + CONTROL + NOTIFY + CONFIGURE |
+| `ADMIN` | All except AI |
+| `SUPERUSER` | All permissions |
+
+**Configuration Example:**
+
+```json
+{
+  "users": [
+    { "sub": "admin@example.com", "role": "admin" },
+    { "sub": "user@example.com", "role": "operator" },
+    { "sub": "viewer@example.com", "role": "readonly" }
+  ],
+  "defaultRole": "NONE"
+}
+```
+
+Set via environment variable (escape quotes for shell):
+```bash
+MCP_PERMISSIONS_CONFIG='{"users":[{"sub":"admin","role":"admin"}],"defaultRole":"NONE"}'
+```
 
 ### Optional - AI Provider
 
 | Variable | Default | Description |
 |----------|---------|-------------|
+| `AI_PLUGIN_ENABLED` | `true` | Enable AI plugin |
 | `AI_PROVIDER` | `ollama` | AI provider: `ollama`, `openai`, or `none` |
-| `AI_URL` | `http://ollama.10.0.0.17.nip.io:11434` | AI server URL (Ollama) |
+| `AI_URL` | `http://localhost:11434` | AI server URL (Ollama) |
 | `AI_MODEL` | `llama2` | AI model name |
 | `AI_TIMEOUT` | `60000` | AI request timeout (ms) |
 
+### Optional - Omada Network Controller
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `OMADA_PLUGIN_ENABLED` | `false` | Enable Omada plugin |
+| `OMADA_BASE_URL` | - | Omada controller URL (e.g., `https://192.168.0.1:8043`) |
+| `OMADA_CLIENT_ID` | - | OAuth2 client ID from Omada controller |
+| `OMADA_CLIENT_SECRET` | - | OAuth2 client secret from Omada controller |
+| `OMADA_OMADAC_ID` | - | Omada controller ID |
+| `OMADA_SITE_ID` | - | Default site ID for operations |
+| `OMADA_STRICT_SSL` | `true` | Validate SSL certificates |
+| `OMADA_TIMEOUT` | `30000` | API request timeout (ms) |
+
 ## Advanced Configuration Examples
 
 ### With AI Analysis (Ollama)
@@ -664,10 +698,6 @@ MIT
 
 Coffee Run Hobby ([github.com/coffeerunhobby](https://github.com/coffeerunhobby))
 
-## Version
-
-0.7.0
-
 ## Links
 
 - **GitHub**: [https://github.com/coffeerunhobby/mcp-ha-connect](https://github.com/coffeerunhobby/mcp-ha-connect)
@@ -676,9 +706,8 @@ Coffee Run Hobby ([github.com/coffeerunhobby](https://github.com/coffeerunhobby)
 
 ## Documentation
 
+- [Quick Start Guide](docs/QUICK_START.md)
 - [Changelog](docs/CHANGELOG.md)
-- [Local Client Configuration](docs/LOCAL_CLIENT.md)
-- [SSE Event API](docs/SSE_API.md)
 
 ## Contributing
 

package/dist/autonomic/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Autonomic Module
+ * Implements the autonomic nervous system architecture for home automation
+ * with tiered response system (reflex, supervised, informational)
+ */
+export { Priority, PriorityMask, matchesPriority, getPriorityName, getPriorityTier, bypassesQuietHours, requiresImmediateAction, requiresApproval, } from './priority.js';

package/dist/autonomic/index.js

@@ -0,0 +1,7 @@
+/**
+ * Autonomic Module
+ * Implements the autonomic nervous system architecture for home automation
+ * with tiered response system (reflex, supervised, informational)
+ */
+export { Priority, PriorityMask, matchesPriority, getPriorityName, getPriorityTier, bypassesQuietHours, requiresImmediateAction, requiresApproval, } from './priority.js';
+//# sourceMappingURL=index.js.map

package/dist/autonomic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/autonomic/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,eAAe,CAAC"}

package/dist/autonomic/priority.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Autonomic Priority System
+ * Uses powers of 2 for bitwise operations - can combine with OR, check with AND
+ *
+ * Based on MOQT priority model adapted for home automation tiers:
+ * - REFLEX (Tier 0): Immediate autonomous response, no AI delay
+ * - SUPERVISED (Tier 1): Quick decision with timeout + default action
+ * - INFORMATIONAL (Tier 2): Passive awareness, respects quiet hours
+ * - LOG: Debug/metrics, lowest priority
+ */
+/**
+ * Priority levels as powers of 2 for bitwise operations
+ */
+export declare enum Priority {
+    /** Tier 0: Immediate reflex - smoke, gas, intrusion. No confirmation needed. */
+    REFLEX = 1,
+    /** Tier 1: Supervised action - requires approval within timeout window */
+    SUPERVISED = 32,
+    /** Tier 2: Informational alert - passive, respects quiet hours */
+    INFORMATIONAL = 64,
+    /** Logging/metrics - lowest priority */
+    LOG = 128
+}
+/**
+ * Priority masks for filtering
+ */
+export declare const PriorityMask: {
+    /** All critical priorities (REFLEX only) */
+    readonly CRITICAL: Priority.REFLEX;
+    /** Action priorities (REFLEX + SUPERVISED) */
+    readonly ACTIONABLE: number;
+    /** User-facing priorities (everything except LOG) */
+    readonly USER_FACING: number;
+    /** All priorities */
+    readonly ALL: number;
+};
+/**
+ * Check if a priority matches a mask
+ */
+export declare function matchesPriority(priority: Priority, mask: number): boolean;
+/**
+ * Get human-readable priority name
+ */
+export declare function getPriorityName(priority: Priority): string;
+/**
+ * Get tier number from priority
+ */
+export declare function getPriorityTier(priority: Priority): 0 | 1 | 2 | 3;
+/**
+ * Check if priority should bypass quiet hours
+ */
+export declare function bypassesQuietHours(priority: Priority): boolean;
+/**
+ * Check if priority requires immediate action (no AI delay)
+ */
+export declare function requiresImmediateAction(priority: Priority): boolean;
+/**
+ * Check if priority requires user approval
+ */
+export declare function requiresApproval(priority: Priority): boolean;

package/dist/autonomic/priority.js

@@ -0,0 +1,97 @@
+/**
+ * Autonomic Priority System
+ * Uses powers of 2 for bitwise operations - can combine with OR, check with AND
+ *
+ * Based on MOQT priority model adapted for home automation tiers:
+ * - REFLEX (Tier 0): Immediate autonomous response, no AI delay
+ * - SUPERVISED (Tier 1): Quick decision with timeout + default action
+ * - INFORMATIONAL (Tier 2): Passive awareness, respects quiet hours
+ * - LOG: Debug/metrics, lowest priority
+ */
+/**
+ * Priority levels as powers of 2 for bitwise operations
+ */
+export var Priority;
+(function (Priority) {
+    /** Tier 0: Immediate reflex - smoke, gas, intrusion. No confirmation needed. */
+    Priority[Priority["REFLEX"] = 1] = "REFLEX";
+    /** Tier 1: Supervised action - requires approval within timeout window */
+    Priority[Priority["SUPERVISED"] = 32] = "SUPERVISED";
+    /** Tier 2: Informational alert - passive, respects quiet hours */
+    Priority[Priority["INFORMATIONAL"] = 64] = "INFORMATIONAL";
+    /** Logging/metrics - lowest priority */
+    Priority[Priority["LOG"] = 128] = "LOG";
+})(Priority || (Priority = {}));
+/**
+ * Priority masks for filtering
+ */
+export const PriorityMask = {
+    /** All critical priorities (REFLEX only) */
+    CRITICAL: Priority.REFLEX,
+    /** Action priorities (REFLEX + SUPERVISED) */
+    ACTIONABLE: Priority.REFLEX | Priority.SUPERVISED,
+    /** User-facing priorities (everything except LOG) */
+    USER_FACING: Priority.REFLEX | Priority.SUPERVISED | Priority.INFORMATIONAL,
+    /** All priorities */
+    ALL: Priority.REFLEX | Priority.SUPERVISED | Priority.INFORMATIONAL | Priority.LOG,
+};
+/**
+ * Check if a priority matches a mask
+ */
+export function matchesPriority(priority, mask) {
+    return (priority & mask) !== 0;
+}
+/**
+ * Get human-readable priority name
+ */
+export function getPriorityName(priority) {
+    switch (priority) {
+        case Priority.REFLEX:
+            return 'reflex';
+        case Priority.SUPERVISED:
+            return 'supervised';
+        case Priority.INFORMATIONAL:
+            return 'informational';
+        case Priority.LOG:
+            return 'log';
+        default:
+            return 'unknown';
+    }
+}
+/**
+ * Get tier number from priority
+ */
+export function getPriorityTier(priority) {
+    switch (priority) {
+        case Priority.REFLEX:
+            return 0;
+        case Priority.SUPERVISED:
+            return 1;
+        case Priority.INFORMATIONAL:
+            return 2;
+        case Priority.LOG:
+            return 3;
+        default:
+            return 3;
+    }
+}
+/**
+ * Check if priority should bypass quiet hours
+ */
+export function bypassesQuietHours(priority) {
+    // Only REFLEX bypasses quiet hours
+    return priority === Priority.REFLEX;
+}
+/**
+ * Check if priority requires immediate action (no AI delay)
+ */
+export function requiresImmediateAction(priority) {
+    return priority === Priority.REFLEX;
+}
+/**
+ * Check if priority requires user approval
+ */
+export function requiresApproval(priority) {
+    return priority === Priority.SUPERVISED;
+}
+//# sourceMappingURL=priority.js.map

package/dist/autonomic/priority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"priority.js","sourceRoot":"","sources":["../../src/autonomic/priority.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,QAYX;AAZD,WAAY,QAAQ;IAClB,gFAAgF;IAChF,2CAAU,CAAA;IAEV,0EAA0E;IAC1E,oDAAe,CAAA;IAEf,kEAAkE;IAClE,0DAAkB,CAAA;IAElB,wCAAwC;IACxC,uCAAS,CAAA;AACX,CAAC,EAZW,QAAQ,KAAR,QAAQ,QAYnB;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,4CAA4C;IAC5C,QAAQ,EAAE,QAAQ,CAAC,MAAM;IAEzB,8CAA8C;IAC9C,UAAU,EAAE,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,UAAU;IAEjD,qDAAqD;IACrD,WAAW,EAAE,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC,aAAa;IAE3E,qBAAqB;IACrB,GAAG,EAAE,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC,GAAG;CAC1E,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAkB,EAAE,IAAY;IAC9D,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAkB;IAChD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ,CAAC,MAAM;YAClB,OAAO,QAAQ,CAAC;QAClB,KAAK,QAAQ,CAAC,UAAU;YACtB,OAAO,YAAY,CAAC;QACtB,KAAK,QAAQ,CAAC,aAAa;YACzB,OAAO,eAAe,CAAC;QACzB,KAAK,QAAQ,CAAC,GAAG;YACf,OAAO,KAAK,CAAC;QACf;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAkB;IAChD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ,CAAC,MAAM;YAClB,OAAO,CAAC,CAAC;QACX,KAAK,QAAQ,CAAC,UAAU;YACtB,OAAO,CAAC,CAAC;QACX,KAAK,QAAQ,CAAC,aAAa;YACzB,OAAO,CAAC,CAAC;QACX,KAAK,QAAQ,CAAC,GAAG;YACf,OAAO,CAAC,CAAC;QACX;YACE,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAkB;IACnD,mCAAmC;IACnC,OAAO,QAAQ,KAAK,QAAQ,CAAC,MAAM,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAkB;IACxD,OAAO,QAAQ,KAAK,QAAQ,CAAC,MAAM,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAkB;IACjD,OAAO,QAAQ,KAAK,QAAQ,CAAC,UAAU,CAAC;AAC1C,CAAC"}