@minhpnq1807/contextos 0.5.19 → 0.5.21

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.5.21
+
+- Makes prompt hooks fall back to direct scoring when the `ctx-mcp` bridge socket is missing, stale, or unavailable, avoiding empty `hook context` output.
+- Prioritizes imperative and code-review-graph rules in injected critical context so `IMPORTANT` project rules appear before generic semantic matches.
+- Improves workflow detection for CI, deployment, server, runtime, debugging, and issue-analysis prompts.
+
+## 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.

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.19",
+  "version": "0.5.21",
   "description": "Task-aware AGENTS.md context injection and compliance reporting for Codex, Claude Code, and Antigravity.",
   "type": "module",
   "bin": {

package/plugins/ctx/lib/analyzer.js

@@ -259,7 +259,7 @@ export function scoreRules(rules, task, openFiles = []) {
 
     const lowerRule = rule.content.toLowerCase();
     if (IMPORTANT_WORDS.some((word) => lowerRule.includes(word))) {
-      score += 0.4;
+      score += 0.5;
       reasons.push("imperative");
     }
 

package/plugins/ctx/lib/prompt-hook.js

@@ -2,6 +2,7 @@ import { scheduleContext } from "./scheduler.js";
 import { appendJsonLine, writeJsonFile } from "./fs-utils.js";
 import { callCtxScoreContext } from "./ctx-mcp-client.js";
 import { resolveHookCwd } from "./hook-io.js";
+import { scoreContext as scoreContextDirect } from "./score-context.js";
 import path from "node:path";
 
 export async function handlePromptPayload(
@@ -21,15 +22,31 @@ export async function handlePromptPayload(
   const openFiles = payload.openFiles || payload.open_files || payload.files || [];
   const dataDir = dataPath ? path.dirname(dataPath) : undefined;
 
-  const scored = await scoreContextClient({
-    cwd,
-    prompt,
-    openFiles,
-    maxFiles: 3
-  }, {
-    dataDir: mcpDataDir || dataDir,
-    timeoutMs: Number(process.env.CONTEXTOS_MCP_BRIDGE_TIMEOUT_MS || 1000)
-  });
+  let scored;
+  try {
+    scored = await scoreContextClient({
+      cwd,
+      prompt,
+      openFiles,
+      maxFiles: 3
+    }, {
+      dataDir: mcpDataDir || dataDir,
+      timeoutMs: Number(process.env.CONTEXTOS_MCP_BRIDGE_TIMEOUT_MS || 1000)
+    });
+  } catch (error) {
+    scored = await scoreContextDirect({
+      cwd,
+      prompt,
+      openFiles,
+      maxFiles: 3,
+      dataDir: mcpDataDir || dataDir
+    });
+    scored.telemetry = {
+      ...(scored.telemetry || {}),
+      bridgeStatus: "fallback",
+      bridgeError: error?.message || String(error)
+    };
+  }
 
   if (scored.error) throw new Error(scored.error);
   const scoredRules = scored.scoredRules || [];

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/lib/scheduler.js

@@ -1,9 +1,10 @@
 const MAX_CONTEXT_CHARS = 4000;
 
 export function scheduleContext({ rules = [], relevantFiles = [], suggestedSkills = [], suggestedWorkflows = [], maxChars = MAX_CONTEXT_CHARS } = {}) {
-  const high = rules.filter((rule) => rule.score >= 0.5);
-  const mid = rules.filter((rule) => rule.score >= 0.1 && rule.score < 0.5);
-  const dropped = rules.filter((rule) => rule.score < 0.1);
+  const orderedRules = [...rules].sort(compareRulesForContext);
+  const high = orderedRules.filter((rule) => rule.score >= 0.5);
+  const mid = orderedRules.filter((rule) => rule.score >= 0.1 && rule.score < 0.5);
+  const dropped = orderedRules.filter((rule) => rule.score < 0.1);
 
   const sections = [];
   if (high.length) {
@@ -37,6 +38,20 @@ export function scheduleContext({ rules = [], relevantFiles = [], suggestedSkill
   };
 }
 
+function compareRulesForContext(a, b) {
+  return rulePriority(b) - rulePriority(a)
+    || Number(b.score || 0) - Number(a.score || 0)
+    || Number(a.originalOrder || 0) - Number(b.originalOrder || 0);
+}
+
+function rulePriority(rule) {
+  const content = String(rule.content || "").toLowerCase();
+  let priority = 0;
+  if (/\b(important|always|must|required|mandatory|strictly|never)\b/.test(content)) priority += 10;
+  if (/\b(code-review-graph|query_graph|get_minimal_context|detect_changes|semantic_search_nodes)\b/.test(content)) priority += 4;
+  return priority;
+}
+
 function section(title, lines) {
   if (!lines.length) return "";
   return `## ${title}\n${lines.join("\n")}`;

package/plugins/ctx/lib/workflow-discoverer.js

@@ -320,12 +320,12 @@ function scoreWorkflowsByKeyword({ prompt, workflows }) {
 
 function actionIntentBonus(normalizedPrompt, workflow) {
   const name = normalize(`${workflow.name} ${workflow.title} ${workflow.description}`);
-  const implementationIntent = /\b(implement|feature|build|create|fix|debug|test|ci|failing)\b/.test(normalizedPrompt);
+  const implementationIntent = /\b(implement|feature|build|create|fix|debug|test|ci|cd|pipeline|failing|failure|error|issue|bug|analyze|analyse|solution|server|runtime|deploy|fly|flyio|loi|phan tich|giai phap)\b/.test(normalizedPrompt);
   const docsIntent = /\b(doc|docs|documentation|readme|changelog|roadmap)\b/.test(normalizedPrompt);
   const orchestrationIntent = /\b(parallel|sequential|chain|delegate|agent|subagent|orchestrat)\b/.test(normalizedPrompt);
-  if (implementationIntent && /\b(primary|implementation|testing|debugging|quality)\b/.test(name)) return 0.35;
-  if (docsIntent && /\b(documentation|docs|changelog|roadmap)\b/.test(name)) return 0.35;
-  if (orchestrationIntent && /\b(orchestration|parallel|sequential|chaining)\b/.test(name)) return 0.35;
+  if (implementationIntent && /\b(primary|implementation|testing|debugging|quality)\b/.test(name)) return 0.42;
+  if (docsIntent && /\b(documentation|docs|changelog|roadmap)\b/.test(name)) return 0.42;
+  if (orchestrationIntent && /\b(orchestration|parallel|sequential|chaining)\b/.test(name)) return 0.42;
   return 0;
 }