@meridiona/meridian-darwin-arm64 1.4.1 → 1.4.3

package/.env.example

@@ -13,12 +13,9 @@
 # POLL_INTERVAL_SECS=60
 # RUST_LOG=meridian=info
 
-# Classification backend: "hermes" (default) | "mlx"
-#   hermes — dynamic local-LLM selector (LM Studio / Ollama / llama.cpp / mlx_lm),
-#            cloud fallback configured in services/.hermes/.env.
-#   mlx    — persistent MLX inference server (Apple Silicon). The daemon calls its
-#            /classify_sessions endpoint. Install with ./install.sh --mlx.
-# CLASSIFIER_BACKEND=mlx
+# Classification runs on the persistent MLX inference server (Apple Silicon). The
+# daemon calls its /classify_sessions endpoint; install with ./install.sh. Only the
+# port is configurable.
 # MLX_SERVER_HOST=127.0.0.1
 # MLX_SERVER_PORT=7823
 
@@ -80,8 +77,8 @@
 # LINEAR_TEAM_IDS=TEAM1,TEAM2        # optional — comma-separated; empty = all teams
 
 # ---------------------------------------------------------------------------
-# Python LLM backend — only used by the hermes classifier (CLASSIFIER_BACKEND=hermes)
-# and the MLX summariser fallback. The MLX classifier backend ignores these.
+# Python LLM backend — cloud fallback for the coding-agent summariser (Claude/
+# Codex paths). The MLX classifier server ignores these.
 # ---------------------------------------------------------------------------
 
 # Local-LLM discovery: 1 = try local servers first (LM Studio / Ollama / llama.cpp /
@@ -101,10 +98,6 @@
 # set both to the same value when Jira is configured).
 # JIRA_URL=https://your-org.atlassian.net
 
-# hermes embedded API server (optional, hermes backend only).
-# API_SERVER_ENABLED=0
-# API_SERVER_KEY=
-
 # Disable Python OTLP tracing regardless of OO config (1 = off).
 # MERIDIAN_TRACING_DISABLED=0
 

package/VERSION

@@ -1 +1 @@
-1.4.1
+1.4.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meridiona/meridian-darwin-arm64",
-  "version": "1.4.1",
+  "version": "1.4.3",
   "description": "Prebuilt Meridian app for macOS arm64 (daemon binary + dashboard + Python services). Installed via @meridiona/meridian.",
   "homepage": "https://github.com/Meridiona/meridian",
   "repository": {

package/scripts/com.meridiona.daemon.plist

@@ -30,6 +30,13 @@
 
     <key>EnvironmentVariables</key>
     <dict>
+        <!-- launchd gives agents a minimal PATH (/usr/bin:/bin:/usr/sbin:/sbin).
+             The coding-agent summariser shells out to `claude` (~/.local/bin) and
+             `codex` (/opt/homebrew/bin); without them on PATH every primary
+             summary silently falls back to MLX. Keep ~/.local/bin and Homebrew
+             ahead of the system defaults. -->
+        <key>PATH</key>
+        <string>{{HOME}}/.local/bin:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin</string>
         <key>SCREENPIPE_DB</key>
         <string>{{HOME}}/.screenpipe/db.sqlite</string>
         <key>MERIDIAN_DB</key>

package/services/agents/run_task_linker_mlx.py

@@ -76,6 +76,33 @@ class SessionClassification(BaseModel):
         ..., ge=0.0, le=1.0,
         description="How certain you are. See scoring heuristics for ranges.",
     )
