knowns 0.10.1 → 0.10.3

package/dist/mcp/server.js

@@ -10289,17 +10289,39 @@ var require_gray_matter = __commonJS({
 });
 
 // src/import/config.ts
+import { existsSync as existsSync4 } from "node:fs";
+import { mkdir as mkdir3, readFile as readFile3, writeFile as writeFile2 } from "node:fs/promises";
 import { dirname as dirname2, join as join7 } from "node:path";
 function getKnownsDir(projectRoot) {
   return join7(projectRoot, ".knowns");
 }
+function getConfigPath(projectRoot) {
+  return join7(getKnownsDir(projectRoot), CONFIG_FILE);
+}
 function getImportsDir(projectRoot) {
   return join7(getKnownsDir(projectRoot), IMPORTS_DIR);
 }
-var IMPORTS_DIR;
+async function readConfig(projectRoot) {
+  const configPath = getConfigPath(projectRoot);
+  if (!existsSync4(configPath)) {
+    return {};
+  }
+  try {
+    const content = await readFile3(configPath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return {};
+  }
+}
+async function getImportConfigs(projectRoot) {
+  const config2 = await readConfig(projectRoot);
+  return config2.imports || [];
+}
+var CONFIG_FILE, IMPORTS_DIR;
 var init_config = __esm({
   "src/import/config.ts"() {
     "use strict";
+    CONFIG_FILE = "config.json";
     IMPORTS_DIR = "imports";
   }
 });
@@ -28631,8 +28653,8 @@ var require_prompts3 = __commonJS({
 });
 
 // src/mcp/server.ts
-import { existsSync as existsSync13 } from "node:fs";
-import { readFile as readFile8 } from "node:fs/promises";
+import { existsSync as existsSync14 } from "node:fs";
+import { readFile as readFile9 } from "node:fs/promises";
 import { join as join18 } from "node:path";
 
 // node_modules/zod/v3/helpers/util.js
@@ -51220,8 +51242,8 @@ async function handleGetBoard(fileStore2) {
 }
 
 // src/mcp/handlers/doc.ts
-import { existsSync as existsSync8 } from "node:fs";
-import { mkdir as mkdir6, readFile as readFile3, readdir as readdir5, writeFile as writeFile2 } from "node:fs/promises";
+import { existsSync as existsSync9 } from "node:fs";
+import { mkdir as mkdir7, readFile as readFile4, readdir as readdir5, writeFile as writeFile3 } from "node:fs/promises";
 import { join as join13 } from "node:path";
 
 // src/utils/markdown-toc.ts
@@ -51398,7 +51420,7 @@ var ImportError = class extends Error {
 init_config();
 
 // src/import/validator.ts
-import { existsSync as existsSync4 } from "node:fs";
+import { existsSync as existsSync5 } from "node:fs";
 import { readdir as readdir2 } from "node:fs/promises";
 import { join as join8 } from "node:path";
 var KNOWNS_DIR = ".knowns";
@@ -51406,7 +51428,7 @@ var TEMPLATES_DIR = "templates";
 var DOCS_DIR = "docs";
 async function validateKnownsDir(dir) {
   const knownsPath = join8(dir, KNOWNS_DIR);
-  if (!existsSync4(knownsPath)) {
+  if (!existsSync5(knownsPath)) {
     return {
       valid: false,
       error: "Source does not contain .knowns/ directory",
@@ -51415,8 +51437,8 @@ async function validateKnownsDir(dir) {
   }
   const templatesPath = join8(knownsPath, TEMPLATES_DIR);
   const docsPath = join8(knownsPath, DOCS_DIR);
-  const hasTemplates = existsSync4(templatesPath);
-  const hasDocs = existsSync4(docsPath);
+  const hasTemplates = existsSync5(templatesPath);
+  const hasDocs = existsSync5(docsPath);
   if (!hasTemplates && !hasDocs) {
     return {
       valid: false,
@@ -51477,7 +51499,7 @@ var ImportProvider = class {
 
 // src/import/providers/git.ts
 import { execSync, spawnSync } from "node:child_process";
-import { mkdir as mkdir3 } from "node:fs/promises";
+import { mkdir as mkdir4 } from "node:fs/promises";
 var KNOWNS_DIR2 = ".knowns";
 function getGitInfo() {
   try {
@@ -51548,7 +51570,7 @@ var GitProvider = class extends ImportProvider {
       throw new ImportError("Git is not installed", "GIT_ERROR" /* GIT_ERROR */, "Install git first");
     }
     const tempDir = this.getTempDir();
-    await mkdir3(tempDir, { recursive: true });
+    await mkdir4(tempDir, { recursive: true });
     const ref = options2?.ref || "HEAD";
     try {
       if (this.gitInfo.supportsSparse) {
@@ -51625,8 +51647,8 @@ var gitProvider = new GitProvider();
 
 // src/import/providers/npm.ts
 import { spawnSync as spawnSync2 } from "node:child_process";
-import { existsSync as existsSync5 } from "node:fs";
-import { mkdir as mkdir4, readdir as readdir3, rename as rename2, rm as rm2 } from "node:fs/promises";
+import { existsSync as existsSync6 } from "node:fs";
+import { mkdir as mkdir5, readdir as readdir3, rename as rename2, rm as rm2 } from "node:fs/promises";
 import { join as join10 } from "node:path";
 function isNpmAvailable() {
   try {
@@ -51688,7 +51710,7 @@ var NpmProvider = class extends ImportProvider {
       throw new ImportError("npm is not installed", "NPM_ERROR" /* NPM_ERROR */, "Install Node.js/npm first");
     }
     const tempDir = this.getTempDir();
-    await mkdir4(tempDir, { recursive: true });
+    await mkdir5(tempDir, { recursive: true });
     const packageSpec = options2?.version ? `${source}@${options2.version}` : source;
     try {
       const packResult = spawnSync2("npm", ["pack", packageSpec, "--pack-destination", tempDir], {
@@ -51712,7 +51734,7 @@ var NpmProvider = class extends ImportProvider {
         throw new Error(extractResult.stderr || "tar extraction failed");
       }
       const packageDir = join10(tempDir, "package");
-      if (!existsSync5(packageDir)) {
+      if (!existsSync6(packageDir)) {
         throw new Error("Extracted package directory not found");
       }
       const extractedDir = this.getTempDir();
@@ -51743,9 +51765,9 @@ var NpmProvider = class extends ImportProvider {
     const metadata = {};
     try {
       const packageJsonPath = join10(tempDir, "package.json");
-      if (existsSync5(packageJsonPath)) {
-        const { readFile: readFile9 } = await import("node:fs/promises");
-        const content = await readFile9(packageJsonPath, "utf-8");
+      if (existsSync6(packageJsonPath)) {
+        const { readFile: readFile10 } = await import("node:fs/promises");
+        const content = await readFile10(packageJsonPath, "utf-8");
         const pkg = JSON.parse(content);
         if (pkg.version) {
           metadata.version = pkg.version;
@@ -51762,8 +51784,8 @@ var NpmProvider = class extends ImportProvider {
 var npmProvider = new NpmProvider();
 
 // src/import/providers/local.ts
-import { existsSync as existsSync6, statSync } from "node:fs";
-import { cp, mkdir as mkdir5, readlink, symlink } from "node:fs/promises";
+import { existsSync as existsSync7, statSync } from "node:fs";
+import { cp, mkdir as mkdir6, readlink, symlink } from "node:fs/promises";
 import { homedir } from "node:os";
 import { isAbsolute, join as join11, resolve } from "node:path";
 var KNOWNS_DIR3 = ".knowns";
@@ -51781,7 +51803,7 @@ var LocalProvider = class extends ImportProvider {
   type = "local";
   async validate(source, _options) {
     const resolvedPath = resolvePath(source);
-    if (!existsSync6(resolvedPath)) {
+    if (!existsSync7(resolvedPath)) {
       return {
         valid: false,
         error: `Path not found: ${source}`,
@@ -51798,7 +51820,7 @@ var LocalProvider = class extends ImportProvider {
     let knownsPath;
     if (resolvedPath.endsWith(KNOWNS_DIR3)) {
       knownsPath = resolvedPath;
-    } else if (existsSync6(join11(resolvedPath, KNOWNS_DIR3))) {
+    } else if (existsSync7(join11(resolvedPath, KNOWNS_DIR3))) {
       knownsPath = join11(resolvedPath, KNOWNS_DIR3);
     } else {
       return {
@@ -51812,7 +51834,7 @@ var LocalProvider = class extends ImportProvider {
   }
   async fetch(source, options2) {
     const resolvedPath = resolvePath(source);
-    if (!existsSync6(resolvedPath)) {
+    if (!existsSync7(resolvedPath)) {
       throw new ImportError(`Path not found: ${source}`, "SOURCE_NOT_FOUND" /* SOURCE_NOT_FOUND */);
     }
     let sourceKnowns;
@@ -51821,7 +51843,7 @@ var LocalProvider = class extends ImportProvider {
     } else {
       sourceKnowns = join11(resolvedPath, KNOWNS_DIR3);
     }
-    if (!existsSync6(sourceKnowns)) {
+    if (!existsSync7(sourceKnowns)) {
       throw new ImportError(
         "Source does not contain .knowns/ directory",
         "NO_KNOWNS_DIR" /* NO_KNOWNS_DIR */,
@@ -51837,7 +51859,7 @@ var LocalProvider = class extends ImportProvider {
       return sourceKnowns;
     }
     const tempDir = this.getTempDir();
-    await mkdir5(tempDir, { recursive: true });
+    await mkdir6(tempDir, { recursive: true });
     try {
       await cp(parentDir, tempDir, { recursive: true });
       return tempDir;
@@ -51857,12 +51879,12 @@ var LocalProvider = class extends ImportProvider {
    */
   async createSymlink(source, target) {
     const resolvedSource = resolvePath(source);
-    if (existsSync6(target)) {
+    if (existsSync7(target)) {
       const { rm: rm3 } = await import("node:fs/promises");
       await rm3(target, { recursive: true, force: true });
     }
     const { dirname: dirname4 } = await import("node:path");
-    await mkdir5(dirname4(target), { recursive: true });
+    await mkdir6(dirname4(target), { recursive: true });
     await symlink(resolvedSource, target, "junction");
   }
   /**
@@ -51884,15 +51906,46 @@ init_config();
 
 // src/import/resolver.ts
 init_config();
-import { existsSync as existsSync7 } from "node:fs";
+import { existsSync as existsSync8 } from "node:fs";
 import { readdir as readdir4 } from "node:fs/promises";
 import { join as join12 } from "node:path";
 var KNOWNS_DIR4 = ".knowns";
+var TEMPLATES_DIR2 = "templates";
 var DOCS_DIR2 = "docs";
+async function getTemplateDirectories(projectRoot) {
+  const results = [];
+  const localTemplates = join12(projectRoot, KNOWNS_DIR4, TEMPLATES_DIR2);
+  if (existsSync8(localTemplates)) {
+    results.push({
+      path: localTemplates,
+      source: "local",
+      isImported: false
+    });
+  }
+  const importsDir = getImportsDir(projectRoot);
+  if (existsSync8(importsDir)) {
+    try {
+      const entries = await readdir4(importsDir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+        const importedTemplates = join12(importsDir, entry.name, TEMPLATES_DIR2);
+        if (existsSync8(importedTemplates)) {
+          results.push({
+            path: importedTemplates,
+            source: entry.name,
+            isImported: true
+          });
+        }
+      }
+    } catch {
+    }
+  }
+  return results;
+}
 async function getDocDirectories(projectRoot) {
   const results = [];
   const localDocs = join12(projectRoot, KNOWNS_DIR4, DOCS_DIR2);
-  if (existsSync7(localDocs)) {
+  if (existsSync8(localDocs)) {
     results.push({
       path: localDocs,
       source: "local",
@@ -51900,13 +51953,13 @@ async function getDocDirectories(projectRoot) {
     });
   }
   const importsDir = getImportsDir(projectRoot);
-  if (existsSync7(importsDir)) {
+  if (existsSync8(importsDir)) {
     try {
       const entries = await readdir4(importsDir, { withFileTypes: true });
       for (const entry of entries) {
         if (!entry.isDirectory()) continue;
         const importedDocs = join12(importsDir, entry.name, DOCS_DIR2);
-        if (existsSync7(importedDocs)) {
+        if (existsSync8(importedDocs)) {
           results.push({
             path: importedDocs,
             source: entry.name,
@@ -51927,7 +51980,7 @@ async function parseImportPath(projectRoot, refPath) {
   const potentialImport = parts[0];
   const importsDir = getImportsDir(projectRoot);
   const importPath = join12(importsDir, potentialImport);
-  if (existsSync7(importPath)) {
+  if (existsSync8(importPath)) {
     return {
       importName: potentialImport,
       subPath: parts.slice(1).join("/")
@@ -51944,7 +51997,7 @@ async function resolveDocWithContext(projectRoot, docPath, context) {
   if (importName) {
     const importedDocs = join12(getImportsDir(projectRoot), importName, DOCS_DIR2);
     const fullPath = join12(importedDocs, normalizedSubPath);
-    if (existsSync7(fullPath)) {
+    if (existsSync8(fullPath)) {
       return {
         path: fullPath,
         source: importName,
@@ -51958,7 +52011,7 @@ async function resolveDocWithContext(projectRoot, docPath, context) {
     const contextDir = directories.find((d) => d.source === context && d.isImported);
     if (contextDir) {
       const fullPath = join12(contextDir.path, normalizedSubPath);
-      if (existsSync7(fullPath)) {
+      if (existsSync8(fullPath)) {
         return {
           path: fullPath,
           source: contextDir.source,
@@ -51971,7 +52024,7 @@ async function resolveDocWithContext(projectRoot, docPath, context) {
   const localDirs = directories.filter((d) => !d.isImported);
   for (const dir of importDirs) {
     const fullPath = join12(dir.path, normalizedSubPath);
-    if (existsSync7(fullPath)) {
+    if (existsSync8(fullPath)) {
       return {
         path: fullPath,
         source: dir.source,
@@ -51981,7 +52034,7 @@ async function resolveDocWithContext(projectRoot, docPath, context) {
   }
   for (const dir of localDirs) {
     const fullPath = join12(dir.path, normalizedSubPath);
-    if (existsSync7(fullPath)) {
+    if (existsSync8(fullPath)) {
       return {
         path: fullPath,
         source: dir.source,
@@ -51991,6 +52044,67 @@ async function resolveDocWithContext(projectRoot, docPath, context) {
   }
   return null;
 }
+async function listAllTemplates(projectRoot) {
+  const directories = await getTemplateDirectories(projectRoot);
+  const importConfigs = await getImportConfigs(projectRoot);
+  const sourceUrlMap = new Map(importConfigs.map((c) => [c.name, c.source]));
+  const results = [];
+  for (const dir of directories) {
+    try {
+      const entries = await readdir4(dir.path, { withFileTypes: true });
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+        if (entry.name.startsWith(".")) continue;
+        const ref = dir.isImported ? `${dir.source}/${entry.name}` : entry.name;
+        results.push({
+          name: entry.name,
+          ref,
+          source: dir.source,
+          sourceUrl: dir.isImported ? sourceUrlMap.get(dir.source) : void 0,
+          path: join12(dir.path, entry.name),
+          isImported: dir.isImported
+        });
+      }
+    } catch {
+    }
+  }
+  return results.sort((a, b) => a.ref.localeCompare(b.ref));
+}
+async function listAllDocs(projectRoot) {
+  const directories = await getDocDirectories(projectRoot);
+  const importConfigs = await getImportConfigs(projectRoot);
+  const sourceUrlMap = new Map(importConfigs.map((c) => [c.name, c.source]));
+  const results = [];
+  async function scanDir(baseDir, relativePath, source, isImported) {
+    const currentDir = join12(baseDir, relativePath);
+    try {
+      const entries = await readdir4(currentDir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (entry.name.startsWith(".")) continue;
+        const entryRelPath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+          await scanDir(baseDir, entryRelPath, source, isImported);
+        } else if (entry.name.endsWith(".md")) {
+          const docPath = entryRelPath.replace(/\.md$/, "");
+          const ref = isImported ? `${source}/${docPath}` : docPath;
+          results.push({
+            name: docPath,
+            ref,
+            source,
+            sourceUrl: isImported ? sourceUrlMap.get(source) : void 0,
+            fullPath: join12(currentDir, entry.name),
+            isImported
+          });
+        }
+      }
+    } catch {
+    }
+  }
+  for (const dir of directories) {
+    await scanDir(dir.path, "", dir.source, dir.isImported);
+  }
+  return results.sort((a, b) => a.ref.localeCompare(b.ref));
+}
 async function validateRefs(projectRoot, content, tasksDir) {
   const results = [];
   const seen = /* @__PURE__ */ new Set();
@@ -52019,7 +52133,7 @@ async function validateRefs(projectRoot, content, tasksDir) {
     let exists = false;
     if (tasksDir) {
       const taskPath = join12(tasksDir, `task-${taskId}.md`);
-      exists = existsSync7(taskPath);
+      exists = existsSync8(taskPath);
     }
     results.push({
       ref: `@task-${taskId}`,
@@ -52182,8 +52296,8 @@ var docTools = [
   }
 ];
 async function ensureDocsDir() {
-  if (!existsSync8(DOCS_DIR3)) {
-    await mkdir6(DOCS_DIR3, { recursive: true });
+  if (!existsSync9(DOCS_DIR3)) {
+    await mkdir7(DOCS_DIR3, { recursive: true });
   }
 }
 function titleToFilename(title) {
@@ -52191,7 +52305,7 @@ function titleToFilename(title) {
 }
 async function getAllMdFiles(dir, basePath = "") {
   const files = [];
-  if (!existsSync8(dir)) {
+  if (!existsSync9(dir)) {
     return files;
   }
   const entries = await readdir5(dir, { withFileTypes: true });
@@ -52211,12 +52325,12 @@ async function resolveDocPath(name) {
   await ensureDocsDir();
   let filename = name.endsWith(".md") ? name : `${name}.md`;
   let filepath = join13(DOCS_DIR3, filename);
-  if (existsSync8(filepath)) {
+  if (existsSync9(filepath)) {
     return { filepath, filename };
   }
   filename = `${titleToFilename(name)}.md`;
   filepath = join13(DOCS_DIR3, filename);
-  if (existsSync8(filepath)) {
+  if (existsSync9(filepath)) {
     return { filepath, filename };
   }
   const allFiles = await getAllMdFiles(DOCS_DIR3);
@@ -52237,8 +52351,9 @@ async function resolveDocPath(name) {
 async function handleListDocs(args) {
   const input = listDocsSchema.parse(args);
   await ensureDocsDir();
-  const mdFiles = await getAllMdFiles(DOCS_DIR3);
-  if (mdFiles.length === 0) {
+  const projectRoot = process.cwd();
+  const allDocs = await listAllDocs(projectRoot);
+  if (allDocs.length === 0) {
     return successResponse({
       count: 0,
       docs: [],
@@ -52246,22 +52361,29 @@ async function handleListDocs(args) {
     });
   }
   const docs = [];
-  for (const file3 of mdFiles) {
-    const fileContent = await readFile3(join13(DOCS_DIR3, file3), "utf-8");
-    const { data, content } = (0, import_gray_matter3.default)(fileContent);
-    const metadata = data;
-    const stats = calculateDocStats(content);
-    if (input.tag && !metadata.tags?.includes(input.tag)) {
-      continue;
+  for (const doc of allDocs) {
+    try {
+      const fileContent = await readFile4(doc.fullPath, "utf-8");
+      const { data, content } = (0, import_gray_matter3.default)(fileContent);
+      const metadata = data;
+      const stats = calculateDocStats(content);
+      if (input.tag && !metadata.tags?.includes(input.tag)) {
+        continue;
+      }
+      docs.push({
+        path: doc.ref,
+        // Use full ref path (includes import prefix if imported)
+        title: metadata.title || doc.name,
+        description: metadata.description,
+        tags: metadata.tags,
+        tokens: stats.estimatedTokens,
+        updatedAt: metadata.updatedAt,
+        source: doc.source,
+        sourceUrl: doc.sourceUrl,
+        isImported: doc.isImported
+      });
+    } catch {
     }
-    docs.push({
-      path: file3.replace(/\.md$/, ""),
-      title: metadata.title || file3.replace(/\.md$/, ""),
-      description: metadata.description,
-      tags: metadata.tags,
-      tokens: stats.estimatedTokens,
-      updatedAt: metadata.updatedAt
-    });
   }
   return successResponse({
     count: docs.length,
@@ -52274,7 +52396,7 @@ async function handleGetDoc(args) {
   if (!resolved) {
     return errorResponse(`Documentation not found: ${input.path}`);
   }
-  const fileContent = await readFile3(resolved.filepath, "utf-8");
+  const fileContent = await readFile4(resolved.filepath, "utf-8");
   const { data, content } = (0, import_gray_matter3.default)(fileContent);
   const metadata = data;
   if (input.smart) {
@@ -52396,12 +52518,12 @@ async function handleCreateDoc(args) {
     const folderPath = input.folder.replace(/^\/|\/$/g, "");
     targetDir = join13(DOCS_DIR3, folderPath);
     relativePath = join13(folderPath, filename);
-    if (!existsSync8(targetDir)) {
-      await mkdir6(targetDir, { recursive: true });
+    if (!existsSync9(targetDir)) {
+      await mkdir7(targetDir, { recursive: true });
     }
   }
   const filepath = join13(targetDir, filename);
-  if (existsSync8(filepath)) {
+  if (existsSync9(filepath)) {
     return errorResponse(`Document already exists: ${relativePath}`);
   }
   const now = (/* @__PURE__ */ new Date()).toISOString();
@@ -52418,7 +52540,7 @@ async function handleCreateDoc(args) {
   }
   const initialContent = input.content || "# Content\n\nWrite your documentation here.";
   const fileContent = import_gray_matter3.default.stringify(initialContent, metadata);
-  await writeFile2(filepath, fileContent, "utf-8");
+  await writeFile3(filepath, fileContent, "utf-8");
   await notifyDocUpdate(relativePath);
   return successResponse({
     message: `Created documentation: ${relativePath}`,
@@ -52436,7 +52558,7 @@ async function handleUpdateDoc(args) {
   if (!resolved) {
     return errorResponse(`Documentation not found: ${input.path}`);
   }
-  const fileContent = await readFile3(resolved.filepath, "utf-8");
+  const fileContent = await readFile4(resolved.filepath, "utf-8");
   const { data, content } = (0, import_gray_matter3.default)(fileContent);
   const metadata = data;
   if (input.title) metadata.title = input.title;
@@ -52464,7 +52586,7 @@ async function handleUpdateDoc(args) {
 ${input.appendContent}`;
   }
   const newFileContent = import_gray_matter3.default.stringify(updatedContent, metadata);
-  await writeFile2(resolved.filepath, newFileContent, "utf-8");
+  await writeFile3(resolved.filepath, newFileContent, "utf-8");
   await notifyDocUpdate(resolved.filename);
   return successResponse({
     message: sectionUpdated ? `Updated section "${sectionUpdated}" in ${resolved.filename}` : `Updated documentation: ${resolved.filename}`,
@@ -52485,7 +52607,7 @@ async function handleSearchDocs(args) {
   const query = input.query.toLowerCase();
   const results = [];
   for (const file3 of mdFiles) {
-    const fileContent = await readFile3(join13(DOCS_DIR3, file3), "utf-8");
+    const fileContent = await readFile4(join13(DOCS_DIR3, file3), "utf-8");
     const { data, content } = (0, import_gray_matter3.default)(fileContent);
     const metadata = data;
     if (input.tag && !metadata.tags?.includes(input.tag)) {
@@ -52522,7 +52644,7 @@ async function handleSearchDocs(args) {
 }
 
 // src/codegen/renderer.ts
-import { readFile as readFile4 } from "node:fs/promises";
+import { readFile as readFile5 } from "node:fs/promises";
 var import_handlebars = __toESM(require_lib(), 1);
 
 // node_modules/change-case/dist/index.js
@@ -52719,7 +52841,7 @@ function renderString(template, context) {
   return compiled(context);
 }
 async function renderFile(templatePath, context) {
-  const content = await readFile4(templatePath, "utf-8");
+  const content = await readFile5(templatePath, "utf-8");
   return renderString(content, context);
 }
 function renderPath(pathPattern, context) {
@@ -52750,7 +52872,7 @@ function evaluateCondition(condition, context) {
 var commands_reference_default = '{{#if mcp}}\n# MCP Tools Reference\n\n## Task Tools\n\n### mcp__knowns__create_task\n\n```json\n{\n  "title": "Task title",\n  "description": "Task description",\n  "status": "todo",\n  "priority": "medium",\n  "labels": ["label1"],\n  "assignee": "@me",\n  "parent": "parent-id"\n}\n```\n\n### mcp__knowns__update_task\n\n```json\n{\n  "taskId": "<id>",\n  "status": "in-progress",\n  "assignee": "@me",\n  "addAc": ["Criterion 1", "Criterion 2"],\n  "checkAc": [1, 2],\n  "uncheckAc": [3],\n  "removeAc": [4],\n  "plan": "1. Step one\\n2. Step two",\n  "notes": "Implementation notes",\n  "appendNotes": "Additional notes"\n}\n```\n\n| Field | Purpose |\n|-------|---------|\n| `addAc` | Add new acceptance criteria |\n| `checkAc` | Mark AC done (1-based index) |\n| `uncheckAc` | Unmark AC (1-based index) |\n| `removeAc` | Remove AC (1-based index) |\n| `plan` | Set implementation plan |\n| `notes` | Replace implementation notes |\n| `appendNotes` | Append to notes |\n\n### mcp__knowns__get_task\n\n```json\n{ "taskId": "<id>" }\n```\n\n### mcp__knowns__list_tasks\n\n```json\n{ "status": "in-progress", "assignee": "@me" }\n```\n\n### mcp__knowns__search_tasks\n\n```json\n{ "query": "keyword" }\n```\n\n---\n\n## Doc Tools\n\n### mcp__knowns__get_doc\n\n**ALWAYS use `smart: true`** - auto-handles small/large docs:\n\n```json\n{ "path": "readme", "smart": true }\n```\n\nIf large, returns TOC. Then read section:\n```json\n{ "path": "readme", "section": "3" }\n```\n\n### mcp__knowns__list_docs\n\n```json\n{ "tag": "api" }\n```\n\n### mcp__knowns__create_doc\n\n```json\n{\n  "title": "Doc Title",\n  "description": "Description",\n  "tags": ["tag1"],\n  "folder": "guides",\n  "content": "Initial content"\n}\n```\n\n### mcp__knowns__update_doc\n\n```json\n{\n  "path": "readme",\n  "content": "Replace content",\n  "section": "2"\n}\n```\n\n### mcp__knowns__search_docs\n\n```json\n{ "query": "keyword", "tag": "api" }\n```\n\n### mcp__knowns__search (Unified)\n\n```json\n{\n  "query": "keyword",\n  "type": "all",\n  "status": "in-progress",\n  "priority": "high",\n  "assignee": "@me",\n  "label": "feature",\n  "tag": "api",\n  "limit": 20\n}\n```\n\n| Field | Purpose |\n|-------|---------|\n| `type` | "all", "task", or "doc" |\n| `status/priority/assignee/label` | Task filters |\n| `tag` | Doc filter |\n| `limit` | Max results (default: 20) |\n\n---\n\n## Time Tools\n\n### mcp__knowns__start_time\n\n```json\n{ "taskId": "<id>" }\n```\n\n### mcp__knowns__stop_time\n\n```json\n{ "taskId": "<id>" }\n```\n\n### mcp__knowns__add_time\n\n```json\n{\n  "taskId": "<id>",\n  "duration": "2h30m",\n  "note": "Note",\n  "date": "2025-01-15"\n}\n```\n\n### mcp__knowns__get_time_report\n\n```json\n{ "from": "2025-01-01", "to": "2025-01-31", "groupBy": "task" }\n```\n\n---\n\n## Template Tools\n\n### mcp__knowns__list_templates\n\n```json\n{}\n```\n\n### mcp__knowns__get_template\n\n```json\n{ "name": "template-name" }\n```\n\n### mcp__knowns__run_template\n\n```json\n{\n  "name": "template-name",\n  "variables": { "name": "MyComponent" },\n  "dryRun": true\n}\n```\n\n### mcp__knowns__create_template\n\n```json\n{\n  "name": "my-template",\n  "description": "Description",\n  "doc": "patterns/my-pattern"\n}\n```\n\n---\n\n## Other\n\n### mcp__knowns__get_board\n\n```json\n{}\n```\n\n{{else}}\n# CLI Commands Reference\n\n## task create\n\n```bash\nknowns task create <title> [options]\n```\n\n| Flag | Short | Purpose |\n|------|-------|---------|\n| `--description` | `-d` | Task description |\n| `--ac` | | Acceptance criterion (repeatable) |\n| `--labels` | `-l` | Comma-separated labels |\n| `--assignee` | `-a` | Assign to user |\n| `--priority` | | low/medium/high |\n| `--parent` | | Parent task ID (raw ID only!) |\n\n**`-a` = assignee, NOT acceptance criteria! Use `--ac` for AC.**\n\n---\n\n## task edit\n\n```bash\nknowns task edit <id> [options]\n```\n\n| Flag | Short | Purpose |\n|------|-------|---------|\n| `--status` | `-s` | Change status |\n| `--assignee` | `-a` | Assign user |\n| `--ac` | | Add acceptance criterion |\n| `--check-ac` | | Mark AC done (1-indexed) |\n| `--uncheck-ac` | | Unmark AC |\n| `--plan` | | Set implementation plan |\n| `--notes` | | Replace notes |\n| `--append-notes` | | Add to notes |\n\n---\n\n## task view/list\n\n```bash\nknowns task <id> --plain\nknowns task list --plain\nknowns task list --status in-progress --plain\nknowns task list --tree --plain\n```\n\n---\n\n## doc create\n\n```bash\nknowns doc create <title> [options]\n```\n\n| Flag | Short | Purpose |\n|------|-------|---------|\n| `--description` | `-d` | Description |\n| `--tags` | `-t` | Comma-separated tags |\n| `--folder` | `-f` | Folder path |\n\n---\n\n## doc edit\n\n```bash\nknowns doc edit <name> [options]\n```\n\n| Flag | Short | Purpose |\n|------|-------|---------|\n| `--content` | `-c` | Replace content |\n| `--append` | `-a` | Append content |\n| `--section` | | Target section (use with -c) |\n\n**In doc edit, `-a` = append content, NOT assignee!**\n\n---\n\n## doc view/list\n\n**ALWAYS use `--smart`** - auto-handles small/large docs:\n\n```bash\nknowns doc <path> --plain --smart\n```\n\nIf large, returns TOC. Then read section:\n```bash\nknowns doc <path> --plain --section 3\n```\n\n```bash\nknowns doc list --plain\nknowns doc list --tag api --plain\n```\n\n---\n\n## time\n\n```bash\nknowns time start <id>    # REQUIRED when taking task\nknowns time stop          # REQUIRED when completing\nknowns time status\nknowns time add <id> <duration> -n "Note"\n```\n\n---\n\n## search\n\n```bash\nknowns search "query" --plain\nknowns search "auth" --type task --plain\nknowns search "api" --type doc --plain\n```\n\n---\n\n## template\n\n```bash\nknowns template list\nknowns template info <name>\nknowns template run <name> --name "X" --dry-run\nknowns template create <name>\n```\n\n---\n\n## Multi-line Input\n\n```bash\nknowns task edit <id> --plan $\'1. Step\\n2. Step\\n3. Step\'\n```\n{{/if}}\n';
 
 // src/instructions/guidelines/unified/common-mistakes.md
-var common_mistakes_default = '# Common Mistakes\n\n{{#unless mcp}}\n## CRITICAL: The -a Flag\n\n| Command | `-a` Means | NOT This! |\n|---------|------------|-----------|\n| `task create/edit` | `--assignee` | ~~acceptance criteria~~ |\n| `doc edit` | `--append` | ~~assignee~~ |\n\n```bash\n# WRONG (sets assignee to garbage!)\nknowns task edit 35 -a "Criterion text"\n\n# CORRECT (use --ac)\nknowns task edit 35 --ac "Criterion text"\n```\n\n---\n{{/unless}}\n\n## Quick Reference\n\n| DON\'T | DO |\n|-------|-----|\n{{#if mcp}}\n| Edit .md files directly | Use MCP tools |\n{{else}}\n| Edit .md files directly | Use CLI commands |\n| `-a "criterion"` | `--ac "criterion"` |\n| `--parent task-48` | `--parent 48` (raw ID) |\n| `--plain` with create/edit | `--plain` only for view/list |\n{{/if}}\n| Check AC before work done | Check AC AFTER work done |\n| Code before plan approval | Wait for user approval |\n| Code before reading docs | Read docs FIRST |\n| Skip time tracking | Always start/stop timer |\n| Ignore refs | Follow ALL `@task-xxx`, `@doc/xxx`, `@template/xxx` refs |\n\n{{#if mcp}}\n---\n\n## MCP Task Operations\n\nAll task operations are available via MCP:\n\n| Operation | MCP Field |\n|-----------|-----------|\n| Add acceptance criteria | `addAc: ["criterion"]` |\n| Check AC | `checkAc: [1, 2]` (1-based) |\n| Uncheck AC | `uncheckAc: [1]` (1-based) |\n| Remove AC | `removeAc: [1]` (1-based) |\n| Set plan | `plan: "..."` |\n| Set notes | `notes: "..."` |\n| Append notes | `appendNotes: "..."` |\n| Change status | `status: "in-progress"` |\n| Assign | `assignee: "@me"` |\n{{/if}}\n\n---\n\n## Error Recovery\n\n| Problem | Solution |\n|---------|----------|\n{{#if mcp}}\n| Forgot to stop timer | `mcp__knowns__add_time` with duration |\n| Wrong status | `mcp__knowns__update_task` to fix |\n| Task not found | `mcp__knowns__list_tasks` to find ID |\n| Need to uncheck AC | `mcp__knowns__update_task` with `uncheckAc: [N]` |\n| Checked AC too early | `mcp__knowns__update_task` with `uncheckAc: [N]` |\n{{else}}\n| Set assignee to AC text | `knowns task edit <id> -a @me` |\n| Forgot to stop timer | `knowns time add <id> <duration>` |\n| Checked AC too early | `knowns task edit <id> --uncheck-ac N` |\n| Task not found | `knowns task list --plain` |\n{{/if}}\n';
+var common_mistakes_default = '# Common Mistakes\n\n{{#unless mcp}}\n## CRITICAL: The -a Flag\n\n| Command | `-a` Means | NOT This! |\n|---------|------------|-----------|\n| `task create/edit` | `--assignee` | ~~acceptance criteria~~ |\n| `doc edit` | `--append` | ~~assignee~~ |\n\n```bash\n# WRONG (sets assignee to garbage!)\nknowns task edit 35 -a "Criterion text"\n\n# CORRECT (use --ac)\nknowns task edit 35 --ac "Criterion text"\n```\n\n---\n{{/unless}}\n\n## Quick Reference\n\n| DON\'T | DO |\n|-------|-----|\n{{#if mcp}}\n| Edit .md files directly | Use MCP tools |\n{{else}}\n| Edit .md files directly | Use CLI commands |\n| `-a "criterion"` | `--ac "criterion"` |\n| `--parent task-48` | `--parent 48` (raw ID) |\n| `--plain` with create/edit | `--plain` only for view/list |\n{{/if}}\n| Check AC before work done | Check AC AFTER work done |\n| Code before plan approval | Wait for user approval |\n| Code before reading docs | Read docs FIRST |\n| Skip time tracking | Always start/stop timer |\n| Ignore refs | Follow ALL `@task-xxx`, `@doc/xxx`, `@template/xxx` refs |\n\n{{#if mcp}}\n---\n\n## MCP Task Operations\n\nAll task operations are available via MCP:\n\n| Operation | MCP Field |\n|-----------|-----------|\n| Add acceptance criteria | `addAc: ["criterion"]` |\n| Check AC | `checkAc: [1, 2]` (1-based) |\n| Uncheck AC | `uncheckAc: [1]` (1-based) |\n| Remove AC | `removeAc: [1]` (1-based) |\n| Set plan | `plan: "..."` |\n| Set notes | `notes: "..."` |\n| Append notes | `appendNotes: "..."` |\n| Change status | `status: "in-progress"` |\n| Assign | `assignee: "@me"` |\n{{/if}}\n\n---\n\n## Template Syntax Pitfalls\n\nWhen writing `.hbs` templates, **NEVER** create `$` followed by triple-brace - Handlebars interprets triple-brace as unescaped output:\n\n```\n// \u274C WRONG - Parse error!\nthis.logger.log(`Created: $` + `{` + `{` + `{camelCase entity}.id}`);\n\n// \u2705 CORRECT - Add space between ${ and double-brace, use ~ to trim whitespace\nthis.logger.log(`Created: ${ \\{{~camelCase entity~}}.id}`);\n```\n\n| DON\'T | DO |\n|-------|-----|\n| `$` + triple-brace | `${ \\{{~helper~}}}` (space + escaped) |\n\n**Rules:**\n- Add space between `${` and double-brace\n- Use `~` (tilde) to trim whitespace in output\n- Escape literal braces with backslash\n\n---\n\n## Error Recovery\n\n| Problem | Solution |\n|---------|----------|\n{{#if mcp}}\n| Forgot to stop timer | `mcp__knowns__add_time` with duration |\n| Wrong status | `mcp__knowns__update_task` to fix |\n| Task not found | `mcp__knowns__list_tasks` to find ID |\n| Need to uncheck AC | `mcp__knowns__update_task` with `uncheckAc: [N]` |\n| Checked AC too early | `mcp__knowns__update_task` with `uncheckAc: [N]` |\n{{else}}\n| Set assignee to AC text | `knowns task edit <id> -a @me` |\n| Forgot to stop timer | `knowns time add <id> <duration>` |\n| Checked AC too early | `knowns task edit <id> --uncheck-ac N` |\n| Task not found | `knowns task list --plain` |\n{{/if}}\n';
 
 // src/instructions/guidelines/unified/context-optimization.md
 var context_optimization_default = '# Context Optimization\n\nOptimize your context usage to work more efficiently within token limits.\n\n---\n\n{{#unless mcp}}\n## Output Format\n\n```bash\n# Verbose output\nknowns task 42 --json\n\n# Compact output (always use --plain)\nknowns task 42 --plain\n```\n\n---\n{{/unless}}\n\n## Search Before Read\n\n{{#if mcp}}\n```json\n// DON\'T: Read all docs hoping to find info\nmcp__knowns__get_doc({ "path": "doc1" })\nmcp__knowns__get_doc({ "path": "doc2" })\n\n// DO: Search first, then read only relevant docs\nmcp__knowns__search_docs({ "query": "authentication" })\nmcp__knowns__get_doc({ "path": "security-patterns" })\n```\n{{else}}\n```bash\n# DON\'T: Read all docs hoping to find info\nknowns doc "doc1" --plain\nknowns doc "doc2" --plain\n\n# DO: Search first, then read only relevant docs\nknowns search "authentication" --type doc --plain\nknowns doc "security-patterns" --plain\n```\n{{/if}}\n\n---\n\n{{#if mcp}}\n## Use Filters\n\n```json\n// DON\'T: List all then filter manually\nmcp__knowns__list_tasks({})\n\n// DO: Use filters in the query\nmcp__knowns__list_tasks({\n  "status": "in-progress",\n  "assignee": "@me"\n})\n```\n\n---\n{{/if}}\n\n## Reading Documents\n\n{{#if mcp}}\n**ALWAYS use `smart: true`** - auto-handles both small and large docs:\n\n```json\n// DON\'T: Read without smart\nmcp__knowns__get_doc({ "path": "readme" })\n\n// DO: Always use smart\nmcp__knowns__get_doc({ "path": "readme", "smart": true })\n// Small doc \u2192 full content\n// Large doc \u2192 stats + TOC\n\n// If large, read specific section:\nmcp__knowns__get_doc({ "path": "readme", "section": "3" })\n```\n{{else}}\n**ALWAYS use `--smart`** - auto-handles both small and large docs:\n\n```bash\n# DON\'T: Read without --smart\nknowns doc readme --plain\n\n# DO: Always use --smart\nknowns doc readme --plain --smart\n# Small doc \u2192 full content\n# Large doc \u2192 stats + TOC\n\n# If large, read specific section:\nknowns doc readme --plain --section 3\n```\n{{/if}}\n\n**Behavior:**\n- **\u22642000 tokens**: Returns full content automatically\n- **>2000 tokens**: Returns stats + TOC, then use section parameter\n\n---\n\n## Compact Notes\n\n```bash\n# DON\'T: Verbose notes\nknowns task edit 42 --append-notes "I have successfully completed the implementation..."\n\n# DO: Compact notes\nknowns task edit 42 --append-notes "Done: Auth middleware + JWT validation"\n```\n\n---\n\n## Avoid Redundant Operations\n\n| Don\'t | Do Instead |\n|-------|------------|\n| Re-read files already in context | Reference from memory |\n| List tasks/docs multiple times | List once, remember results |\n| Quote entire file contents | Summarize key points |\n\n---\n\n## Efficient Workflow\n\n| Phase | Context-Efficient Approach |\n|-------|---------------------------|\n| **Research** | Search \u2192 Read only matches |\n| **Planning** | Brief plan, not detailed prose |\n| **Coding** | Read only files being modified |\n| **Notes** | Bullet points, not paragraphs |\n| **Completion** | Summary, not full log |\n\n---\n\n## Quick Rules\n\n{{#if mcp}}\n1. **Always `smart: true`** - Auto-handles doc size\n{{else}}\n1. **Always `--plain`** - Never use `--json` unless needed\n2. **Always `--smart`** - Auto-handles doc size\n{{/if}}\n3. **Search first** - Don\'t read all docs hoping to find info\n4. **Read selectively** - Only fetch what you need\n5. **Write concise** - Compact notes, not essays\n6. **Don\'t repeat** - Reference context already loaded\n';
@@ -52895,8 +53017,8 @@ async function handleGetGuideline(args) {
 }
 
 // src/mcp/handlers/template.ts
-import { existsSync as existsSync11 } from "node:fs";
-import { mkdir as mkdir8, writeFile as writeFile4 } from "node:fs/promises";
+import { existsSync as existsSync12 } from "node:fs";
+import { mkdir as mkdir9, writeFile as writeFile5 } from "node:fs/promises";
 import { join as join16 } from "node:path";
 
 // src/codegen/schema.ts
@@ -52977,8 +53099,8 @@ function safeValidateTemplateConfig(data) {
 
 // src/codegen/parser.ts
 var import_yaml = __toESM(require_dist2(), 1);
-import { existsSync as existsSync9 } from "node:fs";
-import { readFile as readFile5, readdir as readdir6 } from "node:fs/promises";
+import { existsSync as existsSync10 } from "node:fs";
+import { readFile as readFile6, readdir as readdir6 } from "node:fs/promises";
 import { join as join14 } from "node:path";
 var CONFIG_FILENAME = "_template.yaml";
 var TEMPLATE_EXTENSION = ".hbs";
@@ -52991,16 +53113,16 @@ var TemplateParseError = class extends Error {
   }
 };
 async function loadTemplate(templateDir) {
-  if (!existsSync9(templateDir)) {
+  if (!existsSync10(templateDir)) {
     throw new TemplateParseError(`Template directory not found: ${templateDir}`);
   }
   const configPath = join14(templateDir, CONFIG_FILENAME);
-  if (!existsSync9(configPath)) {
+  if (!existsSync10(configPath)) {
     throw new TemplateParseError(`Template config not found: ${CONFIG_FILENAME}`, void 0, [
       `Expected file at: ${configPath}`
     ]);
   }
-  const configContent = await readFile5(configPath, "utf-8");
+  const configContent = await readFile6(configPath, "utf-8");
   let rawConfig;
   try {
     rawConfig = (0, import_yaml.parse)(configContent);
@@ -53041,7 +53163,7 @@ async function loadTemplateByName(templatesDir, templateName) {
   return loadTemplate(templateDir);
 }
 async function listTemplates(templatesDir) {
-  if (!existsSync9(templatesDir)) {
+  if (!existsSync10(templatesDir)) {
     return [];
   }
   const entries = await readdir6(templatesDir, { withFileTypes: true });
@@ -53049,7 +53171,7 @@ async function listTemplates(templatesDir) {
   for (const entry of entries) {
     if (!entry.isDirectory()) continue;
     const configPath = join14(templatesDir, entry.name, CONFIG_FILENAME);
-    if (!existsSync9(configPath)) continue;
+    if (!existsSync10(configPath)) continue;
     try {
       const loaded = await loadTemplate(join14(templatesDir, entry.name));
       templates.push(loaded.config);
@@ -53060,8 +53182,8 @@ async function listTemplates(templatesDir) {
 }
 
 // src/codegen/runner.ts
-import { existsSync as existsSync10 } from "node:fs";
-import { appendFile, mkdir as mkdir7, readFile as readFile6, writeFile as writeFile3 } from "node:fs/promises";
+import { existsSync as existsSync11 } from "node:fs";
+import { appendFile, mkdir as mkdir8, readFile as readFile7, writeFile as writeFile4 } from "node:fs/promises";
 import { dirname as dirname3, join as join15 } from "node:path";
 
 // node_modules/@isaacs/balanced-match/dist/esm/index.js
@@ -59838,7 +59960,7 @@ async function executeAddAction(action, template, context, options2, result) {
   const sourcePath = join15(template.templateDir, action.template);
   const destRelative = renderPath(action.path, context);
   const destPath = join15(options2.projectRoot, template.config.destination || "", destRelative);
-  if (existsSync10(destPath)) {
+  if (existsSync11(destPath)) {
     if (action.skipIfExists && !options2.force) {
       result.skipped.push(destRelative);
       return;
@@ -59851,7 +59973,7 @@ async function executeAddAction(action, template, context, options2, result) {
   const content = await renderFile(sourcePath, context);
   if (!options2.dryRun) {
     await ensureDir(dirname3(destPath));
-    await writeFile3(destPath, content, "utf-8");
+    await writeFile4(destPath, content, "utf-8");
   }
   result.created.push(destRelative);
 }
@@ -59863,7 +59985,7 @@ async function executeAddManyAction(action, template, context, options2, result)
     const sourcePath = join15(sourceDir, file3);
     const destRelative = renderPath(join15(action.destination, file3), context);
     const destPath = join15(options2.projectRoot, template.config.destination || "", destRelative);
-    if (existsSync10(destPath)) {
+    if (existsSync11(destPath)) {
       if (action.skipIfExists && !options2.force) {
         result.skipped.push(destRelative);
         continue;
@@ -59876,17 +59998,17 @@ async function executeAddManyAction(action, template, context, options2, result)
     const content = await renderFile(sourcePath, context);
     if (!options2.dryRun) {
       await ensureDir(dirname3(destPath));
-      await writeFile3(destPath, content, "utf-8");
+      await writeFile4(destPath, content, "utf-8");
     }
     result.created.push(destRelative);
   }
 }
 async function executeModifyAction(action, context, options2, result) {
   const filePath = join15(options2.projectRoot, renderPath(action.path, context));
-  if (!existsSync10(filePath)) {
+  if (!existsSync11(filePath)) {
     throw new Error(`Cannot modify: file not found: ${action.path}`);
   }
-  const content = await readFile6(filePath, "utf-8");
+  const content = await readFile7(filePath, "utf-8");
   const replacement = renderString(action.template, context);
   const pattern = new RegExp(action.pattern, "g");
   const newContent = content.replace(pattern, replacement);
@@ -59895,15 +60017,15 @@ async function executeModifyAction(action, context, options2, result) {
     return;
   }
   if (!options2.dryRun) {
-    await writeFile3(filePath, newContent, "utf-8");
+    await writeFile4(filePath, newContent, "utf-8");
   }
   result.modified.push(action.path);
 }
 async function executeAppendAction(action, context, options2, result) {
   const filePath = join15(options2.projectRoot, renderPath(action.path, context));
   const contentToAppend = renderString(action.template, context);
-  if (action.unique && existsSync10(filePath)) {
-    const existingContent = await readFile6(filePath, "utf-8");
+  if (action.unique && existsSync11(filePath)) {
+    const existingContent = await readFile7(filePath, "utf-8");
     if (existingContent.includes(contentToAppend.trim())) {
       result.skipped.push(action.path);
       return;
@@ -59913,21 +60035,21 @@ async function executeAppendAction(action, context, options2, result) {
   const fullContent = separator + contentToAppend;
   if (!options2.dryRun) {
     await ensureDir(dirname3(filePath));
-    if (existsSync10(filePath)) {
+    if (existsSync11(filePath)) {
       await appendFile(filePath, fullContent, "utf-8");
     } else {
-      await writeFile3(filePath, contentToAppend, "utf-8");
+      await writeFile4(filePath, contentToAppend, "utf-8");
     }
   }
-  if (existsSync10(filePath)) {
+  if (existsSync11(filePath)) {
     result.modified.push(action.path);
   } else {
     result.created.push(action.path);
   }
 }
 async function ensureDir(dir) {
-  if (!existsSync10(dir)) {
-    await mkdir7(dir, { recursive: true });
+  if (!existsSync11(dir)) {
+    await mkdir8(dir, { recursive: true });
   }
 }
 
@@ -59935,7 +60057,7 @@ async function ensureDir(dir) {
 var import_gray_matter4 = __toESM(require_gray_matter(), 1);
 
 // src/mcp/handlers/template.ts
-var TEMPLATES_DIR2 = join16(process.cwd(), ".knowns", "templates");
+var TEMPLATES_DIR3 = join16(process.cwd(), ".knowns", "templates");
 var listTemplatesSchema = external_exports3.object({});
 var getTemplateSchema = external_exports3.object({
   name: external_exports3.string()
@@ -60028,30 +60150,45 @@ var templateTools = [
 ];
 async function handleListTemplates(_args) {
   listTemplatesSchema.parse(_args);
-  if (!existsSync11(TEMPLATES_DIR2)) {
-    return successResponse({
-      count: 0,
-      templates: [],
-      message: "No templates directory found. Create templates in .knowns/templates/"
-    });
-  }
+  const projectRoot = process.cwd();
   try {
-    const templates = await listTemplates(TEMPLATES_DIR2);
-    if (templates.length === 0) {
+    const allTemplates = await listAllTemplates(projectRoot);
+    if (allTemplates.length === 0) {
       return successResponse({
         count: 0,
         templates: [],
-        message: "No templates found in .knowns/templates/"
+        message: "No templates found. Create templates in .knowns/templates/"
       });
     }
-    const templateList = templates.map((t) => ({
-      name: t.name,
-      description: t.description,
-      doc: t.doc,
-      // Linked documentation
-      promptCount: t.prompts?.length || 0,
-      fileCount: t.files?.length || 0
-    }));
+    const templateList = [];
+    for (const t of allTemplates) {
+      try {
+        const loaded = await listTemplates(join16(t.path, ".."));
+        const match2 = loaded.find((l) => l.name === t.name);
+        templateList.push({
+          name: t.name,
+          ref: t.ref,
+          description: match2?.description || "No description",
+          doc: match2?.doc,
+          promptCount: match2?.prompts?.length || 0,
+          fileCount: match2?.files?.length || 0,
+          source: t.source,
+          sourceUrl: t.sourceUrl,
+          isImported: t.isImported
+        });
+      } catch {
+        templateList.push({
+          name: t.name,
+          ref: t.ref,
+          description: "No description",
+          promptCount: 0,
+          fileCount: 0,
+          source: t.source,
+          sourceUrl: t.sourceUrl,
+          isImported: t.isImported
+        });
+      }
+    }
     return successResponse({
       count: templateList.length,
       templates: templateList
@@ -60062,27 +60199,37 @@ async function handleListTemplates(_args) {
 }
 async function handleGetTemplate(args) {
   const input = getTemplateSchema.parse(args);
-  if (!existsSync11(TEMPLATES_DIR2)) {
+  if (!existsSync12(TEMPLATES_DIR3)) {
     return errorResponse("No templates directory found");
   }
   try {
-    const template = await loadTemplateByName(input.name, TEMPLATES_DIR2);
+    const template = await loadTemplateByName(TEMPLATES_DIR3, input.name);
     if (!template) {
       return errorResponse(`Template not found: ${input.name}`);
     }
     const prompts2 = template.config.prompts?.map((p) => ({
       name: p.name,
       message: p.message,
-      type: p.type || "input",
+      type: p.type || "text",
       required: p.validate === "required",
-      default: p.default,
+      default: p.initial,
       choices: p.choices
     }));
-    const files = template.config.files?.map((f) => ({
-      template: f.template,
-      destination: f.destination,
-      condition: f.condition
-    }));
+    const actions = template.config.actions?.map((a) => {
+      if (a.type === "add") {
+        return { type: a.type, template: a.template, path: a.path, skipIfExists: a.skipIfExists };
+      }
+      if (a.type === "addMany") {
+        return { type: a.type, source: a.source, destination: a.destination, globPattern: a.globPattern };
+      }
+      if (a.type === "modify") {
+        return { type: a.type, path: a.path, pattern: a.pattern };
+      }
+      if (a.type === "append") {
+        return { type: a.type, path: a.path, unique: a.unique };
+      }
+      return a;
+    });
     return successResponse({
       template: {
         name: template.config.name,
@@ -60090,7 +60237,7 @@ async function handleGetTemplate(args) {
         doc: template.config.doc,
         // Linked documentation - AI should read this
         prompts: prompts2 || [],
-        files: files || [],
+        actions: actions || [],
         messages: template.config.messages
       },
       hint: template.config.doc ? `This template links to @doc/${template.config.doc}. Read the doc for context before running.` : void 0
@@ -60102,11 +60249,11 @@ async function handleGetTemplate(args) {
 async function handleRunTemplate(args) {
   const input = runTemplateSchema.parse(args);
   const dryRun = input.dryRun !== false;
-  if (!existsSync11(TEMPLATES_DIR2)) {
+  if (!existsSync12(TEMPLATES_DIR3)) {
     return errorResponse("No templates directory found");
   }
   try {
-    const template = await loadTemplateByName(input.name, TEMPLATES_DIR2);
+    const template = await loadTemplateByName(TEMPLATES_DIR3, input.name);
     if (!template) {
       return errorResponse(`Template not found: ${input.name}`);
     }
@@ -60121,8 +60268,8 @@ async function handleRunTemplate(args) {
     for (const prompt of template.config.prompts || []) {
       if (input.variables?.[prompt.name]) {
         values[prompt.name] = input.variables[prompt.name];
-      } else if (prompt.default) {
-        values[prompt.name] = String(prompt.default);
+      } else if (prompt.initial !== void 0) {
+        values[prompt.name] = String(prompt.initial);
       }
     }
     const result = await runTemplate(template, {
@@ -60133,19 +60280,18 @@ async function handleRunTemplate(args) {
     if (!result.success) {
       return errorResponse(`Template failed: ${result.error}`);
     }
-    const filesCreated = result.files?.map((f) => ({
-      path: f.path,
-      action: f.action,
-      skipped: f.skipped,
-      skipReason: f.skipReason
-    }));
+    const totalCreated = result.created?.length || 0;
+    const totalModified = result.modified?.length || 0;
+    const totalSkipped = result.skipped?.length || 0;
     return successResponse({
       success: true,
       dryRun,
       template: input.name,
       variables: values,
-      files: filesCreated || [],
-      message: dryRun ? `Dry run complete. ${filesCreated?.length || 0} files would be created. Set dryRun: false to write files.` : `Template executed. ${filesCreated?.filter((f) => !f.skipped).length || 0} files created.`
+      created: result.created || [],
+      modified: result.modified || [],
+      skipped: result.skipped || [],
+      message: dryRun ? `Dry run complete. ${totalCreated} files would be created, ${totalModified} modified. Set dryRun: false to write files.` : `Template executed. ${totalCreated} files created, ${totalModified} modified, ${totalSkipped} skipped.`
     });
   } catch (error48) {
     return errorResponse(`Failed to run template: ${error48 instanceof Error ? error48.message : String(error48)}`);
@@ -60154,14 +60300,14 @@ async function handleRunTemplate(args) {
 async function handleCreateTemplate(args) {
   const input = createTemplateSchema.parse(args);
   try {
-    if (!existsSync11(TEMPLATES_DIR2)) {
-      await mkdir8(TEMPLATES_DIR2, { recursive: true });
+    if (!existsSync12(TEMPLATES_DIR3)) {
+      await mkdir9(TEMPLATES_DIR3, { recursive: true });
     }
-    const templateDir = join16(TEMPLATES_DIR2, input.name);
-    if (existsSync11(templateDir)) {
+    const templateDir = join16(TEMPLATES_DIR3, input.name);
+    if (existsSync12(templateDir)) {
       return errorResponse(`Template "${input.name}" already exists`);
     }
-    await mkdir8(templateDir, { recursive: true });
+    await mkdir9(templateDir, { recursive: true });
     const docLine = input.doc ? `doc: ${input.doc}
 ` : "";
     const configContent = `# Template: ${input.name}
@@ -60187,7 +60333,7 @@ messages:
   success: |
     \u2713 Created {{name}}!
 `;
-    await writeFile4(join16(templateDir, "_template.yaml"), configContent, "utf-8");
+    await writeFile5(join16(templateDir, "_template.yaml"), configContent, "utf-8");
     const exampleTemplate = `/**
  * {{pascalCase name}}
  * Generated from ${input.name} template
@@ -60197,7 +60343,7 @@ export function {{camelCase name}}() {
   console.log("Hello from {{name}}!");
 }
 `;
-    await writeFile4(join16(templateDir, "example.ts.hbs"), exampleTemplate, "utf-8");
+    await writeFile5(join16(templateDir, "example.ts.hbs"), exampleTemplate, "utf-8");
     return successResponse({
       message: `Created template: ${input.name}`,
       template: {
@@ -60220,8 +60366,8 @@ export function {{camelCase name}}() {
 
 // src/mcp/handlers/search.ts
 var import_gray_matter5 = __toESM(require_gray_matter(), 1);
-import { existsSync as existsSync12 } from "node:fs";
-import { readFile as readFile7, readdir as readdir8 } from "node:fs/promises";
+import { existsSync as existsSync13 } from "node:fs";
+import { readFile as readFile8, readdir as readdir8 } from "node:fs/promises";
 import { join as join17 } from "node:path";
 var searchSchema = external_exports3.object({
   query: external_exports3.string(),
@@ -60309,7 +60455,7 @@ function calculateDocScore(title, description, content, tags, query) {
 }
 async function getAllMdFiles2(dir, basePath = "") {
   const files = [];
-  if (!existsSync12(dir)) {
+  if (!existsSync13(dir)) {
     return files;
   }
   const entries = await readdir8(dir, { withFileTypes: true });
@@ -60357,14 +60503,14 @@ async function searchTasks(fileStore2, query, filters) {
   })).sort((a, b) => b.score - a.score);
 }
 async function searchDocs(docsDir, query, tagFilter) {
-  if (!existsSync12(docsDir)) {
+  if (!existsSync13(docsDir)) {
     return [];
   }
   const mdFiles = await getAllMdFiles2(docsDir);
   const q = query.toLowerCase();
   const results = [];
   for (const file3 of mdFiles) {
-    const fileContent = await readFile7(join17(docsDir, file3), "utf-8");
+    const fileContent = await readFile8(join17(docsDir, file3), "utf-8");
     const { data, content } = (0, import_gray_matter5.default)(fileContent);
     const metadata = data;
     if (tagFilter && !metadata.tags?.includes(tagFilter)) {
@@ -60528,7 +60674,7 @@ server.setRequestHandler(ListResourcesRequestSchema, async () => {
     description: `Task #${task.id}: ${task.title}`
   }));
   const docResources = [];
-  if (existsSync13(docsDir)) {
+  if (existsSync14(docsDir)) {
     const { readdir: readdir9 } = await import("node:fs/promises");
     async function getAllMdFiles3(dir, basePath = "") {
       const files = [];
@@ -60548,7 +60694,7 @@ server.setRequestHandler(ListResourcesRequestSchema, async () => {
     const mdFiles = await getAllMdFiles3(docsDir);
     for (const file3 of mdFiles) {
       const filepath = join18(docsDir, file3);
-      const content = await readFile8(filepath, "utf-8");
+      const content = await readFile9(filepath, "utf-8");
       const { data } = (0, import_gray_matter6.default)(content);
       docResources.push({
         uri: `knowns://doc/${file3.replace(/\.md$/, "")}`,
@@ -60586,10 +60732,10 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
     const docPath = docMatch[1];
     const docsDir = join18(process.cwd(), ".knowns", "docs");
     const filepath = join18(docsDir, `${docPath}.md`);
-    if (!existsSync13(filepath)) {
+    if (!existsSync14(filepath)) {
       throw new Error(`Documentation ${docPath} not found`);
     }
-    const content = await readFile8(filepath, "utf-8");
+    const content = await readFile9(filepath, "utf-8");
     const { data, content: docContent } = (0, import_gray_matter6.default)(content);
     return {
       contents: [