arkaos 4.1.0 → 4.1.1

package/VERSION

@@ -1 +1 @@
-4.1.0
+4.1.1

package/config/hooks/post-tool-use.sh

@@ -49,5 +49,20 @@ if [ ! -f "$ARKAOS_ROOT/core/hooks/post_tool_use.py" ]; then
   fi
 fi
 
+# Interpreter resolution: prefer the ArkaOS venv (has pyyaml/pydantic);
+# otherwise probe — an unrelated project venv first on PATH would give a
+# python3 without yaml and silently degrade every gate.
+_PY=""
+for _cand in "$HOME/.arkaos/venv/bin/python3" "$HOME/.arkaos/.venv/bin/python3"; do
+  if [ -x "$_cand" ]; then _PY="$_cand"; break; fi
+done
+if [ -z "$_PY" ]; then
+  _PY="python3"
+  if ! "$_PY" -c "import yaml" 2>/dev/null; then
+    for _cand in /opt/homebrew/bin/python3 /usr/local/bin/python3 /usr/bin/python3; do
+      if [ -x "$_cand" ] && "$_cand" -c "import yaml" 2>/dev/null; then _PY="$_cand"; break; fi
+    done
+  fi
+fi
 PYTHONPATH="$ARKAOS_ROOT${PYTHONPATH:+:$PYTHONPATH}" \
-  exec python3 -m core.hooks.post_tool_use
+  exec "$_PY" -m core.hooks.post_tool_use

package/config/hooks/pre-tool-use.sh

@@ -52,5 +52,20 @@ if [ ! -f "$ARKAOS_ROOT/core/hooks/pre_tool_use.py" ]; then
 fi
 
 # ─── Single python process; stdin/stdout/stderr/exit-code pass through ──
+# Interpreter resolution: prefer the ArkaOS venv (has pyyaml/pydantic);
+# otherwise probe — an unrelated project venv first on PATH would give a
+# python3 without yaml and silently degrade every gate.
+_PY=""
+for _cand in "$HOME/.arkaos/venv/bin/python3" "$HOME/.arkaos/.venv/bin/python3"; do
+  if [ -x "$_cand" ]; then _PY="$_cand"; break; fi
+done
+if [ -z "$_PY" ]; then
+  _PY="python3"
+  if ! "$_PY" -c "import yaml" 2>/dev/null; then
+    for _cand in /opt/homebrew/bin/python3 /usr/local/bin/python3 /usr/bin/python3; do
+      if [ -x "$_cand" ] && "$_cand" -c "import yaml" 2>/dev/null; then _PY="$_cand"; break; fi
+    done
+  fi
+fi
 PYTHONPATH="$ARKAOS_ROOT${PYTHONPATH:+:$PYTHONPATH}" \
-  exec python3 -m core.hooks.pre_tool_use
+  exec "$_PY" -m core.hooks.pre_tool_use

package/config/hooks/stop.sh

@@ -49,6 +49,21 @@ if [ ! -f "$ARKAOS_ROOT/core/hooks/stop.py" ]; then
   fi
 fi
 
+# Interpreter resolution: prefer the ArkaOS venv (has pyyaml/pydantic);
+# otherwise probe — an unrelated project venv first on PATH would give a
+# python3 without yaml and silently degrade every gate.
+_PY=""
+for _cand in "$HOME/.arkaos/venv/bin/python3" "$HOME/.arkaos/.venv/bin/python3"; do
+  if [ -x "$_cand" ]; then _PY="$_cand"; break; fi
+done
+if [ -z "$_PY" ]; then
+  _PY="python3"
+  if ! "$_PY" -c "import yaml" 2>/dev/null; then
+    for _cand in /opt/homebrew/bin/python3 /usr/local/bin/python3 /usr/bin/python3; do
+      if [ -x "$_cand" ] && "$_cand" -c "import yaml" 2>/dev/null; then _PY="$_cand"; break; fi
+    done
+  fi
+fi
 PYTHONPATH="$ARKAOS_ROOT${PYTHONPATH:+:$PYTHONPATH}" \
-  python3 -m core.hooks.stop
+  "$_PY" -m core.hooks.stop
 exit 0

package/config/hooks/user-prompt-submit.sh

@@ -54,5 +54,20 @@ if [ ! -f "$ARKAOS_ROOT/core/hooks/user_prompt_submit.py" ]; then
   fi
 fi
 
