@ksm0709/context 0.0.5 → 0.0.7

package/dist/index.js

@@ -818,14 +818,17 @@ var DEFAULTS = {
   turnEndFile: "turn-end.md",
   knowledgeSources: ["AGENTS.md"],
   knowledgeDir: "docs",
-  templateDir: ".opencode/context/templates"
+  templateDir: ".opencode/context/templates",
+  indexFilename: "INDEX.md",
+  maxDomainDepth: 2
 };
 var LIMITS = {
   maxPromptFileSize: 64 * 1024,
   maxIndexEntries: 100,
   maxTotalInjectionSize: 128 * 1024,
   maxScanDepth: 3,
-  maxSummaryLength: 100
+  maxSummaryLength: 100,
+  maxIndexFileSize: 32 * 1024
 };
 
 // src/lib/config.ts
@@ -837,7 +840,10 @@ function getDefaultConfig() {
     },
     knowledge: {
       dir: DEFAULTS.knowledgeDir,
-      sources: [...DEFAULTS.knowledgeSources]
+      sources: [...DEFAULTS.knowledgeSources],
+      mode: "auto",
+      indexFilename: DEFAULTS.indexFilename,
+      maxDomainDepth: DEFAULTS.maxDomainDepth
     }
   };
 }
@@ -850,7 +856,10 @@ function mergeWithDefaults(partial) {
     },
     knowledge: {
       dir: partial.knowledge?.dir ?? defaults.knowledge.dir,
-      sources: partial.knowledge?.sources ?? defaults.knowledge.sources
+      sources: partial.knowledge?.sources ?? defaults.knowledge.sources,
+      mode: partial.knowledge?.mode ?? defaults.knowledge.mode,
+      indexFilename: partial.knowledge?.indexFilename ?? defaults.knowledge.indexFilename,
+      maxDomainDepth: partial.knowledge?.maxDomainDepth ?? defaults.knowledge.maxDomainDepth
     }
   };
 }
@@ -939,6 +948,131 @@ function formatKnowledgeIndex(entries) {
   return lines.join(`
 `);
 }
