@dotdotgod/hermes 0.6.0 → 0.6.2

package/mcp/server.mjs

@@ -23240,28 +23240,33 @@ async function cliJson(args, cwd) {
     throw new Error(`Expected JSON from dotdotgod: ${out.slice(0, 500)}`);
   }
 }
+function embeddingRuntimeRecovery() {
+  return {
+    code: "EMBEDDING_RUNTIME_MISSING",
+    message: "Semantic vectors need an optional runtime; continue with keyword/map retrieval or ask before installation.",
+    recovery: { kind: "embedding-runtime-install", requiresConfirmation: true, statusTool: "dotdotgod_embedding_status", installTool: "dotdotgod_embedding_install", cliCommand: "dotdotgod embedding install --confirm" }
+  };
+}
 async function projectLoad(input) {
   const root2 = resolve5(input.root || process.cwd());
   const focus = input.focus?.trim() ?? "";
   const tree = markdownTree(root2, input.maxDepth ?? (focus ? 3 : 5));
   let query = null;
   let queryUnavailable;
+  let vectorUnavailable;
   if (focus) {
     try {
       query = await cliJson(["query", root2, focus, "--limit", String(Math.min(input.limit ?? 30, 30)), "--json"], root2);
+      if (query.warnings?.some((warning) => warning.includes("Optional local embedding runtime is not installed"))) vectorUnavailable = embeddingRuntimeRecovery();
     } catch (error2) {
       const missingRuntime = String(error2?.message ?? error2).includes("Optional local embedding runtime is not installed");
-      queryUnavailable = missingRuntime ? {
-        code: "EMBEDDING_RUNTIME_MISSING",
-        message: "Local semantic search requires an optional embedding runtime; continue with the documentation map or ask the user before installation.",
-        recovery: { kind: "embedding-runtime-install", requiresConfirmation: true, statusTool: "dotdotgod_embedding_status", installTool: "dotdotgod_embedding_install", cliCommand: "dotdotgod embedding install --confirm" }
-      } : {
+      queryUnavailable = missingRuntime ? embeddingRuntimeRecovery() : {
         code: "QUERY_UNAVAILABLE",
         message: "Semantic project query is unavailable; continue with the documentation map and targeted reads."
       };
     }
   }
-  return { ok: true, root: root2, focus, documentationTree: tree, query, ...queryUnavailable ? { queryUnavailable } : {} };
+  return { ok: true, root: root2, focus, documentationTree: tree, query, ...queryUnavailable ? { queryUnavailable } : {}, ...vectorUnavailable ? { vectorUnavailable } : {} };
 }
 async function projectEmbeddingStatus(input = {}) {
   const root2 = resolve5(input.root || process.cwd());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotdotgod/hermes",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Hermes CLI and messaging-gateway adapter without Plan Mode.",
   "type": "module",
   "publishConfig": {
@@ -13,7 +13,7 @@
   "devDependencies": {
     "@modelcontextprotocol/sdk": "^1.25.2",
     "esbuild": "0.27.3",
-    "@dotdotgod/context": "0.6.0"
+    "@dotdotgod/context": "0.6.2"
   },
   "files": [
     "plugin.yaml",

package/plugin.yaml

@@ -1,5 +1,5 @@
 name: dotdotgod
-version: 0.6.0
+version: 0.6.2
 description: Project memory, isolated context tools and impact checks for Hermes CLI and messaging gateway; no Plan Mode.
 author: dotdotgod
 license: Elastic-2.0

package/runtime.py

@@ -52,10 +52,13 @@ class Runtime:
         labels = access.get(session.principal, []) if isinstance(access, dict) else []
         return {label: roots[label] for label in labels if label in roots} if isinstance(labels, list) else {}
 
-    def session(self, session_id):
+    def trusted_session(self, session_id):
         if not session_id or session_id not in self.sessions:
             raise ValueError("No trusted host session; start a turn before using dotdotgod")
-        session = self.sessions[session_id]
+        return self.sessions[session_id]
+
+    def session(self, session_id):
+        session = self.trusted_session(session_id)
         if session.root is None:
             raise ValueError("Select an authorized repository with dotdotgod_select_root first")
         if session.parent_id:
@@ -122,8 +125,23 @@ class Runtime:
 
     def call(self, name, args, session_id):
         with self.lock:
+            session = self.trusted_session(session_id)
             if name == "dotdotgod_select_root":
-                return self.select(self.sessions[session_id], args.get("label"))
+                if not self.allowed(session):
+                    raise PermissionError("No authorized repository labels; only dotdotgod_project_initialize is available")
+                return self.select(session, args.get("label"))
+            if session.root is None and not session.parent_id and name == "dotdotgod_project_initialize":
+                target = args.get("root")
+                if not isinstance(target, str) or not Path(target).is_absolute():
+                    raise ValueError("Initialization without selection requires an explicit absolute root directory")
+                root = Path(target).resolve(strict=True)
+                if not root.is_dir():
+                    raise ValueError("Initialization root must be a directory")
+                proxy = Proxy(root, digest(session.principal + "\0" + session.id + "\0initialize"))
+                try:
+                    return proxy.call(name, {**args, "root": str(root)})
+                finally:
+                    proxy.close()
             session = self.session(session_id)
         if name == "dotdotgod_impact_status":
             return envelope({"ok": True, "pending": list(self.pending(session))})
@@ -160,6 +178,13 @@ class Runtime:
 
     def before_tool(self, tool_name, args, session_id="", **kwargs):
         try:
+            session = self.trusted_session(session_id)
+            if session.root is None and not session.parent_id:
+                if not tool_name.startswith("dotdotgod_") or tool_name == "dotdotgod_project_initialize":
+                    return None
+                if tool_name == "dotdotgod_select_root" and self.allowed(session):
+                    return None
+                return {"action": "block", "message": "dotdotgod is inactive without a selected repository; only initialization is available (selection requires authorized labels)"}
             if tool_name == "dotdotgod_select_root":
                 return None
             session = self.session(session_id)
@@ -194,7 +219,11 @@ class Runtime:
                 elif platform in {"", "cli"}:
                     session.root = Path(self.ctx.get_config("cli_root", "") or self.launch_root).resolve(strict=True)
         if session.root is None:
-            return {"context": "Select a repository using dotdotgod_select_root. Authorized labels: " + json.dumps(list(self.allowed(session)))}
+            labels = list(self.allowed(session))
+            context = "dotdotgod is inactive; ordinary host tools remain available. Only dotdotgod_project_initialize may run without selection, with an explicit absolute root and existing write confirmation. Initialization does not select or authorize a repository."
+            if labels:
+                context += " Optionally select a repository using dotdotgod_select_root. Authorized labels: " + json.dumps(labels)
+            return {"context": context}
         try:
             self.session(session_id)
             parts = []

package/skills/project-load/SKILL.md

@@ -22,9 +22,9 @@ Load the repository's dotdotgod project memory without modifying maintained file
 1. Identify the repository root. Expose `Help: dotdotgod --help` as optional CLI discovery guidance without checking or reporting installation status, and do not require Help execution for Load to continue.
 2. When baseline context is missing, read `AGENTS.md`, the adapter entrypoint, `README.md`, and `docs/README.md` when present.
 3. Without arguments, run `dotdotgod map <root> --depth 5 --json` and use its configured prefix-compressed documentation tree. The command owns `documentation.root`, `load.documentationSummary.exclude`, deterministic Markdown discovery, and boundary summaries.
-4. With arguments, run `dotdotgod query <root> "<focus>" --limit 30 --json` for at most 30 distinct Markdown files and `dotdotgod map <root> --depth 3 --json` for the configured navigation tree.
+4. With arguments, run `dotdotgod query <root> "<focus>" --limit 30 --json` for at most 30 documentation-file or code-symbol results and `dotdotgod map <root> --depth 3 --json` for the configured navigation tree.
 5. If the CLI or shell execution is unavailable, preserve Load behavior by building the same tree from the configured documentation root when known, excluding local memory, and using README routing. At the depth boundary, list every direct Markdown file and immediate child directory, then summarize hidden descendants separately under each named child with exact recursive directory and Markdown-file counts.
-6. Read bodies selectively from query results, explicit paths, and README indexes. Read relevant active plans only when needed, use `docs/archive/README.md` (or the configured archive `README.md` under an alternate documentation root) as the history map, and avoid broad generated, dependency, cache, or secret reads.
+6. Query searches full documentation content and code outlines/comments, not implementation bodies. Preserve result kind, source ranges and retrieval warnings; verify source freshness before reading a symbol's implementation. Read bodies selectively from query results, explicit paths, and README indexes. Read relevant active plans only when needed, use `docs/archive/README.md` (or the configured archive `README.md` under an alternate documentation root) as the history map, and avoid broad generated, dependency, cache, or secret reads.
 
 ## Output