@meridiona/meridian-darwin-arm64 1.4.0 → 1.4.2

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.0
+1.4.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meridiona/meridian-darwin-arm64",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "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/meridian-cli.sh

@@ -56,13 +56,12 @@ EOF
         cat <<'EOF'
 
 Dev (source checkout — builds from this repo, MLX stays loaded):
-  dev                Build daemon + UI, restart them, start MLX/screenpipe if down
-  dev daemon         Rebuild Rust + restart only the daemon   ← main backend loop
-  dev ui             Rebuild UI + restart the dashboard (:3939)
-  dev ui-watch       Next.js hot-reload dev server (foreground)  ← main UI loop
+  dev                Backing services up (bg) + UI dev server in foreground (hot reload)
+  dev ui             UI dev server only — hot reload, foreground (Ctrl-C to stop)
+  dev daemon         Rebuild Rust + restart the daemon (bg)   ← backend loop (2nd terminal)
   dev mlx            Restart only the MLX server (reloads the model)
   dev screenpipe     Restart only screenpipe
-  dev build          Build daemon + UI, no restart
+  dev build          Production build of daemon + UI (verify the shipped build; no run)
 EOF
     fi
 }
@@ -389,13 +388,26 @@ cmd_daemon_passthrough() {
 # ~/.meridian/app) has no source, so these are hidden/disabled there.
 _is_source_checkout() { [[ -f "${REPO_ROOT}/Cargo.toml" ]]; }
 
-# Restart a service to pick up a new build (no-op-with-warning if not running).
-_dev_kick() {
+# Bring a service up-to-date: ensure it's loaded (enable + bootstrap), then
+# (re)start it so a fresh build is picked up. Works whether it was stopped,
+# booted out, or already running — the same sequence cmd_start uses.
+_dev_up() {
     local label="$1"
-    if launchctl kickstart -k "${GUI_TARGET}/${label}" 2>/dev/null; then
-        ok "restarted ${label}"
+    local plist="${LAUNCH_AGENTS}/${label}.plist"
+    if [[ ! -f "$plist" ]]; then
+        warn "${label} not installed — run ./install.sh"
+        return 0
+    fi
+    set +e
+    launchctl enable "${GUI_TARGET}/${label}" 2>/dev/null
+    launchctl bootstrap "${GUI_TARGET}" "$plist" 2>/dev/null
+    launchctl kickstart -k "${GUI_TARGET}/${label}" 2>/dev/null
+    local rc=$?
+    set -e
+    if [[ $rc -eq 0 ]]; then
+        ok "(re)started ${label}"
     else
-        warn "${label} not running — 'meridian start' or ./install.sh first"
+        warn "${label} failed to start — check: meridian logs ${label#com.meridiona.}"
     fi
 }
 
@@ -405,20 +417,59 @@ _dev_ensure() {
     local label="$1"
     if launchctl print "${GUI_TARGET}/${label}" >/dev/null 2>&1; then
         ok "${label} already up (left as-is)"
-    elif [[ -f "${LAUNCH_AGENTS}/${label}.plist" ]]; then
-        set +e
-        launchctl enable "${GUI_TARGET}/${label}" 2>/dev/null
-        launchctl bootstrap "${GUI_TARGET}" "${LAUNCH_AGENTS}/${label}.plist" 2>/dev/null
-        set -e
-        info "started ${label}"
     else
-        warn "${label} not installed — run ./install.sh"
+        _dev_up "$label"
     fi
 }
 
+# The daemon hard-exits if the MLX server isn't reachable, so wait for /health
+# before (re)starting it. Returns immediately if MLX is already serving.
+_dev_wait_mlx() {
+    local port="${MLX_SERVER_PORT:-7823}" w=0
+    info "waiting for MLX server (port ${port}) to answer…"
+    until curl -sf "http://127.0.0.1:${port}/health" >/dev/null 2>&1; do
+        sleep 2; w=$((w+2))
+        if [[ $w -ge 120 ]]; then
+            warn "MLX not ready after 120s — daemon will retry on its own (KeepAlive)"
+            return 0
+        fi
+    done
+    ok "MLX ready (${w}s)"
+}
+
 _dev_build_daemon() { info "building daemon (cargo --release)…"; ( cd "${REPO_ROOT}" && cargo build --release ); }
 _dev_build_ui()     { info "building UI (npm run build)…";       ( cd "${REPO_ROOT}/ui" && npm run build ); }
 
+# Stop the launchd (production) dashboard so `next dev` can bind its port.
+# Disable too, so KeepAlive doesn't race to relaunch the prod server.
+_dev_stop_prod_ui() {
+    if launchctl print "${GUI_TARGET}/${LABEL_UI}" >/dev/null 2>&1; then
+        set +e
+        launchctl disable "${GUI_TARGET}/${LABEL_UI}" 2>/dev/null
+        launchctl bootout  "${GUI_TARGET}/${LABEL_UI}" 2>/dev/null
+        set -e
+        info "stopped launchd dashboard (freeing the port for the dev server)"
+    fi
+}
+
+# Run the Next.js dev server in the FOREGROUND (hot reload). Replaces this shell
+# (exec), so Ctrl-C stops just the UI server — backing services keep running.
+# Re-enable the prod dashboard later with `meridian start`.
+_dev_ui_server() {
+    local port="${MERIDIAN_UI_PORT:-3939}"
+    _dev_stop_prod_ui
+    echo
+    info "UI dev server (hot reload) → http://localhost:${port}   ·   Ctrl-C to stop"
+    info "edit-and-save reflects instantly; backing services keep running in the background"
+    echo
+    cd "${REPO_ROOT}/ui" || { err "ui/ not found at ${REPO_ROOT}/ui"; exit 1; }
+    if [[ -x ./node_modules/.bin/next ]]; then
+        exec ./node_modules/.bin/next dev --turbopack -p "${port}"
+    else
+        warn "next not found — run 'cd ui && npm install' first"; exec npm run dev
+    fi
+}
+
 cmd_dev() {
     if ! _is_source_checkout; then
         err "'meridian dev' needs a source checkout (no Cargo.toml at ${REPO_ROOT})."
@@ -428,24 +479,24 @@ cmd_dev() {
     local target="${1:-all}"
     case "$target" in
         all)
-            # Build everything + bring up: rebuild & restart the cheap services,
-            # start MLX/screenpipe only if down (don't reload a live model).
-            _dev_build_daemon; _dev_build_ui
+            # Dev session: backing services in the background (start screenpipe/
+            # MLX only if down — don't reload a live model — rebuild & restart the
+            # daemon), then the UI dev server in the FOREGROUND (hot reload). Wait
+            # for MLX before the daemon (it hard-exits if MLX is unreachable).
+            _dev_build_daemon
             _dev_ensure "${LABEL_SCREENPIPE}"
             _dev_ensure "${LABEL_MLX}"
-            _dev_kick   "${LABEL_DAEMON}"
-            _dev_kick   "${LABEL_UI}"
-            echo; info "dev up (MLX left loaded if it was already running)"; echo
-            cmd_status
+            _dev_wait_mlx
+            _dev_up "${LABEL_DAEMON}"
+            _dev_ui_server      # foreground (exec) — runs until Ctrl-C
             ;;
-        build)      _dev_build_daemon; _dev_build_ui; ok "built (no restart)" ;;
-        daemon)     _dev_build_daemon; _dev_kick "${LABEL_DAEMON}" ;;
-        ui)         _dev_build_ui;     _dev_kick "${LABEL_UI}" ;;
-        ui-watch)   info "Next.js hot reload (Ctrl-C to stop)…"; ( cd "${REPO_ROOT}/ui" && exec npm run dev ) ;;
-        mlx)        _dev_kick "${LABEL_MLX}" ;;          # python — restart reloads the model
-        screenpipe) _dev_kick "${LABEL_SCREENPIPE}" ;;
+        ui)         _dev_ui_server ;;                 # UI dev server only (foreground, hot reload)
+        daemon)     _dev_build_daemon; _dev_wait_mlx; _dev_up "${LABEL_DAEMON}" ;;
+        mlx)        _dev_up "${LABEL_MLX}" ;;          # python — restart reloads the model
+        screenpipe) _dev_up "${LABEL_SCREENPIPE}" ;;
+        build)      _dev_build_daemon; _dev_build_ui; ok "built production bundles (no run)" ;;
         *) err "unknown dev target: ${target}";
-           echo "  targets: all | build | daemon | ui | ui-watch | mlx | screenpipe"; exit 1 ;;
+           echo "  targets: all | ui | daemon | mlx | screenpipe | build"; exit 1 ;;
     esac
 }
 

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.0"
+version = "1.4.2"
 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 @@
+bQDXGTzxuyW-RF9A8oeCn

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

@@ -0,0 +1,20 @@
+{
+  "pages": {
+    "/_app": []
+  },
+  "devFiles": [],
+  "polyfillFiles": [
+    "static/chunks/03~yq9q893hmn.js"
+  ],
+  "lowPriorityFiles": [
+    "static/bQDXGTzxuyW-RF9A8oeCn/_buildManifest.js",
+    "static/bQDXGTzxuyW-RF9A8oeCn/_ssgManifest.js",
+    "static/bQDXGTzxuyW-RF9A8oeCn/_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": "eae174b5f7b0dde56f93209075f369d8",
+    "previewModeSigningKey": "cb19dddf00204f1d38d383c5a708cfd8c862b81e3de1acd65712b487ac54dc00",
+    "previewModeEncryptionKey": "c6c03f621f3341bc837ca659a0987ea760180b2409aa9277507375818458ac30"
+  }
+}