knowns 0.10.0 → 0.10.2

package/dist/index.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { createRequire } from 'module';
+import { createRequire as __createRequire } from 'module';
 import { fileURLToPath as __fileURLToPath } from 'url';
 import { dirname as __dirname_fn } from 'path';
-const require = createRequire(import.meta.url);
+const require = __createRequire(import.meta.url);
 const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __dirname_fn(__filename);
 
@@ -61849,22 +61849,25 @@ var searchCommand = new Command("search").description("Search tasks and document
             const pathGroups = {};
             for (const doc of docResults) {
               const parts = doc.filename.split("/");
-              const folder = parts.length > 1 ? `${parts.slice(0, -1).join("/")}/` : "(root)";
+              const folder = parts.length > 1 ? `${parts.slice(0, -1).join("/")}/` : "";
               if (!pathGroups[folder]) {
                 pathGroups[folder] = [];
               }
               pathGroups[folder].push(doc);
             }
             const sortedPaths = Object.keys(pathGroups).sort((a, b) => {
-              if (a === "(root)") return -1;
-              if (b === "(root)") return 1;
+              if (a === "") return -1;
+              if (b === "") return 1;
               return a.localeCompare(b);
             });
             for (const path3 of sortedPaths) {
-              console.log(`  ${path3}:`);
+              if (path3) {
+                console.log(`  ${path3}:`);
+              }
+              const indent = path3 ? "    " : "  ";
               for (const doc of pathGroups[path3]) {
                 const filename = doc.filename.split("/").pop() || doc.filename;
-                console.log(`    ${filename} - ${doc.metadata.title}`);
+                console.log(`${indent}${filename} - ${doc.metadata.title}`);
               }
             }
           }
