@ksm0709/context 0.0.33 → 0.0.35

package/README.md

@@ -10,7 +10,20 @@ Context plugin for Bun
 
 ## MCP Server
 
-This plugin automatically registers an MCP (Model Context Protocol) server named `context-mcp` with OpenCode. The server provides tools for searching knowledge base files (`.md` files in `docs/` and `.context/` directories).
+This plugin automatically registers an MCP (Model Context Protocol) server named `context-mcp` with OpenCode. The server provides metadata-first knowledge discovery for `.md` files in `docs/` and `.context/`.
+
+Recommended workflow:
+
+1. Run `search_knowledge` to get ranked candidate notes.
+2. Compare each result's path, title, description, tags, score, and snippet.
+3. Open the best match with `read_knowledge`.
+4. Use the related-note metadata appended to `read_knowledge` output to continue exploring linked notes.
+
+Core knowledge tools:
+
+- `search_knowledge` — returns ranked note summaries so agents can choose what to open next without relying on exact full-text matches.
+- `read_knowledge` — opens a selected note and appends linked-note metadata for relevant `[[wikilink]]` references.
+- `create_knowledge_note` / `update_knowledge_note` — create and maintain knowledge notes once the relevant context is understood.
 
 ## OMX Support
 

package/dist/cli/index.js

@@ -2,9 +2,9 @@
 // @bun
 
 // src/cli/commands/update.ts
-import { resolve as resolve3, join as join7 } from "path";
-import { existsSync as existsSync8 } from "fs";
-import { homedir as homedir3 } from "os";
+import { resolve as resolve3, join as join8 } from "path";
+import { existsSync as existsSync9 } from "fs";
+import { homedir as homedir4 } from "os";
 
 // src/lib/scaffold.ts
 import { existsSync as existsSync2, mkdirSync, readFileSync, writeFileSync } from "fs";
