knowns 0.10.3 → 0.10.5

package/dist/mcp/server.js

@@ -10289,25 +10289,25 @@ 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";
+import { existsSync as existsSync5 } from "node:fs";
+import { mkdir as mkdir3, readFile as readFile4, writeFile as writeFile3 } from "node:fs/promises";
+import { dirname as dirname2, join as join8 } from "node:path";
 function getKnownsDir(projectRoot) {
-  return join7(projectRoot, ".knowns");
+  return join8(projectRoot, ".knowns");
 }
 function getConfigPath(projectRoot) {
-  return join7(getKnownsDir(projectRoot), CONFIG_FILE);
+  return join8(getKnownsDir(projectRoot), CONFIG_FILE);
 }
 function getImportsDir(projectRoot) {
-  return join7(getKnownsDir(projectRoot), IMPORTS_DIR);
+  return join8(getKnownsDir(projectRoot), IMPORTS_DIR);
 }
 async function readConfig(projectRoot) {
   const configPath = getConfigPath(projectRoot);
-  if (!existsSync4(configPath)) {
+  if (!existsSync5(configPath)) {
     return {};
   }
   try {
-    const content = await readFile3(configPath, "utf-8");
+    const content = await readFile4(configPath, "utf-8");
     return JSON.parse(content);
   } catch {
     return {};
@@ -13333,7 +13333,7 @@ var require_util2 = __commonJS({
       return path2;
     }
     exports2.normalize = normalize2;
-    function join19(aRoot, aPath) {
+    function join20(aRoot, aPath) {
       if (aRoot === "") {
         aRoot = ".";
       }
@@ -13365,7 +13365,7 @@ var require_util2 = __commonJS({
       }
       return joined;
     }
-    exports2.join = join19;
+    exports2.join = join20;
     exports2.isAbsolute = function(aPath) {
       return aPath.charAt(0) === "/" || urlRegexp.test(aPath);
     };
@@ -13538,7 +13538,7 @@ var require_util2 = __commonJS({
             parsed.path = parsed.path.substring(0, index + 1);
           }
         }
-        sourceURL = join19(urlGenerate(parsed), sourceURL);
+        sourceURL = join20(urlGenerate(parsed), sourceURL);
       }
       return normalize2(sourceURL);
     }
@@ -28653,9 +28653,9 @@ var require_prompts3 = __commonJS({
 });
 
 // src/mcp/server.ts
-import { existsSync as existsSync14 } from "node:fs";
-import { readFile as readFile9 } from "node:fs/promises";
-import { join as join18 } from "node:path";
+import { existsSync as existsSync15 } from "node:fs";
+import { readFile as readFile10 } from "node:fs/promises";
+import { join as join19 } from "node:path";
 
 // node_modules/zod/v3/helpers/util.js
 var util;
@@ -50174,7 +50174,7 @@ var FileStore = class {
     }
     const oldParent = task.parent;
     const newParent = updates.parent;
-    if (oldParent !== newParent) {
+    if ("parent" in updates && oldParent !== newParent) {
       if (oldParent) {
         await this.removeSubtask(oldParent, id);
       }
@@ -50422,6 +50422,11 @@ function findProjectRoot(startPath = process.cwd()) {
   return null;
 }
 
+// src/utils/normalize-id.ts
+function normalizeTaskId(input) {
+  return input.replace(/^task-/i, "");
+}
+
 // src/utils/index.ts
 function normalizePath(filePath) {
   return filePath.replace(/\\/g, "/");
@@ -50805,9 +50810,10 @@ async function handleCreateTask(args, fileStore2) {
 }
 async function handleGetTask(args, fileStore2) {
   const input = getTaskSchema.parse(args);
-  const task = await fileStore2.getTask(input.taskId);
+  const taskId = normalizeTaskId(input.taskId);
+  const task = await fileStore2.getTask(taskId);
   if (!task) {
-    return errorResponse(`Task ${input.taskId} not found`);
+    return errorResponse(`Task ${taskId} not found`);
   }
   const linkedDocs = await fetchLinkedDocs(task);
   return successResponse({
@@ -50830,9 +50836,10 @@ async function handleGetTask(args, fileStore2) {
 }
 async function handleUpdateTask(args, fileStore2) {
   const input = updateTaskSchema.parse(args);
-  const currentTask = await fileStore2.getTask(input.taskId);
+  const taskId = normalizeTaskId(input.taskId);
+  const currentTask = await fileStore2.getTask(taskId);
   if (!currentTask) {
-    return errorResponse(`Task ${input.taskId} not found`);
+    return errorResponse(`Task ${taskId} not found`);
   }
   const updates = {};
   if (input.title) updates.title = input.title;
@@ -50893,7 +50900,7 @@ async function handleUpdateTask(args, fileStore2) {
     const separator = existingNotes ? "\n\n" : "";
     updates.implementationNotes = existingNotes + separator + input.appendNotes;
   }
-  const task = await fileStore2.updateTask(input.taskId, updates);
+  const task = await fileStore2.updateTask(taskId, updates);
   await notifyTaskUpdate(task.id);
   return successResponse({
     task: {
@@ -50953,6 +50960,9 @@ async function handleSearchTasks(args, fileStore2) {
 }
 
 // src/mcp/handlers/time.ts
+import { existsSync as existsSync4 } from "node:fs";
+import { readFile as readFile3, writeFile as writeFile2 } from "node:fs/promises";
+import { join as join7 } from "node:path";
 var startTimeSchema = external_exports3.object({
   taskId: external_exports3.string()
 });
@@ -51034,93 +51044,117 @@ var timeTools = [
     }
   }
 ];
+async function loadTimeData(projectRoot) {
+  const timePath = join7(projectRoot, ".knowns", "time.json");
+  if (!existsSync4(timePath)) {
+    return { active: [] };
+  }
+  const content = await readFile3(timePath, "utf-8");
+  const data = JSON.parse(content);
+  if (data.active && !Array.isArray(data.active)) {
+    return { active: [data.active] };
+  }
+  if (data.active === null) {
+    return { active: [] };
+  }
+  return data;
+}
+async function saveTimeData(projectRoot, data) {
+  const timePath = join7(projectRoot, ".knowns", "time.json");
+  await writeFile2(timePath, JSON.stringify(data, null, 2), "utf-8");
+}
 async function handleStartTime(args, fileStore2) {
   const input = startTimeSchema.parse(args);
-  const task = await fileStore2.getTask(input.taskId);
+  const taskId = normalizeTaskId(input.taskId);
+  const task = await fileStore2.getTask(taskId);
   if (!task) {
-    return errorResponse(`Task ${input.taskId} not found`);
+    return errorResponse(`Task ${taskId} not found`);
   }
-  const activeEntry = task.timeEntries.find((e) => !e.endedAt);
-  if (activeEntry) {
-    return errorResponse("Time tracking already active for this task");
+  const data = await loadTimeData(fileStore2.projectRoot);
+  const existingTimer = data.active.find((t) => t.taskId === taskId);
+  if (existingTimer) {
+    return errorResponse(`Timer already running for task ${taskId}`);
   }
-  const newEntry = {
-    id: `entry-${Date.now()}`,
-    startedAt: /* @__PURE__ */ new Date(),
-    duration: 0,
-    note: "Started via MCP"
-  };
-  await fileStore2.updateTask(input.taskId, {
-    timeEntries: [...task.timeEntries, newEntry]
-  });
-  await notifyTaskUpdate(input.taskId);
-  await notifyTimeUpdate({
-    taskId: input.taskId,
+  const newTimer = {
+    taskId,
     taskTitle: task.title,
-    startedAt: newEntry.startedAt.toISOString(),
+    startedAt: (/* @__PURE__ */ new Date()).toISOString(),
     pausedAt: null,
     totalPausedMs: 0
-  });
+  };
+  data.active.push(newTimer);
+  await saveTimeData(fileStore2.projectRoot, data);
+  await notifyTaskUpdate(taskId);
+  await notifyTimeUpdate(data.active);
   return successResponse({
-    message: `Started tracking time for task ${input.taskId}`,
-    startedAt: newEntry.startedAt
+    message: `Started tracking time for task ${taskId}`,
+    startedAt: newTimer.startedAt,
+    activeTimers: data.active.length
   });
 }
 async function handleStopTime(args, fileStore2) {
   const input = stopTimeSchema.parse(args);
-  const task = await fileStore2.getTask(input.taskId);
+  const taskId = normalizeTaskId(input.taskId);
+  const task = await fileStore2.getTask(taskId);
   if (!task) {
-    return errorResponse(`Task ${input.taskId} not found`);
-  }
-  const activeIndex = task.timeEntries.findIndex((e) => !e.endedAt);
-  if (activeIndex === -1) {
-    return errorResponse("No active time tracking for this task");
-  }
-  const endTime = /* @__PURE__ */ new Date();
-  const startTime = task.timeEntries[activeIndex].startedAt;
-  const duration3 = Math.floor((endTime.getTime() - new Date(startTime).getTime()) / 1e3);
-  const updatedEntries = [...task.timeEntries];
-  updatedEntries[activeIndex] = {
-    ...updatedEntries[activeIndex],
+    return errorResponse(`Task ${taskId} not found`);
+  }
+  const data = await loadTimeData(fileStore2.projectRoot);
+  const timerIndex = data.active.findIndex((t) => t.taskId === taskId);
+  if (timerIndex === -1) {
+    return errorResponse(`No active timer for task ${taskId}`);
+  }
+  const timer = data.active[timerIndex];
+  const { startedAt, pausedAt, totalPausedMs } = timer;
+  const endTime = pausedAt ? new Date(pausedAt) : /* @__PURE__ */ new Date();
+  const elapsed = endTime.getTime() - new Date(startedAt).getTime() - totalPausedMs;
+  const duration3 = Math.floor(elapsed / 1e3);
+  const newEntry = {
+    id: `te-${Date.now()}-${taskId}`,
+    startedAt: new Date(startedAt),
     endedAt: endTime,
     duration: duration3
   };
   const newTimeSpent = task.timeSpent + duration3;
-  await fileStore2.updateTask(input.taskId, {
-    timeEntries: updatedEntries,
+  await fileStore2.updateTask(taskId, {
+    timeEntries: [...task.timeEntries, newEntry],
     timeSpent: newTimeSpent
   });
-  await notifyTaskUpdate(input.taskId);
-  await notifyTimeUpdate(null);
+  data.active.splice(timerIndex, 1);
+  await saveTimeData(fileStore2.projectRoot, data);
+  await notifyTaskUpdate(taskId);
+  await notifyTimeUpdate(data.active.length > 0 ? data.active : null);
   return successResponse({
-    message: `Stopped tracking time for task ${input.taskId}`,
+    message: `Stopped tracking time for task ${taskId}`,
     duration: formatDuration(duration3),
-    totalTime: formatDuration(newTimeSpent)
+    totalTime: formatDuration(newTimeSpent),
+    activeTimers: data.active.length
   });
 }
 async function handleAddTime(args, fileStore2) {
   const input = addTimeSchema.parse(args);
-  const task = await fileStore2.getTask(input.taskId);
+  const taskId = normalizeTaskId(input.taskId);
+  const task = await fileStore2.getTask(taskId);
   if (!task) {
-    return errorResponse(`Task ${input.taskId} not found`);
+    return errorResponse(`Task ${taskId} not found`);
   }
   const duration3 = parseDuration(input.duration);
   const startDate = input.date ? new Date(input.date) : /* @__PURE__ */ new Date();
   const newEntry = {
-    id: `entry-${Date.now()}`,
+    id: `te-${Date.now()}`,
     startedAt: startDate,
     endedAt: new Date(startDate.getTime() + duration3 * 1e3),
     duration: duration3,
     note: input.note || "Added via MCP"
   };
   const newTimeSpent = task.timeSpent + duration3;
-  await fileStore2.updateTask(input.taskId, {
+  await fileStore2.updateTask(taskId, {
     timeEntries: [...task.timeEntries, newEntry],
     timeSpent: newTimeSpent
   });
-  await notifyTaskUpdate(input.taskId);
+  await notifyTaskUpdate(taskId);
   return successResponse({
-    message: `Added ${formatDuration(duration3)} to task ${input.taskId}`,
+    message: `Added ${formatDuration(duration3)} to task ${taskId}`,
     totalTime: formatDuration(newTimeSpent)
   });
 }
@@ -51242,9 +51276,9 @@ async function handleGetBoard(fileStore2) {
 }
 
 // src/mcp/handlers/doc.ts
-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";
+import { existsSync as existsSync10 } from "node:fs";
+import { mkdir as mkdir7, readFile as readFile5, readdir as readdir5, writeFile as writeFile4 } from "node:fs/promises";
+import { join as join14 } from "node:path";
 
 // src/utils/markdown-toc.ts
 function extractToc(markdown) {
@@ -51420,25 +51454,25 @@ var ImportError = class extends Error {
 init_config();
 
 // src/import/validator.ts
-import { existsSync as existsSync5 } from "node:fs";
+import { existsSync as existsSync6 } from "node:fs";
 import { readdir as readdir2 } from "node:fs/promises";
-import { join as join8 } from "node:path";
+import { join as join9 } from "node:path";
 var KNOWNS_DIR = ".knowns";
 var TEMPLATES_DIR = "templates";
 var DOCS_DIR = "docs";
 async function validateKnownsDir(dir) {
-  const knownsPath = join8(dir, KNOWNS_DIR);
-  if (!existsSync5(knownsPath)) {
+  const knownsPath = join9(dir, KNOWNS_DIR);
+  if (!existsSync6(knownsPath)) {
     return {
       valid: false,
       error: "Source does not contain .knowns/ directory",
       hint: "Only Knowns-enabled projects can be imported"
     };
   }
-  const templatesPath = join8(knownsPath, TEMPLATES_DIR);
-  const docsPath = join8(knownsPath, DOCS_DIR);
-  const hasTemplates = existsSync5(templatesPath);
-  const hasDocs = existsSync5(docsPath);
+  const templatesPath = join9(knownsPath, TEMPLATES_DIR);
+  const docsPath = join9(knownsPath, DOCS_DIR);
+  const hasTemplates = existsSync6(templatesPath);
+  const hasDocs = existsSync6(docsPath);
   if (!hasTemplates && !hasDocs) {
     return {
       valid: false,
@@ -51477,14 +51511,14 @@ async function validateKnownsDir(dir) {
 import { randomBytes } from "node:crypto";
 import { rm } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { join as join9 } from "node:path";
+import { join as join10 } from "node:path";
 var ImportProvider = class {
   /**
    * Generate a unique temp directory path
    */
   getTempDir() {
     const id = randomBytes(8).toString("hex");
-    return join9(tmpdir(), `knowns-import-${id}`);
+    return join10(tmpdir(), `knowns-import-${id}`);
   }
   /**
    * Cleanup temp directory
@@ -51647,9 +51681,9 @@ var gitProvider = new GitProvider();
 
 // src/import/providers/npm.ts
 import { spawnSync as spawnSync2 } from "node:child_process";
-import { existsSync as existsSync6 } from "node:fs";
+import { existsSync as existsSync7 } 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";
+import { join as join11 } from "node:path";
 function isNpmAvailable() {
   try {
     const result = spawnSync2("npm", ["--version"], { encoding: "utf-8" });
@@ -51725,7 +51759,7 @@ var NpmProvider = class extends ImportProvider {
       if (!tarball) {
         throw new Error("No tarball created by npm pack");
       }
-      const tarballPath = join10(tempDir, tarball);
+      const tarballPath = join11(tempDir, tarball);
       const extractResult = spawnSync2("tar", ["-xzf", tarball], {
         cwd: tempDir,
         encoding: "utf-8"
@@ -51733,8 +51767,8 @@ var NpmProvider = class extends ImportProvider {
       if (extractResult.status !== 0) {
         throw new Error(extractResult.stderr || "tar extraction failed");
       }
-      const packageDir = join10(tempDir, "package");
-      if (!existsSync6(packageDir)) {
+      const packageDir = join11(tempDir, "package");
+      if (!existsSync7(packageDir)) {
         throw new Error("Extracted package directory not found");
       }
       const extractedDir = this.getTempDir();
@@ -51764,10 +51798,10 @@ var NpmProvider = class extends ImportProvider {
   async getMetadata(tempDir, options2) {
     const metadata = {};
     try {
-      const packageJsonPath = join10(tempDir, "package.json");
-      if (existsSync6(packageJsonPath)) {
-        const { readFile: readFile10 } = await import("node:fs/promises");
-        const content = await readFile10(packageJsonPath, "utf-8");
+      const packageJsonPath = join11(tempDir, "package.json");
+      if (existsSync7(packageJsonPath)) {
+        const { readFile: readFile11 } = await import("node:fs/promises");
+        const content = await readFile11(packageJsonPath, "utf-8");
         const pkg = JSON.parse(content);
         if (pkg.version) {
           metadata.version = pkg.version;
@@ -51784,15 +51818,15 @@ var NpmProvider = class extends ImportProvider {
 var npmProvider = new NpmProvider();
 
 // src/import/providers/local.ts
-import { existsSync as existsSync7, statSync } from "node:fs";
+import { existsSync as existsSync8, 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";
+import { isAbsolute, join as join12, resolve } from "node:path";
 var KNOWNS_DIR3 = ".knowns";
 function resolvePath(source) {
   let resolved = source;
   if (resolved.startsWith("~")) {
-    resolved = join11(homedir(), resolved.slice(1));
+    resolved = join12(homedir(), resolved.slice(1));
   }
   if (!isAbsolute(resolved)) {
     resolved = resolve(resolved);
@@ -51803,7 +51837,7 @@ var LocalProvider = class extends ImportProvider {
   type = "local";
   async validate(source, _options) {
     const resolvedPath = resolvePath(source);
-    if (!existsSync7(resolvedPath)) {
+    if (!existsSync8(resolvedPath)) {
       return {
         valid: false,
         error: `Path not found: ${source}`,
@@ -51820,8 +51854,8 @@ var LocalProvider = class extends ImportProvider {
     let knownsPath;
     if (resolvedPath.endsWith(KNOWNS_DIR3)) {
       knownsPath = resolvedPath;
-    } else if (existsSync7(join11(resolvedPath, KNOWNS_DIR3))) {
-      knownsPath = join11(resolvedPath, KNOWNS_DIR3);
+    } else if (existsSync8(join12(resolvedPath, KNOWNS_DIR3))) {
+      knownsPath = join12(resolvedPath, KNOWNS_DIR3);
     } else {
       return {
         valid: false,
@@ -51834,16 +51868,16 @@ var LocalProvider = class extends ImportProvider {
   }
   async fetch(source, options2) {
     const resolvedPath = resolvePath(source);
-    if (!existsSync7(resolvedPath)) {
+    if (!existsSync8(resolvedPath)) {
       throw new ImportError(`Path not found: ${source}`, "SOURCE_NOT_FOUND" /* SOURCE_NOT_FOUND */);
     }
     let sourceKnowns;
     if (resolvedPath.endsWith(KNOWNS_DIR3)) {
       sourceKnowns = resolvedPath;
     } else {
-      sourceKnowns = join11(resolvedPath, KNOWNS_DIR3);
+      sourceKnowns = join12(resolvedPath, KNOWNS_DIR3);
     }
-    if (!existsSync7(sourceKnowns)) {
+    if (!existsSync8(sourceKnowns)) {
       throw new ImportError(
         "Source does not contain .knowns/ directory",
         "NO_KNOWNS_DIR" /* NO_KNOWNS_DIR */,
@@ -51879,7 +51913,7 @@ var LocalProvider = class extends ImportProvider {
    */
   async createSymlink(source, target) {
     const resolvedSource = resolvePath(source);
-    if (existsSync7(target)) {
+    if (existsSync8(target)) {
       const { rm: rm3 } = await import("node:fs/promises");
       await rm3(target, { recursive: true, force: true });
     }
@@ -51906,16 +51940,16 @@ init_config();
 
 // src/import/resolver.ts
 init_config();
-import { existsSync as existsSync8 } from "node:fs";
+import { existsSync as existsSync9 } from "node:fs";
 import { readdir as readdir4 } from "node:fs/promises";
-import { join as join12 } from "node:path";
+import { join as join13 } 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)) {
+  const localTemplates = join13(projectRoot, KNOWNS_DIR4, TEMPLATES_DIR2);
+  if (existsSync9(localTemplates)) {
     results.push({
       path: localTemplates,
       source: "local",
@@ -51923,13 +51957,13 @@ async function getTemplateDirectories(projectRoot) {
     });
   }
   const importsDir = getImportsDir(projectRoot);
-  if (existsSync8(importsDir)) {
+  if (existsSync9(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)) {
+        const importedTemplates = join13(importsDir, entry.name, TEMPLATES_DIR2);
+        if (existsSync9(importedTemplates)) {
           results.push({
             path: importedTemplates,
             source: entry.name,
@@ -51944,8 +51978,8 @@ async function getTemplateDirectories(projectRoot) {
 }
 async function getDocDirectories(projectRoot) {
   const results = [];
-  const localDocs = join12(projectRoot, KNOWNS_DIR4, DOCS_DIR2);
-  if (existsSync8(localDocs)) {
+  const localDocs = join13(projectRoot, KNOWNS_DIR4, DOCS_DIR2);
+  if (existsSync9(localDocs)) {
     results.push({
       path: localDocs,
       source: "local",
@@ -51953,13 +51987,13 @@ async function getDocDirectories(projectRoot) {
     });
   }
   const importsDir = getImportsDir(projectRoot);
-  if (existsSync8(importsDir)) {
+  if (existsSync9(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 (existsSync8(importedDocs)) {
+        const importedDocs = join13(importsDir, entry.name, DOCS_DIR2);
+        if (existsSync9(importedDocs)) {
           results.push({
             path: importedDocs,
             source: entry.name,
@@ -51979,8 +52013,8 @@ async function parseImportPath(projectRoot, refPath) {
   }
   const potentialImport = parts[0];
   const importsDir = getImportsDir(projectRoot);
-  const importPath = join12(importsDir, potentialImport);
-  if (existsSync8(importPath)) {
+  const importPath = join13(importsDir, potentialImport);
+  if (existsSync9(importPath)) {
     return {
       importName: potentialImport,
       subPath: parts.slice(1).join("/")
@@ -51988,6 +52022,33 @@ async function parseImportPath(projectRoot, refPath) {
   }
   return { importName: null, subPath: refPath };
 }
+async function resolveTemplate(projectRoot, templateName) {
+  const { importName, subPath } = await parseImportPath(projectRoot, templateName);
+  if (importName) {
+    const importedTemplates = join13(getImportsDir(projectRoot), importName, TEMPLATES_DIR2);
+    const templatePath = join13(importedTemplates, subPath);
+    if (existsSync9(templatePath)) {
+      return {
+        path: templatePath,
+        source: importName,
+        isImported: true
+      };
+    }
+    return null;
+  }
+  const directories = await getTemplateDirectories(projectRoot);
+  for (const dir of directories) {
+    const templatePath = join13(dir.path, templateName);
+    if (existsSync9(templatePath)) {
+      return {
+        path: templatePath,
+        source: dir.source,
+        isImported: dir.isImported
+      };
+    }
+  }
+  return null;
+}
 async function resolveDoc(projectRoot, docPath) {
   return resolveDocWithContext(projectRoot, docPath);
 }
@@ -51995,9 +52056,9 @@ async function resolveDocWithContext(projectRoot, docPath, context) {
   const { importName, subPath } = await parseImportPath(projectRoot, docPath);
   const normalizedSubPath = subPath.endsWith(".md") ? subPath : `${subPath}.md`;
   if (importName) {
-    const importedDocs = join12(getImportsDir(projectRoot), importName, DOCS_DIR2);
-    const fullPath = join12(importedDocs, normalizedSubPath);
-    if (existsSync8(fullPath)) {
+    const importedDocs = join13(getImportsDir(projectRoot), importName, DOCS_DIR2);
+    const fullPath = join13(importedDocs, normalizedSubPath);
+    if (existsSync9(fullPath)) {
       return {
         path: fullPath,
         source: importName,
@@ -52010,8 +52071,8 @@ async function resolveDocWithContext(projectRoot, docPath, context) {
   if (context) {
     const contextDir = directories.find((d) => d.source === context && d.isImported);
     if (contextDir) {
-      const fullPath = join12(contextDir.path, normalizedSubPath);
-      if (existsSync8(fullPath)) {
+      const fullPath = join13(contextDir.path, normalizedSubPath);
+      if (existsSync9(fullPath)) {
         return {
           path: fullPath,
           source: contextDir.source,
@@ -52023,8 +52084,8 @@ async function resolveDocWithContext(projectRoot, docPath, context) {
   const importDirs = directories.filter((d) => d.isImported && d.source !== context);
   const localDirs = directories.filter((d) => !d.isImported);
   for (const dir of importDirs) {
-    const fullPath = join12(dir.path, normalizedSubPath);
-    if (existsSync8(fullPath)) {
+    const fullPath = join13(dir.path, normalizedSubPath);
+    if (existsSync9(fullPath)) {
       return {
         path: fullPath,
         source: dir.source,
@@ -52033,8 +52094,8 @@ async function resolveDocWithContext(projectRoot, docPath, context) {
     }
   }
   for (const dir of localDirs) {
-    const fullPath = join12(dir.path, normalizedSubPath);
-    if (existsSync8(fullPath)) {
+    const fullPath = join13(dir.path, normalizedSubPath);
+    if (existsSync9(fullPath)) {
       return {
         path: fullPath,
         source: dir.source,
@@ -52061,7 +52122,7 @@ async function listAllTemplates(projectRoot) {
           ref,
           source: dir.source,
           sourceUrl: dir.isImported ? sourceUrlMap.get(dir.source) : void 0,
-          path: join12(dir.path, entry.name),
+          path: join13(dir.path, entry.name),
           isImported: dir.isImported
         });
       }
@@ -52076,7 +52137,7 @@ async function listAllDocs(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);
+    const currentDir = join13(baseDir, relativePath);
     try {
       const entries = await readdir4(currentDir, { withFileTypes: true });
       for (const entry of entries) {
@@ -52092,7 +52153,7 @@ async function listAllDocs(projectRoot) {
             ref,
             source,
             sourceUrl: isImported ? sourceUrlMap.get(source) : void 0,
-            fullPath: join12(currentDir, entry.name),
+            fullPath: join13(currentDir, entry.name),
             isImported
           });
         }
@@ -52132,8 +52193,8 @@ async function validateRefs(projectRoot, content, tasksDir) {
     seen.add(refKey);
     let exists = false;
     if (tasksDir) {
-      const taskPath = join12(tasksDir, `task-${taskId}.md`);
-      exists = existsSync8(taskPath);
+      const taskPath = join13(tasksDir, `task-${taskId}.md`);
+      exists = existsSync9(taskPath);
     }
     results.push({
       ref: `@task-${taskId}`,
@@ -52146,7 +52207,7 @@ async function validateRefs(projectRoot, content, tasksDir) {
 }
 
 // src/mcp/handlers/doc.ts
-var DOCS_DIR3 = join13(process.cwd(), ".knowns", "docs");
+var DOCS_DIR3 = join14(process.cwd(), ".knowns", "docs");
 var listDocsSchema = external_exports3.object({
   tag: external_exports3.string().optional()
 });
@@ -52296,7 +52357,7 @@ var docTools = [
   }
 ];
 async function ensureDocsDir() {
-  if (!existsSync9(DOCS_DIR3)) {
+  if (!existsSync10(DOCS_DIR3)) {
     await mkdir7(DOCS_DIR3, { recursive: true });
   }
 }
@@ -52305,13 +52366,13 @@ function titleToFilename(title) {
 }
 async function getAllMdFiles(dir, basePath = "") {
   const files = [];
-  if (!existsSync9(dir)) {
+  if (!existsSync10(dir)) {
     return files;
   }
   const entries = await readdir5(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const fullPath = join13(dir, entry.name);
-    const relativePath = normalizePath(basePath ? join13(basePath, entry.name) : entry.name);
+    const fullPath = join14(dir, entry.name);
+    const relativePath = normalizePath(basePath ? join14(basePath, entry.name) : entry.name);
     if (entry.isDirectory()) {
       const subFiles = await getAllMdFiles(fullPath, relativePath);
       files.push(...subFiles);
@@ -52324,13 +52385,13 @@ async function getAllMdFiles(dir, basePath = "") {
 async function resolveDocPath(name) {
   await ensureDocsDir();
   let filename = name.endsWith(".md") ? name : `${name}.md`;
-  let filepath = join13(DOCS_DIR3, filename);
-  if (existsSync9(filepath)) {
+  let filepath = join14(DOCS_DIR3, filename);
+  if (existsSync10(filepath)) {
     return { filepath, filename };
   }
   filename = `${titleToFilename(name)}.md`;
-  filepath = join13(DOCS_DIR3, filename);
-  if (existsSync9(filepath)) {
+  filepath = join14(DOCS_DIR3, filename);
+  if (existsSync10(filepath)) {
     return { filepath, filename };
   }
   const allFiles = await getAllMdFiles(DOCS_DIR3);
@@ -52342,7 +52403,7 @@ async function resolveDocPath(name) {
   });
   if (matchingFile) {
     return {
-      filepath: join13(DOCS_DIR3, matchingFile),
+      filepath: join14(DOCS_DIR3, matchingFile),
       filename: matchingFile
     };
   }
@@ -52363,7 +52424,7 @@ async function handleListDocs(args) {
   const docs = [];
   for (const doc of allDocs) {
     try {
-      const fileContent = await readFile4(doc.fullPath, "utf-8");
+      const fileContent = await readFile5(doc.fullPath, "utf-8");
       const { data, content } = (0, import_gray_matter3.default)(fileContent);
       const metadata = data;
       const stats = calculateDocStats(content);
@@ -52396,7 +52457,7 @@ async function handleGetDoc(args) {
   if (!resolved) {
     return errorResponse(`Documentation not found: ${input.path}`);
   }
-  const fileContent = await readFile4(resolved.filepath, "utf-8");
+  const fileContent = await readFile5(resolved.filepath, "utf-8");
   const { data, content } = (0, import_gray_matter3.default)(fileContent);
   const metadata = data;
   if (input.smart) {
@@ -52492,7 +52553,7 @@ async function handleGetDoc(args) {
     });
   }
   const projectRoot = process.cwd();
-  const tasksDir = join13(projectRoot, ".knowns", "tasks");
+  const tasksDir = join14(projectRoot, ".knowns", "tasks");
   const refs = await validateRefs(projectRoot, content, tasksDir);
   const brokenRefs = refs.filter((r) => !r.exists).map((r) => r.ref);
   return successResponse({
@@ -52516,14 +52577,14 @@ async function handleCreateDoc(args) {
   let relativePath = filename;
   if (input.folder) {
     const folderPath = input.folder.replace(/^\/|\/$/g, "");
-    targetDir = join13(DOCS_DIR3, folderPath);
-    relativePath = join13(folderPath, filename);
-    if (!existsSync9(targetDir)) {
+    targetDir = join14(DOCS_DIR3, folderPath);
+    relativePath = join14(folderPath, filename);
+    if (!existsSync10(targetDir)) {
       await mkdir7(targetDir, { recursive: true });
     }
   }
-  const filepath = join13(targetDir, filename);
-  if (existsSync9(filepath)) {
+  const filepath = join14(targetDir, filename);
+  if (existsSync10(filepath)) {
     return errorResponse(`Document already exists: ${relativePath}`);
   }
   const now = (/* @__PURE__ */ new Date()).toISOString();
@@ -52540,7 +52601,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 writeFile3(filepath, fileContent, "utf-8");
+  await writeFile4(filepath, fileContent, "utf-8");
   await notifyDocUpdate(relativePath);
   return successResponse({
     message: `Created documentation: ${relativePath}`,
@@ -52558,7 +52619,7 @@ async function handleUpdateDoc(args) {
   if (!resolved) {
     return errorResponse(`Documentation not found: ${input.path}`);
   }
-  const fileContent = await readFile4(resolved.filepath, "utf-8");
+  const fileContent = await readFile5(resolved.filepath, "utf-8");
   const { data, content } = (0, import_gray_matter3.default)(fileContent);
   const metadata = data;
   if (input.title) metadata.title = input.title;
@@ -52586,7 +52647,7 @@ async function handleUpdateDoc(args) {
 ${input.appendContent}`;
   }
   const newFileContent = import_gray_matter3.default.stringify(updatedContent, metadata);
-  await writeFile3(resolved.filepath, newFileContent, "utf-8");
+  await writeFile4(resolved.filepath, newFileContent, "utf-8");
   await notifyDocUpdate(resolved.filename);
   return successResponse({
     message: sectionUpdated ? `Updated section "${sectionUpdated}" in ${resolved.filename}` : `Updated documentation: ${resolved.filename}`,
@@ -52607,7 +52668,7 @@ async function handleSearchDocs(args) {
   const query = input.query.toLowerCase();
   const results = [];
   for (const file3 of mdFiles) {
-    const fileContent = await readFile4(join13(DOCS_DIR3, file3), "utf-8");
+    const fileContent = await readFile5(join14(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)) {
@@ -52644,7 +52705,7 @@ async function handleSearchDocs(args) {
 }
 
 // src/codegen/renderer.ts
-import { readFile as readFile5 } from "node:fs/promises";
+import { readFile as readFile6 } from "node:fs/promises";
 var import_handlebars = __toESM(require_lib(), 1);
 
 // node_modules/change-case/dist/index.js
@@ -52841,7 +52902,7 @@ function renderString(template, context) {
   return compiled(context);
 }
 async function renderFile(templatePath, context) {
-  const content = await readFile5(templatePath, "utf-8");
+  const content = await readFile6(templatePath, "utf-8");
   return renderString(content, context);
 }
 function renderPath(pathPattern, context) {
@@ -52869,31 +52930,31 @@ function evaluateCondition(condition, context) {
 }
 
 // src/instructions/guidelines/unified/commands-reference.md
-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';
+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{{/if}}\n{{#if cli}}\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## 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';
+var common_mistakes_default = '# Common Mistakes\n\n{{#if cli}}\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{{/if}}\n\n## CRITICAL: Notes vs Append Notes\n\n**NEVER use `notes`/`--notes` for progress updates - it REPLACES all existing notes!**\n\n{{#if cli}}\n```bash\n# \u274C WRONG - Destroys audit trail!\nknowns task edit <id> --notes "Done: feature X"\n\n# \u2705 CORRECT - Preserves history\nknowns task edit <id> --append-notes "Done: feature X"\n```\n{{/if}}\n{{#if mcp}}\n```json\n// \u274C WRONG - Destroys audit trail!\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "notes": "Done: feature X"\n})\n\n// \u2705 CORRECT - Preserves history\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "appendNotes": "Done: feature X"\n})\n```\n{{/if}}\n\n| Field | Behavior |\n|-------|----------|\n{{#if cli}}\n| `--notes` | **REPLACES** all notes (use only for initial setup) |\n| `--append-notes` | **APPENDS** to existing notes (use for progress) |\n{{/if}}\n{{#if mcp}}\n| `notes` | **REPLACES** all notes (use only for initial setup) |\n| `appendNotes` | **APPENDS** to existing notes (use for progress) |\n{{/if}}\n\n---\n\n## Quick Reference\n\n| DON\'T | DO |\n|-------|-----|\n{{#if cli}}\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| `--notes` for progress | `--append-notes` for progress |\n{{/if}}\n{{#if mcp}}\n| Edit .md files directly | Use MCP tools |\n| `notes` for progress | `appendNotes` for progress |\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 cli}}\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| Replaced notes by mistake | Cannot recover - notes are lost. Use `--append-notes` next time |\n{{/if}}\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| Replaced notes by mistake | Cannot recover - notes are lost. Use `appendNotes` next time |\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';
+var context_optimization_default = '# Context Optimization\n\nOptimize your context usage to work more efficiently within token limits.\n\n---\n\n{{#if cli}}\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{{/if}}\n\n## Search Before Read\n\n{{#if cli}}\n### CLI\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{{#if mcp}}\n### 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{{/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 cli}}\n### CLI\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{{#if mcp}}\n### 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{{/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 cli}}\n1. **Always `--plain`** - Never use `--json` unless needed\n2. **Always `--smart`** - Auto-handles doc size\n{{/if}}\n{{#if mcp}}\n1. **Always `smart: true`** - 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';
 
 // src/instructions/guidelines/unified/core-rules.md
-var core_rules_default = '# Core Rules\n\n> These rules are NON-NEGOTIABLE. Violating them leads to data corruption and lost work.\n\n---\n\n## The Golden Rule\n\n{{#if mcp}}\n**If you want to change ANYTHING in a task or doc, use MCP tools. NEVER edit .md files directly.**\n{{else}}\n**If you want to change ANYTHING in a task or doc, use CLI commands. NEVER edit .md files directly.**\n{{/if}}\n\n{{#unless mcp}}\n---\n\n## CRITICAL: The -a Flag Confusion\n\nThe `-a` flag means DIFFERENT things in different commands:\n\n| Command | `-a` Means | NOT This! |\n|---------|------------|-----------|\n| `task create` | `--assignee` (assign user) | ~~acceptance criteria~~ |\n| `task edit` | `--assignee` (assign user) | ~~acceptance criteria~~ |\n| `doc edit` | `--append` (append content) | ~~assignee~~ |\n\n### Acceptance Criteria: Use --ac\n\n```bash\n# WRONG: -a is assignee, NOT acceptance criteria!\nknowns task edit 35 -a "- [ ] Criterion"    # Sets assignee to garbage!\n\n# CORRECT: Use --ac for acceptance criteria\nknowns task edit 35 --ac "Criterion one"\nknowns task create "Title" --ac "Criterion one" --ac "Criterion two"\n```\n{{/unless}}\n\n---\n\n## Quick Reference\n\n| Rule | Description |\n|------|-------------|\n{{#if mcp}}\n| **MCP Tools Only** | Use MCP tools for ALL operations. NEVER edit .md files directly |\n{{else}}\n| **CLI Only** | Use commands for ALL operations. NEVER edit .md files directly |\n{{/if}}\n| **Docs First** | Read project docs BEFORE planning or coding |\n| **Time Tracking** | Start timer when taking task, stop when done |\n| **Plan Approval** | Share plan with user, WAIT for approval before coding |\n| **Check AC After** | Only mark criteria done AFTER completing work |\n\n{{#unless mcp}}\n---\n\n## The --plain Flag\n\n**ONLY for view/list/search commands (NOT create/edit):**\n\n```bash\n# CORRECT\nknowns task <id> --plain\nknowns task list --plain\nknowns doc "path" --plain\nknowns search "query" --plain\n\n# WRONG (create/edit don\'t support --plain)\nknowns task create "Title" --plain       # ERROR!\nknowns task edit <id> -s done --plain    # ERROR!\n```\n{{/unless}}\n\n---\n\n## Reference System\n\nTasks, docs, and templates can reference each other:\n\n| Type | Writing (Input) | Reading (Output) |\n|------|-----------------|------------------|\n| Task | `@task-<id>` | `@.knowns/tasks/task-<id>` |\n| Doc | `@doc/<path>` | `@.knowns/docs/<path>.md` |\n| Template | `@template/<name>` | `@.knowns/templates/<name>` |\n\n**Always follow refs recursively** to gather complete context before planning.\n\n---\n\n## Subtasks\n\n{{#if mcp}}\n```json\nmcp__knowns__create_task({\n  "title": "Subtask title",\n  "parent": "parent-task-id"\n})\n```\n\n**CRITICAL:** Use raw ID (string) for all MCP tool calls.\n{{else}}\n```bash\nknowns task create "Subtask title" --parent 48\n```\n\n**CRITICAL:** Use raw ID for `--parent`:\n```bash\n# CORRECT\nknowns task create "Title" --parent 48\n\n# WRONG\nknowns task create "Title" --parent task-48\n```\n{{/if}}\n';
+var core_rules_default = '# Core Rules\n\n> These rules are NON-NEGOTIABLE. Violating them leads to data corruption and lost work.\n\n---\n\n## The Golden Rule\n\n{{#if mcp}}\n{{#if cli}}\n**If you want to change ANYTHING in a task or doc, use MCP tools (preferred) or CLI commands (fallback). NEVER edit .md files directly.**\n{{else}}\n**If you want to change ANYTHING in a task or doc, use MCP tools. NEVER edit .md files directly.**\n{{/if}}\n{{else}}\n{{#if cli}}\n**If you want to change ANYTHING in a task or doc, use CLI commands. NEVER edit .md files directly.**\n{{/if}}\n{{/if}}\n\n{{#if cli}}\n---\n\n## CRITICAL: The -a Flag Confusion\n\nThe `-a` flag means DIFFERENT things in different commands:\n\n| Command | `-a` Means | NOT This! |\n|---------|------------|-----------|\n| `task create` | `--assignee` (assign user) | ~~acceptance criteria~~ |\n| `task edit` | `--assignee` (assign user) | ~~acceptance criteria~~ |\n| `doc edit` | `--append` (append content) | ~~assignee~~ |\n\n### Acceptance Criteria: Use --ac\n\n```bash\n# WRONG: -a is assignee, NOT acceptance criteria!\nknowns task edit 35 -a "- [ ] Criterion"    # Sets assignee to garbage!\n\n# CORRECT: Use --ac for acceptance criteria\nknowns task edit 35 --ac "Criterion one"\nknowns task create "Title" --ac "Criterion one" --ac "Criterion two"\n```\n{{/if}}\n\n---\n\n## Quick Reference\n\n| Rule | Description |\n|------|-------------|\n{{#if mcp}}\n{{#if cli}}\n| **MCP Tools (preferred)** | Use MCP tools for ALL operations. Fallback to CLI if needed. NEVER edit .md files directly |\n{{else}}\n| **MCP Tools Only** | Use MCP tools for ALL operations. NEVER edit .md files directly |\n{{/if}}\n{{else}}\n{{#if cli}}\n| **CLI Only** | Use commands for ALL operations. NEVER edit .md files directly |\n{{/if}}\n{{/if}}\n| **Docs First** | Read project docs BEFORE planning or coding |\n| **Time Tracking** | Start timer when taking task, stop when done |\n| **Plan Approval** | Share plan with user, WAIT for approval before coding |\n| **Check AC After** | Only mark criteria done AFTER completing work |\n\n{{#if cli}}\n---\n\n## The --plain Flag\n\n**ONLY for view/list/search commands (NOT create/edit):**\n\n```bash\n# CORRECT\nknowns task <id> --plain\nknowns task list --plain\nknowns doc "path" --plain\nknowns search "query" --plain\n\n# WRONG (create/edit don\'t support --plain)\nknowns task create "Title" --plain       # ERROR!\nknowns task edit <id> -s done --plain    # ERROR!\n```\n{{/if}}\n\n---\n\n## Reference System\n\nTasks, docs, and templates can reference each other:\n\n| Type | Writing (Input) | Reading (Output) |\n|------|-----------------|------------------|\n| Task | `@task-<id>` | `@.knowns/tasks/task-<id>` |\n| Doc | `@doc/<path>` | `@.knowns/docs/<path>.md` |\n| Template | `@template/<name>` | `@.knowns/templates/<name>` |\n\n**Always follow refs recursively** to gather complete context before planning.\n\n---\n\n## Subtasks\n\n{{#if cli}}\n### CLI\n```bash\nknowns task create "Subtask title" --parent 48\n```\n\n**CRITICAL:** Use raw ID for `--parent`:\n```bash\n# CORRECT\nknowns task create "Title" --parent 48\n\n# WRONG\nknowns task create "Title" --parent task-48\n```\n{{/if}}\n{{#if mcp}}\n### MCP\n```json\nmcp__knowns__create_task({\n  "title": "Subtask title",\n  "parent": "parent-task-id"\n})\n```\n\n**CRITICAL:** Use raw ID (string) for all MCP tool calls.\n{{/if}}\n';
 
 // src/instructions/guidelines/unified/workflow-completion.md
-var workflow_completion_default = '# Task Completion\n\n## Definition of Done\n\nA task is **Done** when ALL of these are complete:\n\n{{#if mcp}}\n| Requirement | How |\n|-------------|-----|\n| All AC checked | `mcp__knowns__update_task` with `checkAc` |\n| Notes added | `mcp__knowns__update_task` with `notes` |\n| Timer stopped | `mcp__knowns__stop_time` |\n| Status = done | `mcp__knowns__update_task` with `status: "done"` |\n| Tests pass | Run test suite |\n{{else}}\n| Requirement | Command |\n|-------------|---------|\n| All AC checked | `knowns task edit <id> --check-ac N` |\n| Notes added | `knowns task edit <id> --notes "Summary"` |\n| Timer stopped | `knowns time stop` |\n| Status = done | `knowns task edit <id> -s done` |\n| Tests pass | Run test suite |\n{{/if}}\n\n---\n\n## Completion Steps\n\n{{#if mcp}}\n```json\n// 1. Verify all AC are checked\nmcp__knowns__get_task({ "taskId": "<id>" })\n\n// 2. Add implementation notes\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "notes": "## Summary\\nWhat was done and key decisions."\n})\n\n// 3. Stop timer (REQUIRED!)\nmcp__knowns__stop_time({ "taskId": "<id>" })\n\n// 4. Mark done\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "status": "done"\n})\n```\n{{else}}\n```bash\n# 1. Verify all AC are checked\nknowns task <id> --plain\n\n# 2. Add implementation notes\nknowns task edit <id> --notes $\'## Summary\nWhat was done and key decisions.\'\n\n# 3. Stop timer (REQUIRED!)\nknowns time stop\n\n# 4. Mark done\nknowns task edit <id> -s done\n```\n{{/if}}\n\n---\n\n## Post-Completion Changes\n\nIf user requests changes after task is done:\n\n{{#if mcp}}\n```json\n// 1. Reopen task\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "status": "in-progress"\n})\n\n// 2. Restart timer\nmcp__knowns__start_time({ "taskId": "<id>" })\n\n// 3. Add AC for the fix\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "addAc": ["Fix: description"],\n  "appendNotes": "Reopened: reason"\n})\n```\n{{else}}\n```bash\nknowns task edit <id> -s in-progress    # Reopen\nknowns time start <id>                   # Restart timer\nknowns task edit <id> --ac "Fix: description"\nknowns task edit <id> --append-notes "Reopened: reason"\n```\n{{/if}}\n\nThen follow completion steps again.\n\n---\n\n## Checklist\n\n{{#if mcp}}\n- [ ] All AC checked (`checkAc`)\n- [ ] Notes added (`notes`)\n- [ ] Timer stopped (`mcp__knowns__stop_time`)\n- [ ] Tests pass\n- [ ] Status = done (`mcp__knowns__update_task`)\n{{else}}\n- [ ] All AC checked (`--check-ac`)\n- [ ] Notes added (`--notes`)\n- [ ] Timer stopped (`time stop`)\n- [ ] Tests pass\n- [ ] Status = done (`-s done`)\n{{/if}}\n';
+var workflow_completion_default = '# Task Completion\n\n## Definition of Done\n\nA task is **Done** when ALL of these are complete:\n\n{{#if cli}}\n### CLI\n| Requirement | Command |\n|-------------|---------|\n| All AC checked | `knowns task edit <id> --check-ac N` |\n| Notes added | `knowns task edit <id> --notes "Summary"` |\n| Timer stopped | `knowns time stop` |\n| Status = done | `knowns task edit <id> -s done` |\n| Tests pass | Run test suite |\n{{/if}}\n{{#if mcp}}\n### MCP\n| Requirement | How |\n|-------------|-----|\n| All AC checked | `mcp__knowns__update_task` with `checkAc` |\n| Notes added | `mcp__knowns__update_task` with `notes` |\n| Timer stopped | `mcp__knowns__stop_time` |\n| Status = done | `mcp__knowns__update_task` with `status: "done"` |\n| Tests pass | Run test suite |\n{{/if}}\n\n---\n\n## Completion Steps\n\n{{#if cli}}\n### CLI\n```bash\n# 1. Verify all AC are checked\nknowns task <id> --plain\n\n# 2. Add implementation notes\nknowns task edit <id> --notes $\'## Summary\nWhat was done and key decisions.\'\n\n# 3. Stop timer (REQUIRED!)\nknowns time stop\n\n# 4. Mark done\nknowns task edit <id> -s done\n```\n{{/if}}\n{{#if mcp}}\n### MCP\n```json\n// 1. Verify all AC are checked\nmcp__knowns__get_task({ "taskId": "<id>" })\n\n// 2. Add implementation notes\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "notes": "## Summary\\nWhat was done and key decisions."\n})\n\n// 3. Stop timer (REQUIRED!)\nmcp__knowns__stop_time({ "taskId": "<id>" })\n\n// 4. Mark done\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "status": "done"\n})\n```\n{{/if}}\n\n---\n\n## Post-Completion Changes\n\nIf user requests changes after task is done:\n\n{{#if cli}}\n### CLI\n```bash\nknowns task edit <id> -s in-progress    # Reopen\nknowns time start <id>                   # Restart timer\nknowns task edit <id> --ac "Fix: description"\nknowns task edit <id> --append-notes "Reopened: reason"\n```\n{{/if}}\n{{#if mcp}}\n### MCP\n```json\n// 1. Reopen task\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "status": "in-progress"\n})\n\n// 2. Restart timer\nmcp__knowns__start_time({ "taskId": "<id>" })\n\n// 3. Add AC for the fix\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "addAc": ["Fix: description"],\n  "appendNotes": "Reopened: reason"\n})\n```\n{{/if}}\n\nThen follow completion steps again.\n\n---\n\n## Checklist\n\n{{#if cli}}\n### CLI\n- [ ] All AC checked (`--check-ac`)\n- [ ] Notes added (`--notes`)\n- [ ] Timer stopped (`time stop`)\n- [ ] Tests pass\n- [ ] Status = done (`-s done`)\n{{/if}}\n{{#if mcp}}\n### MCP\n- [ ] All AC checked (`checkAc`)\n- [ ] Notes added (`notes`)\n- [ ] Timer stopped (`mcp__knowns__stop_time`)\n- [ ] Tests pass\n- [ ] Status = done (`mcp__knowns__update_task`)\n{{/if}}\n';
 
 // src/instructions/guidelines/unified/workflow-creation.md
-var workflow_creation_default = '# Task Creation\n\n## Before Creating\n\n{{#if mcp}}\n```json\n// Search for existing tasks first\nmcp__knowns__search_tasks({ "query": "keyword" })\n```\n{{else}}\n```bash\n# Search for existing tasks first\nknowns search "keyword" --type task --plain\n```\n{{/if}}\n\n---\n\n## Create Task\n\n{{#if mcp}}\n```json\nmcp__knowns__create_task({\n  "title": "Clear title (WHAT)",\n  "description": "Description (WHY). Related: @doc/security-patterns",\n  "priority": "medium",\n  "labels": ["feature", "auth"]\n})\n```\n\n**Note:** Add acceptance criteria after creation:\n```bash\nknowns task edit <id> --ac "Outcome 1" --ac "Outcome 2"\n```\n{{else}}\n```bash\nknowns task create "Clear title (WHAT)" \\\n  -d "Description (WHY)" \\\n  --ac "Outcome 1" \\\n  --ac "Outcome 2" \\\n  --priority medium \\\n  -l "labels"\n```\n{{/if}}\n\n---\n\n## Quality Guidelines\n\n### Title\n| Bad | Good |\n|-----|------|\n| Do auth stuff | Add JWT authentication |\n| Fix bug | Fix login timeout |\n\n### Description\nExplain WHY. Include doc refs: `@doc/security-patterns`\n\n### Acceptance Criteria\n**Outcome-focused, NOT implementation steps:**\n\n| Bad | Good |\n|-----|------|\n| Add handleLogin() function | User can login |\n| Use bcrypt | Passwords are hashed |\n| Add try-catch | Errors return proper HTTP codes |\n\n---\n\n## Subtasks\n\n{{#if mcp}}\n```json\n// Create parent first\nmcp__knowns__create_task({ "title": "Parent task" })\n\n// Then create subtask with parent ID\nmcp__knowns__create_task({\n  "title": "Subtask",\n  "parent": "parent-task-id"\n})\n```\n{{else}}\n```bash\nknowns task create "Parent task"\nknowns task create "Subtask" --parent 48  # Raw ID only!\n```\n{{/if}}\n\n---\n\n## Anti-Patterns\n\n- Too many AC in one task -> Split into multiple tasks\n- Implementation steps as AC -> Write outcomes instead\n- Skip search -> Always check existing tasks first\n';
+var workflow_creation_default = '# Task Creation\n\n## Before Creating\n\n{{#if cli}}\n### CLI\n```bash\n# Search for existing tasks first\nknowns search "keyword" --type task --plain\n```\n{{/if}}\n{{#if mcp}}\n### MCP\n```json\n// Search for existing tasks first\nmcp__knowns__search_tasks({ "query": "keyword" })\n```\n{{/if}}\n\n---\n\n## Create Task\n\n{{#if cli}}\n### CLI\n```bash\nknowns task create "Clear title (WHAT)" \\\n  -d "Description (WHY)" \\\n  --ac "Outcome 1" \\\n  --ac "Outcome 2" \\\n  --priority medium \\\n  -l "labels"\n```\n{{/if}}\n{{#if mcp}}\n### MCP\n```json\nmcp__knowns__create_task({\n  "title": "Clear title (WHAT)",\n  "description": "Description (WHY). Related: @doc/security-patterns",\n  "priority": "medium",\n  "labels": ["feature", "auth"]\n})\n```\n\n**Note:** Add acceptance criteria after creation:\n```bash\nknowns task edit <id> --ac "Outcome 1" --ac "Outcome 2"\n```\n{{/if}}\n\n---\n\n## Quality Guidelines\n\n### Title\n| Bad | Good |\n|-----|------|\n| Do auth stuff | Add JWT authentication |\n| Fix bug | Fix login timeout |\n\n### Description\nExplain WHY. Include doc refs: `@doc/security-patterns`\n\n### Acceptance Criteria\n**Outcome-focused, NOT implementation steps:**\n\n| Bad | Good |\n|-----|------|\n| Add handleLogin() function | User can login |\n| Use bcrypt | Passwords are hashed |\n| Add try-catch | Errors return proper HTTP codes |\n\n---\n\n## Subtasks\n\n{{#if cli}}\n### CLI\n```bash\nknowns task create "Parent task"\nknowns task create "Subtask" --parent 48  # Raw ID only!\n```\n{{/if}}\n{{#if mcp}}\n### MCP\n```json\n// Create parent first\nmcp__knowns__create_task({ "title": "Parent task" })\n\n// Then create subtask with parent ID\nmcp__knowns__create_task({\n  "title": "Subtask",\n  "parent": "parent-task-id"\n})\n```\n{{/if}}\n\n---\n\n## Anti-Patterns\n\n- Too many AC in one task -> Split into multiple tasks\n- Implementation steps as AC -> Write outcomes instead\n- Skip search -> Always check existing tasks first\n';
 
 // src/instructions/guidelines/unified/workflow-execution.md
-var workflow_execution_default = '# Task Execution\n\n## Step 1: Take Task\n\n{{#if mcp}}\n```json\n// Update status and assignee\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "status": "in-progress",\n  "assignee": "@me"\n})\n\n// Start timer (REQUIRED!)\nmcp__knowns__start_time({ "taskId": "<id>" })\n```\n{{else}}\n```bash\nknowns task edit <id> -s in-progress -a @me\nknowns time start <id>    # REQUIRED!\n```\n{{/if}}\n\n---\n\n## Step 2: Research\n\n{{#if mcp}}\n```json\n// Read task and follow ALL refs\nmcp__knowns__get_task({ "taskId": "<id>" })\n\n// @doc/xxx -> read the doc\nmcp__knowns__get_doc({ "path": "xxx", "smart": true })\n\n// @task-YY -> read the task\nmcp__knowns__get_task({ "taskId": "YY" })\n\n// Search related docs\nmcp__knowns__search_docs({ "query": "keyword" })\n```\n{{else}}\n```bash\n# Read task and follow ALL refs\nknowns task <id> --plain\n# @doc/xxx \u2192 knowns doc "xxx" --plain\n# @task-YY \u2192 knowns task YY --plain\n\n# Search related docs\nknowns search "keyword" --type doc --plain\n\n# Check similar done tasks\nknowns search "keyword" --type task --status done --plain\n```\n{{/if}}\n\n---\n\n## Step 3: Plan (BEFORE coding!)\n\n{{#if mcp}}\n```json\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "plan": "1. Research (see @doc/xxx)\\n2. Implement\\n3. Test\\n4. Document"\n})\n```\n{{else}}\n```bash\nknowns task edit <id> --plan $\'1. Research (see @doc/xxx)\n2. Implement\n3. Test\n4. Document\'\n```\n{{/if}}\n\n**Share plan with user. WAIT for approval before coding.**\n\n---\n\n## Step 4: Implement\n\n{{#if mcp}}\n```json\n// Check AC only AFTER work is done\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "checkAc": [1],\n  "appendNotes": "Done: feature X"\n})\n```\n{{else}}\n```bash\n# Check AC only AFTER work is done\nknowns task edit <id> --check-ac 1\nknowns task edit <id> --append-notes "Done: feature X"\n```\n{{/if}}\n\n---\n\n## Scope Changes\n\nIf new requirements emerge during work:\n\n{{#if mcp}}\n```json\n// Small: Add to current task\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "addAc": ["New requirement"],\n  "appendNotes": "Scope updated: reason"\n})\n\n// Large: Ask user first, then create follow-up\nmcp__knowns__create_task({\n  "title": "Follow-up: feature",\n  "description": "From task <id>"\n})\n```\n{{else}}\n```bash\n# Small: Add to current task\nknowns task edit <id> --ac "New requirement"\nknowns task edit <id> --append-notes "Scope updated: reason"\n\n# Large: Ask user first, then create follow-up\nknowns task create "Follow-up: feature" -d "From task <id>"\n```\n{{/if}}\n\n**Don\'t silently expand scope. Ask user first.**\n\n---\n\n## Key Rules\n\n1. **Plan before code** - Capture approach first\n2. **Wait for approval** - Don\'t start without OK\n3. **Check AC after work** - Not before\n4. **Ask on scope changes** - Don\'t expand silently\n';
+var workflow_execution_default = '# Task Execution\n\n## Step 1: Take Task\n\n{{#if cli}}\n### CLI\n```bash\nknowns task edit <id> -s in-progress -a @me\nknowns time start <id>    # REQUIRED!\n```\n{{/if}}\n{{#if mcp}}\n### MCP\n```json\n// Update status and assignee\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "status": "in-progress",\n  "assignee": "@me"\n})\n\n// Start timer (REQUIRED!)\nmcp__knowns__start_time({ "taskId": "<id>" })\n```\n{{/if}}\n\n---\n\n## Step 2: Research\n\n{{#if cli}}\n### CLI\n```bash\n# Read task and follow ALL refs\nknowns task <id> --plain\n# @doc/xxx \u2192 knowns doc "xxx" --plain\n# @task-YY \u2192 knowns task YY --plain\n\n# Search related docs\nknowns search "keyword" --type doc --plain\n\n# Check similar done tasks\nknowns search "keyword" --type task --status done --plain\n```\n{{/if}}\n{{#if mcp}}\n### MCP\n```json\n// Read task and follow ALL refs\nmcp__knowns__get_task({ "taskId": "<id>" })\n\n// @doc/xxx -> read the doc\nmcp__knowns__get_doc({ "path": "xxx", "smart": true })\n\n// @task-YY -> read the task\nmcp__knowns__get_task({ "taskId": "YY" })\n\n// Search related docs\nmcp__knowns__search_docs({ "query": "keyword" })\n```\n{{/if}}\n\n---\n\n## Step 3: Plan (BEFORE coding!)\n\n{{#if cli}}\n### CLI\n```bash\nknowns task edit <id> --plan $\'1. Research (see @doc/xxx)\n2. Implement\n3. Test\n4. Document\'\n```\n{{/if}}\n{{#if mcp}}\n### MCP\n```json\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "plan": "1. Research (see @doc/xxx)\\n2. Implement\\n3. Test\\n4. Document"\n})\n```\n{{/if}}\n\n**Share plan with user. WAIT for approval before coding.**\n\n---\n\n## Step 4: Implement\n\n{{#if cli}}\n### CLI\n```bash\n# Check AC only AFTER work is done\nknowns task edit <id> --check-ac 1\nknowns task edit <id> --append-notes "Done: feature X"\n```\n{{/if}}\n{{#if mcp}}\n### MCP\n```json\n// Check AC only AFTER work is done\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "checkAc": [1],\n  "appendNotes": "Done: feature X"\n})\n```\n{{/if}}\n\n---\n\n## Scope Changes\n\nIf new requirements emerge during work:\n\n{{#if cli}}\n### CLI\n```bash\n# Small: Add to current task\nknowns task edit <id> --ac "New requirement"\nknowns task edit <id> --append-notes "Scope updated: reason"\n\n# Large: Ask user first, then create follow-up\nknowns task create "Follow-up: feature" -d "From task <id>"\n```\n{{/if}}\n{{#if mcp}}\n### MCP\n```json\n// Small: Add to current task\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "addAc": ["New requirement"],\n  "appendNotes": "Scope updated: reason"\n})\n\n// Large: Ask user first, then create follow-up\nmcp__knowns__create_task({\n  "title": "Follow-up: feature",\n  "description": "From task <id>"\n})\n```\n{{/if}}\n\n**Don\'t silently expand scope. Ask user first.**\n\n---\n\n## Key Rules\n\n1. **Plan before code** - Capture approach first\n2. **Wait for approval** - Don\'t start without OK\n3. **Check AC after work** - Not before\n4. **Ask on scope changes** - Don\'t expand silently\n';
 
 // src/instructions/guidelines/unified/index.ts
 function render(template, mode) {
   return renderString(template, {
-    mcp: mode === "mcp",
-    cli: mode === "cli"
+    mcp: mode === "mcp" || mode === "unified",
+    cli: mode === "cli" || mode === "unified"
   }).trim();
 }
 function createGuidelines(mode) {
@@ -52961,6 +53022,7 @@ ${content}
 }
 var CLIGuidelines = createGuidelines("cli");
 var MCPGuidelines = createGuidelines("mcp");
+var UnifiedGuidelines = createGuidelines("unified");
 var Guidelines = CLIGuidelines;
 
 // src/instructions/guidelines/index.ts
@@ -53017,9 +53079,9 @@ async function handleGetGuideline(args) {
 }
 
 // src/mcp/handlers/template.ts
-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";
+import { existsSync as existsSync13 } from "node:fs";
+import { mkdir as mkdir9, writeFile as writeFile6 } from "node:fs/promises";
+import { join as join17 } from "node:path";
 
 // src/codegen/schema.ts
 var PromptChoiceSchema = external_exports3.object({
@@ -53099,9 +53161,9 @@ function safeValidateTemplateConfig(data) {
 
 // src/codegen/parser.ts
 var import_yaml = __toESM(require_dist2(), 1);
-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";
+import { existsSync as existsSync11 } from "node:fs";
+import { readFile as readFile7, readdir as readdir6 } from "node:fs/promises";
+import { join as join15 } from "node:path";
 var CONFIG_FILENAME = "_template.yaml";
 var TEMPLATE_EXTENSION = ".hbs";
 var TemplateParseError = class extends Error {
@@ -53113,16 +53175,16 @@ var TemplateParseError = class extends Error {
   }
 };
 async function loadTemplate(templateDir) {
-  if (!existsSync10(templateDir)) {
+  if (!existsSync11(templateDir)) {
     throw new TemplateParseError(`Template directory not found: ${templateDir}`);
   }
-  const configPath = join14(templateDir, CONFIG_FILENAME);
-  if (!existsSync10(configPath)) {
+  const configPath = join15(templateDir, CONFIG_FILENAME);
+  if (!existsSync11(configPath)) {
     throw new TemplateParseError(`Template config not found: ${CONFIG_FILENAME}`, void 0, [
       `Expected file at: ${configPath}`
     ]);
   }
-  const configContent = await readFile6(configPath, "utf-8");
+  const configContent = await readFile7(configPath, "utf-8");
   let rawConfig;
   try {
     rawConfig = (0, import_yaml.parse)(configContent);
@@ -53148,9 +53210,9 @@ async function findTemplateFiles(dir, base = "") {
   const files = [];
   const entries = await readdir6(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const relativePath = base ? join14(base, entry.name) : entry.name;
+    const relativePath = base ? join15(base, entry.name) : entry.name;
     if (entry.isDirectory()) {
-      const subFiles = await findTemplateFiles(join14(dir, entry.name), relativePath);
+      const subFiles = await findTemplateFiles(join15(dir, entry.name), relativePath);
       files.push(...subFiles);
     } else if (entry.name.endsWith(TEMPLATE_EXTENSION)) {
       files.push(relativePath);
@@ -53158,22 +53220,18 @@ async function findTemplateFiles(dir, base = "") {
   }
   return files;
 }
-async function loadTemplateByName(templatesDir, templateName) {
-  const templateDir = join14(templatesDir, templateName);
-  return loadTemplate(templateDir);
-}
 async function listTemplates(templatesDir) {
-  if (!existsSync10(templatesDir)) {
+  if (!existsSync11(templatesDir)) {
     return [];
   }
   const entries = await readdir6(templatesDir, { withFileTypes: true });
   const templates = [];
   for (const entry of entries) {
     if (!entry.isDirectory()) continue;
-    const configPath = join14(templatesDir, entry.name, CONFIG_FILENAME);
-    if (!existsSync10(configPath)) continue;
+    const configPath = join15(templatesDir, entry.name, CONFIG_FILENAME);
+    if (!existsSync11(configPath)) continue;
     try {
-      const loaded = await loadTemplate(join14(templatesDir, entry.name));
+      const loaded = await loadTemplate(join15(templatesDir, entry.name));
       templates.push(loaded.config);
     } catch {
     }
@@ -53182,9 +53240,9 @@ async function listTemplates(templatesDir) {
 }
 
 // src/codegen/runner.ts
-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";
+import { existsSync as existsSync12 } from "node:fs";
+import { appendFile, mkdir as mkdir8, readFile as readFile8, writeFile as writeFile5 } from "node:fs/promises";
+import { dirname as dirname3, join as join16 } from "node:path";
 
 // node_modules/@isaacs/balanced-match/dist/esm/index.js
 var balanced = (a, b, str2) => {
@@ -59957,10 +60015,10 @@ async function executeAction(action, template, context, options2, result) {
   }
 }
 async function executeAddAction(action, template, context, options2, result) {
-  const sourcePath = join15(template.templateDir, action.template);
+  const sourcePath = join16(template.templateDir, action.template);
   const destRelative = renderPath(action.path, context);
-  const destPath = join15(options2.projectRoot, template.config.destination || "", destRelative);
-  if (existsSync11(destPath)) {
+  const destPath = join16(options2.projectRoot, template.config.destination || "", destRelative);
+  if (existsSync12(destPath)) {
     if (action.skipIfExists && !options2.force) {
       result.skipped.push(destRelative);
       return;
@@ -59973,19 +60031,19 @@ async function executeAddAction(action, template, context, options2, result) {
   const content = await renderFile(sourcePath, context);
   if (!options2.dryRun) {
     await ensureDir(dirname3(destPath));
-    await writeFile4(destPath, content, "utf-8");
+    await writeFile5(destPath, content, "utf-8");
   }
   result.created.push(destRelative);
 }
 async function executeAddManyAction(action, template, context, options2, result) {
-  const sourceDir = join15(template.templateDir, action.source);
+  const sourceDir = join16(template.templateDir, action.source);
   const pattern = action.globPattern || "**/*.hbs";
   const files = await glob(pattern, { cwd: sourceDir, nodir: true });
   for (const file3 of files) {
-    const sourcePath = join15(sourceDir, file3);
-    const destRelative = renderPath(join15(action.destination, file3), context);
-    const destPath = join15(options2.projectRoot, template.config.destination || "", destRelative);
-    if (existsSync11(destPath)) {
+    const sourcePath = join16(sourceDir, file3);
+    const destRelative = renderPath(join16(action.destination, file3), context);
+    const destPath = join16(options2.projectRoot, template.config.destination || "", destRelative);
+    if (existsSync12(destPath)) {
       if (action.skipIfExists && !options2.force) {
         result.skipped.push(destRelative);
         continue;
@@ -59998,17 +60056,17 @@ async function executeAddManyAction(action, template, context, options2, result)
     const content = await renderFile(sourcePath, context);
     if (!options2.dryRun) {
       await ensureDir(dirname3(destPath));
-      await writeFile4(destPath, content, "utf-8");
+      await writeFile5(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 (!existsSync11(filePath)) {
+  const filePath = join16(options2.projectRoot, renderPath(action.path, context));
+  if (!existsSync12(filePath)) {
     throw new Error(`Cannot modify: file not found: ${action.path}`);
   }
-  const content = await readFile7(filePath, "utf-8");
+  const content = await readFile8(filePath, "utf-8");
   const replacement = renderString(action.template, context);
   const pattern = new RegExp(action.pattern, "g");
   const newContent = content.replace(pattern, replacement);
@@ -60017,15 +60075,15 @@ async function executeModifyAction(action, context, options2, result) {
     return;
   }
   if (!options2.dryRun) {
-    await writeFile4(filePath, newContent, "utf-8");
+    await writeFile5(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 filePath = join16(options2.projectRoot, renderPath(action.path, context));
   const contentToAppend = renderString(action.template, context);
-  if (action.unique && existsSync11(filePath)) {
-    const existingContent = await readFile7(filePath, "utf-8");
+  if (action.unique && existsSync12(filePath)) {
+    const existingContent = await readFile8(filePath, "utf-8");
     if (existingContent.includes(contentToAppend.trim())) {
       result.skipped.push(action.path);
       return;
@@ -60035,20 +60093,20 @@ async function executeAppendAction(action, context, options2, result) {
   const fullContent = separator + contentToAppend;
   if (!options2.dryRun) {
     await ensureDir(dirname3(filePath));
-    if (existsSync11(filePath)) {
+    if (existsSync12(filePath)) {
       await appendFile(filePath, fullContent, "utf-8");
     } else {
-      await writeFile4(filePath, contentToAppend, "utf-8");
+      await writeFile5(filePath, contentToAppend, "utf-8");
     }
   }
-  if (existsSync11(filePath)) {
+  if (existsSync12(filePath)) {
     result.modified.push(action.path);
   } else {
     result.created.push(action.path);
   }
 }
 async function ensureDir(dir) {
-  if (!existsSync11(dir)) {
+  if (!existsSync12(dir)) {
     await mkdir8(dir, { recursive: true });
   }
 }
@@ -60056,8 +60114,79 @@ async function ensureDir(dir) {
 // src/codegen/skill-parser.ts
 var import_gray_matter4 = __toESM(require_gray_matter(), 1);
 
+// src/instructions/skills/knowns.commit/SKILL.md
+var SKILL_default = '---\nname: knowns.commit\ndescription: Use when committing code changes with proper conventional commit format and verification\n---\n\n# Committing Changes\n\nCreate well-formatted commits following conventional commit standards.\n\n**Announce at start:** "I\'m using the knowns.commit skill to commit changes."\n\n**Core principle:** VERIFY BEFORE COMMITTING - check staged changes, ask for confirmation.\n\n## The Process\n\n### Step 1: Review Staged Changes\n\n```bash\ngit status\ngit diff --staged\n```\n\n### Step 2: Generate Commit Message\n\n**Format:**\n```\n<type>(<scope>): <message>\n\n- Bullet point summarizing change\n- Another point if needed\n```\n\n**Types:**\n\n| Type | Description |\n|------|-------------|\n| `feat` | New feature |\n| `fix` | Bug fix |\n| `docs` | Documentation only |\n| `style` | Formatting, no code change |\n| `refactor` | Code restructure |\n| `perf` | Performance improvement |\n| `test` | Adding tests |\n| `chore` | Maintenance |\n\n**Rules:**\n- Title lowercase, no period, max 50 chars\n- Scope optional but recommended\n- Body explains *why*, not just *what*\n\n### Step 3: Ask for Confirmation\n\nPresent message to user:\n\n```\nReady to commit:\n\nfeat(auth): add JWT token refresh\n\n- Added refresh token endpoint\n- Tokens expire after 1 hour\n\nProceed? (yes/no/edit)\n```\n\n**Wait for user approval.**\n\n### Step 4: Commit\n\n```bash\ngit commit -m "feat(auth): add JWT token refresh\n\n- Added refresh token endpoint\n- Tokens expire after 1 hour"\n```\n\n## Guidelines\n\n- Only commit staged files (don\'t `git add` unless asked)\n- NO "Co-Authored-By" lines\n- NO "Generated with Claude Code" ads\n- Ask before committing, never auto-commit\n\n## Examples\n\n**Good:**\n```\nfeat(api): add user profile endpoint\nfix(auth): handle expired token gracefully\ndocs(readme): update installation steps\n```\n\n**Bad:**\n```\nupdate code          (too vague)\nWIP                  (not ready)\nfix bug              (which bug?)\n```\n\n## Remember\n\n- Review staged changes first\n- Follow conventional format\n- Ask for confirmation\n- Keep messages concise\n';
+
+// src/instructions/skills/knowns.doc/SKILL.md
+var SKILL_default2 = '---\nname: knowns.doc\ndescription: Use when working with Knowns documentation - viewing, searching, creating, or updating docs\n---\n\n# Working with Documentation\n\nNavigate, create, and update Knowns project documentation.\n\n**Announce at start:** "I\'m using the knowns.doc skill to work with documentation."\n\n**Core principle:** SEARCH BEFORE CREATING - avoid duplicates.\n\n## Quick Reference\n\n{{#if mcp}}\n```json\n// List all docs\nmcp__knowns__list_docs({})\n\n// View doc (smart mode)\nmcp__knowns__get_doc({ "path": "<path>", "smart": true })\n\n// Search docs\nmcp__knowns__search_docs({ "query": "<query>" })\n\n// Create doc\nmcp__knowns__create_doc({\n  "title": "<title>",\n  "description": "<description>",\n  "tags": ["tag1", "tag2"],\n  "folder": "folder"\n})\n\n// Update doc\nmcp__knowns__update_doc({\n  "path": "<path>",\n  "content": "content"\n})\n\n// Update section only\nmcp__knowns__update_doc({\n  "path": "<path>",\n  "section": "2",\n  "content": "new section content"\n})\n```\n{{else}}\n```bash\n# List all docs\nknowns doc list --plain\n\n# View doc (auto-handles large docs)\nknowns doc "<path>" --plain\n\n# Search docs\nknowns search "<query>" --type doc --plain\n\n# Create doc\nknowns doc create "<title>" -d "<description>" -t "tags" -f "folder"\n\n# Update doc\nknowns doc edit "<path>" -c "content"      # Replace\nknowns doc edit "<path>" -a "content"      # Append\nknowns doc edit "<path>" --section "2" -c "content"  # Section only\n```\n{{/if}}\n\n## Reading Documents\n\n{{#if mcp}}\n**Use smart mode:**\n```json\nmcp__knowns__get_doc({ "path": "<path>", "smart": true })\n```\n\n- Small doc (\u22642000 tokens) \u2192 full content\n- Large doc \u2192 stats + TOC, then request specific section\n{{else}}\n**View doc:**\n```bash\nknowns doc "<path>" --plain\n```\n\nFor large docs, use sections:\n```bash\nknowns doc "<path>" --toc --plain\nknowns doc "<path>" --section "2" --plain\n```\n{{/if}}\n\n## Creating Documents\n\n### Step 1: Search First\n\n{{#if mcp}}\n```json\nmcp__knowns__search_docs({ "query": "<topic>" })\n```\n{{else}}\n```bash\nknowns search "<topic>" --type doc --plain\n```\n{{/if}}\n\n**Don\'t duplicate.** Update existing docs when possible.\n\n### Step 2: Choose Location\n\n| Doc Type | Location | Folder |\n|----------|----------|--------|\n| Core (README, ARCH) | Root | (none) |\n| Guide | `guides/` | `guides` |\n| Pattern | `patterns/` | `patterns` |\n| API doc | `api/` | `api` |\n\n### Step 3: Create\n\n{{#if mcp}}\n```json\nmcp__knowns__create_doc({\n  "title": "<title>",\n  "description": "<brief description>",\n  "tags": ["tag1", "tag2"],\n  "folder": "folder"\n})\n```\n{{else}}\n```bash\nknowns doc create "<title>" \\\n  -d "<brief description>" \\\n  -t "tag1,tag2" \\\n  -f "folder"  # optional\n```\n{{/if}}\n\n### Step 4: Add Content\n\n{{#if mcp}}\n```json\nmcp__knowns__update_doc({\n  "path": "<path>",\n  "content": "# Title\\n\\n## 1. Overview\\nWhat this doc covers.\\n\\n## 2. Details\\nMain content."\n})\n```\n{{else}}\n```bash\nknowns doc edit "<path>" -c "$(cat <<\'EOF\'\n# Title\n\n## 1. Overview\nWhat this doc covers.\n\n## 2. Details\nMain content.\n\n## 3. Examples\nPractical examples.\nEOF\n)"\n```\n{{/if}}\n\n## Updating Documents\n\n### View First\n\n{{#if mcp}}\n```json\nmcp__knowns__get_doc({ "path": "<path>", "smart": true })\nmcp__knowns__get_doc({ "path": "<path>", "toc": true })\n```\n{{else}}\n```bash\nknowns doc "<path>" --plain\nknowns doc "<path>" --toc --plain  # For large docs\n```\n{{/if}}\n\n### Update Methods\n\n| Method | Use When |\n|--------|----------|\n| Replace all | Rewriting entire doc |\n| Append | Adding to end |\n| Section edit | Updating one section |\n\n**Section edit is most efficient** - less context, safer.\n\n{{#if mcp}}\n```json\n// Update just section 3\nmcp__knowns__update_doc({\n  "path": "<path>",\n  "section": "3",\n  "content": "## 3. New Content\\n\\nUpdated section content..."\n})\n```\n{{else}}\n```bash\n# Update just section 3\nknowns doc edit "<path>" --section "3" -c "## 3. New Content\n\nUpdated section content..."\n```\n{{/if}}\n\n## Document Structure\n\nUse numbered headings for section editing to work:\n\n```markdown\n# Title (H1 - only one)\n\n## 1. Overview\n...\n\n## 2. Installation\n...\n\n## 3. Configuration\n...\n```\n\n## Remember\n\n- Search before creating (avoid duplicates)\n- Use smart mode when reading\n- Use section editing for targeted updates\n- Use numbered headings\n- Reference docs with `@doc/<path>`\n';
+
+// src/instructions/skills/knowns.extract/SKILL.md
+var SKILL_default3 = '---\nname: knowns.extract\ndescription: Use when extracting reusable patterns, solutions, or knowledge into documentation\n---\n\n# Extracting Knowledge\n\nConvert implementations, patterns, or solutions into reusable project documentation.\n\n**Announce at start:** "I\'m using the knowns.extract skill to extract knowledge."\n\n**Core principle:** ONLY EXTRACT GENERALIZABLE KNOWLEDGE.\n\n## The Process\n\n### Step 1: Identify Source\n\n**From task (if ID provided):**\n{{#if mcp}}\n```json\nmcp__knowns__get_task({ "taskId": "$ARGUMENTS" })\n```\n{{else}}\n```bash\nknowns task $ARGUMENTS --plain\n```\n{{/if}}\n\n**From current context (no arguments):**\n- Recent implementation work\n- Patterns discovered during research\n- Solutions found in conversation\n\nLook for:\n- Implementation patterns used\n- Problems solved\n- Decisions made\n- Lessons learned\n\n### Step 2: Identify Extractable Knowledge\n\n**Good candidates for extraction:**\n- Reusable code patterns\n- Error handling approaches\n- Integration patterns\n- Performance solutions\n- Security practices\n- API design decisions\n\n**NOT good for extraction:**\n- Task-specific details\n- One-time fixes\n- Context-dependent solutions\n\n### Step 3: Search for Existing Docs\n\n{{#if mcp}}\n```json\n// Check if pattern already documented\nmcp__knowns__search_docs({ "query": "<pattern/topic>" })\n\n// List related docs\nmcp__knowns__list_docs({ "tag": "pattern" })\n```\n{{else}}\n```bash\n# Check if pattern already documented\nknowns search "<pattern/topic>" --type doc --plain\n\n# List related docs\nknowns doc list --tag pattern --plain\n```\n{{/if}}\n\n**Don\'t duplicate.** Update existing docs when possible.\n\n### Step 4: Create or Update Documentation\n\n**If new pattern - create doc:**\n\n{{#if mcp}}\n```json\nmcp__knowns__create_doc({\n  "title": "Pattern: <Name>",\n  "description": "Reusable pattern for <purpose>",\n  "tags": ["pattern", "<domain>"],\n  "folder": "patterns"\n})\n```\n{{else}}\n```bash\nknowns doc create "Pattern: <Name>" \\\n  -d "Reusable pattern for <purpose>" \\\n  -t "pattern,<domain>" \\\n  -f "patterns"\n```\n{{/if}}\n\n**Add content:**\n\n{{#if mcp}}\n```json\nmcp__knowns__update_doc({\n  "path": "patterns/<name>",\n  "content": "# Pattern: <Name>\\n\\n## 1. Problem\\nWhat problem this pattern solves.\\n\\n## 2. Solution\\nHow to implement the pattern.\\n\\n## 3. Example\\n```typescript\\n// Code example\\n```\\n\\n## 4. When to Use\\n- Situation 1\\n\\n## 5. Source\\nDiscovered in @task-<id>"\n})\n```\n{{else}}\n```bash\nknowns doc edit "patterns/<name>" -c "$(cat <<\'EOF\'\n# Pattern: <Name>\n\n## 1. Problem\nWhat problem this pattern solves.\n\n## 2. Solution\nHow to implement the pattern.\n\n## 3. Example\n```typescript\n// Code example\n```\n\n## 4. When to Use\n- Situation 1\n- Situation 2\n\n## 5. Source\nDiscovered in @task-<id> (or describe context)\nEOF\n)"\n```\n{{/if}}\n\n**If updating existing doc:**\n\n{{#if mcp}}\n```json\nmcp__knowns__update_doc({\n  "path": "<path>",\n  "appendContent": "\\n\\n## Additional: <Topic>\\n\\n<new insight or example>"\n})\n```\n{{else}}\n```bash\nknowns doc edit "<path>" -a "\n\n## Additional: <Topic>\n\n<new insight or example>\n"\n```\n{{/if}}\n\n### Step 5: Create Template (if code-generatable)\n\nIf the pattern involves repeatable code structure, create a codegen template:\n\n```bash\n# Create template skeleton\nknowns template create <pattern-name>\n```\n\n**Update template config** (`.knowns/templates/<pattern-name>/_template.yaml`):\n\n```yaml\nname: <pattern-name>\ndescription: Generate <what it creates>\ndoc: patterns/<pattern-name>    # Link to the doc you just created\n\nprompts:\n  - name: name\n    message: Name?\n    validate: required\n\nfiles:\n  - template: "{{name}}.ts.hbs"\n    destination: "src/{{kebabCase name}}.ts"\n```\n\n**Create template files** (`.hbs` files with Handlebars):\n\n```handlebars\n// {{name}}.ts.hbs\nexport class {{pascalCase name}} {\n  // Pattern implementation\n}\n```\n\n**Link template in doc:**\n\n{{#if mcp}}\n```json\nmcp__knowns__update_doc({\n  "path": "patterns/<name>",\n  "appendContent": "\\n\\n## Generate\\n\\nUse @template/<pattern-name> to generate this pattern."\n})\n```\n{{else}}\n```bash\nknowns doc edit "patterns/<name>" -a "\n\n## Generate\n\nUse @template/<pattern-name> to generate this pattern.\n"\n```\n{{/if}}\n\n### Step 6: Link Back (if from task)\n\n```bash\nknowns task edit $ARGUMENTS --append-notes "\u{1F4DA} Extracted to @doc/patterns/<name>"\nknowns task edit $ARGUMENTS --append-notes "\u{1F527} Template: @template/<pattern-name>"\n```\n\n## What to Extract\n\n| Source | Extract As | Create Template? |\n|--------|------------|------------------|\n| Code pattern | Pattern doc | \u2705 Yes |\n| Component structure | Pattern doc | \u2705 Yes |\n| API endpoint pattern | Integration guide | \u2705 Yes |\n| Error solution | Troubleshooting guide | \u274C No |\n| Performance fix | Performance patterns | \u274C Usually no |\n| Security approach | Security guidelines | \u274C No |\n\n**Create template when:**\n- Pattern is repeatable (will be used multiple times)\n- Has consistent file structure\n- Can be parameterized (name, type, etc.)\n\n## Document Templates\n\n### Pattern Template\n```markdown\n# Pattern: <Name>\n\n## Problem\nWhat this solves.\n\n## Solution\nHow to implement.\n\n## Example\nWorking code.\n\n## When to Use\nWhen to apply this pattern.\n```\n\n### Guide Template\n```markdown\n# Guide: <Topic>\n\n## Overview\nWhat this covers.\n\n## Steps\n1. Step one\n2. Step two\n\n## Common Issues\n- Issue and solution\n```\n\n## Quality Checklist\n\n- [ ] Knowledge is generalizable (not task-specific)\n- [ ] Includes working example\n- [ ] Explains when to use\n- [ ] Links back to source (if applicable)\n- [ ] Tagged appropriately\n- [ ] Template created (if code-generatable)\n- [ ] Doc links to template (`@template/...`)\n- [ ] Template links to doc (`doc:` in config)\n\n## Remember\n\n- Only extract generalizable knowledge\n- Search before creating (avoid duplicates)\n- Include practical examples\n- Reference source when available\n- Tag docs for discoverability\n- **Create template for repeatable code patterns**\n- **Link doc \u2194 template bidirectionally**\n';
+
+// src/instructions/skills/knowns.init/SKILL.md
+var SKILL_default4 = '---\nname: knowns.init\ndescription: Use at the start of a new session to read project docs, understand context, and see current state\n---\n\n# Session Initialization\n\nInitialize a session by reading project documentation and understanding current state.\n\n**Announce at start:** "I\'m using the knowns.init skill to initialize this session."\n\n**Core principle:** READ DOCS BEFORE DOING ANYTHING ELSE.\n\n## The Process\n\n### Step 1: List Available Documentation\n\n{{#if mcp}}\n```json\nmcp__knowns__list_docs({})\n```\n{{else}}\n```bash\nknowns doc list --plain\n```\n{{/if}}\n\n### Step 2: Read Core Documents\n\n**Priority order:**\n\n{{#if mcp}}\n```json\n// 1. Project overview (always read)\nmcp__knowns__get_doc({ "path": "README", "smart": true })\n\n// 2. Architecture (if exists)\nmcp__knowns__get_doc({ "path": "ARCHITECTURE", "smart": true })\n\n// 3. Conventions (if exists)\nmcp__knowns__get_doc({ "path": "CONVENTIONS", "smart": true })\n```\n{{else}}\n```bash\n# 1. Project overview (always read)\nknowns doc "README" --plain\n\n# 2. Architecture (if exists)\nknowns doc "ARCHITECTURE" --plain\n\n# 3. Conventions (if exists)\nknowns doc "CONVENTIONS" --plain\n```\n{{/if}}\n\n### Step 3: Check Current State\n\n{{#if mcp}}\n```json\n// Active timer?\nmcp__knowns__get_time_report({})\n\n// Tasks in progress\nmcp__knowns__list_tasks({ "status": "in-progress" })\n\n// Board overview\nmcp__knowns__get_board({})\n```\n{{else}}\n```bash\n# Active timer?\nknowns time status\n\n# Tasks in progress\nknowns task list --status in-progress --plain\n\n# High priority todos\nknowns task list --status todo --plain | head -20\n```\n{{/if}}\n\n### Step 4: Summarize Context\n\nProvide a brief summary:\n\n```markdown\n## Session Context\n\n### Project\n- **Name**: [from config]\n- **Purpose**: [from README]\n\n### Key Docs Available\n- README: [brief note]\n- ARCHITECTURE: [if exists]\n- CONVENTIONS: [if exists]\n\n### Current State\n- Tasks in progress: [count]\n- Active timer: [yes/no]\n\n### Ready for\n- Working on tasks\n- Creating documentation\n- Answering questions about codebase\n```\n\n## Quick Commands After Init\n\n```\n# Work on a task\n/knowns.task <id>\n\n# Search for something\n{{#if mcp}}\nmcp__knowns__search_docs({ "query": "<query>" })\n{{else}}\nknowns search "<query>" --plain\n{{/if}}\n```\n\n## When to Re-Initialize\n\n**Run init again when:**\n- Starting a new session\n- Major project changes occurred\n- Switching to different area of project\n- Context feels stale\n\n## What to Learn from Docs\n\nFrom **README**:\n- Project purpose and scope\n- Key features\n- Getting started info\n\nFrom **ARCHITECTURE**:\n- System design\n- Component structure\n- Key decisions\n\nFrom **CONVENTIONS**:\n- Coding standards\n- Naming conventions\n- File organization\n\n## Remember\n\n- Always read docs first\n- Check for active work (in-progress tasks)\n- Summarize context for reference\n- Re-init when switching areas\n';
+
+// src/instructions/skills/knowns.research/SKILL.md
+var SKILL_default5 = '---\nname: knowns.research\ndescription: Use when you need to understand existing code, find patterns, or explore the codebase before implementation\n---\n\n# Researching the Codebase\n\nUnderstand existing patterns and implementation before making changes.\n\n**Announce at start:** "I\'m using the knowns.research skill to research [topic]."\n\n**Core principle:** UNDERSTAND WHAT EXISTS BEFORE ADDING NEW CODE.\n\n## The Process\n\n### Step 1: Search Documentation\n\n{{#if mcp}}\n```json\n// Search docs for topic\nmcp__knowns__search_docs({ "query": "<topic>" })\n\n// Read relevant docs\nmcp__knowns__get_doc({ "path": "<path>", "smart": true })\n```\n{{else}}\n```bash\n# Search docs for topic\nknowns search "<topic>" --type doc --plain\n\n# Read relevant docs\nknowns doc "<path>" --plain\n```\n{{/if}}\n\n### Step 2: Search Completed Tasks\n\n{{#if mcp}}\n```json\n// Find similar work that was done\nmcp__knowns__search_tasks({ "query": "<keywords>" })\n\n// View task for implementation details\nmcp__knowns__get_task({ "taskId": "<id>" })\n```\n{{else}}\n```bash\n# Find similar work that was done\nknowns search "<keywords>" --type task --status done --plain\n\n# View task for implementation details\nknowns task <id> --plain\n```\n{{/if}}\n\n**Learn from history** - completed tasks often contain valuable insights.\n\n### Step 3: Search Codebase\n\n```bash\n# Find files by name pattern\nfind . -name "*<pattern>*" -type f | grep -v node_modules | head -20\n\n# Search code content\ngrep -r "<pattern>" --include="*.ts" --include="*.tsx" -l | head -20\n```\n\n### Step 4: Analyze Patterns\n\nLook for:\n- How similar features are implemented\n- Common patterns used\n- File/folder structure conventions\n- Naming conventions\n- Error handling patterns\n\n### Step 5: Document Findings\n\n```markdown\n## Research: [Topic]\n\n### Existing Implementations\n- `src/path/file.ts`: Does X\n- `src/path/other.ts`: Handles Y\n\n### Patterns Found\n- Pattern 1: Used for...\n- Pattern 2: Applied when...\n\n### Related Docs\n- @doc/path1 - Covers X\n- @doc/path2 - Explains Y\n\n### Recommendations\nBased on research:\n1. Reuse X from Y\n2. Follow pattern Z\n3. Avoid approach W because...\n```\n\n## Research Checklist\n\n- [ ] Searched documentation\n- [ ] Reviewed similar completed tasks\n- [ ] Found existing code patterns\n- [ ] Identified reusable components\n- [ ] Noted conventions to follow\n\n## After Research\n\nUse findings in task:\n{{#if mcp}}\n```json\n// Create informed task\nmcp__knowns__create_task({\n  "title": "<title>",\n  "description": "Based on research: use pattern from X"\n})\n```\n{{else}}\n```bash\n# Create informed task\nknowns task create "<title>" \\\n  -d "Based on research: use pattern from X" \\\n  --ac "Follow pattern in src/..." \\\n  --ac "Reuse component Y"\n\n# Or update existing task plan\nknowns task edit <id> --plan $\'1. Based on research...\n2. Reuse pattern from...\'\n```\n{{/if}}\n\n## What to Look For\n\n| Looking For | Where to Check |\n|-------------|----------------|\n| Conventions | @doc/CONVENTIONS, existing code |\n| Patterns | @doc/patterns/*, similar features |\n| Utilities | src/utils/*, src/lib/* |\n| Examples | Completed tasks, tests |\n| API design | Existing endpoints, @doc/api/* |\n\n## When to Research\n\n**Always research before:**\n- Implementing new features\n- Adding new patterns\n- Making architectural decisions\n\n**Skip research for:**\n- Simple bug fixes with clear cause\n- Trivial changes following obvious patterns\n\n## Remember\n\n- Check docs and tasks first\n- Look at how similar things are done\n- Note file locations for reference\n- Look at tests for expected behavior\n- Document findings for future reference\n';
+
+// src/instructions/skills/knowns.task.brainstorm/SKILL.md
+var SKILL_default6 = '---\nname: knowns.task.brainstorm\ndescription: Use when requirements are unclear, multiple approaches exist, or you need to explore solutions before planning\n---\n\n# Brainstorming for Tasks\n\nConvert vague requirements into concrete design through structured questioning and exploration.\n\n**Announce at start:** "I\'m using the knowns.task.brainstorm skill to explore approaches."\n\n**Core principle:** UNDERSTAND THE PROBLEM BEFORE PROPOSING SOLUTIONS.\n\n## The Process\n\n### Phase 1: Discovery\n\n**One question at a time.** Don\'t overwhelm with multiple questions.\n\nPrefer multiple-choice when possible:\n```\nWhich approach do you prefer?\nA) Quick solution with trade-offs\nB) Comprehensive solution, more effort\nC) Something else (describe)\n```\n\nQuestions to clarify:\n- What problem are we solving?\n- Who are the users/stakeholders?\n- What are the constraints?\n- What does success look like?\n\n### Phase 2: Research Existing Patterns\n\n{{#if mcp}}\n```json\n// Search docs for related patterns\nmcp__knowns__search_docs({ "query": "<topic>" })\n\n// Check how similar things were done\nmcp__knowns__search_tasks({ "query": "<keywords>" })\n```\n{{else}}\n```bash\n# Search docs for related patterns\nknowns search "<topic>" --type doc --plain\n\n# Check how similar things were done\nknowns search "<keywords>" --type task --status done --plain\n```\n{{/if}}\n\n**Learn from history** - completed tasks often contain implementation insights.\n\n### Phase 3: Explore Approaches\n\nPresent 2-3 options with trade-offs:\n\n```markdown\n## Option A: [Name]\n- **Approach**: Brief description\n- **Pros**: What\'s good\n- **Cons**: What\'s challenging\n- **Effort**: Low/Medium/High\n\n## Option B: [Name]\n- **Approach**: Brief description\n- **Pros**: What\'s good\n- **Cons**: What\'s challenging\n- **Effort**: Low/Medium/High\n```\n\n**Lead with your recommendation** and explain why.\n\n### Phase 4: Validate and Document\n\nAfter agreement:\n- Summarize the chosen approach\n- Identify potential risks\n- Define acceptance criteria\n\nIf creating a new task:\n{{#if mcp}}\n```json\nmcp__knowns__create_task({\n  "title": "<title>",\n  "description": "Based on brainstorm: <key decisions>",\n  "acceptanceCriteria": ["Criterion 1", "Criterion 2"]\n})\n```\n{{else}}\n```bash\nknowns task create "<title>" \\\n  -d "Based on brainstorm: <key decisions>" \\\n  --ac "Criterion 1" \\\n  --ac "Criterion 2"\n```\n{{/if}}\n\nIf updating existing task:\n{{#if mcp}}\n```json\nmcp__knowns__update_task({\n  "taskId": "$ARGUMENTS",\n  "description": "Updated based on brainstorm..."\n})\n```\n{{else}}\n```bash\nknowns task edit $ARGUMENTS -d "Updated based on brainstorm..."\n```\n{{/if}}\n\n## When to Use This Skill\n\n**Good candidates:**\n- Vague requirements ("make it faster", "improve UX")\n- Multiple valid approaches exist\n- Significant effort involved\n- New territory for the project\n\n**Skip for:**\n- Clear, well-defined tasks\n- Bug fixes with obvious solutions\n- Simple additions following existing patterns\n\n## Red Flags\n\n**You\'re doing it wrong if:**\n- Proposing solutions before understanding the problem\n- Asking too many questions at once\n- Not researching existing patterns first\n- Skipping trade-off analysis\n\n## Remember\n\n- One question at a time\n- Research existing patterns first\n- Present options with trade-offs\n- Lead with your recommendation\n- Document the decision\n';
+
+// src/instructions/skills/knowns.task.implement/SKILL.md
+var SKILL_default7 = '---\nname: knowns.task.implement\ndescription: Use when implementing a task - follow the plan, check ACs, track progress\n---\n\n# Implementing a Task\n\nExecute the implementation plan, track progress, and complete the task.\n\n**Announce at start:** "I\'m using the knowns.task.implement skill to implement task [ID]."\n\n**Core principle:** CHECK AC ONLY AFTER WORK IS DONE.\n\n## The Process\n\n### Step 1: Review Current State\n\n{{#if mcp}}\n```json\nmcp__knowns__get_task({ "taskId": "$ARGUMENTS" })\n```\n{{else}}\n```bash\nknowns task $ARGUMENTS --plain\n```\n{{/if}}\n\nVerify:\n- Plan exists and is approved\n- Timer is running\n- Know which ACs are pending\n\n### Step 2: Check for Applicable Templates\n\nBefore writing code, check if there\'s a template that matches:\n\n```bash\nknowns template list\n```\n\n**If template exists:**\n1. Read linked doc for context\n2. Use template to generate boilerplate\n3. Customize generated code as needed\n\n{{#if mcp}}\n```json\n// Read template\'s linked doc\nmcp__knowns__get_doc({ "path": "<template-doc>", "smart": true })\n```\n```bash\n# Generate code from template (reduces context, ensures consistency)\nknowns template run <template-name> --name "MyComponent"\n```\n{{else}}\n```bash\n# Read template\'s linked doc\nknowns doc "<template-doc>" --plain\n\n# Generate code from template (reduces context, ensures consistency)\nknowns template run <template-name> --name "MyComponent"\n```\n{{/if}}\n\n**Why use templates:**\n- Reduces context (no need to generate boilerplate)\n- Ensures consistency with project patterns\n- Faster implementation\n\n### Step 3: Work Through Plan\n\nFor each step in the plan:\n\n1. **Check for template** (use if available)\n2. **Do the work** (generate or write code)\n3. **Check related AC** (only after work is done!)\n4. **Append progress note**\n\n{{#if mcp}}\n```json\n// After completing work for AC #1:\nmcp__knowns__update_task({\n  "taskId": "$ARGUMENTS",\n  "checkAc": [1],\n  "appendNotes": "\u2713 Done: brief description"\n})\n```\n{{else}}\n```bash\n# After completing work for AC #1:\nknowns task edit $ARGUMENTS --check-ac 1\nknowns task edit $ARGUMENTS --append-notes "\u2713 Done: brief description"\n```\n{{/if}}\n\n### Step 4: Handle Scope Changes\n\nIf new requirements emerge during implementation:\n\n**Small change:**\n{{#if mcp}}\n```json\nmcp__knowns__update_task({\n  "taskId": "$ARGUMENTS",\n  "addAc": ["New requirement"],\n  "appendNotes": "\u26A0\uFE0F Scope: added requirement per user"\n})\n```\n{{else}}\n```bash\nknowns task edit $ARGUMENTS --ac "New requirement"\nknowns task edit $ARGUMENTS --append-notes "\u26A0\uFE0F Scope: added requirement per user"\n```\n{{/if}}\n\n**Large change:**\n- Stop and ask user\n- Consider creating follow-up task\n- Update plan if needed\n\n### Step 5: Verify & Complete\n\nWhen all ACs are checked:\n\n**1. Verify code quality:**\n```bash\nnpm test        # or project\'s test command\nnpm run lint    # or project\'s lint command\nnpm run build   # if applicable\n```\n\n**Don\'t complete if verification fails.** Fix issues first.\n\n**2. Add implementation notes (REQUIRED for audit):**\n\nDocument all changes made for audit trail.\n\n> \u26A0\uFE0F **CRITICAL**: Use `appendNotes` (NOT `notes`). Using `notes` will DESTROY the audit trail!\n\n{{#if mcp}}\n```json\nmcp__knowns__update_task({\n  "taskId": "$ARGUMENTS",\n  "appendNotes": "## Implementation Complete\\n\\n### Files Changed\\n- `src/path/file.ts` - Added X\\n- `src/path/other.ts` - Modified Y\\n\\n### Key Changes\\n- Change 1: description\\n\\n### Testing\\n- Test coverage / manual testing done"\n})\n```\n{{else}}\n```bash\nknowns task edit $ARGUMENTS --append-notes $\'\n## Implementation Complete\n\n### Files Changed\n- `src/path/file.ts` - Added X\n- `src/path/other.ts` - Modified Y\n- `tests/file.test.ts` - Added tests\n\n### Key Changes\n- Change 1: description\n- Change 2: description\n\n### Testing\n- Test coverage / manual testing done\n\'\n```\n{{/if}}\n\n**IMPORTANT:** Always use `appendNotes` (not `notes`) to preserve audit trail.\n\n**3. Stop timer and mark done:**\n\n{{#if mcp}}\n```json\nmcp__knowns__stop_time({ "taskId": "$ARGUMENTS" })\n```\n```json\nmcp__knowns__update_task({\n  "taskId": "$ARGUMENTS",\n  "status": "done"\n})\n```\n{{else}}\n```bash\nknowns time stop\nknowns task edit $ARGUMENTS -s done\n```\n{{/if}}\n\n### Step 6: Consider Knowledge Extraction\n\nIf generalizable patterns were discovered:\n\n```\n/knowns.extract $ARGUMENTS\n```\n\n## Progress Tracking\n\nUse concise notes:\n\n{{#if mcp}}\n```json\n// Good\nmcp__knowns__update_task({\n  "taskId": "$ARGUMENTS",\n  "appendNotes": "\u2713 Auth middleware implemented"\n})\n\n// Bad (too verbose)\nmcp__knowns__update_task({\n  "taskId": "$ARGUMENTS",\n  "appendNotes": "I have successfully completed..."\n})\n```\n{{else}}\n```bash\n# Good\nknowns task edit $ARGUMENTS --append-notes "\u2713 Auth middleware implemented"\n\n# Bad (too verbose)\nknowns task edit $ARGUMENTS --append-notes "I have successfully completed..."\n```\n{{/if}}\n\n## Completion Checklist\n\n- [ ] All ACs checked\n- [ ] Tests pass\n- [ ] Lint clean\n- [ ] Implementation notes added (with file changes for audit)\n- [ ] Timer stopped\n- [ ] Status set to `done`\n- [ ] Knowledge extracted (if applicable)\n\n## Red Flags\n\n**You\'re doing it wrong if:**\n- Checking AC before work is actually complete\n- Making changes not in the approved plan (without asking)\n- Skipping tests\n- Not tracking progress with notes\n- Marking done without verification\n\n## When to Stop\n\n**STOP and ask when:**\n- Requirements unclear or contradictory\n- Approach isn\'t working after 2-3 attempts\n- Need changes outside approved scope\n- Hit unexpected blocker\n\n## If Verification Fails\n\n**Tests failing:**\n1. Keep task in-progress\n2. Fix the issue\n3. Re-run verification\n\n**Forgot to stop timer:**\n{{#if mcp}}\n```json\nmcp__knowns__add_time({\n  "taskId": "$ARGUMENTS",\n  "duration": "<duration>",\n  "note": "Timer correction"\n})\n```\n{{else}}\n```bash\nknowns time add $ARGUMENTS <duration> -n "Timer correction"\n```\n{{/if}}\n\n## Remember\n\n- Check AC only AFTER work is done\n- Use templates when available\n- Track progress with notes\n- Ask before scope changes\n- Follow the approved plan\n- Verify before marking done\n- Always stop the timer\n- Consider knowledge extraction\n';
+
+// src/instructions/skills/knowns.task.plan/SKILL.md
+var SKILL_default8 = '---\nname: knowns.task.plan\ndescription: Use when creating an implementation plan for a task\n---\n\n# Planning a Task\n\nTake ownership, gather context, create implementation plan, and get user approval.\n\n**Announce at start:** "I\'m using the knowns.task.plan skill to plan task [ID]."\n\n**Core principle:** GATHER CONTEXT \u2192 PLAN \u2192 WAIT FOR APPROVAL.\n\n## The Process\n\n### Step 1: View Task & Take Ownership\n\n{{#if mcp}}\n```json\nmcp__knowns__get_task({ "taskId": "$ARGUMENTS" })\n```\n\n```json\nmcp__knowns__update_task({\n  "taskId": "$ARGUMENTS",\n  "status": "in-progress",\n  "assignee": "@me"\n})\n```\n\n```json\nmcp__knowns__start_time({ "taskId": "$ARGUMENTS" })\n```\n{{else}}\n```bash\nknowns task $ARGUMENTS --plain\nknowns task edit $ARGUMENTS -s in-progress -a @me\nknowns time start $ARGUMENTS\n```\n{{/if}}\n\n**Timer is mandatory.** Time data is used for estimation.\n\n### Step 2: Gather Context\n\n**Follow all refs in task:**\n\n{{#if mcp}}\n```json\n// @doc/<path> \u2192\nmcp__knowns__get_doc({ "path": "<path>", "smart": true })\n\n// @task-<id> \u2192\nmcp__knowns__get_task({ "taskId": "<id>" })\n```\n{{else}}\n```bash\n# @doc/<path> \u2192\nknowns doc "<path>" --plain\n\n# @task-<id> \u2192\nknowns task <id> --plain\n```\n{{/if}}\n\n**Search for related context:**\n\n{{#if mcp}}\n```json\nmcp__knowns__search_docs({ "query": "<keywords>" })\nmcp__knowns__search_tasks({ "query": "<keywords>" })\n```\n{{else}}\n```bash\nknowns search "<keywords>" --type doc --plain\nknowns search "<keywords>" --type task --status done --plain\n```\n{{/if}}\n\n**Check for templates:**\n\n```bash\nknowns template list\n```\n\n### Step 3: Draft Implementation Plan\n\nStructure your plan:\n\n```markdown\n## Implementation Plan\n\n1. [Step] (see @doc/relevant-doc)\n2. [Step] (use @template/xxx if available)\n3. Add tests\n4. Update documentation\n```\n\n**Plan guidelines:**\n- Reference relevant docs with `@doc/<path>`\n- Reference templates with `@template/<name>`\n- Include testing step\n- Include doc updates if needed\n- Keep steps actionable and specific\n\n### Step 4: Present to User\n\nShow the plan and **ASK for approval**:\n\n```markdown\nHere\'s my implementation plan for task [ID]:\n\n1. Step one (see @doc/xxx)\n2. Generate boilerplate with @template/xxx\n3. Customize implementation\n4. Add unit tests\n5. Update API docs\n\nShall I proceed with this plan?\n```\n\n**WAIT for explicit approval.**\n\n### Step 5: Save Plan (after approval)\n\n> \u26A0\uFE0F **Use `appendNotes` (NOT `notes`)** to preserve audit trail:\n\n{{#if mcp}}\n```json\nmcp__knowns__update_task({\n  "taskId": "$ARGUMENTS",\n  "plan": "1. Step one (see @doc/xxx)\\n2. Step two\\n3. Add unit tests\\n4. Update API docs",\n  "appendNotes": "\u{1F4CB} Plan approved, starting implementation"\n})\n```\n{{else}}\n```bash\nknowns task edit $ARGUMENTS --plan $\'1. Step one (see @doc/xxx)\n2. Step two\n3. Add unit tests\n4. Update API docs\'\nknowns task edit $ARGUMENTS --append-notes "\u{1F4CB} Plan approved, starting implementation"\n```\n{{/if}}\n\n## Plan Quality Checklist\n\n- [ ] Task ownership taken (status: in-progress)\n- [ ] Timer started\n- [ ] All refs followed\n- [ ] Related docs/tasks searched\n- [ ] Templates identified (if any)\n- [ ] Steps are specific and actionable\n- [ ] Includes relevant doc/template references\n- [ ] Includes testing\n- [ ] User has approved\n\n## Next Step\n\nAfter plan is approved:\n\n```\n/knowns.task.implement $ARGUMENTS\n```\n\n## When Plan Isn\'t Clear\n\nIf requirements are unclear or multiple approaches exist:\n\n```\n/knowns.task.brainstorm $ARGUMENTS\n```\n\n## Remember\n\n- Take ownership and start timer first\n- Gather context before planning\n- Check for templates to use\n- Never implement without approved plan\n- Reference docs and templates in the plan\n';
+
+// src/instructions/skills/knowns.task.reopen/SKILL.md
+var SKILL_default9 = '---\nname: knowns.task.reopen\ndescription: Use when reopening a completed task to add new requirements, fix issues, or extend functionality\n---\n\n# Reopening Tasks\n\nReopen completed tasks properly with time tracking and requirement documentation.\n\n**Announce at start:** "I\'m using the knowns.task.reopen skill to reopen task [ID]."\n\n**Core principle:** DOCUMENT WHY THE TASK IS REOPENED.\n\n## The Process\n\n### Step 1: View Current Task State\n\n{{#if mcp}}\n```json\nmcp__knowns__get_task({ "taskId": "$ARGUMENTS" })\n```\n{{else}}\n```bash\nknowns task $ARGUMENTS --plain\n```\n{{/if}}\n\nVerify:\n- Task is currently `done`\n- Understand what was implemented\n- Review implementation notes\n\n### Step 2: Reopen and Start Timer\n\n{{#if mcp}}\n```json\n// Set back to in-progress\nmcp__knowns__update_task({\n  "taskId": "$ARGUMENTS",\n  "status": "in-progress"\n})\n\n// Start timer (REQUIRED)\nmcp__knowns__start_time({ "taskId": "$ARGUMENTS" })\n```\n{{else}}\n```bash\n# Set back to in-progress\nknowns task edit $ARGUMENTS -s in-progress\n\n# Start timer (REQUIRED)\nknowns time start $ARGUMENTS\n```\n{{/if}}\n\n### Step 3: Document Reopen Reason\n\n> \u26A0\uFE0F **Use `appendNotes` (NOT `notes`)** to preserve existing audit trail:\n\n{{#if mcp}}\n```json\nmcp__knowns__update_task({\n  "taskId": "$ARGUMENTS",\n  "appendNotes": "\u{1F504} Reopened: <reason>"\n})\n```\n{{else}}\n```bash\nknowns task edit $ARGUMENTS --append-notes "\u{1F504} Reopened: <reason>"\n```\n{{/if}}\n\n**Common reasons:**\n- User requested changes\n- Bug found in implementation\n- New requirements added\n- Missed acceptance criteria\n\n### Step 4: Add New Requirements\n\n{{#if mcp}}\n```json\nmcp__knowns__update_task({\n  "taskId": "$ARGUMENTS",\n  "addAc": ["New requirement 1", "Fix: issue description"]\n})\n```\n{{else}}\n```bash\n# Add new acceptance criteria\nknowns task edit $ARGUMENTS --ac "New requirement 1"\nknowns task edit $ARGUMENTS --ac "Fix: issue description"\n```\n{{/if}}\n\n### Step 5: Update Plan (if needed)\n\n{{#if mcp}}\n```json\nmcp__knowns__update_task({\n  "taskId": "$ARGUMENTS",\n  "plan": "Previous plan + new steps:\\n1. Original step (done)\\n2. Original step (done)\\n3. NEW: Address new requirement\\n4. NEW: Fix reported issue"\n})\n```\n{{else}}\n```bash\nknowns task edit $ARGUMENTS --plan $\'Previous plan + new steps:\n1. Original step (done)\n2. Original step (done)\n3. NEW: Address new requirement\n4. NEW: Fix reported issue\'\n```\n{{/if}}\n\n**Present updated plan and WAIT for approval.**\n\n### Step 6: Implement and Complete\n\nFollow normal task completion flow:\n\n{{#if mcp}}\n```json\n// Check new ACs as completed\nmcp__knowns__update_task({\n  "taskId": "$ARGUMENTS",\n  "checkAc": [<new-index>],\n  "appendNotes": "\u2713 Done: new requirement"\n})\n\n// Stop timer\nmcp__knowns__stop_time({ "taskId": "$ARGUMENTS" })\n\n// Mark done again\nmcp__knowns__update_task({\n  "taskId": "$ARGUMENTS",\n  "status": "done"\n})\n```\n{{else}}\n```bash\n# Check new ACs as completed\nknowns task edit $ARGUMENTS --check-ac <new-index>\nknowns task edit $ARGUMENTS --append-notes "\u2713 Done: new requirement"\n\n# Stop timer\nknowns time stop\n\n# Mark done again\nknowns task edit $ARGUMENTS -s done\n```\n{{/if}}\n\n## When to Reopen vs Create New Task\n\n| Reopen Existing | Create New Task |\n|-----------------|-----------------|\n| Small fix/change | Major new feature |\n| Related to original work | Unrelated work |\n| Same context needed | Different context |\n| Quick addition | Significant scope |\n\n**Rule of thumb:** If it takes < 30 mins and relates to original task, reopen. Otherwise, create new task with reference.\n\n## Creating Follow-up Task Instead\n\n{{#if mcp}}\n```json\nmcp__knowns__create_task({\n  "title": "Follow-up: <description>",\n  "description": "Related to @task-$ARGUMENTS"\n})\n```\n{{else}}\n```bash\nknowns task create "Follow-up: <description>" \\\n  -d "Related to @task-$ARGUMENTS" \\\n  --ac "New requirement"\n```\n{{/if}}\n\n## Remember\n\n- Always document reopen reason\n- Start timer when reopening\n- Add new AC for traceability\n- Stop timer when done\n- Consider if new task is more appropriate\n';
+
+// src/instructions/skills/knowns.task/SKILL.md
+var SKILL_default10 = '---\nname: knowns.task\ndescription: Use when working on a Knowns task - view task details and decide next action\n---\n\n# Working on a Task\n\nView task details and determine the appropriate next action.\n\n**Announce at start:** "I\'m using the knowns.task skill to view task [ID]."\n\n**Core principle:** VIEW AND ROUTE - analyze state, suggest next skill.\n\n## The Process\n\n### Step 1: View Task\n\n{{#if mcp}}\n```json\nmcp__knowns__get_task({ "taskId": "$ARGUMENTS" })\n```\n{{else}}\n```bash\nknowns task $ARGUMENTS --plain\n```\n{{/if}}\n\n### Step 2: Analyze State\n\nCheck:\n- **Status**: todo, in-progress, done?\n- **Assignee**: Assigned to someone?\n- **AC**: Any checked? All checked?\n- **Plan**: Has implementation plan?\n- **Refs**: Any `@doc/` or `@task-` references?\n\n### Step 3: Suggest Next Action\n\nBased on task state, recommend the appropriate skill:\n\n| State | Next Skill |\n|-------|------------|\n| `todo`, not started | `knowns.task.plan` |\n| `in-progress`, no plan | `knowns.task.plan` |\n| `in-progress`, has plan | `knowns.task.implement` |\n| `done`, needs changes | `knowns.task.reopen` |\n| Requirements unclear | `knowns.task.brainstorm` |\n\n### Step 4: Follow Refs (if needed)\n\nIf task has references, follow them for context:\n\n{{#if mcp}}\n```json\n// Doc ref: @doc/path \u2192\nmcp__knowns__get_doc({ "path": "<path>", "smart": true })\n\n// Task ref: @task-<id> \u2192\nmcp__knowns__get_task({ "taskId": "<id>" })\n```\n{{else}}\n```bash\n# Doc ref: @doc/path \u2192\nknowns doc "<path>" --plain\n\n# Task ref: @task-<id> \u2192\nknowns task <id> --plain\n```\n{{/if}}\n\n## Quick Actions\n\n**Start planning (includes taking ownership):**\n```\n/knowns.task.plan $ARGUMENTS\n```\n\n**Continue implementing:**\n```\n/knowns.task.implement $ARGUMENTS\n```\n\n**Requirements unclear:**\n```\n/knowns.task.brainstorm $ARGUMENTS\n```\n\n**Reopen completed task:**\n```\n/knowns.task.reopen $ARGUMENTS\n```\n\n## Remember\n\n- This skill is for viewing and routing\n- Use `plan` to start a new task (takes ownership, starts timer)\n- Use `implement` to continue/complete in-progress tasks\n- Always follow refs for full context\n';
+
+// src/instructions/skills/knowns.template/SKILL.md
+var SKILL_default11 = '---\nname: knowns.template\ndescription: Use when generating code from templates - list, run, or create templates\n---\n\n# Working with Templates\n\nGenerate code from predefined templates stored in `.knowns/templates/`.\n\n**Announce at start:** "I\'m using the knowns.template skill to work with templates."\n\n**Core principle:** USE TEMPLATES FOR CONSISTENT CODE GENERATION.\n\n## The Process\n\n### Step 1: List Available Templates\n\n{{#if mcp}}\n```json\nmcp__knowns__list_templates({})\n```\n{{else}}\n```bash\nknowns template list\n```\n{{/if}}\n\n### Step 2: Get Template Details\n\n{{#if mcp}}\n```json\nmcp__knowns__get_template({ "name": "<template-name>" })\n```\n{{else}}\n```bash\nknowns template info <template-name>\n```\n{{/if}}\n\nCheck:\n- Required variables (prompts)\n- Linked documentation (`doc:`)\n- Files that will be generated\n\n### Step 3: Read Linked Documentation\n\nIf template has a `doc:` field, read it first:\n\n{{#if mcp}}\n```json\nmcp__knowns__get_doc({ "path": "<doc-path>", "smart": true })\n```\n{{else}}\n```bash\nknowns doc "<doc-path>" --plain\n```\n{{/if}}\n\n### Step 4: Run Template\n\n{{#if mcp}}\n```json\n// Dry run first (preview)\nmcp__knowns__run_template({\n  "name": "<template-name>",\n  "variables": { "name": "MyComponent", "type": "page" },\n  "dryRun": true\n})\n\n// Then run for real\nmcp__knowns__run_template({\n  "name": "<template-name>",\n  "variables": { "name": "MyComponent", "type": "page" },\n  "dryRun": false\n})\n```\n{{else}}\n```bash\n# Dry run (preview)\nknowns template run <template-name> --name "MyComponent" --dry-run\n\n# Run for real\nknowns template run <template-name> --name "MyComponent"\n```\n{{/if}}\n\n### Step 5: Create New Template\n\n{{#if mcp}}\n```json\nmcp__knowns__create_template({\n  "name": "<template-name>",\n  "description": "Template description",\n  "doc": "patterns/<related-doc>"  // Optional: link to documentation\n})\n```\n{{else}}\n```bash\nknowns template create <template-name>\n```\n{{/if}}\n\nThis creates:\n```\n.knowns/templates/<template-name>/\n  \u251C\u2500\u2500 _template.yaml    # Config\n  \u2514\u2500\u2500 example.ts.hbs    # Example file\n```\n\n## Template Config (`_template.yaml`)\n\n```yaml\nname: react-component\ndescription: Create a React component with tests\ndoc: patterns/react-component    # Link to documentation\n\nprompts:\n  - name: name\n    message: Component name?\n    validate: required\n\n  - name: type\n    message: Component type?\n    type: select\n    choices:\n      - page\n      - component\n      - layout\n\nfiles:\n  - template: "{{name}}.tsx.hbs"\n    destination: "src/components/{{pascalCase name}}/{{pascalCase name}}.tsx"\n\n  - template: "{{name}}.test.tsx.hbs"\n    destination: "src/components/{{pascalCase name}}/{{pascalCase name}}.test.tsx"\n    condition: "{{includeTests}}"\n```\n\n## Template-Doc Linking\n\nTemplates can reference docs and vice versa:\n\n**In `_template.yaml`:**\n```yaml\ndoc: patterns/react-component\n```\n\n**In doc (markdown):**\n```markdown\nUse @template/react-component to generate.\n```\n\n**AI workflow:**\n1. Get template config\n2. Follow `doc:` link to understand patterns\n3. Run template with appropriate variables\n\n## Handlebars Helpers\n\nTemplates use Handlebars with built-in helpers:\n\n| Helper | Example | Output |\n|--------|---------|--------|\n| `camelCase` | `{{camelCase "my name"}}` | `myName` |\n| `pascalCase` | `{{pascalCase "my name"}}` | `MyName` |\n| `kebabCase` | `{{kebabCase "MyName"}}` | `my-name` |\n| `snakeCase` | `{{snakeCase "MyName"}}` | `my_name` |\n| `upperCase` | `{{upperCase "name"}}` | `NAME` |\n| `lowerCase` | `{{lowerCase "NAME"}}` | `name` |\n\n## CRITICAL: Template Syntax Pitfalls\n\n### JavaScript Template Literals + Handlebars\n\n**NEVER write `$` 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, use ~ to trim whitespace\nthis.logger.log(`Created: ${ \\{{~camelCase entity~}}.id}`);\n// Output: this.logger.log(`Created: ${product.id}`);\n```\n\n**Rules when writing .hbs templates:**\n1. Never `$` + triple-brace - always add space: `${ \\{{`\n2. Use `~` (tilde) to trim whitespace: `\\{{~helper~}}`\n3. For literal braces, escape with backslash\n\n## When to Use Templates\n\n| Scenario | Action |\n|----------|--------|\n| Creating new component | Run `react-component` template |\n| Adding API endpoint | Run `api-endpoint` template |\n| Setting up new feature | Run `feature-module` template |\n| Consistent file structure | Use template instead of copy-paste |\n\n## Integrated Workflows\n\n### During Implementation (Use Template)\n\n```\nTask \u2192 Read Context \u2192 Find Template \u2192 Generate Code \u2192 Customize\n```\n\n1. Read task and understand requirements\n2. List templates to find applicable one\n3. Get template details and read linked doc\n4. Run template (dry run first, then real)\n5. Customize generated code as needed\n6. Continue with remaining implementation\n\n**Benefits:**\n- Reduces context (no need to generate boilerplate)\n- Ensures consistency with project patterns\n- Faster implementation\n\n### During Extract (Create Template)\n\n```\nContext \u2192 Identify Pattern \u2192 Create Doc \u2192 Create Template \u2192 Link Both\n```\n\n1. Identify repeatable code pattern\n2. Create doc with `/knowns.extract`\n3. Create template with `knowns template create <name>`\n4. Link template to doc: `doc: patterns/<name>`\n5. Link doc to template: `@template/<name>`\n\n**When to create template:**\n- Pattern will be used multiple times\n- Has consistent file structure\n- Can be parameterized\n\n## Checklist\n\n- [ ] Listed available templates\n- [ ] Got template details (prompts, files)\n- [ ] Read linked documentation (if any)\n- [ ] Understood required variables\n- [ ] Ran dry run first\n- [ ] Ran template with correct inputs\n- [ ] Verified generated files\n\n## Remember\n\n- Always dry run first before writing files\n- Check `doc:` link in template for context\n- Templates ensure consistent code structure\n- Create new templates for repeated patterns\n- **NEVER write `$` + triple-brace** - use `${ \\{{~helper~}}` instead (add space, use tilde)\n';
+
+// src/instructions/skills/index.ts
+function parseSkillFrontmatter(content) {
+  const lines = content.trim().split("\n");
+  let name = "";
+  let description = "";
+  if (lines[0] === "---") {
+    for (let i = 1; i < lines.length; i++) {
+      if (lines[i] === "---") break;
+      const nameMatch = lines[i].match(/^name:\s*(.+)$/);
+      if (nameMatch) name = nameMatch[1].trim();
+      const descMatch = lines[i].match(/^description:\s*(.+)$/);
+      if (descMatch) description = descMatch[1].trim();
+    }
+  }
+  return { name, description };
+}
+function createSkill(content, folderName) {
+  const { name, description } = parseSkillFrontmatter(content);
+  return {
+    name: name || folderName,
+    folderName,
+    description,
+    content: content.trim()
+  };
+}
+var SKILL_TASK = createSkill(SKILL_default10, "knowns.task");
+var SKILL_TASK_PLAN = createSkill(SKILL_default8, "knowns.task.plan");
+var SKILL_TASK_IMPLEMENT = createSkill(SKILL_default7, "knowns.task.implement");
+var SKILL_TASK_BRAINSTORM = createSkill(SKILL_default6, "knowns.task.brainstorm");
+var SKILL_TASK_REOPEN = createSkill(SKILL_default9, "knowns.task.reopen");
+var SKILL_EXTRACT = createSkill(SKILL_default3, "knowns.extract");
+var SKILL_DOC = createSkill(SKILL_default2, "knowns.doc");
+var SKILL_COMMIT = createSkill(SKILL_default, "knowns.commit");
+var SKILL_INIT = createSkill(SKILL_default4, "knowns.init");
+var SKILL_RESEARCH = createSkill(SKILL_default5, "knowns.research");
+var SKILL_TEMPLATE = createSkill(SKILL_default11, "knowns.template");
+
 // src/mcp/handlers/template.ts
-var TEMPLATES_DIR3 = join16(process.cwd(), ".knowns", "templates");
+var TEMPLATES_DIR3 = join17(process.cwd(), ".knowns", "templates");
+var PROJECT_ROOT = process.cwd();
 var listTemplatesSchema = external_exports3.object({});
 var getTemplateSchema = external_exports3.object({
   name: external_exports3.string()
@@ -60096,7 +60225,7 @@ var templateTools = [
       properties: {
         name: {
           type: "string",
-          description: "Template name (folder name in .knowns/templates/)"
+          description: "Template name. Supports import prefix (e.g., 'knowns/component' for imported template)"
         }
       },
       required: ["name"]
@@ -60110,7 +60239,7 @@ var templateTools = [
       properties: {
         name: {
           type: "string",
-          description: "Template name to run"
+          description: "Template name to run. Supports import prefix (e.g., 'knowns/component' for imported template)"
         },
         variables: {
           type: "object",
@@ -60163,7 +60292,7 @@ async function handleListTemplates(_args) {
     const templateList = [];
     for (const t of allTemplates) {
       try {
-        const loaded = await listTemplates(join16(t.path, ".."));
+        const loaded = await listTemplates(join17(t.path, ".."));
         const match2 = loaded.find((l) => l.name === t.name);
         templateList.push({
           name: t.name,
@@ -60199,13 +60328,14 @@ async function handleListTemplates(_args) {
 }
 async function handleGetTemplate(args) {
   const input = getTemplateSchema.parse(args);
-  if (!existsSync12(TEMPLATES_DIR3)) {
-    return errorResponse("No templates directory found");
-  }
   try {
-    const template = await loadTemplateByName(TEMPLATES_DIR3, input.name);
+    const resolved = await resolveTemplate(PROJECT_ROOT, input.name);
+    if (!resolved) {
+      return errorResponse(`Template not found: ${input.name}. Use list_templates to see available templates.`);
+    }
+    const template = await loadTemplate(resolved.path);
     if (!template) {
-      return errorResponse(`Template not found: ${input.name}`);
+      return errorResponse(`Failed to load template: ${input.name}`);
     }
     const prompts2 = template.config.prompts?.map((p) => ({
       name: p.name,
@@ -60240,6 +60370,8 @@ async function handleGetTemplate(args) {
         actions: actions || [],
         messages: template.config.messages
       },
+      source: resolved.isImported ? resolved.source : "local",
+      isImported: resolved.isImported,
       hint: template.config.doc ? `This template links to @doc/${template.config.doc}. Read the doc for context before running.` : void 0
     });
   } catch (error48) {
@@ -60249,13 +60381,14 @@ async function handleGetTemplate(args) {
 async function handleRunTemplate(args) {
   const input = runTemplateSchema.parse(args);
   const dryRun = input.dryRun !== false;
-  if (!existsSync12(TEMPLATES_DIR3)) {
-    return errorResponse("No templates directory found");
-  }
   try {
-    const template = await loadTemplateByName(TEMPLATES_DIR3, input.name);
+    const resolved = await resolveTemplate(PROJECT_ROOT, input.name);
+    if (!resolved) {
+      return errorResponse(`Template not found: ${input.name}. Use list_templates to see available templates.`);
+    }
+    const template = await loadTemplate(resolved.path);
     if (!template) {
-      return errorResponse(`Template not found: ${input.name}`);
+      return errorResponse(`Failed to load template: ${input.name}`);
     }
     const requiredPrompts = template.config.prompts?.filter((p) => p.validate === "required") || [];
     const missingVars = requiredPrompts.filter((p) => !input.variables?.[p.name]).map((p) => p.name);
@@ -60273,7 +60406,7 @@ async function handleRunTemplate(args) {
       }
     }
     const result = await runTemplate(template, {
-      projectRoot: process.cwd(),
+      projectRoot: PROJECT_ROOT,
       values,
       dryRun
     });
@@ -60287,6 +60420,8 @@ async function handleRunTemplate(args) {
       success: true,
       dryRun,
       template: input.name,
+      source: resolved.isImported ? resolved.source : "local",
+      isImported: resolved.isImported,
       variables: values,
       created: result.created || [],
       modified: result.modified || [],
@@ -60300,11 +60435,11 @@ async function handleRunTemplate(args) {
 async function handleCreateTemplate(args) {
   const input = createTemplateSchema.parse(args);
   try {
-    if (!existsSync12(TEMPLATES_DIR3)) {
+    if (!existsSync13(TEMPLATES_DIR3)) {
       await mkdir9(TEMPLATES_DIR3, { recursive: true });
     }
-    const templateDir = join16(TEMPLATES_DIR3, input.name);
-    if (existsSync12(templateDir)) {
+    const templateDir = join17(TEMPLATES_DIR3, input.name);
+    if (existsSync13(templateDir)) {
       return errorResponse(`Template "${input.name}" already exists`);
     }
     await mkdir9(templateDir, { recursive: true });
@@ -60333,7 +60468,7 @@ messages:
   success: |
     \u2713 Created {{name}}!
 `;
-    await writeFile5(join16(templateDir, "_template.yaml"), configContent, "utf-8");
+    await writeFile6(join17(templateDir, "_template.yaml"), configContent, "utf-8");
     const exampleTemplate = `/**
  * {{pascalCase name}}
  * Generated from ${input.name} template
@@ -60343,7 +60478,7 @@ export function {{camelCase name}}() {
   console.log("Hello from {{name}}!");
 }
 `;
-    await writeFile5(join16(templateDir, "example.ts.hbs"), exampleTemplate, "utf-8");
+    await writeFile6(join17(templateDir, "example.ts.hbs"), exampleTemplate, "utf-8");
     return successResponse({
       message: `Created template: ${input.name}`,
       template: {
@@ -60366,9 +60501,9 @@ export function {{camelCase name}}() {
 
 // src/mcp/handlers/search.ts
 var import_gray_matter5 = __toESM(require_gray_matter(), 1);
-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";
+import { existsSync as existsSync14 } from "node:fs";
+import { readFile as readFile9, readdir as readdir8 } from "node:fs/promises";
+import { join as join18 } from "node:path";
 var searchSchema = external_exports3.object({
   query: external_exports3.string(),
   type: external_exports3.enum(["all", "task", "doc"]).optional(),
@@ -60455,12 +60590,12 @@ function calculateDocScore(title, description, content, tags, query) {
 }
 async function getAllMdFiles2(dir, basePath = "") {
   const files = [];
-  if (!existsSync13(dir)) {
+  if (!existsSync14(dir)) {
     return files;
   }
   const entries = await readdir8(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const fullPath = join17(dir, entry.name);
+    const fullPath = join18(dir, entry.name);
     const relativePath = basePath ? `${basePath}/${entry.name}` : entry.name;
     if (entry.isDirectory()) {
       const subFiles = await getAllMdFiles2(fullPath, relativePath);
@@ -60503,14 +60638,14 @@ async function searchTasks(fileStore2, query, filters) {
   })).sort((a, b) => b.score - a.score);
 }
 async function searchDocs(docsDir, query, tagFilter) {
-  if (!existsSync13(docsDir)) {
+  if (!existsSync14(docsDir)) {
     return [];
   }
   const mdFiles = await getAllMdFiles2(docsDir);
   const q = query.toLowerCase();
   const results = [];
   for (const file3 of mdFiles) {
-    const fileContent = await readFile8(join17(docsDir, file3), "utf-8");
+    const fileContent = await readFile9(join18(docsDir, file3), "utf-8");
     const { data, content } = (0, import_gray_matter5.default)(fileContent);
     const metadata = data;
     if (tagFilter && !metadata.tags?.includes(tagFilter)) {
@@ -60547,7 +60682,7 @@ async function handleSearch(args, fileStore2) {
   const input = searchSchema.parse(args);
   const searchType = input.type || "all";
   const limit = input.limit || 20;
-  const docsDir = join17(process.cwd(), ".knowns", "docs");
+  const docsDir = join18(process.cwd(), ".knowns", "docs");
   let taskResults = [];
   let docResults = [];
   if (searchType === "all" || searchType === "task") {
@@ -60666,7 +60801,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 });
 server.setRequestHandler(ListResourcesRequestSchema, async () => {
   const tasks = await fileStore.getAllTasks();
-  const docsDir = join18(process.cwd(), ".knowns", "docs");
+  const docsDir = join19(process.cwd(), ".knowns", "docs");
   const taskResources = tasks.map((task) => ({
     uri: `knowns://task/${task.id}`,
     name: task.title,
@@ -60674,14 +60809,14 @@ server.setRequestHandler(ListResourcesRequestSchema, async () => {
     description: `Task #${task.id}: ${task.title}`
   }));
   const docResources = [];
-  if (existsSync14(docsDir)) {
+  if (existsSync15(docsDir)) {
     const { readdir: readdir9 } = await import("node:fs/promises");
     async function getAllMdFiles3(dir, basePath = "") {
       const files = [];
       const entries = await readdir9(dir, { withFileTypes: true });
       for (const entry of entries) {
-        const fullPath = join18(dir, entry.name);
-        const relativePath = normalizePath(basePath ? join18(basePath, entry.name) : entry.name);
+        const fullPath = join19(dir, entry.name);
+        const relativePath = normalizePath(basePath ? join19(basePath, entry.name) : entry.name);
         if (entry.isDirectory()) {
           const subFiles = await getAllMdFiles3(fullPath, relativePath);
           files.push(...subFiles);
@@ -60693,8 +60828,8 @@ server.setRequestHandler(ListResourcesRequestSchema, async () => {
     }
     const mdFiles = await getAllMdFiles3(docsDir);
     for (const file3 of mdFiles) {
-      const filepath = join18(docsDir, file3);
-      const content = await readFile9(filepath, "utf-8");
+      const filepath = join19(docsDir, file3);
+      const content = await readFile10(filepath, "utf-8");
       const { data } = (0, import_gray_matter6.default)(content);
       docResources.push({
         uri: `knowns://doc/${file3.replace(/\.md$/, "")}`,
@@ -60730,12 +60865,12 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
   const docMatch = uri.match(/^knowns:\/\/doc\/(.+)$/);
   if (docMatch) {
     const docPath = docMatch[1];
-    const docsDir = join18(process.cwd(), ".knowns", "docs");
-    const filepath = join18(docsDir, `${docPath}.md`);
-    if (!existsSync14(filepath)) {
+    const docsDir = join19(process.cwd(), ".knowns", "docs");
+    const filepath = join19(docsDir, `${docPath}.md`);
+    if (!existsSync15(filepath)) {
       throw new Error(`Documentation ${docPath} not found`);
     }
-    const content = await readFile9(filepath, "utf-8");
+    const content = await readFile10(filepath, "utf-8");
     const { data, content: docContent } = (0, import_gray_matter6.default)(content);
     return {
       contents: [