+function countMdFiles(dir, indexFilename) {
+  try {
+    const items = readdirSync(dir);
+    return items.filter((item) => extname(item) === ".md" && item !== indexFilename && statSync(join2(dir, item)).isFile()).length;
+  } catch {
+    return 0;
+  }
+}
+function scanDomainsRecursive(baseDir, projectDir, indexFilename, currentDepth, maxDepth, results) {
+  if (currentDepth > maxDepth)
+    return;
+  try {
+    const items = readdirSync(baseDir);
+    for (const item of items) {
+      const fullPath = join2(baseDir, item);
+      try {
+        if (!statSync(fullPath).isDirectory())
+          continue;
+        const indexPath = join2(fullPath, indexFilename);
+        if (existsSync(indexPath) && statSync(indexPath).isFile()) {
+          const rawContent = readFileSync2(indexPath, "utf-8");
+          const indexContent = rawContent.slice(0, LIMITS.maxIndexFileSize);
+          results.push({
+            domain: item,
+            path: relative(projectDir, fullPath),
+            indexContent,
+            noteCount: countMdFiles(fullPath, indexFilename)
+          });
+        }
+        scanDomainsRecursive(fullPath, projectDir, indexFilename, currentDepth + 1, maxDepth, results);
+      } catch {}
+    }
+  } catch {}
+}
+function scanDomains(projectDir, knowledgeDir, indexFilename, maxDepth) {
+  const baseDir = join2(projectDir, knowledgeDir);
+  if (!existsSync(baseDir))
+    return [];
+  const results = [];
+  scanDomainsRecursive(baseDir, projectDir, indexFilename, 1, maxDepth, results);
+  return results;
+}
+function detectKnowledgeMode(projectDir, knowledgeDir, indexFilename, configMode) {
+  if (configMode !== "auto")
+    return configMode;
+  const domains = scanDomains(projectDir, knowledgeDir, indexFilename, 1);
+  return domains.length > 0 ? "domain" : "flat";
+}
+function formatDomainIndex(index) {
+  const hasDomains = index.domains.length > 0;
+  const hasFiles = index.individualFiles.length > 0;
+  if (!hasDomains && !hasFiles)
+    return "";
+  const lines = ["## Available Knowledge", ""];
+  if (hasDomains) {
+    lines.push("### Domains", "");
+    for (const domain of index.domains) {
+      lines.push(`#### ${domain.path}/ (${domain.noteCount} notes)`, "");
+      lines.push(domain.indexContent, "");
+    }
+  }
+  if (hasFiles) {
+    if (hasDomains) {
+      lines.push("### Individual Files", "");
+    }
+    for (const file of index.individualFiles) {
+      lines.push(`- ${file.filename}${file.summary ? ` \u2014 ${file.summary}` : ""}`);
+    }
+  }
+  return lines.join(`
+`);
+}
+function collectRootFiles(projectDir, knowledgeDir, indexFilename) {
+  const baseDir = join2(projectDir, knowledgeDir);
+  if (!existsSync(baseDir))
+    return [];
+  const entries = [];
+  try {
+    const items = readdirSync(baseDir);
+    for (const item of items) {
+      const fullPath = join2(baseDir, item);
+      try {
+        const stat = statSync(fullPath);
+        if (stat.isFile() && extname(item) === ".md" && item !== indexFilename) {
+          entries.push({
+            filename: relative(projectDir, fullPath),
+            summary: extractSummary(fullPath)
+          });
+        }
+      } catch {}
+    }
+  } catch {}
+  return entries;
+}
+function buildKnowledgeIndexV2(projectDir, knowledgeConfig) {
+  const dir = knowledgeConfig.dir ?? "docs";
+  const indexFilename = knowledgeConfig.indexFilename ?? "INDEX.md";
+  const maxDepth = knowledgeConfig.maxDomainDepth ?? 2;
+  const configMode = knowledgeConfig.mode ?? "auto";
+  const mode = detectKnowledgeMode(projectDir, dir, indexFilename, configMode);
+  if (mode === "flat") {
+    const allSources = [dir, ...knowledgeConfig.sources].filter(Boolean);
+    const entries = buildKnowledgeIndex(projectDir, allSources);
+    return { mode: "flat", domains: [], individualFiles: entries };
+  }
+  const domains = scanDomains(projectDir, dir, indexFilename, maxDepth);
+  const rootFiles = collectRootFiles(projectDir, dir, indexFilename);
+  const sourcesEntries = [];
+  for (const source of knowledgeConfig.sources) {
+    const fullPath = join2(projectDir, source);
+    if (!existsSync(fullPath))
+      continue;
+    try {
+      const stat = statSync(fullPath);
+      if (stat.isFile() && extname(source) === ".md") {
+        sourcesEntries.push({
+          filename: source,
+          summary: extractSummary(fullPath)
+        });
+      }
+    } catch {}
+  }
+  const individualFiles = [...rootFiles, ...sourcesEntries];
+  return { mode: "domain", domains, individualFiles };
+}
 
 // src/lib/prompt-reader.ts
 import { readFileSync as readFileSync3 } from "fs";
@@ -957,6 +1091,11 @@ function readPromptFile(filePath) {
 // src/lib/scaffold.ts
 import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync4, writeFileSync } from "fs";
 import { join as join3 } from "path";
+
+// src/version.ts
+var PLUGIN_VERSION = "0.0.6";
+
+// src/lib/scaffold.ts
 var DEFAULT_CONFIG = `{
   // Context Plugin Configuration
   // See: https://github.com/ksm0709/context
@@ -983,9 +1122,16 @@ var DEFAULT_TURN_START = `## Knowledge Context
 ### \uC791\uC5C5 \uC804 \uD544\uC218
 
 - \uC544\uB798 **Available Knowledge** \uBAA9\uB85D\uC5D0\uC11C \uD604\uC7AC \uC791\uC5C5\uACFC \uAD00\uB828\uB41C \uBB38\uC11C\uB97C **\uBA3C\uC800** \uC77D\uC73C\uC138\uC694
+- \uB3C4\uBA54\uC778 \uD3F4\uB354 \uAD6C\uC870\uAC00 \uC788\uB2E4\uBA74 INDEX.md\uC758 \uC694\uC57D\uC744 \uCC38\uACE0\uD558\uC5EC \uD544\uC694\uD55C \uB178\uD2B8\uB9CC \uC120\uD0DD\uC801\uC73C\uB85C \uC77D\uC73C\uC138\uC694
 - \uBB38\uC11C \uB0B4 [[\uB9C1\uD06C]]\uB97C \uB530\uB77C\uAC00\uBA70 \uAD00\uB828 \uB178\uD2B8\uB97C \uD0D0\uC0C9\uD558\uC138\uC694 -- \uB9C1\uD06C\uB97C \uB193\uCE58\uBA74 \uC911\uC694\uD55C \uB9E5\uB77D\uC744 \uC783\uC2B5\uB2C8\uB2E4
 - \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