@@ -62482,6 +62485,7 @@ function createConfigRoutes(ctx) {
         name: data.name,
         id: data.id,
         createdAt: data.createdAt,
+        imports: data.imports,
         ...settings
       };
       if (!config2.visibleColumns) {
@@ -62501,10 +62505,13 @@ function createConfigRoutes(ctx) {
         const content = await readFile7(configPath, "utf-8");
         existingData = JSON.parse(content);
       }
-      const { name, ...settings } = config2;
+      const { name, imports, id, createdAt, ...settings } = config2;
       const merged = {
         ...existingData,
         name: name || existingData.name,
+        id: id || existingData.id,
+        createdAt: createdAt || existingData.createdAt,
+        imports: imports !== void 0 ? imports : existingData.imports,
         settings
       };
       await writeFile4(configPath, JSON.stringify(merged, null, 2), "utf-8");
@@ -63966,7 +63973,7 @@ async function importSource(projectRoot, source, options2 = {}) {
   if (!nameValidation.valid) {
     throw new ImportError(nameValidation.error || "Invalid name", "NAME_CONFLICT" /* NAME_CONFLICT */);
   }
-  if (!options2.force && await importExists(projectRoot, name)) {
+  if (!options2.force && !options2.isSync && await importExists(projectRoot, name)) {
     throw new ImportError(
       `Import "${name}" already exists`,
       "NAME_CONFLICT" /* NAME_CONFLICT */,
@@ -64144,8 +64151,10 @@ async function syncImport(projectRoot, name, options2 = {}) {
     exclude: config2.exclude,
     force: options2.force,
     dryRun: options2.dryRun,
-    noSave: true
+    noSave: true,
     // Don't update config on sync
+    isSync: true
+    // Bypass "already exists" check
   });
 }
 async function syncAllImports(projectRoot, options2 = {}) {
@@ -64153,7 +64162,7 @@ async function syncAllImports(projectRoot, options2 = {}) {
   const configs = await getImportConfigs2(projectRoot);
   const results = [];
   for (const config2 of configs) {
-    if (config2.autoSync === false && !options2.force) {
+    if (options2.autoOnly && config2.autoSync === false) {
       continue;
     }
     try {
@@ -64197,7 +64206,38 @@ import { existsSync as existsSync14 } from "node:fs";
 import { readdir as readdir7 } from "node:fs/promises";
 import { join as join17 } from "node:path";
 var KNOWNS_DIR5 = ".knowns";
+var TEMPLATES_DIR2 = "templates";
 var DOCS_DIR2 = "docs";
+async function getTemplateDirectories(projectRoot) {
+  const results = [];
+  const localTemplates = join17(projectRoot, KNOWNS_DIR5, TEMPLATES_DIR2);
+  if (existsSync14(localTemplates)) {
+    results.push({
+      path: localTemplates,
+      source: "local",
+      isImported: false
+    });
+  }
+  const importsDir = getImportsDir(projectRoot);
+  if (existsSync14(importsDir)) {
+    try {
+      const entries = await readdir7(importsDir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+        const importedTemplates = join17(importsDir, entry.name, TEMPLATES_DIR2);
+        if (existsSync14(importedTemplates)) {
+          results.push({
+            path: importedTemplates,
+            source: entry.name,
+            isImported: true
+          });
+        }
+      }
+    } catch {
+    }
+  }
+  return results;
+}
 async function getDocDirectories(projectRoot) {
   const results = [];
   const localDocs = join17(projectRoot, KNOWNS_DIR5, DOCS_DIR2);
@@ -64300,8 +64340,36 @@ 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 readdir7(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: join17(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 = join17(baseDir, relativePath);
@@ -64319,6 +64387,7 @@ async function listAllDocs(projectRoot) {
             name: docPath,
             ref,
             source,
+            sourceUrl: isImported ? sourceUrlMap.get(source) : void 0,
             fullPath: join17(currentDir, entry.name),
             isImported
           });
@@ -87092,131 +87161,190 @@ var createCommand3 = new Command("create").description("Create a new documentati
     }
   }
 );
-var listCommand2 = new Command("list").description("List all documentation files").argument("[path]", "Filter by path (e.g., 'guides/' or 'patterns/')").option("--plain", "Plain text output for AI").option("-t, --tag <tag>", "Filter by tag").action(async (path3, options2) => {
-  try {
-    await ensureDocsDir();
-    const mdFiles = await getAllMdFiles(DOCS_DIR3);
-    if (mdFiles.length === 0) {
-      if (options2.plain) {
-        console.log("No documentation found");
-      } else {
-        console.log(source_default.yellow("No documentation files found."));
-        console.log(source_default.gray(`Create one with: knowns doc create "Title"`));
-      }
-      return;
-    }
-    const docs = [];
-    for (const file3 of mdFiles) {
-      const fileContent = await readFile18(join29(DOCS_DIR3, file3), "utf-8");
-      const { data, content } = (0, import_gray_matter7.default)(fileContent);
-      const stats = calculateDocStats(content);
-      docs.push({
-        filename: file3,
-        metadata: data,
-        tokens: stats.estimatedTokens
-      });
-    }
-    let filteredDocs = docs;
-    if (path3) {
-      const normalizedPath = path3.endsWith("/") ? path3 : `${path3}/`;
-      filteredDocs = docs.filter((doc) => doc.filename.startsWith(normalizedPath));
-    }
-    if (options2.tag) {
-      filteredDocs = filteredDocs.filter((doc) => doc.metadata.tags?.includes(options2.tag));
-    }
-    if (filteredDocs.length === 0) {
-      const filterMsg = path3 ? `path: ${path3}` : options2.tag ? `tag: ${options2.tag}` : "";
-      console.log(
-        options2.plain ? "No documentation found" : source_default.yellow(`No documentation found${filterMsg ? ` with ${filterMsg}` : ""}`)
-      );
-      return;
-    }
-    if (options2.plain) {
-      const folders = /* @__PURE__ */ new Map();
-      const rootDocs = [];
-      for (const doc of filteredDocs) {
-        const parts = doc.filename.split("/");
-        if (parts.length === 1) {
-          rootDocs.push({
-            name: parts[0].replace(/\.md$/, ""),
-            title: doc.metadata.title,
-            tokens: doc.tokens
-          });
+var listCommand2 = new Command("list").description("List all documentation files (local + imported)").argument("[path]", "Filter by path (e.g., 'guides/' or 'patterns/')").option("--plain", "Plain text output for AI").option("-t, --tag <tag>", "Filter by tag").option("--local", "Show only local docs").option("--imported", "Show only imported docs").action(
+  async (path3, options2) => {
+    try {
+      await ensureDocsDir();
+      const projectRoot = await findProjectRoot() || process.cwd();
+      const allDocs = await listAllDocs(projectRoot);
+      if (allDocs.length === 0) {
+        if (options2.plain) {
+          console.log("No documentation found");
         } else {
-          const folder = parts.slice(0, -1).join("/");
-          const name = parts[parts.length - 1].replace(/\.md$/, "");
-          if (!folders.has(folder)) {
-            folders.set(folder, []);
-          }
-          folders.get(folder)?.push({ name, title: doc.metadata.title, tokens: doc.tokens });
+          console.log(source_default.yellow("No documentation files found."));
+          console.log(source_default.gray(`Create one with: knowns doc create "Title"`));
         }
+        return;
       }
-      const sortedFolders = Array.from(folders.keys()).sort();
-      for (const folder of sortedFolders) {
-        console.log(`${folder}/`);
-        const docs2 = folders.get(folder)?.sort((a, b) => a.name.localeCompare(b.name));
-        for (const doc of docs2) {
-          console.log(`  ${doc.name} - ${doc.title} (~${doc.tokens} tokens)`);
+      const docs = [];
+      for (const doc of allDocs) {
+        try {
+          const fileContent = await readFile18(doc.fullPath, "utf-8");
+          const { data, content } = (0, import_gray_matter7.default)(fileContent);
+          const stats = calculateDocStats(content);
+          docs.push({
+            ref: doc.ref,
+            name: doc.name,
+            source: doc.source,
+            sourceUrl: doc.sourceUrl,
+            isImported: doc.isImported,
+            fullPath: doc.fullPath,
+            metadata: data,
+            tokens: stats.estimatedTokens
+          });
+        } catch {
         }
       }
-      if (rootDocs.length > 0) {
-        rootDocs.sort((a, b) => a.name.localeCompare(b.name));
-        for (const doc of rootDocs) {
-          console.log(`${doc.name} - ${doc.title} (~${doc.tokens} tokens)`);
-        }
+      let filteredDocs = docs;
+      if (options2.local) {
+        filteredDocs = docs.filter((doc) => !doc.isImported);
+      } else if (options2.imported) {
+        filteredDocs = docs.filter((doc) => doc.isImported);
       }
-    } else {
-      const folders = /* @__PURE__ */ new Map();
-      const rootDocs = [];
-      for (const doc of filteredDocs) {
-        const parts = doc.filename.split("/");
-        if (parts.length === 1) {
-          rootDocs.push(doc);
-        } else {
-          const folder = parts.slice(0, -1).join("/");
-          if (!folders.has(folder)) {
-            folders.set(folder, []);
+      if (path3) {
+        const normalizedPath = path3.endsWith("/") ? path3 : `${path3}/`;
+        filteredDocs = filteredDocs.filter(
+          (doc) => doc.ref.startsWith(normalizedPath) || doc.name.startsWith(normalizedPath)
+        );
+      }
+      if (options2.tag) {
+        filteredDocs = filteredDocs.filter((doc) => doc.metadata.tags?.includes(options2.tag));
+      }
+      if (filteredDocs.length === 0) {
+        const filterMsg = path3 ? `path: ${path3}` : options2.tag ? `tag: ${options2.tag}` : "";
+        console.log(
+          options2.plain ? "No documentation found" : source_default.yellow(`No documentation found${filterMsg ? ` with ${filterMsg}` : ""}`)
+        );
+        return;
+      }
+      if (options2.plain) {
+        const sources = /* @__PURE__ */ new Map();
+        for (const doc of filteredDocs) {
+          const sourceKey = doc.isImported ? `[${doc.source}]` : "[local]";
+          if (!sources.has(sourceKey)) {
+            sources.set(sourceKey, []);
+          }
+          sources.get(sourceKey)?.push(doc);
+        }
+        const sortedSources = Array.from(sources.keys()).sort((a, b) => {
+          if (a === "[local]") return -1;
+          if (b === "[local]") return 1;
+          return a.localeCompare(b);
+        });
+        for (const sourceKey of sortedSources) {
+          const sourceDocs = sources.get(sourceKey) || [];
+          const sourceUrl = sourceDocs[0]?.sourceUrl;
+          if (sourceUrl) {
+            console.log(`${sourceKey} (${sourceUrl})`);
+          } else {
+            console.log(`${sourceKey}`);
+          }
+          const folders = /* @__PURE__ */ new Map();
+          const rootDocs = [];
+          for (const doc of sourceDocs) {
+            const parts = doc.name.split("/");
+            if (parts.length === 1) {
+              rootDocs.push({
+                name: parts[0],
+                title: doc.metadata.title || parts[0],
+                tokens: doc.tokens
+              });
+            } else {
+              const folder = parts.slice(0, -1).join("/");
+              const name = parts[parts.length - 1];
+              if (!folders.has(folder)) {
+                folders.set(folder, []);
+              }
+              folders.get(folder)?.push({ name, title: doc.metadata.title || name, tokens: doc.tokens });
+            }
+          }
+          const sortedFolders = Array.from(folders.keys()).sort();
+          for (const folder of sortedFolders) {
+            console.log(`  ${folder}/`);
+            const folderDocs = folders.get(folder)?.sort((a, b) => a.name.localeCompare(b.name));
+            for (const doc of folderDocs || []) {
+              console.log(`    ${doc.name} - ${doc.title} (~${doc.tokens} tokens)`);
+            }
+          }
+          if (rootDocs.length > 0) {
+            rootDocs.sort((a, b) => a.name.localeCompare(b.name));
+            for (const doc of rootDocs) {
+              console.log(`  ${doc.name} - ${doc.title} (~${doc.tokens} tokens)`);
+            }
           }
-          folders.get(folder)?.push(doc);
         }
-      }
-      console.log(source_default.bold(`
+      } else {
+        const sources = /* @__PURE__ */ new Map();
+        for (const doc of filteredDocs) {
+          const sourceKey = doc.isImported ? doc.source : "local";
+          if (!sources.has(sourceKey)) {
+            sources.set(sourceKey, []);
+          }
+          sources.get(sourceKey)?.push(doc);
+        }
+        const sortedSources = Array.from(sources.keys()).sort((a, b) => {
+          if (a === "local") return -1;
+          if (b === "local") return 1;
+          return a.localeCompare(b);
+        });
+        console.log(source_default.bold(`
 Documentation (${filteredDocs.length})
 `));
-      const sortedFolders = Array.from(folders.keys()).sort();
-      for (const folder of sortedFolders) {
-        console.log(source_default.cyan.bold(`${folder}/`));
-        const docs2 = folders.get(folder)?.sort((a, b) => a.metadata.title.localeCompare(b.metadata.title));
-        for (const doc of docs2) {
-          console.log(source_default.white(`  ${doc.metadata.title}`));
-          if (doc.metadata.description) {
-            console.log(source_default.gray(`    ${doc.metadata.description}`));
-          }
-          if (doc.metadata.tags && doc.metadata.tags.length > 0) {
-            console.log(source_default.gray(`    Tags: ${doc.metadata.tags.join(", ")}`));
+        for (const sourceKey of sortedSources) {
+          const sourceDocs = sources.get(sourceKey) || [];
+          const sourceUrl = sourceDocs[0]?.sourceUrl;
+          const sourceLabel = sourceKey === "local" ? "Local" : `Import: ${sourceKey}`;
+          if (sourceUrl) {
+            console.log(source_default.magenta.bold(`[${sourceLabel}]`) + source_default.gray(` ${sourceUrl}`));
+          } else {
+            console.log(source_default.magenta.bold(`[${sourceLabel}]`));
+          }
+          const folders = /* @__PURE__ */ new Map();
+          const rootDocs = [];
+          for (const doc of sourceDocs) {
+            const parts = doc.name.split("/");
+            if (parts.length === 1) {
+              rootDocs.push(doc);
+            } else {
+              const folder = parts.slice(0, -1).join("/");
+              if (!folders.has(folder)) {
+                folders.set(folder, []);
+              }
+              folders.get(folder)?.push(doc);
+            }
           }
-        }
-        console.log();
-      }
-      if (rootDocs.length > 0) {
-        rootDocs.sort((a, b) => a.metadata.title.localeCompare(b.metadata.title));
-        for (const doc of rootDocs) {
-          console.log(source_default.white(`${doc.metadata.title}`));
-          if (doc.metadata.description) {
-            console.log(source_default.gray(`  ${doc.metadata.description}`));
+          const sortedFolders = Array.from(folders.keys()).sort();
+          for (const folder of sortedFolders) {
+            console.log(source_default.cyan.bold(`  ${folder}/`));
+            const folderDocs = folders.get(folder)?.sort((a, b) => (a.metadata.title || "").localeCompare(b.metadata.title || ""));
+            for (const doc of folderDocs || []) {
+              console.log(source_default.white(`    ${doc.metadata.title || doc.name}`));
+              if (doc.metadata.description) {
+                console.log(source_default.gray(`      ${doc.metadata.description}`));
+              }
+            }
           }
-          if (doc.metadata.tags && doc.metadata.tags.length > 0) {
-            console.log(source_default.gray(`  Tags: ${doc.metadata.tags.join(", ")}`));
+          if (rootDocs.length > 0) {
+            rootDocs.sort((a, b) => (a.metadata.title || "").localeCompare(b.metadata.title || ""));
+            for (const doc of rootDocs) {
+              console.log(source_default.white(`  ${doc.metadata.title || doc.name}`));
+              if (doc.metadata.description) {
+                console.log(source_default.gray(`    ${doc.metadata.description}`));
+              }
+            }
           }
           console.log();
         }
       }
+    } catch (error48) {
+      console.error(
+        source_default.red("Error listing documentation:"),
+        error48 instanceof Error ? error48.message : String(error48)
+      );
+      process.exit(1);
     }
-  } catch (error48) {
-    console.error(source_default.red("Error listing documentation:"), error48 instanceof Error ? error48.message : String(error48));
-    process.exit(1);
   }
-});
+);
 var viewCommand2 = new Command("view").description("View a documentation file").argument("<name>", "Document name (filename or title or path)").option("--plain", "Plain text output for AI").option("--info", "Show document stats (size, tokens, headings) without content").option("--toc", "Show table of contents only").option("--section <title>", "Show specific section by heading title or number (e.g., '2. Overview' or '2')").option("--smart", "Smart mode: auto-return full content if small, or stats+TOC if large (>2000 tokens)").action(
   async (name, options2) => {
     try {
@@ -96471,8 +96599,9 @@ async function resolveDocPath2(name) {
 async function handleListDocs(args2) {
   const input = listDocsSchema.parse(args2);
   await ensureDocsDir2();
-  const mdFiles = await getAllMdFiles2(DOCS_DIR4);
-  if (mdFiles.length === 0) {
+  const projectRoot = process.cwd();
+  const allDocs = await listAllDocs(projectRoot);
+  if (allDocs.length === 0) {
     return successResponse({
       count: 0,
       docs: [],
@@ -96480,22 +96609,29 @@ async function handleListDocs(args2) {
     });
   }
   const docs = [];
-  for (const file3 of mdFiles) {
-    const fileContent = await readFile21(join33(DOCS_DIR4, file3), "utf-8");
-    const { data, content } = (0, import_gray_matter9.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 readFile21(doc.fullPath, "utf-8");
+      const { data, content } = (0, import_gray_matter9.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,
@@ -96803,7 +96939,7 @@ async function handleGetGuideline(args2) {
 import { existsSync as existsSync29 } from "node:fs";
 import { mkdir as mkdir18, writeFile as writeFile16 } from "node:fs/promises";
 import { join as join34 } from "node:path";
-var TEMPLATES_DIR2 = join34(process.cwd(), ".knowns", "templates");
+var TEMPLATES_DIR3 = join34(process.cwd(), ".knowns", "templates");
 var listTemplatesSchema = external_exports.object({});
 var getTemplateSchema = external_exports.object({
   name: external_exports.string()
@@ -96896,30 +97032,45 @@ var templateTools = [
 ];
 async function handleListTemplates(_args) {
   listTemplatesSchema.parse(_args);
-  if (!existsSync29(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(join34(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
@@ -96930,11 +97081,11 @@ async function handleListTemplates(_args) {
 }
 async function handleGetTemplate(args2) {
   const input = getTemplateSchema.parse(args2);
-  if (!existsSync29(TEMPLATES_DIR2)) {
+  if (!existsSync29(TEMPLATES_DIR3)) {
     return errorResponse("No templates directory found");
   }
   try {
-    const template = await loadTemplateByName(input.name, TEMPLATES_DIR2);
+    const template = await loadTemplateByName(input.name, TEMPLATES_DIR3);
     if (!template) {
       return errorResponse(`Template not found: ${input.name}`);
     }
@@ -96970,11 +97121,11 @@ async function handleGetTemplate(args2) {
 async function handleRunTemplate(args2) {
   const input = runTemplateSchema.parse(args2);
   const dryRun = input.dryRun !== false;
-  if (!existsSync29(TEMPLATES_DIR2)) {
+  if (!existsSync29(TEMPLATES_DIR3)) {
     return errorResponse("No templates directory found");
   }
   try {
-    const template = await loadTemplateByName(input.name, TEMPLATES_DIR2);
+    const template = await loadTemplateByName(input.name, TEMPLATES_DIR3);
     if (!template) {
       return errorResponse(`Template not found: ${input.name}`);
     }
@@ -97022,10 +97173,10 @@ async function handleRunTemplate(args2) {
 async function handleCreateTemplate(args2) {
   const input = createTemplateSchema.parse(args2);
   try {
-    if (!existsSync29(TEMPLATES_DIR2)) {
-      await mkdir18(TEMPLATES_DIR2, { recursive: true });
+    if (!existsSync29(TEMPLATES_DIR3)) {
+      await mkdir18(TEMPLATES_DIR3, { recursive: true });
     }
-    const templateDir = join34(TEMPLATES_DIR2, input.name);
+    const templateDir = join34(TEMPLATES_DIR3, input.name);
     if (existsSync29(templateDir)) {
       return errorResponse(`Template "${input.name}" already exists`);
     }
@@ -97645,7 +97796,7 @@ function showConfigInfo() {
 import { existsSync as existsSync33 } from "node:fs";
 import { mkdir as mkdir19, writeFile as writeFile17 } from "node:fs/promises";
 import { join as join38 } from "node:path";
-var TEMPLATES_DIR3 = ".knowns/templates";
+var TEMPLATES_DIR4 = ".knowns/templates";
 function getProjectRoot3() {
   const projectRoot = findProjectRoot();
   if (!projectRoot) {
@@ -97656,7 +97807,7 @@ function getProjectRoot3() {
   return projectRoot;
 }
 function getTemplatesDir(projectRoot) {
-  return join38(projectRoot, TEMPLATES_DIR3);
+  return join38(projectRoot, TEMPLATES_DIR4);
 }
 async function ensureTemplatesDir(projectRoot) {
   const templatesDir = getTemplatesDir(projectRoot);
@@ -97666,20 +97817,16 @@ async function ensureTemplatesDir(projectRoot) {
   return templatesDir;
 }
 var templateCommand = new Command("template").description("Manage code generation templates").enablePositionalOptions();
-var listCommand4 = new Command("list").description("List available templates").option("--plain", "Plain text output for AI").action(async (options2) => {
+var listCommand4 = new Command("list").description("List available templates (local + imported)").option("--plain", "Plain text output for AI").option("--local", "Show only local templates").option("--imported", "Show only imported templates").action(async (options2) => {
   try {
     const projectRoot = getProjectRoot3();
-    const templatesDir = getTemplatesDir(projectRoot);
-    if (!existsSync33(templatesDir)) {
-      if (options2.plain) {
-        console.log("No templates found");
-      } else {
-        console.log(source_default.yellow("No templates found"));
-        console.log(source_default.gray("  Create one with: knowns template create <name>"));
-      }
-      return;
+    const allTemplates = await listAllTemplates(projectRoot);
+    let templates = allTemplates;
+    if (options2.local) {
+      templates = allTemplates.filter((t) => !t.isImported);
+    } else if (options2.imported) {
+      templates = allTemplates.filter((t) => t.isImported);
     }
-    const templates = await listTemplates(templatesDir);
     if (templates.length === 0) {
       if (options2.plain) {
         console.log("No templates found");
@@ -97689,21 +97836,88 @@ var listCommand4 = new Command("list").description("List available templates").o
       }
       return;
     }
+    const templatesWithDesc = [];
+    for (const t of templates) {
+      try {
+        const loaded = await listTemplates(join38(t.path, ".."));
+        const match2 = loaded.find((l) => l.name === t.name);
+        templatesWithDesc.push({
+          ref: t.ref,
+          name: t.name,
+          source: t.source,
+          sourceUrl: t.sourceUrl,
+          isImported: t.isImported,
+          description: match2?.description || "No description"
+        });
+      } catch {
+        templatesWithDesc.push({
+          ref: t.ref,
+          name: t.name,
+          source: t.source,
+          sourceUrl: t.sourceUrl,
+          isImported: t.isImported,
+          description: "No description"
+        });
+      }
+    }
     if (options2.plain) {
-      for (const template of templates) {
-        console.log(`${template.name} - ${template.description || "No description"}`);
+      const sources = /* @__PURE__ */ new Map();
+      for (const t of templatesWithDesc) {
+        const sourceKey = t.isImported ? `[${t.source}]` : "[local]";
+        if (!sources.has(sourceKey)) {
+          sources.set(sourceKey, []);
+        }
+        sources.get(sourceKey)?.push(t);
+      }
+      const sortedSources = Array.from(sources.keys()).sort((a, b) => {
+        if (a === "[local]") return -1;
+        if (b === "[local]") return 1;
+        return a.localeCompare(b);
+      });
+      for (const sourceKey of sortedSources) {
+        const sourceTemplates = sources.get(sourceKey) || [];
+        const sourceUrl = sourceTemplates[0]?.sourceUrl;
+        if (sourceUrl) {
+          console.log(`${sourceKey} (${sourceUrl})`);
+        } else {
+          console.log(sourceKey);
+        }
+        for (const t of sourceTemplates) {
+          console.log(`  ${t.name} - ${t.description}`);
+        }
       }
     } else {
       console.log(source_default.bold("\nTemplates:\n"));
-      const maxNameLen = Math.max(...templates.map((t) => t.name.length), 4);
-      console.log(source_default.gray(`${"Name".padEnd(maxNameLen + 2)}Description`));
-      console.log(source_default.gray("\u2500".repeat(60)));
-      for (const template of templates) {
-        const name = source_default.cyan(template.name.padEnd(maxNameLen + 2));
-        const desc = template.description || source_default.gray("No description");
-        console.log(`${name}${desc}`);
+      const sources = /* @__PURE__ */ new Map();
+      for (const t of templatesWithDesc) {
+        const sourceKey = t.isImported ? t.source : "local";
+        if (!sources.has(sourceKey)) {
+          sources.set(sourceKey, []);
+        }
+        sources.get(sourceKey)?.push(t);
+      }
+      const sortedSources = Array.from(sources.keys()).sort((a, b) => {
+        if (a === "local") return -1;
+        if (b === "local") return 1;
+        return a.localeCompare(b);
+      });
+      for (const sourceKey of sortedSources) {
+        const sourceTemplates = sources.get(sourceKey) || [];
+        const sourceUrl = sourceTemplates[0]?.sourceUrl;
+        const sourceLabel = sourceKey === "local" ? "Local" : `Import: ${sourceKey}`;
+        if (sourceUrl) {
+          console.log(source_default.magenta.bold(`[${sourceLabel}]`) + source_default.gray(` ${sourceUrl}`));
+        } else {
+          console.log(source_default.magenta.bold(`[${sourceLabel}]`));
+        }
+        const maxNameLen = Math.max(...sourceTemplates.map((t) => t.name.length), 4);
+        for (const t of sourceTemplates) {
+          const name = source_default.cyan(t.name.padEnd(maxNameLen + 2));
+          const desc = t.description || source_default.gray("No description");
+          console.log(`  ${name}${desc}`);
+        }
+        console.log();
       }
-      console.log();
     }
   } catch (error48) {
     console.error(source_default.red("Error:"), error48 instanceof Error ? error48.message : String(error48));
@@ -97831,7 +98045,7 @@ export function {{camelCase name}}() {
     await writeFile17(join38(templateDir, "example.ts.hbs"), exampleTemplate, "utf-8");
     console.log();
     console.log(source_default.green(`\u2713 Created template: ${name}`));
-    console.log(source_default.gray(`  Location: ${TEMPLATES_DIR3}/${name}/`));
+    console.log(source_default.gray(`  Location: ${TEMPLATES_DIR4}/${name}/`));
     console.log();
     console.log(source_default.cyan("Files created:"));
     console.log(source_default.gray("  - _template.yaml (config)"));
@@ -98636,7 +98850,7 @@ async function notifyCliUpdate(options2) {
 // package.json
 var package_default = {
   name: "knowns",
-  version: "0.10.0",
+  version: "0.10.2",
   description: "AI-native task and documentation management for dev teams",
   module: "index.ts",
   type: "module",