@ksm0709/context 0.0.35 → 0.0.36

package/dist/cli/index.js

@@ -27,7 +27,7 @@ function resolveContextDir(projectDir) {
 // package.json
 var package_default = {
   name: "@ksm0709/context",
-  version: "0.0.35",
+  version: "0.0.36",
   author: {
     name: "TaehoKang",
     email: "ksm07091@gmail.com"
@@ -325,6 +325,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

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.35",
+  version: "0.0.36",
   author: {
     name: "TaehoKang",
     email: "ksm07091@gmail.com"
@@ -323,6 +323,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

package/dist/mcp.js

@@ -33093,6 +33093,100 @@ function stripExtension(file2) {
   return file2.endsWith(".md") ? file2.slice(0, -3) : file2;
 }
 
+// src/lib/knowledge-note-template-validation.ts
+var HEADING_REGEX2 = /^(#{1,3})\s+(.+)$/;
+var ADDITIONAL_FORBIDDEN_SNIPPETS = ["[\uC81C\uBAA9]", "[\uAC04\uB2E8\uD55C \uC124\uBA85]", "TODO"];
+var RELATED_NOTES_TITLES = ["\uAD00\uB828 \uB178\uD2B8", "Related Notes"];
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function parseMarkdownHeadings(content) {
+  const lines = content.split(`
+`);
+  return lines.flatMap((line, index) => {
+    const match = line.match(HEADING_REGEX2);
+    if (!match) {
+      return [];
+    }
+    return [
+      {
+        level: match[1].length,
+        line: index,
+        raw: line.trim(),
+        text: match[2].trim()
+      }
+    ];
+  });
+}
+function buildHeadingPattern(templateText) {
+  const escaped = escapeRegExp(templateText).replace(/\\\[[^\]]+\\\]/g, "(.+)");
+  return new RegExp(`^${escaped}$`);
+}
+function headingMatches(template, candidate) {
+  if (template.level !== candidate.level) {
+    return false;
+  }
+  return buildHeadingPattern(template.text).test(candidate.text);
+}
+function collectForbiddenSnippets(templateContent) {
+  const snippets = new Set(ADDITIONAL_FORBIDDEN_SNIPPETS);
+  for (const line of templateContent.split(`
+`)) {
+    const trimmed = line.trim();
+    if (!trimmed) {
+      continue;
+    }
+    const headingMatch = trimmed.match(HEADING_REGEX2);
+    if (headingMatch) {
+      if (trimmed.includes("[") || trimmed.includes("...") || trimmed.includes("TODO")) {
+        snippets.add(trimmed);
+      }
+      continue;
+    }
+    snippets.add(trimmed);
+  }
+  return [...snippets];
+}
+function isRelatedNotesHeading(heading) {
+  return RELATED_NOTES_TITLES.includes(heading.text);
+}
+function validateTemplatedKnowledgeNoteContent(templateContent, content) {
+  const templateHeadings = parseMarkdownHeadings(templateContent);
+  const contentHeadings = parseMarkdownHeadings(content);
+  const contentLines = content.split(`
+`);
+  const errors3 = [];
+  const matchedHeadings = [];
+  let searchStart = 0;
+  for (const templateHeading of templateHeadings) {
+    const matchIndex = contentHeadings.findIndex((candidate, index) => index >= searchStart && headingMatches(templateHeading, candidate));
+    if (matchIndex === -1) {
+      errors3.push(`Missing required heading: ${templateHeading.raw}`);
+      continue;
+    }
+    matchedHeadings.push(contentHeadings[matchIndex]);
+    searchStart = matchIndex + 1;
+  }
+  for (const forbiddenSnippet of collectForbiddenSnippets(templateContent)) {
+    if (content.includes(forbiddenSnippet)) {
+      errors3.push(`Template placeholder was not replaced: ${forbiddenSnippet}`);
+    }
+  }
+  matchedHeadings.forEach((heading, index) => {
+    const nextHeadingLine = matchedHeadings[index + 1]?.line ?? contentLines.length;
+    const sectionBody = contentLines.slice(heading.line + 1, nextHeadingLine).join(`
+`).trim();
+    if (heading.level > 1 && !sectionBody) {
+      errors3.push(`Section is empty: ${heading.raw}`);
+      return;
+    }
+    if (isRelatedNotesHeading(heading) && !/\[\[[^[\]]+\]\]/.test(sectionBody)) {
+      errors3.push(`Related notes section must include at least one wikilink: ${heading.raw}`);
+    }
+  });
+  return { errors: errors3 };
+}
+
 // src/lib/mcp-server.ts
 function startMcpServer() {
   const server = new McpServer({
@@ -33283,13 +33377,13 @@ function startMcpServer() {
     }
   });
   server.registerTool("create_knowledge_note", {
-    description: "Create a new Zettelkasten knowledge note with frontmatter and wikilinks. You can optionally use a template by providing the `template` parameter. Available templates: adr (Architecture Decision Records), pattern (Design patterns), bug (Bug reports and analysis), gotcha (Pitfalls and gotchas), decision (General decisions), context (General context and background), runbook (Procedures and runbooks), insight (Insights and learnings).",
+    description: "Create a new Zettelkasten knowledge note with frontmatter and wikilinks. When you provide `template`, first read `.context/templates/<template>.md` and pass fully completed markdown in `content`. Available templates: adr (Architecture Decision Records), pattern (Design patterns), bug (Bug reports and analysis), gotcha (Pitfalls and gotchas), decision (General decisions), context (General context and background), runbook (Procedures and runbooks), insight (Insights and learnings).",
     inputSchema: {
       title: exports_external.string().describe("The title of the note"),
-      content: exports_external.string().describe("The main content of the note"),
-      tags: exports_external.array(exports_external.string()).optional().describe("Optional tags for the note"),
-      linked_notes: exports_external.array(exports_external.string()).optional().describe("Optional list of related note titles to link to"),
-      template: exports_external.enum(["adr", "pattern", "bug", "gotcha", "decision", "context", "runbook", "insight"]).optional().describe("Optional template to use for the note")
+      content: exports_external.string().describe("The main content of the note. When `template` is set, this must be the complete markdown document that already follows the template."),
+      tags: exports_external.array(exports_external.string()).optional().describe("Optional tags for the note. Not supported when `template` is set."),
+      linked_notes: exports_external.array(exports_external.string()).optional().describe("Optional list of related note titles to link to. Not supported when `template` is set; include related notes directly in the markdown content instead."),
+      template: exports_external.enum(["adr", "pattern", "bug", "gotcha", "decision", "context", "runbook", "insight"]).optional().describe("Optional template to validate against. Read the template file first and pass fully completed markdown in `content`.")
     }
   }, async ({ title, content, tags, linked_notes, template }) => {
     try {
@@ -33300,18 +33394,48 @@ function startMcpServer() {
       const date6 = new Date().toISOString().split("T")[0];
       let fileContent = "";
       if (template) {
+        if (tags && tags.length > 0) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: "Error creating knowledge note: `tags` is not supported in template mode. Read the template and include any frontmatter or metadata directly in the markdown content."
+              }
+            ],
+            isError: true
+          };
+        }
+        if (linked_notes && linked_notes.length > 0) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: "Error creating knowledge note: `linked_notes` is not supported in template mode. Read the template and include related notes directly in the markdown content."
+              }
+            ],
+            isError: true
+          };
+        }
         const templatePath = path2.resolve(process.cwd(), `.context/templates/${template}.md`);
-        try {
-          fileContent = await fs2.readFile(templatePath, "utf-8");
-          fileContent = fileContent.replace(/\[\uC81C\uBAA9\]/g, title);
-          fileContent += `
-
-${content}`;
-        } catch (err) {
-          fileContent = `Error loading template: ${err instanceof Error ? err.message : String(err)}
-
-${content}`;
+        const templateContent = await fs2.readFile(templatePath, "utf-8");
+        const validation = validateTemplatedKnowledgeNoteContent(templateContent, content);
+        if (validation.errors.length > 0) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Error creating knowledge note: template content is invalid.
+- ${validation.errors.join(`
+- `)}
+Read the template and provide the fully completed markdown document in \`content\`.`
+              }
+            ],
+            isError: true
+          };
         }
+        fileContent = content.endsWith(`
+`) ? content : `${content}
+`;
       } else {
         fileContent = `---
 `;

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.35",
+  version: "0.0.36",
   author: {
     name: "TaehoKang",
     email: "ksm07091@gmail.com"
@@ -318,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

package/dist/omx/index.mjs

@@ -105,7 +105,7 @@ import { join as join3 } from "node:path";
 // package.json
 var package_default = {
   name: "@ksm0709/context",
-  version: "0.0.35",
+  version: "0.0.36",
   author: {
     name: "TaehoKang",
     email: "ksm07091@gmail.com"
@@ -403,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대 원칙 준수:
   - [ ] 원자성: 한 노트당 한 주제
   - [ ] 연결: 고립된 노트 방지

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ksm0709/context",
-  "version": "0.0.35",
+  "version": "0.0.36",
   "author": {
     "name": "TaehoKang",
     "email": "ksm07091@gmail.com"