eminiar 0.12.0 → 0.13.1

package/eminiar.config.schema.json

@@ -260,7 +260,8 @@
       "properties": {
         "manifest": {
           "default": ".eminiar/docs.json",
-          "type": "string"
+          "type": "string",
+          "pattern": "^(?![/\\\\])(?![A-Za-z]:)(?!(?:[\\s\\S]*[/\\\\])?\\.\\.[. ]*(?:[/\\\\]|$))[^\\p{Cc}]+$"
         },
         "ttlHours": {
           "default": 168,
@@ -489,6 +490,454 @@
           "type": "boolean"
         }
       }
+    },
+    "adjudicator": {
+      "default": {},
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "default": false,
+          "type": "boolean"
+        },
+        "provider": {
+          "default": "heuristic",
+          "type": "string",
+          "enum": [
+            "heuristic",
+            "typesafe",
+            "openai-compatible",
+            "embedding"
+          ]
+        },
+        "mode": {
+          "default": "advise",
+          "type": "string",
+          "enum": [
+            "advise",
+            "apply"
+          ]
+        },
+        "surfaces": {
+          "default": {},
+          "type": "object",
+          "properties": {
+            "prompt": {
+              "default": true,
+              "type": "boolean"
+            },
+            "agent": {
+              "default": true,
+              "type": "boolean"
+            },
+            "plan": {
+              "default": true,
+              "type": "boolean"
+            },
+            "tools": {
+              "default": false,
+              "type": "boolean"
+            }
+          }
+        },
+        "promptMode": {
+          "default": "async",
+          "type": "string",
+          "enum": [
+            "heuristic",
+            "async",
+            "blocking"
+          ]
+        },
+        "typesafe": {
+          "default": {},
+          "type": "object",
+          "properties": {
+            "model": {
+              "default": "jev-1.14.0",
+              "type": "string"
+            },
+            "baseUrl": {
+              "default": "https://api.typesafe.ai/v1",
+              "type": "string",
+              "format": "uri"
+            }
+          }
+        },
+        "openai": {
+          "default": {},
+          "type": "object",
+          "properties": {
+            "preset": {
+              "default": "groq",
+              "type": "string",
+              "enum": [
+                "groq",
+                "cerebras",
+                "ollama",
+                "lmstudio",
+                "llamacpp",
+                "custom"
+              ]
+            },
+            "baseUrl": {
+              "type": "string",
+              "format": "uri"
+            },
+            "model": {
+              "type": "string"
+            },
+            "json": {
+              "default": "auto",
+              "type": "string",
+              "enum": [
+                "schema",
+                "object",
+                "auto"
+              ]
+            },
+            "price": {
+              "type": "object",
+              "properties": {
+                "inPerM": {
+                  "type": "number",
+                  "minimum": 0
+                },
+                "outPerM": {
+                  "type": "number",
+                  "minimum": 0
+                }
+              },
+              "required": [
+                "inPerM",
+                "outPerM"
+              ]
+            }
+          }
+        },
+        "embedding": {
+          "default": {},
+          "type": "object",
+          "properties": {
+            "k": {
+              "default": 5,
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991
+            },
+            "minSimilarity": {
+              "default": 0.55,
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1
+            }
+          }
+        },
+        "keyEnv": {
+          "type": "string",
+          "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
+        },
+        "remoteConsent": {
+          "default": false,
+          "type": "boolean"
+        },
+        "remoteConsentOrigins": {
+          "maxItems": 64,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "maxLength": 512
+          }
+        },
+        "timeouts": {
+          "default": {},
+          "type": "object",
+          "properties": {
+            "promptMs": {
+              "default": 1200,
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991
+            },
+            "agentMs": {
+              "default": 800,
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991
+            },
+            "planMs": {
+              "default": 3000,
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991
+            },
+            "localMs": {
+              "default": 600,
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991
+            },
+            "connectMs": {
+              "default": 150,
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991
+            }
+          }
+        },
+        "minPromptChars": {
+          "default": 12,
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        },
+        "tiers": {
+          "default": [
+            "haiku",
+            "sonnet",
+            "opus"
+          ],
+          "minItems": 1,
+          "maxItems": 4,
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "haiku",
+              "sonnet",
+              "opus",
+              "fable"
+            ]
+          },
+          "uniqueItems": true
+        },
+        "weights": {
+          "default": {},
+          "type": "object",
+          "properties": {
+            "providerMax": {
+              "default": 0.7,
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1
+            },
+            "embeddingMax": {
+              "default": 0.4,
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1
+            },
+            "selfReportScale": {
+              "default": 0.6,
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1
+            },
+            "lowConfidence": {
+              "default": 0.55,
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1
+            },
+            "tierCenters": {
+              "default": {
+                "haiku": 0.6,
+                "sonnet": 2,
+                "opus": 3.4
+              },
+              "type": "object",
+              "propertyNames": {
+                "type": "string",
+                "maxLength": 32
+              },
+              "additionalProperties": {
+                "type": "number"
+              },
+              "maxProperties": 16
+            },
+            "features": {
+              "default": {},
+              "type": "object",
+              "propertyNames": {
+                "type": "string",
+                "maxLength": 64
+              },
+              "additionalProperties": {
+                "type": "number"
+              },
+              "maxProperties": 64
+            }
+          }
+        },
+        "apply": {
+          "default": {},
+          "type": "object",
+          "properties": {
+            "scope": {
+              "default": "swarm",
+              "type": "string",
+              "enum": [
+                "swarm",
+                "all"
+              ]
+            },
+            "minConfidence": {
+              "default": 0.7,
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1
+            },
+            "floor": {
+              "default": "haiku",
+              "type": "string",
+              "enum": [
+                "haiku",
+                "sonnet",
+                "opus",
+                "fable"
+              ]
+            },
+            "ceiling": {
+              "default": "opus",
+              "type": "string",
+              "enum": [
+                "haiku",
+                "sonnet",
+                "opus",
+                "fable"
+              ]
+            },
+            "respectFrontmatter": {
+              "default": true,
+              "type": "boolean"
+            }
+          }
+        },
+        "advice": {
+          "default": {},
+          "type": "object",
+          "properties": {
+            "mainSession": {
+              "default": "user",
+              "type": "string",
+              "enum": [
+                "off",
+                "user",
+                "context"
+              ]
+            },
+            "cooldownPrompts": {
+              "default": 8,
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            }
+          }
+        },
+        "learning": {
+          "default": {},
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "default": true,
+              "type": "boolean"
+            },
+            "maxBias": {
+              "default": 0.3,
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1
+            },
+            "minSamples": {
+              "default": 5,
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            },
+            "halfLife": {
+              "default": 50,
+              "type": "number",
+              "exclusiveMinimum": 0
+            },
+            "costWeight": {
+              "default": 0.05,
+              "type": "number",
+              "minimum": 0
+            }
+          }
+        },
+        "cache": {
+          "default": {},
+          "type": "object",
+          "properties": {
+            "ttlHours": {
+              "default": 24,
+              "type": "number",
+              "exclusiveMinimum": 0
+            },
+            "maxEntries": {
+              "default": 2000,
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991
+            }
+          }
+        },
+        "breaker": {
+          "default": {},
+          "type": "object",
+          "properties": {
+            "failures": {
+              "default": 2,
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991
+            },
+            "cooldownSec": {
+              "default": 120,
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991
+            }
+          }
+        },
+        "budget": {
+          "default": {},
+          "type": "object",
+          "properties": {
+            "dailyUsd": {
+              "default": 0.5,
+              "type": "number",
+              "minimum": 0
+            },
+            "dailyCalls": {
+              "default": 2000,
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991
+            }
+          }
+        },
+        "privacy": {
+          "default": {},
+          "type": "object",
+          "properties": {
+            "maxChars": {
+              "default": 2000,
+              "type": "integer",
+              "exclusiveMinimum": 0,
+              "maximum": 9007199254740991
+            },
+            "storeHead": {
+              "default": true,
+              "type": "boolean"
+            },
+            "captureExchanges": {
+              "default": false,
+              "type": "boolean"
+            }
+          }
+        }
+      }
     }
   },
   "title": "eminiar.config.json",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eminiar",