@@ -27,7 +27,7 @@ function resolveContextDir(projectDir) {
 // package.json
 var package_default = {
   name: "@ksm0709/context",
-  version: "0.0.33",
+  version: "0.0.35",
   author: {
     name: "TaehoKang",
     email: "ksm07091@gmail.com"
@@ -69,24 +69,23 @@ var package_default = {
     "@opencode-ai/plugin": ">=1.0.0"
   },
   dependencies: {
-    "@ksm0709/context": "^0.0.33",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "jsonc-parser": "^3.0.0"
   },
   devDependencies: {
-    "@opencode-ai/plugin": "^1.2.10",
     "@eslint/js": "^9.39.1",
+    "@opencode-ai/plugin": "^1.2.10",
     "@types/node": "^20.11.5",
     "@typescript-eslint/eslint-plugin": "8.47.0",
     "@typescript-eslint/parser": "8.47.0",
+    "@vitest/coverage-v8": "^3.2.4",
     "bun-types": "latest",
     eslint: "^9.39.1",
     "eslint-config-prettier": "10.1.8",
     "eslint-plugin-prettier": "^5.1.3",
     prettier: "^3.2.4",
     "typescript-eslint": "^8.47.0",
-    vitest: "^3.2.4",
-    "@vitest/coverage-v8": "^3.2.4"
+    vitest: "^3.2.4"
   }
 };
 
@@ -450,8 +449,8 @@ function writeVersion(contextDir, version) {
 }
 
 // src/cli/commands/install.ts
-import { join as join6, resolve as resolve2, dirname as dirname5 } from "path";
-import { existsSync as existsSync7, mkdirSync as mkdirSync5, copyFileSync } from "fs";
+import { join as join7, resolve as resolve2, dirname as dirname5 } from "path";
+import { existsSync as existsSync8, mkdirSync as mkdirSync5, copyFileSync } from "fs";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { createRequire as createRequire2 } from "module";
 import { execSync as execSync2 } from "child_process";
@@ -622,14 +621,17 @@ var STATIC_KNOWLEDGE_CONTEXT = `## Knowledge Context
 3. **\uC790\uAE30 \uC5B8\uC5B4** -- \uBCF5\uC0AC-\uBD99\uC5EC\uB123\uAE30\uAC00 \uC544\uB2CC, \uD575\uC2EC\uC744 \uC774\uD574\uD558\uACE0 \uAC04\uACB0\uD558\uAC8C \uC11C\uC220\uD558\uC138\uC694.
 
 ### MCP Tools
-- **\uC9C0\uC2DD \uAD00\uB9AC**: \`context_mcp_search_knowledge\`, \`context_mcp_read_knowledge\`, \`context_mcp_create_knowledge_note\`, \`context_mcp_update_knowledge_note\`
+- **\uC9C0\uC2DD \uD0D0\uC0C9**: \`context_mcp_search_knowledge\`\uB85C \uD6C4\uBCF4 \uB178\uD2B8\uB97C \uCC3E\uACE0, \uACB0\uACFC\uC758 title / description / tags / path / score\uB97C \uBA3C\uC800 \uBE44\uAD50\uD558\uC138\uC694.
+- **\uB178\uD2B8 \uC5F4\uAE30**: \`context_mcp_read_knowledge\`\uB85C \uC120\uD0DD\uD55C \uB178\uD2B8\uB97C \uC5F4\uACE0, \uB05D\uC5D0 \uBD99\uB294 related notes \uBA54\uD0C0\uB370\uC774\uD130\uB85C \uB2E4\uC74C \uD0D0\uC0C9 \uACBD\uB85C\uB97C \uC815\uD558\uC138\uC694.
+- **\uB178\uD2B8 \uC791\uC131/\uC218\uC815**: \`context_mcp_create_knowledge_note\`, \`context_mcp_update_knowledge_note\`
 - **\uB370\uC77C\uB9AC \uB178\uD2B8**: \`context_mcp_read_daily_note\`, \`context_mcp_append_daily_note\`
 - **\uC791\uC5C5 \uC644\uB8CC**: \`context_mcp_submit_turn_complete\` (\uC791\uC5C5 \uC885\uB8CC \uC2DC \uD544\uC218 \uD638\uCD9C)
 
 ### \uC791\uC5C5 \uC804 \uD544\uC218
 - **\uB370\uC77C\uB9AC \uB178\uD2B8 \uD655\uC778**: \uAC00\uC7A5 \uCD5C\uADFC\uC758 \uB370\uC77C\uB9AC \uB178\uD2B8\uB97C \uC77D\uACE0 \uC774\uC804 \uC138\uC158\uC758 \uCEE8\uD14D\uC2A4\uD2B8\uC640 \uBBF8\uD574\uACB0 \uC774\uC288\uB97C \uD30C\uC545\uD558\uC138\uC694.
 - **\uC791\uC5C5 \uC758\uB3C4 \uC120\uC5B8**: \uC791\uC5C5 \uC2DC\uC791 \uC804, \uD604\uC7AC \uC138\uC158\uC758 \uBAA9\uD45C\uC640 \uC791\uC5C5 \uC758\uB3C4\uB97C \uBA85\uD655\uD788 \uD30C\uC545\uD558\uACE0 \uC120\uC5B8\uD558\uC138\uC694.
-- **\uC9C0\uC2DD \uAC80\uC0C9**: \uC791\uC5C5\uACFC \uAD00\uB828\uB41C \uBB38\uC11C\uB97C **\uC9C1\uC811 \uBA3C\uC800** \uAC80\uC0C9\uD558\uACE0 \uC77D\uC73C\uC138\uC694.
+- **\uBA54\uD0C0\uB370\uC774\uD130 \uC6B0\uC120 \uAC80\uC0C9**: \uBA3C\uC800 \`search_knowledge\`\uB85C \uAD00\uB828 \uD6C4\uBCF4\uB97C \uCC3E\uACE0, \uBA54\uD0C0\uB370\uC774\uD130\uB97C \uBE44\uAD50\uD55C \uB4A4 \uAC00\uC7A5 \uC720\uB825\uD55C \uB178\uD2B8\uB97C \`read_knowledge\`\uB85C \uC5EC\uC138\uC694.
+- **\uAD00\uB828 \uB178\uD2B8 \uCD94\uC801**: \`read_knowledge\` \uB05D\uC758 related notes \uC139\uC158\uC5D0\uC11C \uC5F0\uACB0\uB41C \uB178\uD2B8\uC758 title / description / tags / path\uB97C \uD655\uC778\uD558\uACE0 \uD544\uC694\uC2DC \uC5F0\uC1C4 \uD0D0\uC0C9\uD558\uC138\uC694.
 - \uC9C0\uC2DD \uD30C\uC77C\uC5D0 \uAE30\uB85D\uB41C \uC544\uD0A4\uD14D\uCC98 \uACB0\uC815, \uD328\uD134, \uC81C\uC57D\uC0AC\uD56D\uC744 \uBC18\uB4DC\uC2DC \uB530\uB974\uC138\uC694.
 
 ### \uAC1C\uBC1C \uC6D0\uCE59
@@ -647,10 +649,63 @@ var STATIC_KNOWLEDGE_CONTEXT = `## Knowledge Context
 - \uC774 \uD638\uCD9C \uC5C6\uC774 \uC138\uC158\uC744 \uC885\uB8CC\uD558\uBA74 \uC791\uC5C5 \uAE30\uB85D\uC774 \uBCF4\uC874\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.
 - \uD544\uC694\uD55C \uC778\uC790: daily_note_update_proof, knowledge_note_proof, quality_check_output, checkpoint_commit_hashes, scope_review_notes`;
 
-// src/shared/claude-settings.ts
-import { existsSync as existsSync6, readFileSync as readFileSync4, writeFileSync as writeFileSync4, renameSync as renameSync2, mkdirSync as mkdirSync4 } from "fs";
-import { dirname as dirname4, join as join5 } from "path";
+// src/shared/codex-settings.ts
+import { existsSync as existsSync6, readFileSync as readFileSync4, writeFileSync as writeFileSync4 } from "fs";
 import { homedir as homedir2 } from "os";
+import { isAbsolute, join as join5 } from "path";
+var STALE_MOCK_MCP_SERVER_NAME = "mock-mcp";
+var codexConfigPath = join5(homedir2(), ".codex", "config.toml");
+function findMcpServerBlockRange(lines, serverName) {
+  const header = `[mcp_servers.${serverName}]`;
+  const start = lines.findIndex((line) => line.trim() === header);
+  if (start === -1) {
+    return null;
+  }
+  let end = lines.length;
+  for (let index = start + 1;index < lines.length; index += 1) {
+    if (lines[index].startsWith("[")) {
+      end = index;
+      break;
+    }
+  }
+  return { start, end };
+}
+function resolveFirstArgPath(blockLines) {
+  for (const line of blockLines) {
+    const match = line.match(/^\s*args\s*=\s*\[\s*["']([^"']+)["']/);
+    if (!match) {
+      continue;
+    }
+    return match[1];
+  }
+  return null;
+}
+function pruneStaleMockMcpServer() {
+  if (!existsSync6(codexConfigPath)) {
+    return false;
+  }
+  const content = readFileSync4(codexConfigPath, "utf8");
+  const lines = content.split(`
+`);
+  const blockRange = findMcpServerBlockRange(lines, STALE_MOCK_MCP_SERVER_NAME);
+  if (!blockRange) {
+    return false;
+  }
+  const blockLines = lines.slice(blockRange.start, blockRange.end);
+  const firstArgPath = resolveFirstArgPath(blockLines);
+  if (!firstArgPath || !isAbsolute(firstArgPath) || existsSync6(firstArgPath)) {
+    return false;
+  }
+  const nextLines = [...lines.slice(0, blockRange.start), ...lines.slice(blockRange.end)];
+  writeFileSync4(codexConfigPath, nextLines.join(`
+`), "utf8");
+  return true;
+}
+
+// src/shared/claude-settings.ts
+import { existsSync as existsSync7, readFileSync as readFileSync5, writeFileSync as writeFileSync5, renameSync as renameSync2, mkdirSync as mkdirSync4 } from "fs";
+import { dirname as dirname4, join as join6 } from "path";
+import { homedir as homedir3 } from "os";
 
 // node_modules/jsonc-parser/lib/esm/impl/scanner.js
 function createScanner(text, ignoreTrivia = false) {
@@ -1978,12 +2033,12 @@ function applyEdits(text, edits) {
 // src/shared/claude-settings.ts
 var CONTEXT_MCP_SERVER_NAME = "context-mcp";
 var LEGACY_CONTEXT_MCP_SERVER_NAME = "context_mcp";
-var settingsPath = join5(homedir2(), ".claude", "settings.json");
+var settingsPath = join6(homedir3(), ".claude", "settings.json");
 function readClaudeSettings() {
-  if (!existsSync6(settingsPath)) {
+  if (!existsSync7(settingsPath)) {
     return {};
   }
-  const content = readFileSync4(settingsPath, "utf8");
+  const content = readFileSync5(settingsPath, "utf8");
   return parse2(content) ?? {};
 }
 function hasContextMcpServer(settings) {
@@ -1994,12 +2049,12 @@ function hasContextMcpServer(settings) {
 }
 function writeClaudeSettings(settings) {
   const dir = dirname4(settingsPath);
-  if (!existsSync6(dir)) {
+  if (!existsSync7(dir)) {
     mkdirSync4(dir, { recursive: true });
   }
   let content;
-  if (existsSync6(settingsPath)) {
-    content = readFileSync4(settingsPath, "utf8");
+  if (existsSync7(settingsPath)) {
+    content = readFileSync5(settingsPath, "utf8");
     for (const [key, value] of Object.entries(settings)) {
       const edits = modify(content, [key], value, {});
       content = applyEdits(content, edits);
@@ -2015,7 +2070,7 @@ function writeClaudeSettings(settings) {
     content = JSON.stringify(settings, null, 2);
   }
   const tmp = settingsPath + ".tmp";
-  writeFileSync4(tmp, content, "utf8");
+  writeFileSync5(tmp, content, "utf8");
   renameSync2(tmp, settingsPath);
 }
 function removeMcpServer(name) {
@@ -2082,8 +2137,8 @@ function resolveOmxSource() {
   try {
     const cliDir = dirname5(fileURLToPath2(import.meta.url));
     const pkgRoot = resolve2(cliDir, "..", "..");
-    const source = join6(pkgRoot, "dist", "omx", "index.mjs");
-    if (existsSync7(source))
+    const source = join7(pkgRoot, "dist", "omx", "index.mjs");
+    if (existsSync8(source))
       return source;
   } catch {}
   try {
@@ -2094,31 +2149,35 @@ function resolveOmxSource() {
   }
 }
 function installOmx(projectDir, sourcePath) {
-  if (!existsSync7(sourcePath)) {
+  if (!existsSync8(sourcePath)) {
     process.stderr.write(`Could not find OMX plugin source file: ${sourcePath}
 `);
     process.exit(1);
     return;
   }
-  const targetDir = join6(projectDir, ".omx", "hooks");
+  const targetDir = join7(projectDir, ".omx", "hooks");
   mkdirSync5(targetDir, { recursive: true });
-  copyFileSync(sourcePath, join6(targetDir, "context.mjs"));
+  copyFileSync(sourcePath, join7(targetDir, "context.mjs"));
   process.stdout.write(`Installed context plugin to .omx/hooks/context.mjs
 `);
   if (ensureMcpRegistered()) {
     process.stdout.write(`Successfully registered context-mcp in ~/.omx/mcp-registry.json
+`);
+  }
+  if (pruneStaleMockMcpServer()) {
+    process.stdout.write(`Removed stale mock-mcp from ~/.codex/config.toml because its target file is missing
 `);
   }
 }
 function installOmc(projectDir) {
   scaffoldIfNeeded(projectDir);
-  injectIntoAgentsMd(join6(projectDir, "AGENTS.md"), STATIC_KNOWLEDGE_CONTEXT);
+  injectIntoAgentsMd(join7(projectDir, "AGENTS.md"), STATIC_KNOWLEDGE_CONTEXT);
   let bunPath = "bun";
   try {
     bunPath = execSync2("which bun", { encoding: "utf-8" }).trim();
   } catch {}
   const mcpPath = resolveMcpPath();
-  const hookBasePath = join6(dirname5(mcpPath), "omc") + "/";
+  const hookBasePath = join7(dirname5(mcpPath), "omc") + "/";
   removeMcpServer("context_mcp");
   removeMcpServer("context-mcp");
   try {
@@ -2220,7 +2279,7 @@ function runUpdate(args) {
   }
 }
 function isOmxInstalled(projectDir) {
-  return existsSync8(join7(projectDir, ".omx", "hooks", "context.mjs"));
+  return existsSync9(join8(projectDir, ".omx", "hooks", "context.mjs"));
 }
 function isOmcInstalled() {
   try {
@@ -2281,20 +2340,20 @@ OMX plugin is not installed for this project; skipping omx reinstall.
 `);
 }
 function detectPackageManager() {
-  if (existsSync8("bun.lock") || existsSync8("bun.lockb"))
+  if (existsSync9("bun.lock") || existsSync9("bun.lockb"))
     return "bun";
-  if (existsSync8("pnpm-lock.yaml"))
+  if (existsSync9("pnpm-lock.yaml"))
     return "pnpm";
-  if (existsSync8("yarn.lock"))
+  if (existsSync9("yarn.lock"))
     return "yarn";
-  if (existsSync8("package-lock.json"))
+  if (existsSync9("package-lock.json"))
     return "npm";
   return "bun";
 }
 function detectGlobalInstalls() {
   const installs = [];
-  const bunGlobalBin = join7(homedir3(), ".bun", "bin", "context");
-  if (existsSync8(bunGlobalBin)) {
+  const bunGlobalBin = join8(homedir4(), ".bun", "bin", "context");
+  if (existsSync9(bunGlobalBin)) {
     installs.push({ pm: "bun", label: "bun global", installCmd: ["bun", "install", "-g"] });
   }
   const spawnSync = globalThis.Bun?.spawnSync;
@@ -2347,22 +2406,22 @@ function runUpdatePlugin(version) {
 }
 
 // src/cli/commands/migrate.ts
-import { resolve as resolve4, join as join8 } from "path";
-import { existsSync as existsSync9, cpSync, rmSync, readFileSync as readFileSync5, writeFileSync as writeFileSync5 } from "fs";
+import { resolve as resolve4, join as join9 } from "path";
+import { existsSync as existsSync10, cpSync, rmSync, readFileSync as readFileSync6, writeFileSync as writeFileSync6 } from "fs";
 var LEGACY_CONTEXT_DIR = ".opencode/context";
 var NEW_CONTEXT_DIR = ".context";
 function runMigrate(args) {
   const keepFlag = args.includes("--keep");
   const pathArg = args.find((a) => !a.startsWith("--"));
   const projectDir = resolve4(pathArg ?? process.cwd());
-  const legacyDir = join8(projectDir, LEGACY_CONTEXT_DIR);
-  const newDir = join8(projectDir, NEW_CONTEXT_DIR);
-  if (!existsSync9(legacyDir)) {
+  const legacyDir = join9(projectDir, LEGACY_CONTEXT_DIR);
+  const newDir = join9(projectDir, NEW_CONTEXT_DIR);
+  if (!existsSync10(legacyDir)) {
     process.stdout.write(`Nothing to migrate.
 `);
     return;
   }
-  if (existsSync9(newDir)) {
+  if (existsSync10(newDir)) {
     process.stderr.write(`Target .context/ already exists. Aborting.
 `);
     process.exit(1);
@@ -2377,14 +2436,14 @@ function runMigrate(args) {
 `);
 }
 function updateConfigPaths(contextDir) {
-  const configPath = join8(contextDir, "config.jsonc");
-  if (!existsSync9(configPath))
+  const configPath = join9(contextDir, "config.jsonc");
+  if (!existsSync10(configPath))
     return;
   try {
-    const content = readFileSync5(configPath, "utf-8");
+    const content = readFileSync6(configPath, "utf-8");
     const updated = content.replaceAll(".opencode/context/", "");
     if (updated !== content) {
-      writeFileSync5(configPath, updated, "utf-8");
+      writeFileSync6(configPath, updated, "utf-8");
     }
   } catch {}
 }

package/dist/index.js

@@ -25,7 +25,7 @@ import { join as join2 } from "path";
 // package.json
 var package_default = {
   name: "@ksm0709/context",
-  version: "0.0.33",
+  version: "0.0.35",
   author: {
     name: "TaehoKang",
     email: "ksm07091@gmail.com"
@@ -67,24 +67,23 @@ var package_default = {
     "@opencode-ai/plugin": ">=1.0.0"
   },
   dependencies: {
-    "@ksm0709/context": "^0.0.33",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "jsonc-parser": "^3.0.0"
   },
   devDependencies: {
-    "@opencode-ai/plugin": "^1.2.10",
     "@eslint/js": "^9.39.1",
+    "@opencode-ai/plugin": "^1.2.10",
     "@types/node": "^20.11.5",
     "@typescript-eslint/eslint-plugin": "8.47.0",
     "@typescript-eslint/parser": "8.47.0",
+    "@vitest/coverage-v8": "^3.2.4",
     "bun-types": "latest",
     eslint: "^9.39.1",
     "eslint-config-prettier": "10.1.8",
     "eslint-plugin-prettier": "^5.1.3",
     prettier: "^3.2.4",
     "typescript-eslint": "^8.47.0",
-    vitest: "^3.2.4",
-    "@vitest/coverage-v8": "^3.2.4"
+    vitest: "^3.2.4"
   }
 };