+
+- **TDD** (Test-Driven Development): \uD14C\uC2A4\uD2B8\uB97C \uBA3C\uC800 \uC791\uC131\uD558\uACE0(RED), \uAD6C\uD604\uD558\uC5EC \uD1B5\uACFC\uC2DC\uD0A8 \uB4A4(GREEN), \uB9AC\uD329\uD1A0\uB9C1\uD558\uC138\uC694
+- **DDD** (Domain-Driven Design): \uB3C4\uBA54\uC778 \uAC1C\uB150\uC744 \uCF54\uB4DC \uAD6C\uC870\uC5D0 \uBC18\uC601\uD558\uC138\uC694. \uD0C0\uC785\uACFC \uBAA8\uB4C8\uC740 \uBE44\uC988\uB2C8\uC2A4 \uB3C4\uBA54\uC778\uC744 \uAE30\uC900\uC73C\uB85C \uBD84\uB9AC\uD558\uC138\uC694
+- **\uD14C\uC2A4\uD2B8 \uCEE4\uBC84\uB9AC\uC9C0**: \uC0C8\uB85C \uC791\uC131\uD558\uAC70\uB098 \uBCC0\uACBD\uD55C \uCF54\uB4DC\uB294 \uD14C\uC2A4\uD2B8 \uCEE4\uBC84\uB9AC\uC9C0 80% \uC774\uC0C1\uC744 \uBAA9\uD45C\uB85C \uD558\uC138\uC694. \uAD6C\uD604 \uC804\uC5D0 \uD14C\uC2A4\uD2B8\uBD80\uD130 \uC791\uC131\uD558\uBA74 \uC790\uC5F0\uC2A4\uB7FD\uAC8C \uB2EC\uC131\uB429\uB2C8\uB2E4
+
 ### \uC6B0\uC120\uC21C\uC704
 
 - AGENTS.md\uC758 \uC9C0\uC2DC\uC0AC\uD56D\uC774 \uD56D\uC0C1 \uCD5C\uC6B0\uC120
@@ -999,8 +1145,10 @@ var DEFAULT_TURN_END = `## \uC791\uC5C5 \uB9C8\uBB34\uB9AC \uCCB4\uD06C\uB9AC\uC
 ### \uD004\uB9AC\uD2F0 \uBCF4\uC7A5
 
 - [ ] \uBCC0\uACBD\uD55C \uCF54\uB4DC\uC5D0 \uB300\uD574 lint \uC2E4\uD589
-- [ ] \uD0C0\uC785 \uC5D0\uB7EC \uD655\uC778
+- [ ] \uBCC0\uACBD\uD55C \uCF54\uB4DC\uC5D0 \uB300\uD574 formatter \uC2E4\uD589 (lint\uC640 \uBCC4\uAC1C)
 - [ ] \uAE30\uC874 \uD14C\uC2A4\uD2B8 \uD1B5\uACFC \uD655\uC778
+- [ ] \uBCC0\uACBD \uBC94\uC704 \uD655\uC778: \uC694\uCCAD\uACFC \uBB34\uAD00\uD55C \uD30C\uC77C\uC744 \uAC74\uB4DC\uB9AC\uC9C0 \uC54A\uC558\uB294\uAC00?
+- [ ] \uC0C8\uB85C \uC791\uC131\uD558\uAC70\uB098 \uBCC0\uACBD\uD55C \uCF54\uB4DC\uC758 \uD14C\uC2A4\uD2B8 \uCEE4\uBC84\uB9AC\uC9C0 80% \uC774\uC0C1 \uB2EC\uC131
 
 ### \uC9C0\uC2DD \uC815\uB9AC (Zettelkasten)
 
@@ -1020,13 +1168,14 @@ var DEFAULT_TURN_END = `## \uC791\uC5C5 \uB9C8\uBB34\uB9AC \uCCB4\uD06C\uB9AC\uC
 - [ ] \uC704 \uC0C1\uD669\uC5D0 \uD574\uB2F9\uD558\uB294 \uBC1C\uACAC\uC774 \uC788\uC5C8\uB2E4\uBA74 \uB178\uD2B8\uB97C \uC791\uC131\uD588\uB294\uAC00?
 - [ ] \uAD00\uB828 \uAE30\uC874 \uB178\uD2B8\uC5D0 [[\uB9C1\uD06C]]\uB97C \uCD94\uAC00\uD588\uB294\uAC00?
 - [ ] \uAE30\uC874 \uB178\uD2B8\uC758 \uB0B4\uC6A9\uC774 \uBCC0\uACBD\uC0AC\uD56D\uACFC \uBD88\uC77C\uCE58\uD558\uBA74 \uC5C5\uB370\uC774\uD2B8\uD588\uB294\uAC00?