-  "version": "0.12.0",
+  "version": "0.13.1",
   "description": "Local-first context, memory and knowledge-graph plugin for Claude Code and Cursor. Sandboxed execution, FTS5 + vector search, session continuity, and a code graph — nothing leaves your machine.",
   "type": "module",
   "license": "MIT",
@@ -49,7 +49,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsup && tsup --config tsup.web.config.ts && node scripts/copy-grammars.mjs && tsx scripts/gen-schema.ts",
+    "build": "tsup && node scripts/check-bundle.mjs && tsup --config tsup.web.config.ts && node scripts/copy-grammars.mjs && tsx scripts/gen-schema.ts",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.web.json",
     "test": "vitest run",

package/skills/em-doctor/SKILL.md

@@ -1,9 +1,22 @@
 ---
 name: em-doctor
-description: Diagnose the eminiar installation — node, SQLite FTS5, sqlite-vec, embedding model, sandbox languages, routing mode, context-mode coexistence, project root.
+description: Diagnose the eminiar installation — node, SQLite FTS5, sqlite-vec, embedding model, sandbox languages, routing mode, context-mode coexistence, project root, and the opt-in adjudicator (provider, key, consent, health).
 user-invocable: true
 allowed-tools: mcp__plugin_eminiar_eminiar__em_doctor
 ---
 
 Call `em_doctor` and show the checklist verbatim. For any failed check, suggest the fix in one
 line (usually `npx eminiar install` or `eminiar doctor --fix` from a terminal).