+# Interpreter resolution: prefer the ArkaOS venv (has pyyaml/pydantic);
+# otherwise probe — an unrelated project venv first on PATH would give a
+# python3 without yaml and silently degrade every gate.
+_PY=""
+for _cand in "$HOME/.arkaos/venv/bin/python3" "$HOME/.arkaos/.venv/bin/python3"; do
+  if [ -x "$_cand" ]; then _PY="$_cand"; break; fi
+done
+if [ -z "$_PY" ]; then
+  _PY="python3"
+  if ! "$_PY" -c "import yaml" 2>/dev/null; then
+    for _cand in /opt/homebrew/bin/python3 /usr/local/bin/python3 /usr/bin/python3; do
+      if [ -x "$_cand" ] && "$_cand" -c "import yaml" 2>/dev/null; then _PY="$_cand"; break; fi
+    done
+  fi
+fi
 PYTHONPATH="$ARKAOS_ROOT${PYTHONPATH:+:$PYTHONPATH}" \
-  exec python3 -m core.hooks.user_prompt_submit
+  exec "$_PY" -m core.hooks.user_prompt_submit

package/core/obsidian/relator.py

@@ -36,6 +36,13 @@ _STOPWORDS = frozenset({
 })
 
 
+# Jaccard between full documents rarely exceeds ~0.3 even for clearly
+# related notes, while cosine similarity of embeddings sits comfortably
+# above 0.5. A single threshold calibrated for cosine silently disabled
+# the relator on every machine without fastembed (v4.1.1 fix).
+_KEYWORD_MIN_SIMILARITY = 0.15
+
+
 def find_related(
     content: str,
     vault: Path,
@@ -48,8 +55,9 @@ def find_related(
     candidates = _collect_notes(vault, exclude)
     if not candidates:
         return []
-    scored = _score_candidates(content, candidates)
-    filtered = [r for r in scored if r.score >= min_similarity]
+    scored, method = _score_candidates(content, candidates)
+    threshold = min_similarity if method == "semantic" else _KEYWORD_MIN_SIMILARITY
+    filtered = [r for r in scored if r.score >= threshold]
     filtered.sort(key=lambda r: r.score, reverse=True)
     return filtered[:top_n]
 
@@ -70,22 +78,24 @@ def _collect_notes(vault: Path, exclude: Optional[Path]) -> list[tuple[Path, str
 
 def _score_candidates(
     content: str, candidates: list[tuple[Path, str]]
-) -> list[RelatedNote]:
+) -> tuple[list[RelatedNote], str]:
+    """Score candidates, returning (results, method) so the caller can
+    apply a threshold appropriate to the scoring space."""
     try:
         return _semantic_score(content, candidates)
     except Exception:
-        return _keyword_score(content, candidates)
+        return _keyword_score(content, candidates), "keyword"
 
 
 def _semantic_score(
     content: str, candidates: list[tuple[Path, str]]
-) -> list[RelatedNote]:
+) -> tuple[list[RelatedNote], str]:
     from core.knowledge.embedder import embed, is_available
     if not is_available():
-        return _keyword_score(content, candidates)
+        return _keyword_score(content, candidates), "keyword"
     query_emb = embed(content)
     if query_emb is None:
-        return _keyword_score(content, candidates)
+        return _keyword_score(content, candidates), "keyword"
     results = []
     for path, text in candidates:
         note_emb = embed(text[:2000])
@@ -96,7 +106,7 @@ def _semantic_score(
             path=path, title=_title_from_path(path),
             score=score, excerpt=text[:160],
         ))
-    return results
+    return results, "semantic"
 
 
 def _keyword_score(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkaos",
-  "version": "4.1.0",
+  "version": "4.1.1",
   "description": "The Operating System for AI Agent Teams",
   "type": "module",
   "bin": {

package/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "arkaos-core"
-version = "4.1.0"
+version = "4.1.1"
 description = "Core engine for ArkaOS — The Operating System for AI Agent Teams"
 readme = "README.md"
 license = {text = "MIT"}
@@ -35,6 +35,8 @@ knowledge = [
 dashboard = [
     "fastapi>=0.115.0",
     "uvicorn>=0.32.0",
+    "python-multipart>=0.0.9",
+    "websockets>=12.0",
 ]
 ingest = [
     "yt-dlp>=2024.0",