@minhpnq1807/contextos 0.5.18 → 0.5.20

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.5.20
+
+- Refreshes stale `ctx-mcp` Ruler entries that point at temporary paths such as `/tmp/contextos/...`.
+- Keeps `ctx install` fast by skipping large skill/workflow discovery embedding warmup unless `CONTEXTOS_INSTALL_WARM_DISCOVERY=1` is set.
+
+## 0.5.19
+
+- Makes `ctx-mcp` startup non-mutating: the MCP server now verifies the local embedding model without warming or rewriting `embeddings.db` during agent initialization.
+- Fixes Antigravity staying on `ctx-mcp initializing...` when a large embedding cache makes startup writes slow or blocked.
+
 ## 0.5.18
 
 - Prevents `ctx sync --rules` from importing project MCP commands that point into temporary directories such as `/tmp/...`.

package/bin/ctx.js

@@ -299,16 +299,21 @@ async function warmInstallEmbeddings() {
     dataDir,
     allowRemote: !modelReady
   });
-  const skillResult = await warmSkillEmbeddings({
-    cwd: process.cwd(),
-    dataDir,
-    allowRemote: !modelReady
-  });
-  const workflowResult = await warmWorkflowEmbeddings({
-    cwd: process.cwd(),
-    dataDir,
-    allowRemote: !modelReady
-  });
+  const warmDiscovery = process.env.CONTEXTOS_INSTALL_WARM_DISCOVERY === "1";
+  const skillResult = warmDiscovery
+    ? await warmSkillEmbeddings({
+      cwd: process.cwd(),
+      dataDir,
+      allowRemote: !modelReady
+    })
+    : { count: 0 };
+  const workflowResult = warmDiscovery
+    ? await warmWorkflowEmbeddings({
+      cwd: process.cwd(),
+      dataDir,
+      allowRemote: !modelReady
+    })
+    : { count: 0 };
   return { ...result, modelAlreadyCached: modelReady, fileCount: fileResult.count, skillCount: skillResult.count, workflowCount: workflowResult.count };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minhpnq1807/contextos",
-  "version": "0.5.18",
+  "version": "0.5.20",
   "description": "Task-aware AGENTS.md context injection and compliance reporting for Codex, Claude Code, and Antigravity.",
   "type": "module",
   "bin": {

package/plugins/ctx/lib/ruler-sync.js

@@ -268,6 +268,10 @@ function readRulerMcpServers({ tomlPath } = {}) {
   return servers;
 }
 
+function readRulerMcpServer({ tomlPath, name } = {}) {
+  return readRulerMcpServers({ tomlPath }).find((server) => server.name === name) || null;
+}
+
 function antigravityMcpConfigPaths() {
   const home = process.env.HOME || process.cwd();
   return [
@@ -415,7 +419,12 @@ export function injectCtxMcp({ tomlPath, mcpServerPath, agents = DEFAULT_AGENTS,
 
   let content = fs.readFileSync(tomlPath, "utf8");
   const sectionExists = hasTomlSection(content, `mcp_servers.${CTX_MCP_NAME}`);
-  if (sectionExists && !force) return { changed: false, existed: true };
+  if (sectionExists && !force) {
+    const existingServer = readRulerMcpServer({ tomlPath, name: CTX_MCP_NAME });
+    const existingPath = existingServer?.command === "node" ? existingServer.args?.[0] : existingServer?.command;
+    if (existingPath && isRunnableMcpCommand(existingPath)) return { changed: false, existed: true };
+    force = true;
+  }
 
   if (force) {
     content = removeTomlSection(content, "mcp");

package/plugins/ctx/mcp/server.js

@@ -4,7 +4,7 @@ import net from "node:net";
 
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
-import { modelCacheDir, warmRuleEmbeddings } from "../lib/embedding-scorer.js";
+import { isModelCacheReady, modelCacheDir } from "../lib/embedding-scorer.js";
 import { scoreContext } from "../lib/score-context.js";
 import { ctxMcpSocketPath } from "../lib/ctx-mcp-client.js";
 import { defaultDataRoot } from "../lib/workspace-data.js";
@@ -24,15 +24,9 @@ await server.connect(new StdioServerTransport());
 
 async function ensureModelReady() {
   const modelDir = modelCacheDir(dataDir);
-  if (!fs.existsSync(modelDir)) {
+  if (!fs.existsSync(modelDir) || !isModelCacheReady(dataDir)) {
     throw new Error(`ContextOS model cache missing: ${modelDir}. Run ctx install first.`);
   }
-  await warmRuleEmbeddings({
-    task: "contextos mcp model ready",
-    rules: [{ content: "ContextOS semantic scorer is ready." }],
-    dataDir,
-    allowRemote: false
-  });
 }
 
 function startBridge() {