+
+When the adjudicator is on, the `adjudicator*` checks cover: the config is valid; the
+configured provider is the one that runs (or why the heuristic runs instead: no key, no
+consent, an API key rejected, misconfigured); the key is present and `~/.eminiar/adjudicator.key`
+is mode 0600; consent for a remote provider; breaker state and p95 latency against the budget;
+the last 24 h fallback rate; `CLAUDE_CODE_SUBAGENT_MODEL_FORCE` set while mode is apply; in
+apply mode, `adjudicator swarm pins` (information, not a failure) when every role of a swarm
+pins a model without a range, so apply mode cannot change any of its workers; and, for the
+embedding provider, whether the exemplar vectors are cached. Fixes are
+`eminiar adjudicator key set`, `eminiar adjudicator enable --accept-remote`, `chmod 600
+~/.eminiar/adjudicator.key`, `eminiar adjudicator status`, or for swarm pins a `model_range` on
+the roles in `.eminiar/swarm.yaml` followed by `eminiar swarm sync`. `eminiar doctor` (terminal) also
+probes the provider live with a 2 s timeout.

package/skills/em-onboard/SKILL.md

@@ -42,6 +42,38 @@ Then write, via `em_remember {kind: "onboarding", name: …, content: …}`:
   are, which local specs exist, and the rule: `em_docs {action: "lookup", query}` before
   WebFetch/WebSearch for anything the project depends on.
 
+Then ask about the adjudicator (optional; it is off by default and is never turned on
+without a yes). Skip this step if the user asked for a non-interactive or default onboarding,
+or if `eminiar adjudicator status --json` (run with `em_execute`, language shell; use
+`npx eminiar` if `eminiar` is not on PATH) shows it is already on.
+
+1. Explain in two sentences: the adjudicator scores how complex each prompt, subagent task
+   and swarm task is and suggests the eminiar tool, the Claude model size (haiku / sonnet /
+   opus) and the swarm agent role for it, to save tokens. Then ask exactly:
+   **"Use the adjudicator for tool, model and agent selection? (default: no)"**
+   Anything but a clear yes means no: say `eminiar adjudicator enable` turns it on later, and stop.
+2. On yes, ask which provider, and say for each whether text leaves the machine:
+   - **heuristic** (default): built-in rules; offline, nothing leaves this machine.
+   - **embedding**: nearest examples with the local embedding model; offline.
+   - **Jev** (TypeSafe, api.typesafe.ai): hosted; sends prompt text off this machine; needs an API key.
+   - **OpenAI-compatible**: a local server (Ollama on 11434, LM Studio on 1234, llama.cpp on
+     8080; nothing leaves the machine) or a hosted one (Groq, Cerebras; sends prompt text off
+     this machine; needs an API key). `eminiar adjudicator provider --detect` finds local servers.
+3. For a choice that sends text off the machine, quote this and get an explicit yes before
+   continuing: "The text of your prompts and subagent tasks (redacted, at most 2000 chars) is
+   sent to <host> to score them." Without that yes, fall back to the heuristic.
+4. Turn it on with `em_execute` (shell), adding `--accept-remote` only after that explicit yes:
+   `eminiar adjudicator enable --provider <heuristic|embedding|typesafe|ollama|lmstudio|llamacpp|groq|cerebras> [--accept-remote]`
+5. For Jev or a hosted preset the key goes into the local key file `~/.eminiar/adjudicator.key`
+   (mode 0600), never into the chat, a config file or a command line. Ask the user to run, in
+   their own terminal: `eminiar adjudicator key set typesafe` (or `groq` / `cerebras`), which
+   reads the key at a hidden prompt. If the key is already in an environment variable,
+   `eminiar adjudicator key set --from-env NAME` stores only the variable's name. If the user
+   pastes a key into the chat anyway, do not repeat it or put it in a command; tell them to
+   rotate it and use the hidden prompt.
+6. Finish with `eminiar adjudicator status` and tell the user to run `/mcp reconnect` so the
+   `em_adjudicate` tool loads (hooks pick the change up on the next prompt).
+
 Finish with one line listing the five names; mention that the files live under
 `.eminiar/memories/onboarding/` and the manifest at `.eminiar/docs.json`, and that both
-should be committed.
+should be committed. Add whether the adjudicator was turned on, and with which provider.