knowns 0.10.6 → 0.11.0

package/dist/mcp/server.js

@@ -10076,10 +10076,10 @@ var require_stringify = __commonJS({
       data = Object.assign({}, file3.data, data);
       const open = opts.delimiters[0];
       const close = opts.delimiters[1];
-      const matter7 = engine.stringify(data, options2).trim();
+      const matter8 = engine.stringify(data, options2).trim();
       let buf = "";
-      if (matter7 !== "{}") {
-        buf = newline(open) + newline(matter7) + newline(close);
+      if (matter8 !== "{}") {
+        buf = newline(open) + newline(matter8) + newline(close);
       }
       if (typeof file3.excerpt === "string" && file3.excerpt !== "") {
         if (str2.indexOf(file3.excerpt.trim()) === -1) {
@@ -10185,19 +10185,19 @@ var require_gray_matter = __commonJS({
     var toFile = require_to_file();
     var parse4 = require_parse();
     var utils = require_utils2();
-    function matter7(input, options2) {
+    function matter8(input, options2) {
       if (input === "") {
         return { data: {}, content: input, excerpt: "", orig: input };
       }
       let file3 = toFile(input);
-      const cached2 = matter7.cache[file3.content];
+      const cached2 = matter8.cache[file3.content];
       if (!options2) {
         if (cached2) {
           file3 = Object.assign({}, cached2);
           file3.orig = cached2.orig;
           return file3;
         }
-        matter7.cache[file3.content] = file3;
+        matter8.cache[file3.content] = file3;
       }
       return parseMatter(file3, options2);
     }
@@ -10219,7 +10219,7 @@ var require_gray_matter = __commonJS({
       }
       str2 = str2.slice(openLen);
       const len = str2.length;
-      const language = matter7.language(str2, opts);
+      const language = matter8.language(str2, opts);
       if (language.name) {
         file3.language = language.name;
         str2 = str2.slice(language.raw.length);
@@ -10254,24 +10254,24 @@ var require_gray_matter = __commonJS({
       }
       return file3;
     }
-    matter7.engines = engines2;
-    matter7.stringify = function(file3, data, options2) {
-      if (typeof file3 === "string") file3 = matter7(file3, options2);
+    matter8.engines = engines2;
+    matter8.stringify = function(file3, data, options2) {
+      if (typeof file3 === "string") file3 = matter8(file3, options2);
       return stringify(file3, data, options2);
     };
-    matter7.read = function(filepath, options2) {
+    matter8.read = function(filepath, options2) {
       const str2 = fs.readFileSync(filepath, "utf8");
-      const file3 = matter7(str2, options2);
+      const file3 = matter8(str2, options2);
       file3.path = filepath;
       return file3;
     };
-    matter7.test = function(str2, options2) {
+    matter8.test = function(str2, options2) {
       return utils.startsWith(str2, defaults2(options2).delimiters[0]);
     };
-    matter7.language = function(str2, options2) {
+    matter8.language = function(str2, options2) {
       const opts = defaults2(options2);
       const open = opts.delimiters[0];
-      if (matter7.test(str2)) {
+      if (matter8.test(str2)) {
         str2 = str2.slice(open.length);
       }
       const language = str2.slice(0, str2.search(/\r?\n/));
@@ -10280,11 +10280,11 @@ var require_gray_matter = __commonJS({
         name: language ? language.trim() : ""
       };
     };
-    matter7.cache = {};
-    matter7.clearCache = function() {
-      matter7.cache = {};
+    matter8.cache = {};
+    matter8.clearCache = function() {
+      matter8.cache = {};
     };
-    module2.exports = matter7;
+    module2.exports = matter8;
   }
 });
 
@@ -18688,7 +18688,7 @@ var require_no_conflict = __commonJS({
   "node_modules/handlebars/dist/cjs/handlebars/no-conflict.js"(exports2, module2) {
     "use strict";
     exports2.__esModule = true;
-    exports2["default"] = function(Handlebars2) {
+    exports2["default"] = function(Handlebars3) {
       (function() {
         if (typeof globalThis === "object") return;
         Object.prototype.__defineGetter__("__magic__", function() {
@@ -18698,11 +18698,11 @@ var require_no_conflict = __commonJS({
         delete Object.prototype.__magic__;
       })();
       var $Handlebars = globalThis.Handlebars;
-      Handlebars2.noConflict = function() {
-        if (globalThis.Handlebars === Handlebars2) {
+      Handlebars3.noConflict = function() {
+        if (globalThis.Handlebars === Handlebars3) {
           globalThis.Handlebars = $Handlebars;
         }
-        return Handlebars2;
+        return Handlebars3;
       };
     };
     module2.exports = exports2["default"];
@@ -20622,7 +20622,7 @@ var require_util2 = __commonJS({
       return path2;
     }
     exports2.normalize = normalize2;
-    function join21(aRoot, aPath) {
+    function join22(aRoot, aPath) {
       if (aRoot === "") {
         aRoot = ".";
       }
@@ -20654,7 +20654,7 @@ var require_util2 = __commonJS({
       }
       return joined;
     }
-    exports2.join = join21;
+    exports2.join = join22;
     exports2.isAbsolute = function(aPath) {
       return aPath.charAt(0) === "/" || urlRegexp.test(aPath);
     };
@@ -20827,7 +20827,7 @@ var require_util2 = __commonJS({
             parsed.path = parsed.path.substring(0, index + 1);
           }
         }
-        sourceURL = join21(urlGenerate(parsed), sourceURL);
+        sourceURL = join22(urlGenerate(parsed), sourceURL);
       }
       return normalize2(sourceURL);
     }
@@ -28653,9 +28653,9 @@ var require_prompts3 = __commonJS({
 });
 
 // src/mcp/server.ts
-import { existsSync as existsSync16 } from "node:fs";
-import { readFile as readFile10 } from "node:fs/promises";
-import { join as join20 } from "node:path";
+import { existsSync as existsSync17 } from "node:fs";
+import { readFile as readFile11 } from "node:fs/promises";
+import { join as join21 } from "node:path";
 
 // node_modules/zod/v3/helpers/util.js
 var util;
@@ -49715,6 +49715,7 @@ function parseTaskMarkdown(content) {
     assignee: frontmatter.assignee,
     labels: frontmatter.labels || [],
     parent: frontmatter.parent,
+    spec: frontmatter.spec,
     subtasks: [],
     // Will be populated by FileStore
     createdAt: new Date(frontmatter.createdAt),
@@ -49741,6 +49742,7 @@ function serializeTaskMarkdown(task) {
   };
   if (task.assignee) frontmatter.assignee = task.assignee;
   if (task.parent) frontmatter.parent = task.parent;
+  if (task.spec) frontmatter.spec = task.spec;
   let body = "";
   body += `# ${task.title}
 
@@ -50433,7 +50435,7 @@ function normalizePath(filePath) {
 }
 
 // src/mcp/server.ts
-var import_gray_matter6 = __toESM(require_gray_matter(), 1);
+var import_gray_matter7 = __toESM(require_gray_matter(), 1);
 
 // src/utils/notify-server.ts
 import { existsSync as existsSync2, readFileSync } from "node:fs";
@@ -50818,6 +50820,10 @@ function errorResponse(error48) {
 }
 
 // src/mcp/handlers/task.ts
+function normalizeNewlines(text) {
+  if (!text) return text;
+  return text.replace(/\\n/g, "\n");
+}
 var createTaskSchema = external_exports3.object({
   title: external_exports3.string(),
   description: external_exports3.string().optional(),
@@ -50825,7 +50831,8 @@ var createTaskSchema = external_exports3.object({
   priority: external_exports3.enum(["low", "medium", "high"]).optional(),
   assignee: external_exports3.string().optional(),
   labels: external_exports3.array(external_exports3.string()).optional(),
-  parent: external_exports3.string().optional()
+  parent: external_exports3.string().optional(),
+  spec: external_exports3.string().optional()
 });
 var getTaskSchema = external_exports3.object({
   taskId: external_exports3.string()
@@ -50838,6 +50845,8 @@ var updateTaskSchema = external_exports3.object({
   priority: external_exports3.enum(["low", "medium", "high"]).optional(),
   assignee: external_exports3.string().optional(),
   labels: external_exports3.array(external_exports3.string()).optional(),
+  spec: external_exports3.string().nullable().optional(),
+  // Spec document path (null to remove)
   // AC operations
   addAc: external_exports3.array(external_exports3.string()).optional(),
   // Add new acceptance criteria
@@ -50859,7 +50868,8 @@ var listTasksSchema = external_exports3.object({
   status: external_exports3.string().optional(),
   priority: external_exports3.string().optional(),
   assignee: external_exports3.string().optional(),
-  label: external_exports3.string().optional()
+  label: external_exports3.string().optional(),
+  spec: external_exports3.string().optional()
 });
 var searchTasksSchema = external_exports3.object({
   query: external_exports3.string()
@@ -50889,7 +50899,8 @@ var taskTools = [
           items: { type: "string" },
           description: "Task labels"
         },
-        parent: { type: "string", description: "Parent task ID for subtasks" }
+        parent: { type: "string", description: "Parent task ID for subtasks" },
+        spec: { type: "string", description: "Spec document path (e.g., 'specs/user-auth')" }
       },
       required: ["title"]
     }
@@ -50930,6 +50941,7 @@ var taskTools = [
           items: { type: "string" },
           description: "New labels"
         },
+        spec: { type: "string", description: "Spec document path (set to null to remove)" },
         addAc: {
           type: "array",
           items: { type: "string" },
@@ -50966,7 +50978,8 @@ var taskTools = [
         status: { type: "string", description: "Filter by status" },
         priority: { type: "string", description: "Filter by priority" },
         assignee: { type: "string", description: "Filter by assignee" },
-        label: { type: "string", description: "Filter by label" }
+        label: { type: "string", description: "Filter by label" },
+        spec: { type: "string", description: "Filter by spec document path" }
       }
     }
   },
@@ -50986,12 +50999,13 @@ async function handleCreateTask(args, fileStore) {
   const input = createTaskSchema.parse(args);
   const task = await fileStore.createTask({
     title: input.title,
-    description: input.description,
+    description: normalizeNewlines(input.description),
     status: input.status || "todo",
     priority: input.priority || "medium",
     assignee: input.assignee,
     labels: input.labels || [],
     parent: input.parent,
+    spec: input.spec,
     subtasks: [],
     acceptanceCriteria: [],
     timeSpent: 0,
@@ -51024,6 +51038,7 @@ async function handleGetTask(args, fileStore) {
       priority: task.priority,
       assignee: task.assignee,
       labels: task.labels,
+      spec: task.spec,
       acceptanceCriteria: task.acceptanceCriteria,
       implementationPlan: task.implementationPlan,
       implementationNotes: task.implementationNotes,
@@ -51042,11 +51057,14 @@ async function handleUpdateTask(args, fileStore) {
   }
   const updates = {};
   if (input.title) updates.title = input.title;
-  if (input.description) updates.description = input.description;
+  if (input.description) updates.description = normalizeNewlines(input.description);
   if (input.status) updates.status = input.status;
   if (input.priority) updates.priority = input.priority;
   if (input.assignee) updates.assignee = input.assignee;
   if (input.labels) updates.labels = input.labels;
+  if (input.spec !== void 0) {
+    updates.spec = input.spec === null ? void 0 : input.spec;
+  }
   const criteria = [...currentTask.acceptanceCriteria];
   let acModified = false;
   if (input.addAc && input.addAc.length > 0) {
@@ -51089,15 +51107,15 @@ async function handleUpdateTask(args, fileStore) {
     updates.acceptanceCriteria = criteria;
   }
   if (input.plan !== void 0) {
-    updates.implementationPlan = input.plan;
+    updates.implementationPlan = normalizeNewlines(input.plan);
   }
   if (input.notes !== void 0) {
-    updates.implementationNotes = input.notes;
+    updates.implementationNotes = normalizeNewlines(input.notes);
   }
   if (input.appendNotes) {
     const existingNotes = currentTask.implementationNotes || "";
     const separator = existingNotes ? "\n\n" : "";
-    updates.implementationNotes = existingNotes + separator + input.appendNotes;
+    updates.implementationNotes = existingNotes + separator + normalizeNewlines(input.appendNotes);
   }
   const task = await fileStore.updateTask(taskId, updates);
   await notifyTaskUpdate(task.id);
@@ -51128,6 +51146,9 @@ async function handleListTasks(args, fileStore) {
   if (input.label) {
     tasks = tasks.filter((t) => t.labels.includes(input.label));
   }
+  if (input.spec) {
+    tasks = tasks.filter((t) => t.spec === input.spec);
+  }
   return successResponse({
     count: tasks.length,
     tasks: tasks.map((t) => ({
@@ -51136,7 +51157,8 @@ async function handleListTasks(args, fileStore) {
       status: t.status,
       priority: t.priority,
       assignee: t.assignee,
-      labels: t.labels
+      labels: t.labels,
+      spec: t.spec
     }))
   });
 }
@@ -51999,8 +52021,8 @@ var NpmProvider = class extends ImportProvider {
     try {
       const packageJsonPath = join12(tempDir, "package.json");
       if (existsSync8(packageJsonPath)) {
-        const { readFile: readFile11 } = await import("node:fs/promises");
-        const content = await readFile11(packageJsonPath, "utf-8");
+        const { readFile: readFile12 } = await import("node:fs/promises");
+        const content = await readFile12(packageJsonPath, "utf-8");
         const pkg = JSON.parse(content);
         if (pkg.version) {
           metadata.version = pkg.version;
@@ -52409,6 +52431,10 @@ async function validateRefs(projectRoot, content, tasksDir) {
 function getDocsDir() {
   return join15(getProjectRoot(), ".knowns", "docs");
 }
+function normalizeNewlines2(text) {
+  if (!text) return text;
+  return text.replace(/\\n/g, "\n");
+}
 var listDocsSchema = external_exports3.object({
   tag: external_exports3.string().optional()
 });
@@ -52800,7 +52826,7 @@ async function handleCreateDoc(args) {
   if (input.tags) {
     metadata.tags = input.tags;
   }
-  const initialContent = input.content || "# Content\n\nWrite your documentation here.";
+  const initialContent = normalizeNewlines2(input.content) || "# Content\n\nWrite your documentation here.";
   const fileContent = import_gray_matter3.default.stringify(initialContent, metadata);
   await writeFile4(filepath, fileContent, "utf-8");
   await notifyDocUpdate(relativePath);
@@ -52829,9 +52855,11 @@ async function handleUpdateDoc(args) {
   metadata.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
   let updatedContent = content;
   let sectionUpdated;
-  if (input.section && input.content) {
+  const normalizedContent = normalizeNewlines2(input.content);
+  const normalizedAppend = normalizeNewlines2(input.appendContent);
+  if (input.section && normalizedContent) {
     const sectionIndex = /^\d+$/.test(input.section) ? Number.parseInt(input.section, 10) : null;
-    const result = sectionIndex !== null ? replaceSectionByIndex(content, sectionIndex, input.content) : replaceSection(content, input.section, input.content);
+    const result = sectionIndex !== null ? replaceSectionByIndex(content, sectionIndex, normalizedContent) : replaceSection(content, input.section, normalizedContent);
     if (!result) {
       return errorResponse(
         `Section not found: ${input.section}. Use 'toc: true' with get_doc to see available sections.`
@@ -52839,13 +52867,13 @@ async function handleUpdateDoc(args) {
     }
     updatedContent = result;
     sectionUpdated = input.section;
-  } else if (input.content) {
-    updatedContent = input.content;
+  } else if (normalizedContent) {
+    updatedContent = normalizedContent;
   }
-  if (input.appendContent) {
+  if (normalizedAppend) {
     updatedContent = `${updatedContent.trimEnd()}
 
-${input.appendContent}`;
+${normalizedAppend}`;
   }
   const newFileContent = import_gray_matter3.default.stringify(updatedContent, metadata);
   await writeFile4(resolved.filepath, newFileContent, "utf-8");
@@ -53065,6 +53093,20 @@ async function listTemplates(templatesDir) {
   }
   return templates;
 }
+async function getTemplateConfig(templateDir) {
+  const configPath = join16(templateDir, CONFIG_FILENAME);
+  if (!existsSync12(configPath)) {
+    return null;
+  }
+  try {
+    const content = await readFile6(configPath, "utf-8");
+    const raw = (0, import_yaml.parse)(content);
+    const result = safeValidateTemplateConfig(raw);
+    return result.success ? result.data : null;
+  } catch {
+    return null;
+  }
+}
 
 // src/codegen/renderer.ts
 import { readFile as readFile7 } from "node:fs/promises";
@@ -60166,38 +60208,35 @@ 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/kn:commit/SKILL.md
+var SKILL_default = '---\nname: kn:commit\ndescription: Use when committing code changes with proper conventional commit format and verification\n---\n\n# Committing Changes\n\n**Announce:** "Using kn:commit to commit changes."\n\n**Core principle:** VERIFY BEFORE COMMITTING - check staged changes, ask for confirmation.\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```\n\n**Types:** feat, fix, docs, style, refactor, perf, test, chore\n\n**Rules:**\n- Title lowercase, no period, max 50 chars\n- Body explains *why*, not just *what*\n\n## Step 3: Ask for Confirmation\n\n```\nReady to commit:\n\nfeat(auth): add JWT token refresh\n\n- Added refresh token endpoint\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```\n\n## Guidelines\n\n- Only commit staged files\n- NO "Co-Authored-By" lines\n- NO "Generated with Claude Code" ads\n- Ask before committing\n\n## Checklist\n\n- [ ] Reviewed staged changes\n- [ ] Message follows convention\n- [ ] User approved\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/kn:doc/SKILL.md
+var SKILL_default2 = '---\nname: kn:doc\ndescription: Use when working with Knowns documentation - viewing, searching, creating, or updating docs\n---\n\n# Working with Documentation\n\n**Announce:** "Using kn:doc to work with documentation."\n\n**Core principle:** SEARCH BEFORE CREATING - avoid duplicates.\n\n## Quick Reference\n\n```json\n// List 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 (MUST include description)\nmcp__knowns__create_doc({\n  "title": "<title>",\n  "description": "<brief description of what this doc covers>",\n  "tags": ["tag1", "tag2"],\n  "folder": "folder"\n})\n\n// Update content\nmcp__knowns__update_doc({\n  "path": "<path>",\n  "content": "content"\n})\n\n// Update metadata (title, description, tags)\nmcp__knowns__update_doc({\n  "path": "<path>",\n  "title": "New Title",\n  "description": "Updated description",\n  "tags": ["new", "tags"]\n})\n\n// Update section only\nmcp__knowns__update_doc({\n  "path": "<path>",\n  "section": "2",\n  "content": "## 2. New Content\\n\\n..."\n})\n```\n\n## Creating Documents\n\n1. Search first (avoid duplicates)\n2. Choose location:\n\n| Type | Folder |\n|------|--------|\n| Core | (root) |\n| Guide | `guides` |\n| Pattern | `patterns` |\n| API | `api` |\n\n3. Create with **title + description + tags**\n4. Add content\n5. **Validate** after creating\n\n**CRITICAL:** Always include `description` - validate will fail without it!\n\n## Updating Documents\n\n**Section edit is most efficient:**\n```json\nmcp__knowns__update_doc({\n  "path": "<path>",\n  "section": "3",\n  "content": "## 3. New Content\\n\\n..."\n})\n```\n\n## Validate After Changes\n\n**CRITICAL:** After creating/updating docs, validate:\n\n```json\nmcp__knowns__validate({ "scope": "docs" })\n```\n\nIf errors found, fix before continuing.\n\n## Mermaid Diagrams\n\nWebUI supports mermaid rendering. Use for:\n- Architecture diagrams\n- Flowcharts\n- Sequence diagrams\n- Entity relationships\n\n````markdown\n```mermaid\ngraph TD\n    A[Start] --> B{Decision}\n    B -->|Yes| C[Action]\n    B -->|No| D[End]\n```\n````\n\nDiagrams render automatically in WebUI preview.\n\n## Checklist\n\n- [ ] Searched for existing docs\n- [ ] Created with **description** (required!)\n- [ ] Used section editing for updates\n- [ ] Used mermaid for complex flows (optional)\n- [ ] Referenced with `@doc/<path>`\n- [ ] **Validated after changes**\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/kn:extract/SKILL.md
+var SKILL_default3 = '---\nname: kn:extract\ndescription: Use when extracting reusable patterns, solutions, or knowledge into documentation\n---\n\n# Extracting Knowledge\n\n**Announce:** "Using kn:extract to extract knowledge."\n\n**Core principle:** ONLY EXTRACT GENERALIZABLE KNOWLEDGE.\n\n## Step 1: Identify Source\n\n```json\nmcp__knowns__get_task({ "taskId": "$ARGUMENTS" })\n```\n\nLook for: patterns, problems solved, decisions made, lessons learned.\n\n## Step 2: Search for Existing Docs\n\n```json\nmcp__knowns__search_docs({ "query": "<pattern/topic>" })\n```\n\n**Don\'t duplicate.** Update existing docs when possible.\n\n## Step 3: Create Documentation\n\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\nmcp__knowns__update_doc({\n  "path": "patterns/<name>",\n  "content": "# Pattern: <Name>\\n\\n## Problem\\n...\\n\\n## Solution\\n...\\n\\n## Example\\n```typescript\\n// Code\\n```\\n\\n## Source\\n@task-<id>"\n})\n```\n\n## Step 4: Create Template (if code-generatable)\n\n```json\nmcp__knowns__create_template({\n  "name": "<pattern-name>",\n  "description": "Generate <what>",\n  "doc": "patterns/<pattern-name>"\n})\n```\n\nLink template in doc:\n```json\nmcp__knowns__update_doc({\n  "path": "patterns/<name>",\n  "appendContent": "\\n\\n## Generate\\n\\nUse @template/<pattern-name>"\n})\n```\n\n## Step 5: Validate\n\n**CRITICAL:** After creating doc/template, validate to catch broken refs:\n\n```json\nmcp__knowns__validate({})\n```\n\nIf errors found, fix before continuing.\n\n## Step 6: Link Back to Task\n\n```json\nmcp__knowns__update_task({\n  "taskId": "$ARGUMENTS",\n  "appendNotes": "\u{1F4DA} Extracted to @doc/patterns/<name>"\n})\n```\n\n## What to Extract\n\n| Source | Extract As | Template? |\n|--------|------------|-----------|\n| Code pattern | Pattern doc | \u2705 Yes |\n| API pattern | Integration guide | \u2705 Yes |\n| Error solution | Troubleshooting | \u274C No |\n| Security approach | Guidelines | \u274C No |\n\n## Checklist\n\n- [ ] Knowledge is generalizable\n- [ ] Includes working example\n- [ ] Links back to source\n- [ ] Template created (if applicable)\n- [ ] **Validated (no broken refs)**\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/kn:implement/SKILL.md
+var SKILL_default4 = '---\nname: kn: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:** "Using kn:implement for task [ID]."\n\n**Core principle:** CHECK AC ONLY AFTER WORK IS DONE.\n\n## Step 1: Review Task\n\n```json\nmcp__knowns__get_task({ "taskId": "$ARGUMENTS" })\n```\n\n**If task status is "done"** (reopening):\n```json\nmcp__knowns__update_task({\n  "taskId": "$ARGUMENTS",\n  "status": "in-progress",\n  "appendNotes": "Reopened: <reason>"\n})\nmcp__knowns__start_time({ "taskId": "$ARGUMENTS" })\n```\n\nVerify: plan exists, timer running, which ACs pending.\n\n## Step 2: Check Templates\n\n```json\nmcp__knowns__list_templates({})\n```\n\nIf template exists \u2192 use it to generate boilerplate.\n\n## Step 3: Work Through Plan\n\nFor each step:\n1. Do the work\n2. Check AC (only after done!)\n3. Append note\n\n```json\nmcp__knowns__update_task({\n  "taskId": "$ARGUMENTS",\n  "checkAc": [1],\n  "appendNotes": "Done: brief description"\n})\n```\n\n## Step 4: Handle Scope Changes\n\n**Small:** Add AC + note\n```json\nmcp__knowns__update_task({\n  "taskId": "$ARGUMENTS",\n  "addAc": ["New requirement"],\n  "appendNotes": "Scope: added per user"\n})\n```\n\n**Large:** Stop and ask user.\n\n## Step 5: Validate & Complete\n\n1. Run tests/lint/build\n2. **Validate** to catch broken refs:\n\n```json\nmcp__knowns__validate({})\n```\n\n3. Add implementation notes (use `appendNotes`, NOT `notes`!)\n4. Stop timer + mark done\n\n```json\nmcp__knowns__stop_time({ "taskId": "$ARGUMENTS" })\nmcp__knowns__update_task({\n  "taskId": "$ARGUMENTS",\n  "status": "done"\n})\n```\n\n## Step 6: Extract Knowledge (optional)\n\nIf patterns discovered: `/kn:extract $ARGUMENTS`\n\n## Checklist\n\n- [ ] All ACs checked\n- [ ] Tests pass\n- [ ] **Validated (no broken refs)**\n- [ ] Notes added\n- [ ] Timer stopped\n- [ ] Status = done\n\n## Red Flags\n\n- Checking AC before work done\n- Skipping tests\n- Skipping validation\n- Using `notes` instead of `appendNotes`\n- Marking done without verification\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/kn:init/SKILL.md
+var SKILL_default5 = '---\nname: kn: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\n**Announce:** "Using kn:init to initialize session."\n\n**Core principle:** READ DOCS BEFORE DOING ANYTHING ELSE.\n\n## Step 1: List Docs\n\n```json\nmcp__knowns__list_docs({})\n```\n\n## Step 2: Read Core Docs\n\n```json\nmcp__knowns__get_doc({ "path": "README", "smart": true })\nmcp__knowns__get_doc({ "path": "ARCHITECTURE", "smart": true })\nmcp__knowns__get_doc({ "path": "CONVENTIONS", "smart": true })\n```\n\n## Step 3: Check Current State\n\n```json\nmcp__knowns__list_tasks({ "status": "in-progress" })\nmcp__knowns__get_board({})\n```\n\n## Step 4: Summarize\n\n```markdown\n## Session Context\n- **Project**: [name]\n- **Key Docs**: README, ARCHITECTURE, CONVENTIONS\n- **In-progress tasks**: [count]\n- **Ready for**: tasks, docs, questions\n```\n\n## Next Steps\n\n```\n/kn:plan <task-id>     # Plan a task\n/kn:research <query>   # Research codebase\n```\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/kn:plan/SKILL.md
+var SKILL_default6 = '---\nname: kn:plan\ndescription: Use when creating an implementation plan for a task\n---\n\n# Planning a Task\n\n**Announce:** "Using kn:plan for task [ID]."\n\n**Core principle:** GATHER CONTEXT \u2192 PLAN \u2192 VALIDATE \u2192 WAIT FOR APPROVAL.\n\n## Mode Detection\n\nCheck if `$ARGUMENTS` contains `--from`:\n- **Yes** \u2192 Go to "Generate Tasks from Spec" section\n- **No** \u2192 Continue with normal planning flow\n\n---\n\n# Normal Planning Flow\n\n## Step 1: Take Ownership\n\n```json\nmcp__knowns__get_task({ "taskId": "$ARGUMENTS" })\nmcp__knowns__update_task({\n  "taskId": "$ARGUMENTS",\n  "status": "in-progress",\n  "assignee": "@me"\n})\nmcp__knowns__start_time({ "taskId": "$ARGUMENTS" })\n```\n\n## Step 2: Gather Context\n\nFollow refs in task:\n```json\nmcp__knowns__get_doc({ "path": "<path>", "smart": true })\nmcp__knowns__get_task({ "taskId": "<id>" })\n```\n\nSearch related:\n```json\nmcp__knowns__search_docs({ "query": "<keywords>" })\nmcp__knowns__list_templates({})\n```\n\n## Step 3: Draft Plan\n\n```markdown\n## Implementation Plan\n1. [Step] (see @doc/relevant-doc)\n2. [Step] (use @template/xxx)\n3. Add tests\n4. Update docs\n```\n\n**Tip:** Use mermaid for complex flows:\n````markdown\n```mermaid\ngraph LR\n    A[Input] --> B[Process] --> C[Output]\n```\n````\n\n## Step 4: Save Plan\n\n```json\nmcp__knowns__update_task({\n  "taskId": "$ARGUMENTS",\n  "plan": "1. Step one\\n2. Step two\\n3. Tests"\n})\n```\n\n## Step 5: Validate\n\n**CRITICAL:** After saving plan with refs, validate to catch broken refs:\n\n```bash\nknowns validate --plain\n```\n\nIf errors found (broken `@doc/...` or `@task-...`), fix before asking approval.\n\n## Step 6: Ask Approval\n\nPresent plan and **WAIT for explicit approval**.\n\n## Next Step\n\nAfter approval: `/kn:implement $ARGUMENTS`\n\n## Checklist\n\n- [ ] Ownership taken\n- [ ] Timer started\n- [ ] Refs followed\n- [ ] Templates checked\n- [ ] **Validated (no broken refs)**\n- [ ] User approved\n\n---\n\n# Generate Tasks from Spec\n\nWhen `$ARGUMENTS` contains `--from @doc/specs/<name>`:\n\n**Announce:** "Using kn:plan to generate tasks from spec [name]."\n\n## Step 1: Read Spec Document\n\nExtract spec path from arguments (e.g., `--from @doc/specs/user-auth` \u2192 `specs/user-auth`).\n\n```json\nmcp__knowns__get_doc({ "path": "specs/<name>", "smart": true })\n```\n\n## Step 2: Parse Requirements\n\nScan spec for:\n- **Functional Requirements** (FR-1, FR-2, etc.)\n- **Acceptance Criteria** (AC-1, AC-2, etc.)\n- **Scenarios** (for edge cases)\n\nGroup related items into logical tasks.\n\n## Step 3: Generate Task Preview\n\nFor each requirement/group, create task structure:\n\n```markdown\n## Generated Tasks from specs/<name>\n\n### Task 1: [Requirement Title]\n- **Description:** [From spec]\n- **ACs:**\n  - [ ] AC from spec\n  - [ ] AC from spec\n- **Spec:** specs/<name>\n- **Priority:** medium\n\n### Task 2: [Requirement Title]\n- **Description:** [From spec]\n- **ACs:**\n  - [ ] AC from spec\n- **Spec:** specs/<name>\n- **Priority:** medium\n\n---\nTotal: X tasks to create\n```\n\n## Step 4: Ask for Approval\n\n> I\'ve generated **X tasks** from the spec. Please review:\n> - **Approve** to create all tasks\n> - **Edit** to modify before creating\n> - **Cancel** to abort\n\n**WAIT for explicit approval.**\n\n## Step 5: Create Tasks\n\nWhen approved:\n\n```json\nmcp__knowns__create_task({\n  "title": "<requirement title>",\n  "description": "<from spec>",\n  "spec": "specs/<name>",\n  "priority": "medium",\n  "labels": ["from-spec"]\n})\n```\n\nThen add ACs:\n```json\nmcp__knowns__update_task({\n  "taskId": "<new-id>",\n  "addAc": ["AC 1", "AC 2", "AC 3"]\n})\n```\n\nRepeat for each task.\n\n## Step 6: Summary\n\n```markdown\n## Created Tasks\n\n| ID | Title | ACs |\n|----|-------|-----|\n| task-xxx | Requirement 1 | 3 |\n| task-yyy | Requirement 2 | 2 |\n\nAll tasks linked to spec: specs/<name>\n\nNext steps:\n- Start with: `/kn:plan <first-task-id>`\n- Or view all: `knowns task list --spec specs/<name> --plain`\n```\n\n## Checklist (--from mode)\n\n- [ ] Spec document read\n- [ ] Requirements parsed\n- [ ] Tasks previewed\n- [ ] User approved\n- [ ] Tasks created with spec link\n- [ ] Summary shown\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/kn:research/SKILL.md
+var SKILL_default7 = '---\nname: kn: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\n**Announce:** "Using kn:research for [topic]."\n\n**Core principle:** UNDERSTAND WHAT EXISTS BEFORE ADDING NEW CODE.\n\n## Step 1: Search Documentation\n\n```json\nmcp__knowns__search_docs({ "query": "<topic>" })\nmcp__knowns__get_doc({ "path": "<path>", "smart": true })\n```\n\n## Step 2: Search Completed Tasks\n\n```json\nmcp__knowns__search_tasks({ "query": "<keywords>" })\nmcp__knowns__get_task({ "taskId": "<id>" })\n```\n\n## Step 3: Search Codebase\n\n```bash\nfind . -name "*<pattern>*" -type f | grep -v node_modules | head -20\ngrep -r "<pattern>" --include="*.ts" -l | head -20\n```\n\n## Step 4: Document Findings\n\n```markdown\n## Research: [Topic]\n\n### Existing Implementations\n- `src/path/file.ts`: Does X\n\n### Patterns Found\n- Pattern 1: Used for...\n\n### Related Docs\n- @doc/path1 - Covers X\n\n### Recommendations\n1. Reuse X from Y\n2. Follow pattern Z\n```\n\n## Checklist\n\n- [ ] Searched documentation\n- [ ] Reviewed similar completed tasks\n- [ ] Found existing code patterns\n- [ ] Identified reusable components\n\n## Next Step\n\nAfter research: `/kn:plan <task-id>`\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/kn:spec/SKILL.md
+var SKILL_default8 = '---\nname: kn:spec\ndescription: Use when creating a specification document for a feature (SDD workflow)\n---\n\n# Creating a Spec Document\n\nCreate a specification document for a feature using SDD (Spec-Driven Development).\n\n**Announce:** "Using kn:spec to create spec for [name]."\n\n**Core principle:** SPEC FIRST \u2192 REVIEW \u2192 APPROVE \u2192 THEN PLAN TASKS.\n\n## Step 1: Get Feature Name\n\nIf `$ARGUMENTS` provided, use it as spec name.\n\nIf no arguments, ask user:\n> What feature are you speccing? (e.g., "user-auth", "payment-flow")\n\n## Step 2: Gather Requirements\n\nAsk user to describe the feature:\n> Please describe the feature requirements. What should it do?\n\nListen for:\n- Core functionality\n- User stories / scenarios\n- Edge cases\n- Non-functional requirements\n\n## Step 3: Create Spec Document\n\n```json\nmcp__knowns__create_doc({\n  "title": "<Feature Name>",\n  "description": "Specification for <feature>",\n  "folder": "specs",\n  "tags": ["spec", "draft"],\n  "content": "<spec content>"\n})\n```\n\n**Spec Template:**\n\n```markdown\n## Overview\n\nBrief description of the feature and its purpose.\n\n## Requirements\n\n### Functional Requirements\n- FR-1: [Requirement description]\n- FR-2: [Requirement description]\n\n### Non-Functional Requirements\n- NFR-1: [Performance, security, etc.]\n\n## Acceptance Criteria\n\n- [ ] AC-1: [Testable criterion]\n- [ ] AC-2: [Testable criterion]\n- [ ] AC-3: [Testable criterion]\n\n## Scenarios\n\n### Scenario 1: [Happy Path]\n**Given** [context]\n**When** [action]\n**Then** [expected result]\n\n### Scenario 2: [Edge Case]\n**Given** [context]\n**When** [action]\n**Then** [expected result]\n\n## Technical Notes\n\nOptional implementation hints or constraints.\n\n## Open Questions\n\n- [ ] Question 1?\n- [ ] Question 2?\n```\n\n## Step 4: Ask for Review\n\nPresent the spec and ask:\n> Please review this spec:\n> - **Approve** if requirements are complete\n> - **Edit** if you want to modify something\n> - **Add more** if requirements are missing\n\n## Step 5: Handle Response\n\n**If approved:**\n```json\nmcp__knowns__update_doc({\n  "path": "specs/<name>",\n  "tags": ["spec", "approved"]\n})\n```\n\nThen suggest:\n> Spec approved! Ready to create tasks?\n> Run: `/kn:plan --from @doc/specs/<name>`\n\n**If edit requested:**\nUpdate the spec based on feedback and return to Step 4.\n\n**If add more:**\nGather additional requirements and update spec.\n\n## Checklist\n\n- [ ] Feature name determined\n- [ ] Requirements gathered\n- [ ] Spec created in specs/ folder\n- [ ] Includes: Overview, Requirements, ACs, Scenarios\n- [ ] User reviewed\n- [ ] Status updated (draft \u2192 approved)\n- [ ] Next step suggested (/kn:plan --from)\n\n## Red Flags\n\n- Creating spec without user input\n- Skipping review step\n- Approving without explicit user confirmation\n- Not suggesting task creation after approval\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/kn:template/SKILL.md
+var SKILL_default9 = '---\nname: kn:template\ndescription: Use when generating code from templates - list, run, or create templates\n---\n\n# Working with Templates\n\n**Announce:** "Using kn:template to work with templates."\n\n**Core principle:** USE TEMPLATES FOR CONSISTENT CODE GENERATION.\n\n## Step 1: List Templates\n\n```json\nmcp__knowns__list_templates({})\n```\n\n## Step 2: Get Template Details\n\n```json\nmcp__knowns__get_template({ "name": "<template-name>" })\n```\n\nCheck: prompts, `doc:` link, files to generate.\n\n## Step 3: Read Linked Documentation\n\n```json\nmcp__knowns__get_doc({ "path": "<doc-path>", "smart": true })\n```\n\n## Step 4: Run Template\n\n```json\n// Dry run first\nmcp__knowns__run_template({\n  "name": "<template-name>",\n  "variables": { "name": "MyComponent" },\n  "dryRun": true\n})\n\n// Then run for real\nmcp__knowns__run_template({\n  "name": "<template-name>",\n  "variables": { "name": "MyComponent" },\n  "dryRun": false\n})\n```\n\n## Step 5: Create New Template\n\n```json\nmcp__knowns__create_template({\n  "name": "<template-name>",\n  "description": "Description",\n  "doc": "patterns/<related-doc>"\n})\n```\n\n## Template Config\n\n```yaml\nname: react-component\ndescription: Create a React component\ndoc: patterns/react-component\n\nprompts:\n  - name: name\n    message: Component name?\n    validate: required\n\nfiles:\n  - template: ".tsx.hbs"\n    destination: "src/components//.tsx"\n```\n\n## CRITICAL: Syntax Pitfalls\n\n**NEVER write `$` + triple-brace:**\n```\n// \u274C WRONG\n$` + `{` + `{` + `{camelCase name}`\n\n// \u2705 CORRECT - add space, use ~\n${ {{~camelCase name~}}}\n```\n\n## Checklist\n\n- [ ] Listed available templates\n- [ ] Read linked documentation\n- [ ] Ran dry run first\n- [ ] Verified generated files\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/kn:verify/SKILL.md
+var SKILL_default10 = '---\nname: kn:verify\ndescription: Use when running SDD verification and coverage reporting\n---\n\n# SDD Verification\n\nRun validation with SDD-awareness to check spec coverage and task status.\n\n**Announce:** "Using kn:verify to check SDD status."\n\n**Core principle:** VERIFY SPEC COVERAGE \u2192 REPORT WARNINGS \u2192 SUGGEST FIXES.\n\n## Step 1: Run SDD Validation\n\n### Via CLI\n```bash\nknowns validate --sdd --plain\n```\n\n### Via MCP (if available)\n```json\nmcp__knowns__validate({ "scope": "sdd" })\n```\n\n## Step 2: Present SDD Status Report\n\nDisplay the results in this format:\n\n```\nSDD Status Report\n\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\nSpecs:    X total | Y approved | Z draft\nTasks:    X total | Y done | Z in-progress | W todo\nCoverage: X/Y tasks linked to specs (Z%)\n\n\u26A0\uFE0F Warnings:\n  - task-XX has no spec reference\n  - specs/feature: X/Y ACs incomplete\n\n\u2705 Passed:\n  - All spec references resolve\n  - specs/auth: fully implemented\n```\n\n## Step 3: Analyze Results\n\n**Good coverage (>80%):**\n> SDD coverage is healthy. All tasks are properly linked to specs.\n\n**Medium coverage (50-80%):**\n> Some tasks are missing spec references. Consider:\n> - Link existing tasks to specs: `knowns task edit <id> --spec specs/<name>`\n> - Create specs for unlinked work: `/kn:spec <feature-name>`\n\n**Low coverage (<50%):**\n> Many tasks lack spec references. For better traceability:\n> 1. Create specs for major features: `/kn:spec <feature>`\n> 2. Link tasks to specs: `knowns task edit <id> --spec specs/<name>`\n> 3. Use `/kn:plan --from @doc/specs/<name>` for new tasks\n\n## Step 4: Suggest Actions\n\nBased on warnings, suggest specific fixes:\n\n**For tasks without spec:**\n> Link task to spec:\n> ```bash\n> knowns task edit <id> --spec specs/<name>\n> ```\n\n**For incomplete ACs:**\n> Check task progress:\n> ```bash\n> knowns task <id> --plain\n> ```\n\n**For approved specs without tasks:**\n> Create tasks from spec:\n> ```\n> /kn:plan --from @doc/specs/<name>\n> ```\n\n## Checklist\n\n- [ ] Ran validate --sdd\n- [ ] Presented status report\n- [ ] Analyzed coverage level\n- [ ] Suggested specific fixes for warnings\n\n## Red Flags\n\n- Ignoring warnings\n- Not suggesting actionable fixes\n- Skipping coverage analysis\n';
 
 // src/instructions/skills/index.ts
 function parseSkillFrontmatter(content) {
@@ -60224,17 +60263,16 @@ function createSkill(content, folderName) {
     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");
+var SKILL_INIT = createSkill(SKILL_default5, "kn:init");
+var SKILL_PLAN = createSkill(SKILL_default6, "kn:plan");
+var SKILL_IMPLEMENT = createSkill(SKILL_default4, "kn:implement");
+var SKILL_RESEARCH = createSkill(SKILL_default7, "kn:research");
+var SKILL_COMMIT = createSkill(SKILL_default, "kn:commit");
+var SKILL_EXTRACT = createSkill(SKILL_default3, "kn:extract");
+var SKILL_DOC = createSkill(SKILL_default2, "kn:doc");
+var SKILL_TEMPLATE = createSkill(SKILL_default9, "kn:template");
+var SKILL_SPEC = createSkill(SKILL_default8, "kn:spec");
+var SKILL_VERIFY = createSkill(SKILL_default10, "kn:verify");
 
 // src/mcp/handlers/template.ts
 function getTemplatesDir() {
@@ -60766,6 +60804,657 @@ async function handleSearch(args, fileStore) {
   });
 }
 
+// src/mcp/handlers/validate.ts
+import { existsSync as existsSync16 } from "node:fs";
+import { readFile as readFile10, readdir as readdir9, writeFile as writeFile7 } from "node:fs/promises";
+import { join as join20 } from "node:path";
+var import_gray_matter6 = __toESM(require_gray_matter(), 1);
+var import_handlebars2 = __toESM(require_lib(), 1);
+init_config();
+var validateTools = [
+  {
+    name: "validate",
+    description: "Validate tasks, docs, and templates for reference integrity and quality. Returns errors, warnings, and info about broken refs, missing AC, orphan docs, etc. Use scope='sdd' for SDD (Spec-Driven Development) validation.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        scope: {
+          type: "string",
+          enum: ["all", "tasks", "docs", "templates", "sdd"],
+          description: "Validation scope: 'all' (default), 'tasks', 'docs', 'templates', or 'sdd' for spec-driven checks"
+        },
+        strict: {
+          type: "boolean",
+          description: "Treat warnings as errors (default: false)"
+        },
+        fix: {
+          type: "boolean",
+          description: "Auto-fix supported issues like broken doc refs (default: false)"
+        }
+      }
+    }
+  }
+];
+function stripTrailingPunctuation(path2) {
+  return path2.replace(/[.,;:!?`'")\]]+$/, "");
+}
+function extractRefs(content) {
+  const docRefs = [];
+  const taskRefs = [];
+  const templateRefs = [];
+  const docRefPattern = /@docs?\/([^\s,;:!?"'()\]]+)/g;
+  for (const match2 of content.matchAll(docRefPattern)) {
+    let docPath = stripTrailingPunctuation(match2[1] || "");
+    docPath = docPath.replace(/\.md$/, "");
+    if (docPath && !docRefs.includes(docPath)) {
+      docRefs.push(docPath);
+    }
+  }
+  const taskRefPattern = /@task-([a-zA-Z0-9]+)/g;
+  for (const match2 of content.matchAll(taskRefPattern)) {
+    const taskId = match2[1] || "";
+    if (taskId && !taskRefs.includes(taskId)) {
+      taskRefs.push(taskId);
+    }
+  }
+  const templateRefPattern = /@template\/([^\s,;:!?"'()\]]+)/g;
+  for (const match2 of content.matchAll(templateRefPattern)) {
+    const templateName = stripTrailingPunctuation(match2[1] || "");
+    if (templateName && !templateRefs.includes(templateName)) {
+      templateRefs.push(templateName);
+    }
+  }
+  return { docRefs, taskRefs, templateRefs };
+}
+async function loadValidateConfig(projectRoot) {
+  const config2 = await readConfig(projectRoot);
+  return config2.validate || {};
+}
+function getRuleSeverity(rule, defaultSeverity, validateConfig) {
+  if (validateConfig.rules?.[rule]) {
+    return validateConfig.rules[rule];
+  }
+  return defaultSeverity;
+}
+function shouldIgnore(entity, validateConfig) {
+  if (!validateConfig.ignore) return false;
+  for (const pattern of validateConfig.ignore) {
+    const regex = new RegExp(`^${pattern.replace(/\*\*/g, ".*").replace(/\*/g, "[^/]*")}$`);
+    if (regex.test(entity)) return true;
+  }
+  return false;
+}
+async function findSimilarDocs(projectRoot, brokenRef) {
+  const docsDir = join20(projectRoot, ".knowns", "docs");
+  if (!existsSync16(docsDir)) return null;
+  const allDocs = [];
+  async function scanDir(dir, relativePath) {
+    const entries = await readdir9(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.name.startsWith(".")) continue;
+      const entryRelPath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
+      if (entry.isDirectory()) {
+        await scanDir(join20(dir, entry.name), entryRelPath);
+      } else if (entry.name.endsWith(".md")) {
+        allDocs.push(entryRelPath.replace(/\.md$/, ""));
+      }
+    }
+  }
+  await scanDir(docsDir, "");
+  const brokenLower = brokenRef.toLowerCase();
+  let bestMatch = null;
+  let bestScore = 0;
+  for (const doc of allDocs) {
+    const docLower = doc.toLowerCase();
+    const brokenParts = brokenLower.split(/[-_/]/);
+    const docParts = docLower.split(/[-_/]/);
+    let matchScore = 0;
+    for (const part of brokenParts) {
+      if (docLower.includes(part) && part.length > 2) {
+        matchScore += part.length;
+      }
+    }
+    for (const part of docParts) {
+      if (brokenLower.includes(part) && part.length > 2) {
+        matchScore += part.length;
+      }
+    }
+    if (matchScore > bestScore) {
+      bestScore = matchScore;
+      bestMatch = doc;
+    }
+  }
+  return bestScore >= 3 ? bestMatch : null;
+}
+async function validateTasks(projectRoot, fileStore, validateConfig) {
+  const issues = [];
+  const tasks = await fileStore.getAllTasks();
+  const taskIds = new Set(tasks.map((t) => t.id));
+  for (const task of tasks) {
+    const taskRef = `task-${task.id}`;
+    if (shouldIgnore(taskRef, validateConfig)) continue;
+    const content = `${task.description || ""} ${task.implementationPlan || ""} ${task.implementationNotes || ""}`;
+    const { docRefs, taskRefs, templateRefs } = extractRefs(content);
+    const noAcSeverity = getRuleSeverity("task-no-ac", "warning", validateConfig);
+    if (noAcSeverity !== "off" && (!task.acceptanceCriteria || task.acceptanceCriteria.length === 0)) {
+      issues.push({
+        entity: taskRef,
+        entityType: "task",
+        rule: "task-no-ac",
+        severity: noAcSeverity,
+        message: "Task has no acceptance criteria"
+      });
+    }
+    const noDescSeverity = getRuleSeverity("task-no-description", "warning", validateConfig);
+    if (noDescSeverity !== "off" && (!task.description || task.description.trim() === "")) {
+      issues.push({
+        entity: taskRef,
+        entityType: "task",
+        rule: "task-no-description",
+        severity: noDescSeverity,
+        message: "Task has no description"
+      });
+    }
+    const brokenDocSeverity = getRuleSeverity("task-broken-doc-ref", "error", validateConfig);
+    if (brokenDocSeverity !== "off") {
+      for (const docPath of docRefs) {
+        const resolved = await resolveDoc(projectRoot, docPath);
+        if (!resolved) {
+          const suggestion = await findSimilarDocs(projectRoot, docPath);
+          const issue2 = {
+            entity: taskRef,
+            entityType: "task",
+            rule: "task-broken-doc-ref",
+            severity: brokenDocSeverity,
+            message: suggestion ? `Broken reference: @doc/${docPath} \u2192 did you mean @doc/${suggestion}?` : `Broken reference: @doc/${docPath}`,
+            fixable: !!suggestion
+          };
+          if (suggestion) {
+            issue2.fix = async () => {
+              const tasksDir = join20(projectRoot, ".knowns", "tasks");
+              const files = await readdir9(tasksDir);
+              const taskFile = files.find((f) => f.startsWith(`task-${task.id} `));
+              if (taskFile) {
+                const taskFilePath = join20(tasksDir, taskFile);
+                const taskContent = await readFile10(taskFilePath, "utf-8");
+                const updated = taskContent.replace(
+                  new RegExp(`@docs?/${docPath.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}`, "g"),
+                  `@doc/${suggestion}`
+                );
+                await writeFile7(taskFilePath, updated, "utf-8");
+              }
+            };
+          }
+          issues.push(issue2);
+        }
+      }
+    }
+    const brokenTaskSeverity = getRuleSeverity("task-broken-task-ref", "error", validateConfig);
+    if (brokenTaskSeverity !== "off") {
+      for (const refTaskId of taskRefs) {
+        if (!taskIds.has(refTaskId)) {
+          issues.push({
+            entity: taskRef,
+            entityType: "task",
+            rule: "task-broken-task-ref",
+            severity: brokenTaskSeverity,
+            message: `Broken reference: @task-${refTaskId}`
+          });
+        }
+      }
+    }
+    const brokenTplSeverity = getRuleSeverity("task-broken-template-ref", "error", validateConfig);
+    if (brokenTplSeverity !== "off") {
+      for (const templateName of templateRefs) {
+        const resolved = await resolveTemplate(projectRoot, templateName);
+        if (!resolved) {
+          issues.push({
+            entity: taskRef,
+            entityType: "task",
+            rule: "task-broken-template-ref",
+            severity: brokenTplSeverity,
+            message: `Broken reference: @template/${templateName}`
+          });
+        }
+      }
+    }
+    const selfRefSeverity = getRuleSeverity("task-self-ref", "warning", validateConfig);
+    if (selfRefSeverity !== "off" && taskRefs.includes(task.id)) {
+      issues.push({
+        entity: taskRef,
+        entityType: "task",
+        rule: "task-self-ref",
+        severity: selfRefSeverity,
+        message: "Task references itself"
+      });
+    }
+    const circularSeverity = getRuleSeverity("task-circular-parent", "error", validateConfig);
+    if (circularSeverity !== "off" && task.parent) {
+      const visited = /* @__PURE__ */ new Set();
+      let currentId = task.parent;
+      while (currentId) {
+        if (visited.has(currentId) || currentId === task.id) {
+          issues.push({
+            entity: taskRef,
+            entityType: "task",
+            rule: "task-circular-parent",
+            severity: circularSeverity,
+            message: currentId === task.id ? "Task is its own ancestor" : "Circular parent-child relationship detected"
+          });
+          break;
+        }
+        visited.add(currentId);
+        const parentTask = tasks.find((t) => t.id === currentId);
+        currentId = parentTask?.parent;
+      }
+    }
+  }
+  return issues;
+}
+async function validateDocs(projectRoot, fileStore, validateConfig) {
+  const issues = [];
+  const docsDir = join20(projectRoot, ".knowns", "docs");
+  if (!existsSync16(docsDir)) return issues;
+  const tasks = await fileStore.getAllTasks();
+  const taskIds = new Set(tasks.map((t) => t.id));
+  const referencedDocs = /* @__PURE__ */ new Set();
+  for (const task of tasks) {
+    const content = `${task.description || ""} ${task.implementationPlan || ""} ${task.implementationNotes || ""}`;
+    const { docRefs } = extractRefs(content);
+    for (const ref of docRefs) {
+      referencedDocs.add(ref.toLowerCase());
+    }
+  }
+  async function scanDir(dir, relativePath) {
+    const entries = await readdir9(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.name.startsWith(".")) continue;
+      const fullPath = join20(dir, entry.name);
+      const entryRelPath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
+      if (entry.isDirectory()) {
+        await scanDir(fullPath, entryRelPath);
+      } else if (entry.name.endsWith(".md")) {
+        const docPath = entryRelPath.replace(/\.md$/, "");
+        const docRef = `docs/${docPath}`;
+        if (shouldIgnore(docRef, validateConfig) || shouldIgnore(docPath, validateConfig)) continue;
+        try {
+          const content = await readFile10(fullPath, "utf-8");
+          const { data, content: docContent } = (0, import_gray_matter6.default)(content);
+          const noDescSeverity = getRuleSeverity("doc-no-description", "warning", validateConfig);
+          if (noDescSeverity !== "off" && (!data.description || String(data.description).trim() === "")) {
+            issues.push({
+              entity: docRef,
+              entityType: "doc",
+              rule: "doc-no-description",
+              severity: noDescSeverity,
+              message: "Doc has no description"
+            });
+          }
+          const orphanSeverity = getRuleSeverity("doc-orphan", "info", validateConfig);
+          if (orphanSeverity !== "off" && !referencedDocs.has(docPath.toLowerCase())) {
+            issues.push({
+              entity: docRef,
+              entityType: "doc",
+              rule: "doc-orphan",
+              severity: orphanSeverity,
+              message: "Doc is not referenced by any task"
+            });
+          }
+          const { docRefs, taskRefs } = extractRefs(docContent);
+          const brokenDocSeverity = getRuleSeverity("doc-broken-doc-ref", "error", validateConfig);
+          if (brokenDocSeverity !== "off") {
+            for (const refDocPath of docRefs) {
+              const resolved = await resolveDoc(projectRoot, refDocPath);
+              if (!resolved) {
+                const suggestion = await findSimilarDocs(projectRoot, refDocPath);
+                const issue2 = {
+                  entity: docRef,
+                  entityType: "doc",
+                  rule: "doc-broken-doc-ref",
+                  severity: brokenDocSeverity,
+                  message: suggestion ? `Broken reference: @doc/${refDocPath} \u2192 did you mean @doc/${suggestion}?` : `Broken reference: @doc/${refDocPath}`,
+                  fixable: !!suggestion
+                };
+                if (suggestion) {
+                  issue2.fix = async () => {
+                    const docFileContent = await readFile10(fullPath, "utf-8");
+                    const updated = docFileContent.replace(
+                      new RegExp(`@docs?/${refDocPath.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}`, "g"),
+                      `@doc/${suggestion}`
+                    );
+                    await writeFile7(fullPath, updated, "utf-8");
+                  };
+                }
+                issues.push(issue2);
+              }
+            }
+          }
+          const brokenTaskSeverity = getRuleSeverity("doc-broken-task-ref", "error", validateConfig);
+          if (brokenTaskSeverity !== "off") {
+            for (const refTaskId of taskRefs) {
+              if (!taskIds.has(refTaskId)) {
+                const issue2 = {
+                  entity: docRef,
+                  entityType: "doc",
+                  rule: "doc-broken-task-ref",
+                  severity: brokenTaskSeverity,
+                  message: `Broken reference: @task-${refTaskId}`,
+                  fixable: true
+                };
+                issue2.fix = async () => {
+                  const docFileContent = await readFile10(fullPath, "utf-8");
+                  const updated = docFileContent.replace(
+                    new RegExp(`@task-${refTaskId}\\b`, "g"),
+                    `~task-${refTaskId}`
+                  );
+                  await writeFile7(fullPath, updated, "utf-8");
+                };
+                issues.push(issue2);
+              }
+            }
+          }
+        } catch {
+        }
+      }
+    }
+  }
+  await scanDir(docsDir, "");
+  return issues;
+}
+async function validateTemplates(projectRoot, validateConfig) {
+  const issues = [];
+  const templates = await listAllTemplates(projectRoot);
+  for (const template of templates) {
+    const templateRef = `templates/${template.ref}`;
+    if (shouldIgnore(templateRef, validateConfig)) continue;
+    try {
+      const config2 = await getTemplateConfig(template.path);
+      const invalidSyntaxSeverity = getRuleSeverity("template-invalid-syntax", "error", validateConfig);
+      if (invalidSyntaxSeverity !== "off" && !config2) {
+        issues.push({
+          entity: templateRef,
+          entityType: "template",
+          rule: "template-invalid-syntax",
+          severity: invalidSyntaxSeverity,
+          message: "Failed to load template config (invalid or missing _template.yaml)"
+        });
+        continue;
+      }
+      if (!config2) continue;
+      const brokenDocSeverity = getRuleSeverity("template-broken-doc-ref", "error", validateConfig);
+      if (brokenDocSeverity !== "off" && config2.doc) {
+        const resolved = await resolveDoc(projectRoot, config2.doc);
+        if (!resolved) {
+          issues.push({
+            entity: templateRef,
+            entityType: "template",
+            rule: "template-broken-doc-ref",
+            severity: brokenDocSeverity,
+            message: `Broken doc reference: @doc/${config2.doc}`
+          });
+        }
+      }
+      if (invalidSyntaxSeverity !== "off") {
+        for (const action of config2.actions || []) {
+          if (action.type === "add" && action.template) {
+            const templateFilePath = join20(template.path, action.template);
+            if (existsSync16(templateFilePath)) {
+              try {
+                const templateContent = await readFile10(templateFilePath, "utf-8");
+                import_handlebars2.default.compile(templateContent);
+              } catch (err) {
+                issues.push({
+                  entity: templateRef,
+                  entityType: "template",
+                  rule: "template-invalid-syntax",
+                  severity: invalidSyntaxSeverity,
+                  message: `Invalid Handlebars syntax in ${action.template}: ${err instanceof Error ? err.message : "unknown error"}`
+                });
+              }
+            }
+          }
+        }
+      }
+      const missingPartialSeverity = getRuleSeverity("template-missing-partial", "error", validateConfig);
+      if (missingPartialSeverity !== "off" && existsSync16(template.path)) {
+        const files = await readdir9(template.path);
+        const hbsFiles = files.filter((f) => f.endsWith(".hbs"));
+        for (const hbsFile of hbsFiles) {
+          const content = await readFile10(join20(template.path, hbsFile), "utf-8");
+          const partialPattern = /\{\{>\s*([^\s}]+)\s*\}\}/g;
+          for (const match2 of content.matchAll(partialPattern)) {
+            const partialName = match2[1];
+            const partialPath = join20(template.path, `_${partialName}.hbs`);
+            if (!existsSync16(partialPath)) {
+              issues.push({
+                entity: templateRef,
+                entityType: "template",
+                rule: "template-missing-partial",
+                severity: missingPartialSeverity,
+                message: `Missing partial: ${partialName} (expected at _${partialName}.hbs)`
+              });
+            }
+          }
+        }
+      }
+    } catch (err) {
+      const invalidSyntaxSeverity = getRuleSeverity("template-invalid-syntax", "error", validateConfig);
+      if (invalidSyntaxSeverity !== "off") {
+        issues.push({
+          entity: templateRef,
+          entityType: "template",
+          rule: "template-invalid-syntax",
+          severity: invalidSyntaxSeverity,
+          message: `Failed to load template config: ${err instanceof Error ? err.message : "unknown error"}`
+        });
+      }
+    }
+  }
+  return issues;
+}
+async function applyFixes(issues) {
+  const results = [];
+  const fixableIssues = issues.filter((i) => i.fixable && i.fix);
+  for (const issue2 of fixableIssues) {
+    try {
+      await issue2.fix?.();
+      results.push({
+        entity: issue2.entity,
+        rule: issue2.rule,
+        action: issue2.message,
+        success: true
+      });
+    } catch (err) {
+      results.push({
+        entity: issue2.entity,
+        rule: issue2.rule,
+        action: `Failed: ${err instanceof Error ? err.message : "unknown error"}`,
+        success: false
+      });
+    }
+  }
+  return results;
+}
+async function runSDDValidation(projectRoot, fileStore) {
+  const tasks = await fileStore.getAllTasks();
+  const docsDir = join20(projectRoot, ".knowns", "docs");
+  const stats = {
+    specs: { total: 0, approved: 0, draft: 0 },
+    tasks: { total: tasks.length, done: 0, inProgress: 0, todo: 0, withSpec: 0, withoutSpec: 0 },
+    coverage: { linked: 0, total: tasks.length, percent: 0 },
+    acCompletion: {}
+  };
+  const warnings = [];
+  const passed = [];
+  for (const task of tasks) {
+    if (task.status === "done") stats.tasks.done++;
+    else if (task.status === "in-progress") stats.tasks.inProgress++;
+    else stats.tasks.todo++;
+    if (task.spec) {
+      stats.tasks.withSpec++;
+    } else {
+      stats.tasks.withoutSpec++;
+      warnings.push({
+        type: "task-no-spec",
+        entity: `task-${task.id}`,
+        message: `${task.title} has no spec reference`
+      });
+    }
+  }
+  stats.coverage.linked = stats.tasks.withSpec;
+  stats.coverage.percent = stats.tasks.total > 0 ? Math.round(stats.tasks.withSpec / stats.tasks.total * 100) : 0;
+  const specsDir = join20(docsDir, "specs");
+  if (existsSync16(specsDir)) {
+    async function scanSpecs(dir, relativePath) {
+      const entries = await readdir9(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (entry.name.startsWith(".")) continue;
+        const entryRelPath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+          await scanSpecs(join20(dir, entry.name), entryRelPath);
+        } else if (entry.name.endsWith(".md")) {
+          stats.specs.total++;
+          const specPath = `specs/${entryRelPath.replace(/\.md$/, "")}`;
+          try {
+            const content = await readFile10(join20(dir, entry.name), "utf-8");
+            const { data } = (0, import_gray_matter6.default)(content);
+            if (data.status === "approved" || data.status === "implemented") {
+              stats.specs.approved++;
+            } else {
+              stats.specs.draft++;
+            }
+            const linkedTasks = tasks.filter((t) => t.spec === specPath);
+            if (linkedTasks.length > 0) {
+              let totalAC = 0;
+              let completedAC = 0;
+              for (const task of linkedTasks) {
+                totalAC += task.acceptanceCriteria.length;
+                completedAC += task.acceptanceCriteria.filter((ac) => ac.completed).length;
+              }
+              const percent = totalAC > 0 ? Math.round(completedAC / totalAC * 100) : 100;
+              stats.acCompletion[specPath] = { total: totalAC, completed: completedAC, percent };
+              if (percent < 100 && totalAC > 0) {
+                warnings.push({
+                  type: "spec-ac-incomplete",
+                  entity: specPath,
+                  message: `${completedAC}/${totalAC} ACs complete (${percent}%)`
+                });
+              }
+            }
+          } catch {
+          }
+        }
+      }
+    }
+    await scanSpecs(specsDir, "");
+  }
+  for (const task of tasks) {
+    if (task.spec) {
+      const specDocPath = join20(docsDir, `${task.spec}.md`);
+      if (!existsSync16(specDocPath)) {
+        warnings.push({
+          type: "spec-broken-link",
+          entity: `task-${task.id}`,
+          message: `Broken spec reference: @doc/${task.spec}`
+        });
+      }
+    }
+  }
+  if (warnings.filter((w) => w.type === "spec-broken-link").length === 0) {
+    passed.push("All spec references resolve");
+  }
+  for (const [specPath, completion] of Object.entries(stats.acCompletion)) {
+    if (completion.percent === 100) {
+      passed.push(`${specPath}: fully implemented`);
+    }
+  }
+  return { stats, warnings, passed };
+}
+async function handleValidate(args, fileStore) {
+  try {
+    const projectRoot = getProjectRoot();
+    if (args?.scope === "sdd") {
+      const sddResult = await runSDDValidation(projectRoot, fileStore);
+      return successResponse({
+        mode: "sdd",
+        stats: sddResult.stats,
+        warnings: sddResult.warnings,
+        passed: sddResult.passed
+      });
+    }
+    const validateConfig = await loadValidateConfig(projectRoot);
+    const allIssues = [];
+    const stats = { tasks: 0, docs: 0, templates: 0 };
+    if (!args?.type || args.type === "task") {
+      const tasks = await fileStore.getAllTasks();
+      stats.tasks = tasks.length;
+      const taskIssues = await validateTasks(projectRoot, fileStore, validateConfig);
+      allIssues.push(...taskIssues);
+    }
+    if (!args?.type || args.type === "doc") {
+      const docsDir = join20(projectRoot, ".knowns", "docs");
+      if (existsSync16(docsDir)) {
+        async function countDocs(dir) {
+          let count = 0;
+          const entries = await readdir9(dir, { withFileTypes: true });
+          for (const entry of entries) {
+            if (entry.name.startsWith(".")) continue;
+            if (entry.isDirectory()) {
+              count += await countDocs(join20(dir, entry.name));
+            } else if (entry.name.endsWith(".md")) {
+              count++;
+            }
+          }
+          return count;
+        }
+        stats.docs = await countDocs(docsDir);
+      }
+      const docIssues = await validateDocs(projectRoot, fileStore, validateConfig);
+      allIssues.push(...docIssues);
+    }
+    if (!args?.type || args.type === "template") {
+      const templates = await listAllTemplates(projectRoot);
+      stats.templates = templates.length;
+      const templateIssues = await validateTemplates(projectRoot, validateConfig);
+      allIssues.push(...templateIssues);
+    }
+    if (args?.strict) {
+      for (const issue2 of allIssues) {
+        if (issue2.severity === "warning") {
+          issue2.severity = "error";
+        }
+      }
+    }
+    let fixes = [];
+    if (args?.fix) {
+      fixes = await applyFixes(allIssues);
+    }
+    const errors = allIssues.filter((i) => i.severity === "error");
+    const warnings = allIssues.filter((i) => i.severity === "warning");
+    const infos = allIssues.filter((i) => i.severity === "info");
+    return successResponse({
+      valid: errors.length === 0,
+      stats,
+      summary: {
+        errors: errors.length,
+        warnings: warnings.length,
+        info: infos.length
+      },
+      issues: allIssues.map((i) => ({
+        entity: i.entity,
+        entityType: i.entityType,
+        rule: i.rule,
+        severity: i.severity,
+        message: i.message,
+        fixable: i.fixable || false
+      })),
+      ...args?.fix && fixes.length > 0 ? { fixes } : {}
+    });
+  } catch (error48) {
+    return errorResponse(error48 instanceof Error ? error48.message : String(error48));
+  }
+}
+
 // src/mcp/server.ts
 var fileStoreCache = /* @__PURE__ */ new Map();
 function getFileStore() {
@@ -60796,7 +61485,8 @@ var tools = [
   ...boardTools,
   ...docTools,
   ...templateTools,
-  ...searchTools
+  ...searchTools,
+  ...validateTools
 ];
 server.setRequestHandler(ListToolsRequestSchema, async () => {
   return { tools };
@@ -60860,6 +61550,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       // Unified search handler
       case "search":
         return await handleSearch(args, getFileStore());
+      // Validate handler
+      case "validate":
+        return await handleValidate(args, getFileStore());
       default:
         return errorResponse(`Unknown tool: ${name}`);
     }
@@ -60869,7 +61562,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 });
 server.setRequestHandler(ListResourcesRequestSchema, async () => {
   const tasks = await getFileStore().getAllTasks();
-  const docsDir = join20(getProjectRoot(), ".knowns", "docs");
+  const docsDir = join21(getProjectRoot(), ".knowns", "docs");
   const taskResources = tasks.map((task) => ({
     uri: `knowns://task/${task.id}`,
     name: task.title,
@@ -60877,14 +61570,14 @@ server.setRequestHandler(ListResourcesRequestSchema, async () => {
     description: `Task #${task.id}: ${task.title}`
   }));
   const docResources = [];
-  if (existsSync16(docsDir)) {
-    const { readdir: readdir9 } = await import("node:fs/promises");
+  if (existsSync17(docsDir)) {
+    const { readdir: readdir10 } = await import("node:fs/promises");
     async function getAllMdFiles3(dir, basePath = "") {
       const files = [];
-      const entries = await readdir9(dir, { withFileTypes: true });
+      const entries = await readdir10(dir, { withFileTypes: true });
       for (const entry of entries) {
-        const fullPath = join20(dir, entry.name);
-        const relativePath = normalizePath(basePath ? join20(basePath, entry.name) : entry.name);
+        const fullPath = join21(dir, entry.name);
+        const relativePath = normalizePath(basePath ? join21(basePath, entry.name) : entry.name);
         if (entry.isDirectory()) {
           const subFiles = await getAllMdFiles3(fullPath, relativePath);
           files.push(...subFiles);
@@ -60896,9 +61589,9 @@ server.setRequestHandler(ListResourcesRequestSchema, async () => {
     }
     const mdFiles = await getAllMdFiles3(docsDir);
     for (const file3 of mdFiles) {
-      const filepath = join20(docsDir, file3);
-      const content = await readFile10(filepath, "utf-8");
-      const { data } = (0, import_gray_matter6.default)(content);
+      const filepath = join21(docsDir, file3);
+      const content = await readFile11(filepath, "utf-8");
+      const { data } = (0, import_gray_matter7.default)(content);
       docResources.push({
         uri: `knowns://doc/${file3.replace(/\.md$/, "")}`,
         name: data.title || file3.replace(/\.md$/, ""),
@@ -60933,13 +61626,13 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
   const docMatch = uri.match(/^knowns:\/\/doc\/(.+)$/);
   if (docMatch) {
     const docPath = docMatch[1];
-    const docsDir = join20(getProjectRoot(), ".knowns", "docs");
-    const filepath = join20(docsDir, `${docPath}.md`);
-    if (!existsSync16(filepath)) {
+    const docsDir = join21(getProjectRoot(), ".knowns", "docs");
+    const filepath = join21(docsDir, `${docPath}.md`);
+    if (!existsSync17(filepath)) {
       throw new Error(`Documentation ${docPath} not found`);
     }
-    const content = await readFile10(filepath, "utf-8");
-    const { data, content: docContent } = (0, import_gray_matter6.default)(content);
+    const content = await readFile11(filepath, "utf-8");
+    const { data, content: docContent } = (0, import_gray_matter7.default)(content);
     return {
       contents: [
         {