+    category: Literal[
+        "coding", "code_review", "meeting", "communication", "design",
+        "documentation", "planning", "deployment_devops", "research",
+        "idle_personal",
+    ] = Field(
+        ...,
+        description=(
+            "The single best activity category for this session. A rule-based "
+            "guess is supplied in the input — confirm it or correct it from the "
+            "evidence. Declared early in the schema so FSM decoding always emits "
+            "it before the long session_summary field."
+        ),
+    )
+    category_confidence: float = Field(
+        ..., ge=0.0, le=1.0,
+        description="How certain you are about `category` (0.0-1.0).",
+    )
+    category_explanation: str = Field(
+        ..., min_length=1, max_length=300,
+        description=(
+            "One concise sentence justifying the `category` choice, citing the "
+            "app, window titles, or OCR evidence (e.g. 'VS Code editing "
+            "run_watcher.py with a cargo build in the terminal'). Shown in the "
+            "dashboard next to the category. Kept short so FSM decoding emits it "
+            "before the long session_summary."
+        ),
+    )
     session_type: Literal["task", "overhead", "untracked"] = Field(
         ...,
         description=(
@@ -240,15 +267,19 @@ def _error_result(
     session_id: int, reason: str, elapsed: float, method: str
 ) -> dict[str, Any]:
     return {
-        "session_id":      session_id,
-        "task_key":        None,
-        "confidence":      0.0,
-        "session_type":    "overhead",
-        "reasoning":       reason,
-        "method":          method,
-        "dimensions":      {},
-        "session_summary": "",
-        "elapsed_s":       elapsed,
+        "session_id":           session_id,
+        "task_key":             None,
+        "confidence":           0.0,
+        "category":             "idle_personal",
+        "category_confidence":  0.0,
+        "category_explanation": "",
+        "session_type":         "overhead",
+        "reasoning":            reason,
+        "method":              method,
+        "dimensions":          {},
+        "session_summary":     "",
+        "category_explanation": "",
+        "elapsed_s":           elapsed,
     }
 
 
@@ -442,15 +473,18 @@ def _classify_one(
         })
 
     return {
-        "session_id":      session_id,
-        "task_key":        task_key,
-        "confidence":      confidence,
-        "session_type":    result.session_type,
-        "reasoning":       result.reasoning,
-        "method":          "mlx_direct",
-        "dimensions":      result.dimensions,
-        "session_summary": result.session_summary,
-        "elapsed_s":       elapsed,
+        "session_id":           session_id,
+        "task_key":             task_key,
+        "confidence":           confidence,
+        "category":             result.category,
+        "category_confidence":  max(0.0, min(1.0, result.category_confidence)),
+        "category_explanation": result.category_explanation,
+        "session_type":         result.session_type,
+        "reasoning":            result.reasoning,
+        "method":              "mlx_direct",
+        "dimensions":          result.dimensions,
+        "session_summary":     result.session_summary,
+        "elapsed_s":           elapsed,
     }
 
 

package/services/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "meridian-agents"
-version = "1.4.1"
+version = "1.4.3"
 description = "Meridian agents — hermes task linking and Jira progress updates for meridian.db"
 requires-python = ">=3.11"
 authors = [{ name = "Meridiona" }]

package/services/skills/activity/task-classifier/SKILL.md

@@ -85,6 +85,9 @@ Reply with ONE valid JSON object — no preamble, no markdown fences, no follow-
 {
   "task_key": "KAN-86",
   "confidence": 0.85,
+  "category": "coding",
+  "category_confidence": 0.9,
+  "category_explanation": "VS Code editing run_watcher.py with a cargo build running in the integrated terminal.",
   "session_type": "task",
   "reasoning": "Editing run_watcher.py with KAN-86 ticket open in adjacent tab; matches the migration task described.",
   "dimensions": {"activity": ["coding"], "intent": ["implementation"], "tool": ["vscode"]},
@@ -95,11 +98,33 @@ Reply with ONE valid JSON object — no preamble, no markdown fences, no follow-
 ### Field rules
 - `task_key` — must be one of the supplied candidates, or `null`. Never invent a key.
 - `confidence` — see Scoring heuristics section for exact ranges per outcome type.
+- `category` — the single best activity category (see taxonomy below). The input carries a rule-based guess; confirm it or correct it from the evidence.
+- `category_confidence` — how certain you are about `category`, `0.0`–`1.0`.
+- `category_explanation` — ONE concise sentence justifying the category, citing the app / window titles / OCR evidence. Shown in the dashboard next to the category.
 - `session_type` — `"task"` links to Jira; `"overhead"` is thrown away; `"untracked"` is kept for workload analysis.
 - `reasoning` — must cite specific window titles, OCR snippets, or context clues.
 - `dimensions` — omit keys with no evidence; return `{}` if no clear signals.
 - `session_summary` — see the dedicated section below. This is the SINGLE most important field for downstream PM updates.
 
+### Category taxonomy
+
+Choose exactly ONE `category` from this fixed set. Pick the dominant activity by time-on-screen, not a one-off glance.
+
+| `category` | When |
+|---|---|
+| `coding` | Writing/editing code in an editor or IDE, running builds, debugging |
+| `code_review` | Reviewing PRs/MRs/diffs (GitHub, GitLab, Gerrit) |
+| `meeting` | Live video/audio call (Zoom, Meet, Teams) — audio + call UI |
+| `communication` | Slack, Discord, email, DMs — async messaging |
+| `design` | Figma, Sketch, Adobe XD — visual/UX design work |
+| `documentation` | Reading/writing docs (Notion, Confluence, Google Docs, READMEs) |
+| `planning` | Tickets/boards/issues (Jira, Linear, GitHub Issues), sprint planning |
+| `deployment_devops` | CI/CD, cloud consoles, dashboards, K8s, terraform, monitoring |
+| `research` | Reading docs, Stack Overflow, tutorials, articles to learn/solve |
+| `idle_personal` | YouTube, social media, music, games, system settings — non-work |
+
+`category` is independent of `session_type`: a session can be `category: "coding"` and still be `session_type: "untracked"` (real work, no ticket) or even `overhead`.
+
 ## session_summary — THE PM-update payload
 
 This field is what the PM-update workflow consumes to write Jira worklog comments. It REPLACES the raw OCR text downstream — the PM agent will not see the original session_text unless it explicitly asks. So **every SDLC-relevant detail you observe must be captured here, written so a tech-lead reading it understands exactly what happened.**

package/ui/.next/BUILD_ID

@@ -0,0 +1 @@
+ZU3YTNciY2rOTWbXsKDU-

package/ui/.next/build-manifest.json

@@ -0,0 +1,20 @@
+{
+  "pages": {
+    "/_app": []
+  },
+  "devFiles": [],
+  "polyfillFiles": [
+    "static/chunks/03~yq9q893hmn.js"
+  ],
+  "lowPriorityFiles": [
+    "static/ZU3YTNciY2rOTWbXsKDU-/_buildManifest.js",
+    "static/ZU3YTNciY2rOTWbXsKDU-/_ssgManifest.js",
+    "static/ZU3YTNciY2rOTWbXsKDU-/_clientMiddlewareManifest.js"
+  ],
+  "rootMainFiles": [
+    "static/chunks/120gq8w9i9o8g.js",
+    "static/chunks/140ovxvjat1ch.js",
+    "static/chunks/0chwa38d3r7hi.js",
+    "static/chunks/turbopack-0-ynxavni4q39.js"
+  ]
+}

package/ui/.next/prerender-manifest.json

@@ -0,0 +1,109 @@
+{
+  "version": 4,
+  "routes": {
+    "/": {
+      "experimentalBypassFor": [
+        {
+          "type": "header",
+          "key": "next-action"
+        },
+        {
+          "type": "header",
+          "key": "content-type",
+          "value": "multipart/form-data;.*"
+        }
+      ],
+      "initialRevalidateSeconds": false,
+      "srcRoute": "/",
+      "dataRoute": "/index.rsc",
+      "allowHeader": [
+        "host",
+        "x-matched-path",
+        "x-prerender-revalidate",
+        "x-prerender-revalidate-if-generated",
+        "x-next-revalidated-tags",
+        "x-next-revalidate-tag-token"
+      ]
+    },
+    "/_global-error": {
+      "experimentalBypassFor": [
+        {
+          "type": "header",
+          "key": "next-action"
+        },
+        {
+          "type": "header",
+          "key": "content-type",
+          "value": "multipart/form-data;.*"
+        }
+      ],
+      "initialRevalidateSeconds": false,
+      "srcRoute": "/_global-error",
+      "dataRoute": "/_global-error.rsc",
+      "allowHeader": [
+        "host",
+        "x-matched-path",
+        "x-prerender-revalidate",
+        "x-prerender-revalidate-if-generated",
+        "x-next-revalidated-tags",
+        "x-next-revalidate-tag-token"
+      ]
+    },
+    "/_not-found": {
+      "initialStatus": 404,
+      "experimentalBypassFor": [
+        {
+          "type": "header",
+          "key": "next-action"
+        },
+        {
+          "type": "header",
+          "key": "content-type",
+          "value": "multipart/form-data;.*"
+        }
+      ],
+      "initialRevalidateSeconds": false,
+      "srcRoute": "/_not-found",
+      "dataRoute": "/_not-found.rsc",
+      "allowHeader": [
+        "host",
+        "x-matched-path",
+        "x-prerender-revalidate",
+        "x-prerender-revalidate-if-generated",
+        "x-next-revalidated-tags",
+        "x-next-revalidate-tag-token"
+      ]
+    },
+    "/settings": {
+      "experimentalBypassFor": [
+        {
+          "type": "header",
+          "key": "next-action"
+        },
+        {
+          "type": "header",
+          "key": "content-type",
+          "value": "multipart/form-data;.*"
+        }
+      ],
+      "initialRevalidateSeconds": false,
+      "srcRoute": "/settings",
+      "dataRoute": "/settings.rsc",
+      "allowHeader": [
+        "host",
+        "x-matched-path",
+        "x-prerender-revalidate",
+        "x-prerender-revalidate-if-generated",
+        "x-next-revalidated-tags",
+        "x-next-revalidate-tag-token"
+      ]
+    }
+  },
+  "dynamicRoutes": {},
+  "notFoundRoutes": [],
+  "preview": {
+    "previewModeId": "9e93c3849c2f24446879275f2a2dcf48",
+    "previewModeSigningKey": "6141c271d7f39d99863c60f12d6ba97e4b72e32ae90f02c0fb2fa3b2d408b34a",
+    "previewModeEncryptionKey": "aca20f724332563ae34b974dfb5fc1cbf8611512532310847304bab5e5cfa58d"
+  }
+}