@allansantos-dev/smart-tool 0.9.38 → 0.9.39

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.9.39 - beta
+
+- Two-letter technical terms (`ui`, `db`, `id`) count again in the shared `focus_terms`, used by `smart_search
+  mode=dossier` and `smart_scout`. Two-letter English and Portuguese function words (`is`, `of`, `de`, `em`, ...) are
+  dropped like the question words. Tests in `tests/test_dossier.py`.
+- The npm registry and OSV checks of `freshness` no longer raise. `npm_registry_evidence` read a local `version` before
+  assigning it (UnboundLocalError on every call) and `npm_advisories` shadowed the `version` module with its parameter;
+  both return evidence or `None` as documented. Tests in `tests/test_npm_evidence.py`.
+
 ## 0.9.38 - beta
 
 - One definition of a search term. `smart_search mode=dossier` now takes its terms from `dossier.focus_terms`, the

package/README.md

@@ -16,7 +16,7 @@ registered as the `playwright` server where this machine lets a browser be drive
 An optional hook routes the agent's native Grep/Glob/Read/Bash/WebSearch/WebFetch calls to these tools when they
 are cheaper, or just tells the agent what Smart Tool would do.
 
-**Status:** 0.9.38 beta. Windows only. What changed in each version: [CHANGELOG.md](CHANGELOG.md).
+**Status:** 0.9.39 beta. Windows only. What changed in each version: [CHANGELOG.md](CHANGELOG.md).
 
 ## How it works
 

package/dossier.py

@@ -16,7 +16,7 @@ TITLE_CHARS = 80
 MAX_FILE_BYTES = 512 * 1024
 BACKLOG_FILES = ("docs/BACKLOG.md", "BACKLOG.md")
 INSTRUCTION_FILES = (("CLAUDE.md", "claude_md"), (".claude/CLAUDE.md", "claude_md"), ("AGENTS.md", "agents_md"))
-_WORD = re.compile(r"[\w]{3,}", re.UNICODE)
+_WORD = re.compile(r"[\w]{2,}", re.UNICODE)
 _STOPWORDS = {
     "the", "and", "for", "how", "what", "where", "which", "does", "with", "from", "that", "this", "are", "when", "who",
     "why", "into", "used", "use", "uses", "its", "has", "have", "code", "project", "file", "files",
@@ -24,13 +24,15 @@ _STOPWORDS = {
     "pela", "ele", "ela", "isso", "esse", "essa", "este", "esta", "fica", "ficam", "usa", "usado", "usada", "sobre",
     "entre", "depois", "antes", "quando", "cada", "seu", "sua", "seus", "suas", "não", "sem", "mais", "código",
     "projeto", "arquivo", "arquivos", "decide", "funciona",
+    "is", "in", "to", "of", "on", "at", "by", "an", "as", "it", "or", "be", "do", "if", "so", "we", "no", "up", "me", "my",
+    "he", "us", "am", "de", "da", "em", "na", "os", "um", "se", "ao", "ou", "eu", "te", "é", "já", "só",
 }
 _UNIT_START = re.compile(r"#{1,6}\s|[-*]\s")
 
 
 def focus_terms(*texts):
-    """Casefolded content words of the texts (3+ characters, common question words dropped), camelCase split, in
-    order: what a window is scored by."""
+    """Casefolded content words of the texts (2+ characters, common question and function words dropped), camelCase
+    split, in order: what a window is scored by."""
     found = []
     for text in texts:
         spaced = re.sub(r"([a-z])([A-Z])", r"\1 \2", text or "")

package/freshness.py

@@ -62,23 +62,23 @@ def npm_registry_evidence(package):
     try:
         with urllib.request.urlopen(request, timeout=7) as response:
             data = json.load(response)
-        version = data.get("version") if isinstance(data, dict) else None
-        if not isinstance(version, str) or not version or len(version) > 80:
+        latest = data.get("version") if isinstance(data, dict) else None
+        if not isinstance(latest, str) or not latest or len(latest) > 80:
             return None
         return {"title": f"npm registry: {package}", "url": url,
-                "snippet": f"Latest version published on the npm registry: {version}",
-                "tier": "npm_registry", "npm_package": package, "npm_version": version}
+                "snippet": f"Latest version published on the npm registry: {latest}",
+                "tier": "npm_registry", "npm_package": package, "npm_version": latest}
     except Exception:
         return None
 
 
-def npm_advisories(package, version):
+def npm_advisories(package, package_version):
     """IDs conhecidos pela OSV para a versão; None significa checagem indisponível."""
-    if (not package or not version
+    if (not package or not package_version
             or not re.fullmatch(r"(?:@[a-z0-9._-]+/)?[a-z0-9._-]+", package)):
         return None
     body = json.dumps({"package": {"name": package, "ecosystem": "npm"},
-                       "version": version}).encode("utf-8")
+                       "version": package_version}).encode("utf-8")
     request = urllib.request.Request(
         "https://api.osv.dev/v1/query", data=body, method="POST",
         headers={"Content-Type": "application/json", "Accept": "application/json",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allansantos-dev/smart-tool",
-  "version": "0.9.38",
+  "version": "0.9.39",
   "description": "Local MCP server that gives coding agents (Claude Code, Codex) cheaper, sharper tools than their built-in search. Windows.",
   "license": "Apache-2.0",
   "author": "Allan Santos",

package/version.py

@@ -1,7 +1,7 @@
 """Single source of the Smart Tool version and of the User-Agent sent to public APIs."""
 import re
 
-VERSION = "0.9.38"
+VERSION = "0.9.39"
 _CONTACT_RE = re.compile(r"^(?:[^\s@()<>;]+@[^\s@()<>;]+\.[^\s@()<>;]+|https?://[^\s()<>;]+)$")