@ksm0709/context 0.0.34 → 0.0.36

package/dist/omc/session-start-hook.js

@@ -20,7 +20,7 @@ function resolveContextDir(projectDir) {
 // package.json
 var package_default = {
   name: "@ksm0709/context",
-  version: "0.0.34",
+  version: "0.0.36",
   author: {
     name: "TaehoKang",
     email: "ksm07091@gmail.com"
@@ -62,24 +62,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"
   }
 };
 
@@ -319,6 +318,8 @@ var DEFAULT_DAILY_NOTE_GUIDE = `# \uB370\uC77C\uB9AC \uB178\uD2B8 \uAE30\uB85D \
 var DEFAULT_NOTE_GUIDE = `# \uC9C0\uC2DD \uB178\uD2B8 \uC791\uC131 \uBC0F \uAD00\uB9AC \uAC00\uC774\uB4DC
 
 - [ ] **\uB178\uD2B8 \uC0DD\uC131**: \`context_mcp_create_knowledge_note\` \uB3C4\uAD6C\uB97C \uC0AC\uC6A9\uD558\uC5EC \uC0DD\uC131\uD558\uC138\uC694.
+- [ ] \uD15C\uD50C\uB9BF \uBAA8\uB4DC\uC5D0\uC11C\uB294 \uBA3C\uC800 \`.context/templates/<template>.md\`\uB97C \uC77D\uACE0, **\uC644\uC131\uB41C markdown \uC804\uCCB4**\uB97C \`content\`\uB85C \uC804\uB2EC\uD558\uC138\uC694.
+- [ ] \uD15C\uD50C\uB9BF \uBAA8\uB4DC\uC5D0\uC11C\uB294 \`tags\`/\`linked_notes\`\uB97C \uB530\uB85C \uB118\uAE30\uC9C0 \uB9C8\uC138\uC694. \uAD00\uB828 \uB178\uD2B8\uC640 \uBA54\uD0C0\uB370\uC774\uD130\uB294 markdown \uBCF8\uBB38\uC5D0 \uC9C1\uC811 \uC791\uC131\uD574\uC57C \uD569\uB2C8\uB2E4.
 - [ ] \uC81C\uD154\uCE74\uC2A4\uD150(Zettelkasten) 3\uB300 \uC6D0\uCE59 \uC900\uC218:
   - [ ] \uC6D0\uC790\uC131: \uD55C \uB178\uD2B8\uB2F9 \uD55C \uC8FC\uC81C
   - [ ] \uC5F0\uACB0: \uACE0\uB9BD\uB41C \uB178\uD2B8 \uBC29\uC9C0
@@ -482,14 +483,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

package/dist/omx/index.mjs

@@ -1,6 +1,6 @@
 // src/omx/index.ts
-import { existsSync as existsSync6, readFileSync as readFileSync5, unlinkSync } from "node:fs";
-import { join as join6 } from "node:path";
+import { existsSync as existsSync7, readFileSync as readFileSync6, unlinkSync } from "node:fs";
+import { join as join7 } from "node:path";
 
 // src/constants.ts
 var DEFAULTS = {
@@ -105,7 +105,7 @@ import { join as join3 } from "node:path";
 // package.json
 var package_default = {
   name: "@ksm0709/context",
-  version: "0.0.34",
+  version: "0.0.36",
   author: {
     name: "TaehoKang",
     email: "ksm07091@gmail.com"
@@ -147,24 +147,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"
   }
 };
 
@@ -404,6 +403,8 @@ var DEFAULT_DAILY_NOTE_GUIDE = `# 데일리 노트 기록 가이드
 var DEFAULT_NOTE_GUIDE = `# 지식 노트 작성 및 관리 가이드
 
 - [ ] **노트 생성**: \`context_mcp_create_knowledge_note\` 도구를 사용하여 생성하세요.
+- [ ] 템플릿 모드에서는 먼저 \`.context/templates/<template>.md\`를 읽고, **완성된 markdown 전체**를 \`content\`로 전달하세요.
+- [ ] 템플릿 모드에서는 \`tags\`/\`linked_notes\`를 따로 넘기지 마세요. 관련 노트와 메타데이터는 markdown 본문에 직접 작성해야 합니다.
 - [ ] 제텔카스텐(Zettelkasten) 3대 원칙 준수:
   - [ ] 원자성: 한 노트당 한 주제
   - [ ] 연결: 고립된 노트 방지
@@ -555,6 +556,59 @@ function injectIntoAgentsMd(agentsMdPath, content) {
   writeFileAtomically(agentsMdPath, nextContent);
 }
 
+// src/shared/codex-settings.ts
+import { existsSync as existsSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "node:fs";
+import { homedir } from "node:os";
+import { isAbsolute, join as join4 } from "node:path";
+var STALE_MOCK_MCP_SERVER_NAME = "mock-mcp";
+var codexConfigPath = join4(homedir(), ".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 (!existsSync4(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) || existsSync4(firstArgPath)) {
+    return false;
+  }
+  const nextLines = [...lines.slice(0, blockRange.start), ...lines.slice(blockRange.end)];
+  writeFileSync3(codexConfigPath, nextLines.join(`
+`), "utf8");
+  return true;
+}
+
 // src/shared/knowledge-context.ts
 var STATIC_KNOWLEDGE_CONTEXT = `## Knowledge Context
 
@@ -567,14 +621,17 @@ var STATIC_KNOWLEDGE_CONTEXT = `## Knowledge Context
 3. **자기 언어** -- 복사-붙여넣기가 아닌, 핵심을 이해하고 간결하게 서술하세요.
 
 ### MCP Tools
-- **지식 관리**: \`context_mcp_search_knowledge\`, \`context_mcp_read_knowledge\`, \`context_mcp_create_knowledge_note\`, \`context_mcp_update_knowledge_note\`
+- **지식 탐색**: \`context_mcp_search_knowledge\`로 후보 노트를 찾고, 결과의 title / description / tags / path / score를 먼저 비교하세요.
+- **노트 열기**: \`context_mcp_read_knowledge\`로 선택한 노트를 열고, 끝에 붙는 related notes 메타데이터로 다음 탐색 경로를 정하세요.
+- **노트 작성/수정**: \`context_mcp_create_knowledge_note\`, \`context_mcp_update_knowledge_note\`
 - **데일리 노트**: \`context_mcp_read_daily_note\`, \`context_mcp_append_daily_note\`
 - **작업 완료**: \`context_mcp_submit_turn_complete\` (작업 종료 시 필수 호출)
 
 ### 작업 전 필수
 - **데일리 노트 확인**: 가장 최근의 데일리 노트를 읽고 이전 세션의 컨텍스트와 미해결 이슈를 파악하세요.
 - **작업 의도 선언**: 작업 시작 전, 현재 세션의 목표와 작업 의도를 명확히 파악하고 선언하세요.
-- **지식 검색**: 작업과 관련된 문서를 **직접 먼저** 검색하고 읽으세요.
+- **메타데이터 우선 검색**: 먼저 \`search_knowledge\`로 관련 후보를 찾고, 메타데이터를 비교한 뒤 가장 유력한 노트를 \`read_knowledge\`로 여세요.
+- **관련 노트 추적**: \`read_knowledge\` 끝의 related notes 섹션에서 연결된 노트의 title / description / tags / path를 확인하고 필요시 연쇄 탐색하세요.
 - 지식 파일에 기록된 아키텍처 결정, 패턴, 제약사항을 반드시 따르세요.
 
 ### 개발 원칙
@@ -593,32 +650,32 @@ var STATIC_KNOWLEDGE_CONTEXT = `## Knowledge Context
 - 필요한 인자: daily_note_update_proof, knowledge_note_proof, quality_check_output, checkpoint_commit_hashes, scope_review_notes`;
 
 // src/omx/registry.ts
-import { join as join5, dirname as dirname3 } from "node:path";
-import { existsSync as existsSync5, readFileSync as readFileSync4, writeFileSync as writeFileSync3, mkdirSync as mkdirSync3 } from "node:fs";
+import { join as join6, dirname as dirname3 } from "node:path";
+import { existsSync as existsSync6, readFileSync as readFileSync5, writeFileSync as writeFileSync4, mkdirSync as mkdirSync3 } from "node:fs";
 import { execSync } from "node:child_process";
-import { homedir } from "node:os";
+import { homedir as homedir2 } from "node:os";
 
 // src/shared/mcp-path.ts
 import { fileURLToPath } from "node:url";
-import { dirname as dirname2, join as join4, resolve } from "node:path";
-import { existsSync as existsSync4 } from "node:fs";
+import { dirname as dirname2, join as join5, resolve } from "node:path";
+import { existsSync as existsSync5 } from "node:fs";
 import { createRequire } from "node:module";
 function resolveMcpPath() {
   try {
     const req = createRequire(import.meta.url);
     const pkgJsonPath = req.resolve("@ksm0709/context/package.json");
     const pkgRoot = dirname2(pkgJsonPath);
-    const distMcp = join4(pkgRoot, "dist", "mcp.js");
-    if (existsSync4(distMcp))
+    const distMcp = join5(pkgRoot, "dist", "mcp.js");
+    if (existsSync5(distMcp))
       return distMcp;
   } catch {}
   const currentFile = fileURLToPath(import.meta.url);
   const currentDir = dirname2(currentFile);
   const distMcpPath = resolve(currentDir, "..", "mcp.js");
-  if (existsSync4(distMcpPath))
+  if (existsSync5(distMcpPath))
     return distMcpPath;
   const srcMcpPath = resolve(currentDir, "..", "mcp.ts");
-  if (existsSync4(srcMcpPath))
+  if (existsSync5(srcMcpPath))
     return srcMcpPath;
   return distMcpPath;
 }
@@ -633,23 +690,23 @@ function resolveBunPath() {
 }
 function getRegistryPaths() {
   return [
-    join5(homedir(), ".omx", "mcp-registry.json"),
-    join5(homedir(), ".omc", "mcp-registry.json")
+    join6(homedir2(), ".omx", "mcp-registry.json"),
+    join6(homedir2(), ".omc", "mcp-registry.json")
   ];
 }
 function ensureMcpRegistered(sdkLog) {
   const registryPaths = getRegistryPaths();
   let targetPath = registryPaths[0];
   for (const p of registryPaths) {
-    if (existsSync5(p)) {
+    if (existsSync6(p)) {
       targetPath = p;
       break;
     }
   }
   let registry = {};
-  if (existsSync5(targetPath)) {
+  if (existsSync6(targetPath)) {
     try {
-      const content = readFileSync4(targetPath, "utf-8");
+      const content = readFileSync5(targetPath, "utf-8");
       registry = JSON.parse(content);
     } catch (e) {
       if (sdkLog) {
@@ -678,7 +735,7 @@ function ensureMcpRegistered(sdkLog) {
   if (changed) {
     try {
       mkdirSync3(dirname3(targetPath), { recursive: true });
-      writeFileSync3(targetPath, JSON.stringify(registry, null, 2), "utf-8");
+      writeFileSync4(targetPath, JSON.stringify(registry, null, 2), "utf-8");
       if (sdkLog) {
         sdkLog(`[INFO] Registered context-mcp in ${targetPath}`);
       }
@@ -777,8 +834,11 @@ async function logWarn(sdk, message, meta = {}) {
 }
 async function onSessionStart(event, sdk) {
   const projectDir = resolveProjectDir(event);
+  if (pruneStaleMockMcpServer()) {
+    await sdk.log.info("Removed stale mock-mcp from ~/.codex/config.toml because its target file is missing.");
+  }
   scaffoldIfNeeded(projectDir);
-  injectIntoAgentsMd(join6(projectDir, "AGENTS.md"), STATIC_KNOWLEDGE_CONTEXT);
+  injectIntoAgentsMd(join7(projectDir, "AGENTS.md"), STATIC_KNOWLEDGE_CONTEXT);
   await sdk.log.info(`Injected context into AGENTS.md for ${projectDir}`);
   const wasRegistered = ensureMcpRegistered(sdk.log.info);
   if (wasRegistered) {
@@ -818,9 +878,9 @@ async function onTurnComplete(event, sdk) {
   }
   const followupScopeKey = resolveFollowupScopeKey(event);
   let pendingFollowupScopes = typeof sdk.state?.read === "function" ? await sdk.state.read(TURN_END_PENDING_SKIP_KEY, {}) ?? {} : {};
-  const workCompleteFile = join6(projectDir, DEFAULTS.workCompleteFile);
-  if (existsSync6(workCompleteFile)) {
-    const content = readFileSync5(workCompleteFile, "utf-8");
+  const workCompleteFile = join7(projectDir, DEFAULTS.workCompleteFile);
+  if (existsSync7(workCompleteFile)) {
+    const content = readFileSync6(workCompleteFile, "utf-8");
     const { sessionId: fileSessionId, turnId: fileTurnId } = parseWorkComplete(content);
     const currentScopeId = event.session_id ?? event.thread_id ?? "";
     if (!fileSessionId || fileSessionId === currentScopeId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ksm0709/context",
-  "version": "0.0.34",
+  "version": "0.0.36",
   "author": {
     "name": "TaehoKang",
     "email": "ksm07091@gmail.com"
@@ -42,23 +42,22 @@
     "@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"
   }
 }