+- [ ] \uB178\uD2B8\uB97C \uB3C4\uBA54\uC778 \uD3F4\uB354\uC5D0 \uC800\uC7A5\uD588\uB2E4\uBA74 \uD574\uB2F9 INDEX.md\uC5D0 \uCD94\uAC00\uD588\uB294\uAC00?
 
 #### \uB178\uD2B8 \uC791\uC131 \uADDC\uCE59
 
 - \uCCAB \uC904: \uBA85\uD655\uD55C \uC81C\uBAA9 (\`# Title\`)
 - \uD575\uC2EC \uB0B4\uC6A9\uC744 \uC790\uC2E0\uC758 \uC5B8\uC5B4\uB85C \uAC04\uACB0\uD558\uAC8C \uC11C\uC220
 - \uAD00\uB828 \uB178\uD2B8\uB97C \`[[relative/path/file.md]]\` \uD615\uD0DC\uC758 wikilink\uB85C \uC5F0\uACB0
-- knowledge \uB514\uB809\uD1A0\uB9AC (\uAE30\uBCF8: \`docs/\`)\uC5D0 \uC800\uC7A5
+- knowledge \uB514\uB809\uD1A0\uB9AC (\uAE30\uBCF8: \`docs/\`)\uC5D0 \uC800\uC7A5. \uB3C4\uBA54\uC778 \uD3F4\uB354\uAC00 \uC788\uB2E4\uBA74 \uC801\uC808\uD55C \uB3C4\uBA54\uC778\uC5D0 \uC800\uC7A5
 `;
 var DEFAULT_ADR_TEMPLATE = `# ADR-NNN: [\uC81C\uBAA9]
 
@@ -1220,6 +1369,20 @@ var DEFAULT_INSIGHT_TEMPLATE = `# Insight: [\uBC1C\uACAC \uC81C\uBAA9]
 
 - [[\uAD00\uB828-insight.md]] / [[\uC601\uD5A5\uBC1B\uB294-\uD328\uD134.md]] / [[\uAD00\uB828-ADR.md]]
 `;
+var DEFAULT_INDEX_TEMPLATE = `# [Domain] Domain
+
+Overview: [1-2 sentence description of this domain]
+
+## Notes
+
+| File | Summary | Read When... |
+|------|---------|--------------|
+| [[example.md]] | Example summary | Working on X |
+
+## Related Domains
+
+- [[../other-domain/INDEX.md]] -- Description
+`;
 var TEMPLATE_FILES = {
   "adr.md": DEFAULT_ADR_TEMPLATE,
   "pattern.md": DEFAULT_PATTERN_TEMPLATE,
@@ -1228,7 +1391,8 @@ var TEMPLATE_FILES = {
   "decision.md": DEFAULT_DECISION_TEMPLATE,
   "context.md": DEFAULT_CONTEXT_TEMPLATE,
   "runbook.md": DEFAULT_RUNBOOK_TEMPLATE,
-  "insight.md": DEFAULT_INSIGHT_TEMPLATE
+  "insight.md": DEFAULT_INSIGHT_TEMPLATE,
+  "index.md": DEFAULT_INDEX_TEMPLATE
 };
 function scaffoldIfNeeded(projectDir) {
   const contextDir = join3(projectDir, ".opencode", "context");
@@ -1246,6 +1410,7 @@ function scaffoldIfNeeded(projectDir) {
     for (const [filename, content] of Object.entries(TEMPLATE_FILES)) {
       writeFileSync(join3(templatesDir, filename), content, "utf-8");
     }
+    writeVersion(contextDir, PLUGIN_VERSION);
     return true;
   } catch {
     return false;
@@ -1273,6 +1438,39 @@ function updateScaffold(projectDir) {
     writeFileSync(filePath, content, "utf-8");
     updated.push(path);
   }
+  writeVersion(contextDir, PLUGIN_VERSION);
+  return updated;
+}
+function getStoredVersion(projectDir) {
+  try {
+    return readFileSync4(join3(projectDir, ".opencode", "context", ".version"), "utf-8").trim();
+  } catch {
+    return null;
+  }
+}
+function writeVersion(contextDir, version) {
+  writeFileSync(join3(contextDir, ".version"), version, "utf-8");
+}
+function autoUpdateTemplates(projectDir) {
+  const contextDir = join3(projectDir, ".opencode", "context");
+  if (!existsSync2(contextDir))
+    return [];
+  const stored = getStoredVersion(projectDir);
+  if (stored === PLUGIN_VERSION)
+    return [];
+  mkdirSync(join3(contextDir, "templates"), { recursive: true });
+  const updated = [];
+  for (const [filename, content] of Object.entries(TEMPLATE_FILES)) {
+    const filePath = join3(contextDir, "templates", filename);
+    try {
+      const existing = readFileSync4(filePath, "utf-8");
+      if (existing === content)
+        continue;
+    } catch {}
+    writeFileSync(filePath, content, "utf-8");
+    updated.push(`templates/${filename}`);
+  }
+  writeVersion(contextDir, PLUGIN_VERSION);
   return updated;
 }
 
@@ -1287,6 +1485,17 @@ var plugin = async ({ directory, client }) => {
         message: "Scaffold created at .opencode/context/"
       }
     });
+  } else {
+    const autoUpdated = autoUpdateTemplates(directory);
+    if (autoUpdated.length > 0) {
+      await client.app.log({
+        body: {
+          service: "context",
+          level: "info",
+          message: `Auto-updated ${autoUpdated.length} template(s): ${autoUpdated.join(", ")}`
+        }
+      });
+    }
   }
   const config = loadConfig(directory);
   return {
@@ -1301,14 +1510,17 @@ var plugin = async ({ directory, client }) => {
       if (input.command !== "context-update")
         return;
       const updated = updateScaffold(directory);
-      if (updated.length === 0) {
-        output.parts = [{ type: "text", text: "All scaffold files are already up to date." }];
-      } else {
-        const lines = updated.map((f) => `- ${f}`).join(`
-`);
-        output.parts = [{ type: "text", text: `Updated ${updated.length} file(s):
-${lines}` }];
-      }
+      const text = updated.length === 0 ? "All scaffold files are already up to date." : `Updated ${updated.length} file(s):
+${updated.map((f) => `- ${f}`).join(`
+`)}`;
+      const now = Date.now();
+      output.parts.splice(0, output.parts.length, {
+        id: `context-update-${now}`,
+        sessionID: input.sessionID,
+        messageID: `context-update-msg-${now}`,
+        type: "text",
+        text
+      });
     },
     "experimental.chat.messages.transform": async (_input, output) => {
       if (output.messages.length === 0)
@@ -1318,9 +1530,8 @@ ${lines}` }];
         return;
       const turnStartPath = join4(directory, config.prompts.turnStart ?? join4(DEFAULTS.promptDir, DEFAULTS.turnStartFile));
       const turnStart = readPromptFile(turnStartPath);
-      const knowledgeSources = [config.knowledge.dir, ...config.knowledge.sources].filter((s) => Boolean(s));
-      const entries = buildKnowledgeIndex(directory, knowledgeSources);
-      const indexContent = formatKnowledgeIndex(entries);
+      const knowledgeIndex = buildKnowledgeIndexV2(directory, config.knowledge);
+      const indexContent = knowledgeIndex.mode === "flat" ? formatKnowledgeIndex(knowledgeIndex.individualFiles) : formatDomainIndex(knowledgeIndex);
       const combinedContent = [turnStart, indexContent].filter(Boolean).join(`
 
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ksm0709/context",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "Intent tools for Bun",
   "author": {
     "name": "TaehoKang",

package/src/version.ts

@@ -0,0 +1 @@
+export const PLUGIN_VERSION = '0.0.6';