knowns 0.10.5 → 0.10.6

package/dist/index.js

@@ -9108,7 +9108,7 @@ var require_dist = __commonJS({
         });
       };
     }
-    var prompts4 = require_prompts();
+    var prompts3 = require_prompts();
     var passOn = ["suggest", "format", "onState", "validate", "onRender", "type"];
     var noop = () => {
     };
@@ -9159,7 +9159,7 @@ var require_dist = __commonJS({
             var _question2 = question;
             name = _question2.name;
             type = _question2.type;
-            if (prompts4[type] === void 0) {
+            if (prompts3[type] === void 0) {
               throw new Error(`prompt type (${type}) is not defined`);
             }
             if (override2[question.name] !== void 0) {
@@ -9170,7 +9170,7 @@ var require_dist = __commonJS({
               }
             }
             try {
-              answer = prompt._injected ? getInjectedAnswer(prompt._injected, question.initial) : yield prompts4[type](question);
+              answer = prompt._injected ? getInjectedAnswer(prompt._injected, question.initial) : yield prompts3[type](question);
               answers[name] = answer = yield getFormattedAnswer(question, answer, true);
               quit = yield onSubmit(question, answer, answers);
             } catch (err) {
@@ -9202,7 +9202,7 @@ var require_dist = __commonJS({
     }
     module2.exports = Object.assign(prompt, {
       prompt,
-      prompts: prompts4,
+      prompts: prompts3,
       inject,
       override
     });
@@ -11285,7 +11285,7 @@ var require_prompts2 = __commonJS({
 var require_lib = __commonJS({
   "node_modules/prompts/lib/index.js"(exports2, module2) {
     "use strict";
-    var prompts4 = require_prompts2();
+    var prompts3 = require_prompts2();
     var passOn = ["suggest", "format", "onState", "validate", "onRender", "type"];
     var noop = () => {
     };
@@ -11317,7 +11317,7 @@ var require_lib = __commonJS({
           throw new Error("prompt message is required");
         }
         ({ name, type } = question);
-        if (prompts4[type] === void 0) {
+        if (prompts3[type] === void 0) {
           throw new Error(`prompt type (${type}) is not defined`);
         }
         if (override2[question.name] !== void 0) {
@@ -11328,7 +11328,7 @@ var require_lib = __commonJS({
           }
         }
         try {
-          answer = prompt._injected ? getInjectedAnswer(prompt._injected, question.initial) : await prompts4[type](question);
+          answer = prompt._injected ? getInjectedAnswer(prompt._injected, question.initial) : await prompts3[type](question);
           answers[name] = answer = await getFormattedAnswer(question, answer, true);
           quit = await onSubmit(question, answer, answers);
         } catch (err) {
@@ -11351,7 +11351,7 @@ var require_lib = __commonJS({
     function override(answers) {
       prompt._override = Object.assign({}, answers);
     }
-    module2.exports = Object.assign(prompt, { prompt, prompts: prompts4, inject, override });
+    module2.exports = Object.assign(prompt, { prompt, prompts: prompts3, inject, override });
   }
 });
 
@@ -14378,7 +14378,7 @@ var require_util3 = __commonJS({
       return path3;
     }
     exports2.normalize = normalize3;
-    function join42(aRoot, aPath) {
+    function join43(aRoot, aPath) {
       if (aRoot === "") {
         aRoot = ".";
       }
@@ -14410,7 +14410,7 @@ var require_util3 = __commonJS({
       }
       return joined;
     }
-    exports2.join = join42;
+    exports2.join = join43;
     exports2.isAbsolute = function(aPath) {
       return aPath.charAt(0) === "/" || urlRegexp.test(aPath);
     };
@@ -14583,7 +14583,7 @@ var require_util3 = __commonJS({
             parsed.path = parsed.path.substring(0, index + 1);
           }
         }
-        sourceURL = join42(urlGenerate(parsed), sourceURL);
+        sourceURL = join43(urlGenerate(parsed), sourceURL);
       }
       return normalize3(sourceURL);
     }
@@ -36815,9 +36815,9 @@ var require_view = __commonJS({
     var path3 = __require("node:path");
     var fs = __require("node:fs");
     var dirname9 = path3.dirname;
-    var basename4 = path3.basename;
+    var basename5 = path3.basename;
     var extname = path3.extname;
-    var join42 = path3.join;
+    var join43 = path3.join;
     var resolve3 = path3.resolve;
     module2.exports = View;
     function View(name, options2) {
@@ -36854,7 +36854,7 @@ var require_view = __commonJS({
         var root = roots[i];
         var loc = resolve3(root, name);
         var dir = dirname9(loc);
-        var file3 = basename4(loc);
+        var file3 = basename5(loc);
         path4 = this.resolve(dir, file3);
       }
       return path4;
@@ -36879,12 +36879,12 @@ var require_view = __commonJS({
     };
     View.prototype.resolve = function resolve4(dir, file3) {
       var ext2 = this.ext;
-      var path4 = join42(dir, file3);
+      var path4 = join43(dir, file3);
       var stat5 = tryStat(path4);
       if (stat5 && stat5.isFile()) {
         return path4;
       }
-      path4 = join42(dir, basename4(file3, ext2), "index" + ext2);
+      path4 = join43(dir, basename5(file3, ext2), "index" + ext2);
       stat5 = tryStat(path4);
       if (stat5 && stat5.isFile()) {
         return path4;
@@ -40168,7 +40168,7 @@ var require_content_disposition = __commonJS({
     "use strict";
     module2.exports = contentDisposition;
     module2.exports.parse = parse4;
-    var basename4 = __require("path").basename;
+    var basename5 = __require("path").basename;
     var ENCODE_URL_ATTR_CHAR_REGEXP = /[\x00-\x20"'()*,/:;<=>?@[\\\]{}\x7f]/g;
     var HEX_ESCAPE_REGEXP = /%[0-9A-Fa-f]{2}/;
     var HEX_ESCAPE_REPLACE_REGEXP = /%([0-9A-Fa-f]{2})/g;
@@ -40203,9 +40203,9 @@ var require_content_disposition = __commonJS({
       if (typeof fallback === "string" && NON_LATIN1_REGEXP.test(fallback)) {
         throw new TypeError("fallback must be ISO-8859-1 string");
       }
-      var name = basename4(filename);
+      var name = basename5(filename);
       var isQuotedString = TEXT_REGEXP.test(name);
-      var fallbackName = typeof fallback !== "string" ? fallback && getlatin1(name) : basename4(fallback);
+      var fallbackName = typeof fallback !== "string" ? fallback && getlatin1(name) : basename5(fallback);
       var hasFallback = typeof fallbackName === "string" && fallbackName !== name;
       if (hasFallback || !isQuotedString || HEX_ESCAPE_REGEXP.test(name)) {
         params["filename*"] = name;
@@ -40529,7 +40529,7 @@ var require_send = __commonJS({
     var Stream2 = __require("stream");
     var util2 = __require("util");
     var extname = path3.extname;
-    var join42 = path3.join;
+    var join43 = path3.join;
     var normalize3 = path3.normalize;
     var resolve3 = path3.resolve;
     var sep3 = path3.sep;
@@ -40701,7 +40701,7 @@ var require_send = __commonJS({
           return res;
         }
         parts = path4.split(sep3);
-        path4 = normalize3(join42(root, path4));
+        path4 = normalize3(join43(root, path4));
       } else {
         if (UP_PATH_REGEXP.test(path4)) {
           debug('malicious path "%s"', path4);
@@ -40834,7 +40834,7 @@ var require_send = __commonJS({
           if (err) return self.onStatError(err);
           return self.error(404);
         }
-        var p = join42(path4, self._index[i]);
+        var p = join43(path4, self._index[i]);
         debug('stat "%s"', p);
         fs.stat(p, function(err2, stat5) {
           if (err2) return next(err2);
@@ -58796,7 +58796,7 @@ var {
 } = import_index.default;
 
 // src/commands/init.ts
-var import_prompts2 = __toESM(require_prompts3(), 1);
+var import_prompts = __toESM(require_prompts3(), 1);
 
 // src/codegen/skill-sync.ts
 import { existsSync as existsSync2 } from "node:fs";
@@ -59407,7 +59407,7 @@ function detectPlatforms(projectRoot) {
 }
 
 // src/instructions/guidelines/unified/commands-reference.md
-var commands_reference_default = '{{#if mcp}}\n# MCP Tools Reference\n\n## Task Tools\n\n### mcp__knowns__create_task\n\n```json\n{\n  "title": "Task title",\n  "description": "Task description",\n  "status": "todo",\n  "priority": "medium",\n  "labels": ["label1"],\n  "assignee": "@me",\n  "parent": "parent-id"\n}\n```\n\n### mcp__knowns__update_task\n\n```json\n{\n  "taskId": "<id>",\n  "status": "in-progress",\n  "assignee": "@me",\n  "addAc": ["Criterion 1", "Criterion 2"],\n  "checkAc": [1, 2],\n  "uncheckAc": [3],\n  "removeAc": [4],\n  "plan": "1. Step one\\n2. Step two",\n  "notes": "Implementation notes",\n  "appendNotes": "Additional notes"\n}\n```\n\n| Field | Purpose |\n|-------|---------|\n| `addAc` | Add new acceptance criteria |\n| `checkAc` | Mark AC done (1-based index) |\n| `uncheckAc` | Unmark AC (1-based index) |\n| `removeAc` | Remove AC (1-based index) |\n| `plan` | Set implementation plan |\n| `notes` | Replace implementation notes |\n| `appendNotes` | Append to notes |\n\n### mcp__knowns__get_task\n\n```json\n{ "taskId": "<id>" }\n```\n\n### mcp__knowns__list_tasks\n\n```json\n{ "status": "in-progress", "assignee": "@me" }\n```\n\n### mcp__knowns__search_tasks\n\n```json\n{ "query": "keyword" }\n```\n\n---\n\n## Doc Tools\n\n### mcp__knowns__get_doc\n\n**ALWAYS use `smart: true`** - auto-handles small/large docs:\n\n```json\n{ "path": "readme", "smart": true }\n```\n\nIf large, returns TOC. Then read section:\n```json\n{ "path": "readme", "section": "3" }\n```\n\n### mcp__knowns__list_docs\n\n```json\n{ "tag": "api" }\n```\n\n### mcp__knowns__create_doc\n\n```json\n{\n  "title": "Doc Title",\n  "description": "Description",\n  "tags": ["tag1"],\n  "folder": "guides",\n  "content": "Initial content"\n}\n```\n\n### mcp__knowns__update_doc\n\n```json\n{\n  "path": "readme",\n  "content": "Replace content",\n  "section": "2"\n}\n```\n\n### mcp__knowns__search_docs\n\n```json\n{ "query": "keyword", "tag": "api" }\n```\n\n### mcp__knowns__search (Unified)\n\n```json\n{\n  "query": "keyword",\n  "type": "all",\n  "status": "in-progress",\n  "priority": "high",\n  "assignee": "@me",\n  "label": "feature",\n  "tag": "api",\n  "limit": 20\n}\n```\n\n| Field | Purpose |\n|-------|---------|\n| `type` | "all", "task", or "doc" |\n| `status/priority/assignee/label` | Task filters |\n| `tag` | Doc filter |\n| `limit` | Max results (default: 20) |\n\n---\n\n## Time Tools\n\n### mcp__knowns__start_time\n\n```json\n{ "taskId": "<id>" }\n```\n\n### mcp__knowns__stop_time\n\n```json\n{ "taskId": "<id>" }\n```\n\n### mcp__knowns__add_time\n\n```json\n{\n  "taskId": "<id>",\n  "duration": "2h30m",\n  "note": "Note",\n  "date": "2025-01-15"\n}\n```\n\n### mcp__knowns__get_time_report\n\n```json\n{ "from": "2025-01-01", "to": "2025-01-31", "groupBy": "task" }\n```\n\n---\n\n## Template Tools\n\n### mcp__knowns__list_templates\n\n```json\n{}\n```\n\n### mcp__knowns__get_template\n\n```json\n{ "name": "template-name" }\n```\n\n### mcp__knowns__run_template\n\n```json\n{\n  "name": "template-name",\n  "variables": { "name": "MyComponent" },\n  "dryRun": true\n}\n```\n\n### mcp__knowns__create_template\n\n```json\n{\n  "name": "my-template",\n  "description": "Description",\n  "doc": "patterns/my-pattern"\n}\n```\n\n---\n\n## Other\n\n### mcp__knowns__get_board\n\n```json\n{}\n```\n\n{{/if}}\n{{#if cli}}\n# CLI Commands Reference\n\n## task create\n\n```bash\nknowns task create <title> [options]\n```\n\n| Flag | Short | Purpose |\n|------|-------|---------|\n| `--description` | `-d` | Task description |\n| `--ac` | | Acceptance criterion (repeatable) |\n| `--labels` | `-l` | Comma-separated labels |\n| `--assignee` | `-a` | Assign to user |\n| `--priority` | | low/medium/high |\n| `--parent` | | Parent task ID (raw ID only!) |\n\n**`-a` = assignee, NOT acceptance criteria! Use `--ac` for AC.**\n\n---\n\n## task edit\n\n```bash\nknowns task edit <id> [options]\n```\n\n| Flag | Short | Purpose |\n|------|-------|---------|\n| `--status` | `-s` | Change status |\n| `--assignee` | `-a` | Assign user |\n| `--ac` | | Add acceptance criterion |\n| `--check-ac` | | Mark AC done (1-indexed) |\n| `--uncheck-ac` | | Unmark AC |\n| `--plan` | | Set implementation plan |\n| `--notes` | | Replace notes |\n| `--append-notes` | | Add to notes |\n\n---\n\n## task view/list\n\n```bash\nknowns task <id> --plain\nknowns task list --plain\nknowns task list --status in-progress --plain\nknowns task list --tree --plain\n```\n\n---\n\n## doc create\n\n```bash\nknowns doc create <title> [options]\n```\n\n| Flag | Short | Purpose |\n|------|-------|---------|\n| `--description` | `-d` | Description |\n| `--tags` | `-t` | Comma-separated tags |\n| `--folder` | `-f` | Folder path |\n\n---\n\n## doc edit\n\n```bash\nknowns doc edit <name> [options]\n```\n\n| Flag | Short | Purpose |\n|------|-------|---------|\n| `--content` | `-c` | Replace content |\n| `--append` | `-a` | Append content |\n| `--section` | | Target section (use with -c) |\n\n**In doc edit, `-a` = append content, NOT assignee!**\n\n---\n\n## doc view/list\n\n**ALWAYS use `--smart`** - auto-handles small/large docs:\n\n```bash\nknowns doc <path> --plain --smart\n```\n\nIf large, returns TOC. Then read section:\n```bash\nknowns doc <path> --plain --section 3\n```\n\n```bash\nknowns doc list --plain\nknowns doc list --tag api --plain\n```\n\n---\n\n## time\n\n```bash\nknowns time start <id>    # REQUIRED when taking task\nknowns time stop          # REQUIRED when completing\nknowns time status\nknowns time add <id> <duration> -n "Note"\n```\n\n---\n\n## search\n\n```bash\nknowns search "query" --plain\nknowns search "auth" --type task --plain\nknowns search "api" --type doc --plain\n```\n\n---\n\n## template\n\n```bash\nknowns template list\nknowns template info <name>\nknowns template run <name> --name "X" --dry-run\nknowns template create <name>\n```\n\n---\n\n## Multi-line Input\n\n```bash\nknowns task edit <id> --plan $\'1. Step\\n2. Step\\n3. Step\'\n```\n{{/if}}\n';
+var commands_reference_default = '{{#if mcp}}\n# MCP Tools Reference\n\n## Project Tools (Session Init)\n\n**CRITICAL: Call these at session start to initialize the project.**\n\n### mcp__knowns__detect_projects\n\nScan for all Knowns projects on the system:\n\n```json\n{}\n```\n\nReturns: `{ projects: [{ path, name }], currentProject, note }`\n\n### mcp__knowns__set_project\n\nSet the active project for all operations:\n\n```json\n{ "projectRoot": "/absolute/path/to/project" }\n```\n\n### mcp__knowns__get_current_project\n\nCheck current project status:\n\n```json\n{}\n```\n\nReturns: `{ projectRoot, isExplicitlySet, isValid, source }`\n\n---\n\n## Task Tools\n\n### mcp__knowns__create_task\n\n```json\n{\n  "title": "Task title",\n  "description": "Task description",\n  "status": "todo",\n  "priority": "medium",\n  "labels": ["label1"],\n  "assignee": "@me",\n  "parent": "parent-id"\n}\n```\n\n### mcp__knowns__update_task\n\n```json\n{\n  "taskId": "<id>",\n  "status": "in-progress",\n  "assignee": "@me",\n  "addAc": ["Criterion 1", "Criterion 2"],\n  "checkAc": [1, 2],\n  "uncheckAc": [3],\n  "removeAc": [4],\n  "plan": "1. Step one\\n2. Step two",\n  "notes": "Implementation notes",\n  "appendNotes": "Additional notes"\n}\n```\n\n| Field | Purpose |\n|-------|---------|\n| `addAc` | Add new acceptance criteria |\n| `checkAc` | Mark AC done (1-based index) |\n| `uncheckAc` | Unmark AC (1-based index) |\n| `removeAc` | Remove AC (1-based index) |\n| `plan` | Set implementation plan |\n| `notes` | Replace implementation notes |\n| `appendNotes` | Append to notes |\n\n### mcp__knowns__get_task\n\n```json\n{ "taskId": "<id>" }\n```\n\n### mcp__knowns__list_tasks\n\n```json\n{ "status": "in-progress", "assignee": "@me" }\n```\n\n### mcp__knowns__search_tasks\n\n```json\n{ "query": "keyword" }\n```\n\n---\n\n## Doc Tools\n\n### mcp__knowns__get_doc\n\n**ALWAYS use `smart: true`** - auto-handles small/large docs:\n\n```json\n{ "path": "readme", "smart": true }\n```\n\nIf large, returns TOC. Then read section:\n```json\n{ "path": "readme", "section": "3" }\n```\n\n### mcp__knowns__list_docs\n\n```json\n{ "tag": "api" }\n```\n\n### mcp__knowns__create_doc\n\n```json\n{\n  "title": "Doc Title",\n  "description": "Description",\n  "tags": ["tag1"],\n  "folder": "guides",\n  "content": "Initial content"\n}\n```\n\n### mcp__knowns__update_doc\n\n```json\n{\n  "path": "readme",\n  "content": "Replace content",\n  "section": "2"\n}\n```\n\n### mcp__knowns__search_docs\n\n```json\n{ "query": "keyword", "tag": "api" }\n```\n\n### mcp__knowns__search (Unified)\n\n```json\n{\n  "query": "keyword",\n  "type": "all",\n  "status": "in-progress",\n  "priority": "high",\n  "assignee": "@me",\n  "label": "feature",\n  "tag": "api",\n  "limit": 20\n}\n```\n\n| Field | Purpose |\n|-------|---------|\n| `type` | "all", "task", or "doc" |\n| `status/priority/assignee/label` | Task filters |\n| `tag` | Doc filter |\n| `limit` | Max results (default: 20) |\n\n---\n\n## Time Tools\n\n### mcp__knowns__start_time\n\n```json\n{ "taskId": "<id>" }\n```\n\n### mcp__knowns__stop_time\n\n```json\n{ "taskId": "<id>" }\n```\n\n### mcp__knowns__add_time\n\n```json\n{\n  "taskId": "<id>",\n  "duration": "2h30m",\n  "note": "Note",\n  "date": "2025-01-15"\n}\n```\n\n### mcp__knowns__get_time_report\n\n```json\n{ "from": "2025-01-01", "to": "2025-01-31", "groupBy": "task" }\n```\n\n---\n\n## Template Tools\n\n### mcp__knowns__list_templates\n\n```json\n{}\n```\n\n### mcp__knowns__get_template\n\n```json\n{ "name": "template-name" }\n```\n\n### mcp__knowns__run_template\n\n```json\n{\n  "name": "template-name",\n  "variables": { "name": "MyComponent" },\n  "dryRun": true\n}\n```\n\n### mcp__knowns__create_template\n\n```json\n{\n  "name": "my-template",\n  "description": "Description",\n  "doc": "patterns/my-pattern"\n}\n```\n\n---\n\n## Other\n\n### mcp__knowns__get_board\n\n```json\n{}\n```\n\n{{/if}}\n{{#if cli}}\n# CLI Commands Reference\n\n## task create\n\n```bash\nknowns task create <title> [options]\n```\n\n| Flag | Short | Purpose |\n|------|-------|---------|\n| `--description` | `-d` | Task description |\n| `--ac` | | Acceptance criterion (repeatable) |\n| `--labels` | `-l` | Comma-separated labels |\n| `--assignee` | `-a` | Assign to user |\n| `--priority` | | low/medium/high |\n| `--parent` | | Parent task ID (raw ID only!) |\n\n**`-a` = assignee, NOT acceptance criteria! Use `--ac` for AC.**\n\n---\n\n## task edit\n\n```bash\nknowns task edit <id> [options]\n```\n\n| Flag | Short | Purpose |\n|------|-------|---------|\n| `--status` | `-s` | Change status |\n| `--assignee` | `-a` | Assign user |\n| `--ac` | | Add acceptance criterion |\n| `--check-ac` | | Mark AC done (1-indexed) |\n| `--uncheck-ac` | | Unmark AC |\n| `--plan` | | Set implementation plan |\n| `--notes` | | Replace notes |\n| `--append-notes` | | Add to notes |\n\n---\n\n## task view/list\n\n```bash\nknowns task <id> --plain\nknowns task list --plain\nknowns task list --status in-progress --plain\nknowns task list --tree --plain\n```\n\n---\n\n## doc create\n\n```bash\nknowns doc create <title> [options]\n```\n\n| Flag | Short | Purpose |\n|------|-------|---------|\n| `--description` | `-d` | Description |\n| `--tags` | `-t` | Comma-separated tags |\n| `--folder` | `-f` | Folder path |\n\n---\n\n## doc edit\n\n```bash\nknowns doc edit <name> [options]\n```\n\n| Flag | Short | Purpose |\n|------|-------|---------|\n| `--content` | `-c` | Replace content |\n| `--append` | `-a` | Append content |\n| `--section` | | Target section (use with -c) |\n\n**In doc edit, `-a` = append content, NOT assignee!**\n\n---\n\n## doc view/list\n\n**ALWAYS use `--smart`** - auto-handles small/large docs:\n\n```bash\nknowns doc <path> --plain --smart\n```\n\nIf large, returns TOC. Then read section:\n```bash\nknowns doc <path> --plain --section 3\n```\n\n```bash\nknowns doc list --plain\nknowns doc list --tag api --plain\n```\n\n---\n\n## time\n\n```bash\nknowns time start <id>    # REQUIRED when taking task\nknowns time stop          # REQUIRED when completing\nknowns time status\nknowns time add <id> <duration> -n "Note"\n```\n\n---\n\n## search\n\n```bash\nknowns search "query" --plain\nknowns search "auth" --type task --plain\nknowns search "api" --type doc --plain\n```\n\n---\n\n## template\n\n```bash\nknowns template list\nknowns template info <name>\nknowns template run <name> --name "X" --dry-run\nknowns template create <name>\n```\n\n---\n\n## Multi-line Input\n\n```bash\nknowns task edit <id> --plan $\'1. Step\\n2. Step\\n3. Step\'\n```\n{{/if}}\n';
 
 // src/instructions/guidelines/unified/common-mistakes.md
 var common_mistakes_default = '# Common Mistakes\n\n{{#if cli}}\n## CRITICAL: The -a Flag\n\n| Command | `-a` Means | NOT This! |\n|---------|------------|-----------|\n| `task create/edit` | `--assignee` | ~~acceptance criteria~~ |\n| `doc edit` | `--append` | ~~assignee~~ |\n\n```bash\n# WRONG (sets assignee to garbage!)\nknowns task edit 35 -a "Criterion text"\n\n# CORRECT (use --ac)\nknowns task edit 35 --ac "Criterion text"\n```\n\n---\n{{/if}}\n\n## CRITICAL: Notes vs Append Notes\n\n**NEVER use `notes`/`--notes` for progress updates - it REPLACES all existing notes!**\n\n{{#if cli}}\n```bash\n# \u274C WRONG - Destroys audit trail!\nknowns task edit <id> --notes "Done: feature X"\n\n# \u2705 CORRECT - Preserves history\nknowns task edit <id> --append-notes "Done: feature X"\n```\n{{/if}}\n{{#if mcp}}\n```json\n// \u274C WRONG - Destroys audit trail!\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "notes": "Done: feature X"\n})\n\n// \u2705 CORRECT - Preserves history\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "appendNotes": "Done: feature X"\n})\n```\n{{/if}}\n\n| Field | Behavior |\n|-------|----------|\n{{#if cli}}\n| `--notes` | **REPLACES** all notes (use only for initial setup) |\n| `--append-notes` | **APPENDS** to existing notes (use for progress) |\n{{/if}}\n{{#if mcp}}\n| `notes` | **REPLACES** all notes (use only for initial setup) |\n| `appendNotes` | **APPENDS** to existing notes (use for progress) |\n{{/if}}\n\n---\n\n## Quick Reference\n\n| DON\'T | DO |\n|-------|-----|\n{{#if cli}}\n| Edit .md files directly | Use CLI commands |\n| `-a "criterion"` | `--ac "criterion"` |\n| `--parent task-48` | `--parent 48` (raw ID) |\n| `--plain` with create/edit | `--plain` only for view/list |\n| `--notes` for progress | `--append-notes` for progress |\n{{/if}}\n{{#if mcp}}\n| Edit .md files directly | Use MCP tools |\n| `notes` for progress | `appendNotes` for progress |\n{{/if}}\n| Check AC before work done | Check AC AFTER work done |\n| Code before plan approval | Wait for user approval |\n| Code before reading docs | Read docs FIRST |\n| Skip time tracking | Always start/stop timer |\n| Ignore refs | Follow ALL `@task-xxx`, `@doc/xxx`, `@template/xxx` refs |\n\n{{#if mcp}}\n---\n\n## MCP Task Operations\n\nAll task operations are available via MCP:\n\n| Operation | MCP Field |\n|-----------|-----------|\n| Add acceptance criteria | `addAc: ["criterion"]` |\n| Check AC | `checkAc: [1, 2]` (1-based) |\n| Uncheck AC | `uncheckAc: [1]` (1-based) |\n| Remove AC | `removeAc: [1]` (1-based) |\n| Set plan | `plan: "..."` |\n| Set notes | `notes: "..."` |\n| Append notes | `appendNotes: "..."` |\n| Change status | `status: "in-progress"` |\n| Assign | `assignee: "@me"` |\n{{/if}}\n\n---\n\n## Template Syntax Pitfalls\n\nWhen writing `.hbs` templates, **NEVER** create `$` followed by triple-brace - Handlebars interprets triple-brace as unescaped output:\n\n```\n// \u274C WRONG - Parse error!\nthis.logger.log(`Created: $` + `{` + `{` + `{camelCase entity}.id}`);\n\n// \u2705 CORRECT - Add space between ${ and double-brace, use ~ to trim whitespace\nthis.logger.log(`Created: ${ \\{{~camelCase entity~}}.id}`);\n```\n\n| DON\'T | DO |\n|-------|-----|\n| `$` + triple-brace | `${ \\{{~helper~}}}` (space + escaped) |\n\n**Rules:**\n- Add space between `${` and double-brace\n- Use `~` (tilde) to trim whitespace in output\n- Escape literal braces with backslash\n\n---\n\n## Error Recovery\n\n| Problem | Solution |\n|---------|----------|\n{{#if cli}}\n| Set assignee to AC text | `knowns task edit <id> -a @me` |\n| Forgot to stop timer | `knowns time add <id> <duration>` |\n| Checked AC too early | `knowns task edit <id> --uncheck-ac N` |\n| Task not found | `knowns task list --plain` |\n| Replaced notes by mistake | Cannot recover - notes are lost. Use `--append-notes` next time |\n{{/if}}\n{{#if mcp}}\n| Forgot to stop timer | `mcp__knowns__add_time` with duration |\n| Wrong status | `mcp__knowns__update_task` to fix |\n| Task not found | `mcp__knowns__list_tasks` to find ID |\n| Need to uncheck AC | `mcp__knowns__update_task` with `uncheckAc: [N]` |\n| Checked AC too early | `mcp__knowns__update_task` with `uncheckAc: [N]` |\n| Replaced notes by mistake | Cannot recover - notes are lost. Use `appendNotes` next time |\n{{/if}}\n';
@@ -59416,7 +59416,7 @@ var common_mistakes_default = '# Common Mistakes\n\n{{#if cli}}\n## CRITICAL: Th
 var context_optimization_default = '# Context Optimization\n\nOptimize your context usage to work more efficiently within token limits.\n\n---\n\n{{#if cli}}\n## Output Format\n\n```bash\n# Verbose output\nknowns task 42 --json\n\n# Compact output (always use --plain)\nknowns task 42 --plain\n```\n\n---\n{{/if}}\n\n## Search Before Read\n\n{{#if cli}}\n### CLI\n```bash\n# DON\'T: Read all docs hoping to find info\nknowns doc "doc1" --plain\nknowns doc "doc2" --plain\n\n# DO: Search first, then read only relevant docs\nknowns search "authentication" --type doc --plain\nknowns doc "security-patterns" --plain\n```\n{{/if}}\n{{#if mcp}}\n### MCP\n```json\n// DON\'T: Read all docs hoping to find info\nmcp__knowns__get_doc({ "path": "doc1" })\nmcp__knowns__get_doc({ "path": "doc2" })\n\n// DO: Search first, then read only relevant docs\nmcp__knowns__search_docs({ "query": "authentication" })\nmcp__knowns__get_doc({ "path": "security-patterns" })\n```\n{{/if}}\n\n---\n\n{{#if mcp}}\n## Use Filters\n\n```json\n// DON\'T: List all then filter manually\nmcp__knowns__list_tasks({})\n\n// DO: Use filters in the query\nmcp__knowns__list_tasks({\n  "status": "in-progress",\n  "assignee": "@me"\n})\n```\n\n---\n{{/if}}\n\n## Reading Documents\n\n{{#if cli}}\n### CLI\n**ALWAYS use `--smart`** - auto-handles both small and large docs:\n\n```bash\n# DON\'T: Read without --smart\nknowns doc readme --plain\n\n# DO: Always use --smart\nknowns doc readme --plain --smart\n# Small doc \u2192 full content\n# Large doc \u2192 stats + TOC\n\n# If large, read specific section:\nknowns doc readme --plain --section 3\n```\n{{/if}}\n{{#if mcp}}\n### MCP\n**ALWAYS use `smart: true`** - auto-handles both small and large docs:\n\n```json\n// DON\'T: Read without smart\nmcp__knowns__get_doc({ "path": "readme" })\n\n// DO: Always use smart\nmcp__knowns__get_doc({ "path": "readme", "smart": true })\n// Small doc \u2192 full content\n// Large doc \u2192 stats + TOC\n\n// If large, read specific section:\nmcp__knowns__get_doc({ "path": "readme", "section": "3" })\n```\n{{/if}}\n\n**Behavior:**\n- **\u22642000 tokens**: Returns full content automatically\n- **>2000 tokens**: Returns stats + TOC, then use section parameter\n\n---\n\n## Compact Notes\n\n```bash\n# DON\'T: Verbose notes\nknowns task edit 42 --append-notes "I have successfully completed the implementation..."\n\n# DO: Compact notes\nknowns task edit 42 --append-notes "Done: Auth middleware + JWT validation"\n```\n\n---\n\n## Avoid Redundant Operations\n\n| Don\'t | Do Instead |\n|-------|------------|\n| Re-read files already in context | Reference from memory |\n| List tasks/docs multiple times | List once, remember results |\n| Quote entire file contents | Summarize key points |\n\n---\n\n## Efficient Workflow\n\n| Phase | Context-Efficient Approach |\n|-------|---------------------------|\n| **Research** | Search \u2192 Read only matches |\n| **Planning** | Brief plan, not detailed prose |\n| **Coding** | Read only files being modified |\n| **Notes** | Bullet points, not paragraphs |\n| **Completion** | Summary, not full log |\n\n---\n\n## Quick Rules\n\n{{#if cli}}\n1. **Always `--plain`** - Never use `--json` unless needed\n2. **Always `--smart`** - Auto-handles doc size\n{{/if}}\n{{#if mcp}}\n1. **Always `smart: true`** - Auto-handles doc size\n{{/if}}\n3. **Search first** - Don\'t read all docs hoping to find info\n4. **Read selectively** - Only fetch what you need\n5. **Write concise** - Compact notes, not essays\n6. **Don\'t repeat** - Reference context already loaded\n';
 
 // src/instructions/guidelines/unified/core-rules.md
-var core_rules_default = '# Core Rules\n\n> These rules are NON-NEGOTIABLE. Violating them leads to data corruption and lost work.\n\n---\n\n## The Golden Rule\n\n{{#if mcp}}\n{{#if cli}}\n**If you want to change ANYTHING in a task or doc, use MCP tools (preferred) or CLI commands (fallback). NEVER edit .md files directly.**\n{{else}}\n**If you want to change ANYTHING in a task or doc, use MCP tools. NEVER edit .md files directly.**\n{{/if}}\n{{else}}\n{{#if cli}}\n**If you want to change ANYTHING in a task or doc, use CLI commands. NEVER edit .md files directly.**\n{{/if}}\n{{/if}}\n\n{{#if cli}}\n---\n\n## CRITICAL: The -a Flag Confusion\n\nThe `-a` flag means DIFFERENT things in different commands:\n\n| Command | `-a` Means | NOT This! |\n|---------|------------|-----------|\n| `task create` | `--assignee` (assign user) | ~~acceptance criteria~~ |\n| `task edit` | `--assignee` (assign user) | ~~acceptance criteria~~ |\n| `doc edit` | `--append` (append content) | ~~assignee~~ |\n\n### Acceptance Criteria: Use --ac\n\n```bash\n# WRONG: -a is assignee, NOT acceptance criteria!\nknowns task edit 35 -a "- [ ] Criterion"    # Sets assignee to garbage!\n\n# CORRECT: Use --ac for acceptance criteria\nknowns task edit 35 --ac "Criterion one"\nknowns task create "Title" --ac "Criterion one" --ac "Criterion two"\n```\n{{/if}}\n\n---\n\n## Quick Reference\n\n| Rule | Description |\n|------|-------------|\n{{#if mcp}}\n{{#if cli}}\n| **MCP Tools (preferred)** | Use MCP tools for ALL operations. Fallback to CLI if needed. NEVER edit .md files directly |\n{{else}}\n| **MCP Tools Only** | Use MCP tools for ALL operations. NEVER edit .md files directly |\n{{/if}}\n{{else}}\n{{#if cli}}\n| **CLI Only** | Use commands for ALL operations. NEVER edit .md files directly |\n{{/if}}\n{{/if}}\n| **Docs First** | Read project docs BEFORE planning or coding |\n| **Time Tracking** | Start timer when taking task, stop when done |\n| **Plan Approval** | Share plan with user, WAIT for approval before coding |\n| **Check AC After** | Only mark criteria done AFTER completing work |\n\n{{#if cli}}\n---\n\n## The --plain Flag\n\n**ONLY for view/list/search commands (NOT create/edit):**\n\n```bash\n# CORRECT\nknowns task <id> --plain\nknowns task list --plain\nknowns doc "path" --plain\nknowns search "query" --plain\n\n# WRONG (create/edit don\'t support --plain)\nknowns task create "Title" --plain       # ERROR!\nknowns task edit <id> -s done --plain    # ERROR!\n```\n{{/if}}\n\n---\n\n## Reference System\n\nTasks, docs, and templates can reference each other:\n\n| Type | Writing (Input) | Reading (Output) |\n|------|-----------------|------------------|\n| Task | `@task-<id>` | `@.knowns/tasks/task-<id>` |\n| Doc | `@doc/<path>` | `@.knowns/docs/<path>.md` |\n| Template | `@template/<name>` | `@.knowns/templates/<name>` |\n\n**Always follow refs recursively** to gather complete context before planning.\n\n---\n\n## Subtasks\n\n{{#if cli}}\n### CLI\n```bash\nknowns task create "Subtask title" --parent 48\n```\n\n**CRITICAL:** Use raw ID for `--parent`:\n```bash\n# CORRECT\nknowns task create "Title" --parent 48\n\n# WRONG\nknowns task create "Title" --parent task-48\n```\n{{/if}}\n{{#if mcp}}\n### MCP\n```json\nmcp__knowns__create_task({\n  "title": "Subtask title",\n  "parent": "parent-task-id"\n})\n```\n\n**CRITICAL:** Use raw ID (string) for all MCP tool calls.\n{{/if}}\n';
+var core_rules_default = '# Core Rules\n\n> These rules are NON-NEGOTIABLE. Violating them leads to data corruption and lost work.\n\n---\n\n## The Golden Rule\n\n{{#if mcp}}\n{{#if cli}}\n**If you want to change ANYTHING in a task or doc, use MCP tools (preferred) or CLI commands (fallback). NEVER edit .md files directly.**\n{{else}}\n**If you want to change ANYTHING in a task or doc, use MCP tools. NEVER edit .md files directly.**\n{{/if}}\n{{else}}\n{{#if cli}}\n**If you want to change ANYTHING in a task or doc, use CLI commands. NEVER edit .md files directly.**\n{{/if}}\n{{/if}}\n\n{{#if mcp}}\n---\n\n## Session Initialization (MCP)\n\n**CRITICAL: At the START of every session, run these tools to initialize the project:**\n\n```json\n// Step 1: Detect available projects\nmcp__knowns__detect_projects({})\n\n// Step 2: Set the project you want to work with\nmcp__knowns__set_project({ "projectRoot": "/path/to/project" })\n\n// Step 3: Verify project is set correctly\nmcp__knowns__get_current_project({})\n```\n\n**Why?** The MCP server may not know which project you\'re working in. These tools:\n- `detect_projects` - Scans common workspace directories for Knowns projects\n- `set_project` - Sets the active project for all subsequent operations\n- `get_current_project` - Verifies the current project path\n\n**If you skip this step**, other tools like `list_tasks`, `get_doc`, etc. may fail or work on the wrong project.\n{{/if}}\n\n{{#if cli}}\n---\n\n## CRITICAL: The -a Flag Confusion\n\nThe `-a` flag means DIFFERENT things in different commands:\n\n| Command | `-a` Means | NOT This! |\n|---------|------------|-----------|\n| `task create` | `--assignee` (assign user) | ~~acceptance criteria~~ |\n| `task edit` | `--assignee` (assign user) | ~~acceptance criteria~~ |\n| `doc edit` | `--append` (append content) | ~~assignee~~ |\n\n### Acceptance Criteria: Use --ac\n\n```bash\n# WRONG: -a is assignee, NOT acceptance criteria!\nknowns task edit 35 -a "- [ ] Criterion"    # Sets assignee to garbage!\n\n# CORRECT: Use --ac for acceptance criteria\nknowns task edit 35 --ac "Criterion one"\nknowns task create "Title" --ac "Criterion one" --ac "Criterion two"\n```\n{{/if}}\n\n---\n\n## Quick Reference\n\n| Rule | Description |\n|------|-------------|\n{{#if mcp}}\n{{#if cli}}\n| **MCP Tools (preferred)** | Use MCP tools for ALL operations. Fallback to CLI if needed. NEVER edit .md files directly |\n{{else}}\n| **MCP Tools Only** | Use MCP tools for ALL operations. NEVER edit .md files directly |\n{{/if}}\n{{else}}\n{{#if cli}}\n| **CLI Only** | Use commands for ALL operations. NEVER edit .md files directly |\n{{/if}}\n{{/if}}\n| **Docs First** | Read project docs BEFORE planning or coding |\n| **Time Tracking** | Start timer when taking task, stop when done |\n| **Plan Approval** | Share plan with user, WAIT for approval before coding |\n| **Check AC After** | Only mark criteria done AFTER completing work |\n\n{{#if cli}}\n---\n\n## The --plain Flag\n\n**ONLY for view/list/search commands (NOT create/edit):**\n\n```bash\n# CORRECT\nknowns task <id> --plain\nknowns task list --plain\nknowns doc "path" --plain\nknowns search "query" --plain\n\n# WRONG (create/edit don\'t support --plain)\nknowns task create "Title" --plain       # ERROR!\nknowns task edit <id> -s done --plain    # ERROR!\n```\n{{/if}}\n\n---\n\n## Reference System\n\nTasks, docs, and templates can reference each other:\n\n| Type | Writing (Input) | Reading (Output) |\n|------|-----------------|------------------|\n| Task | `@task-<id>` | `@.knowns/tasks/task-<id>` |\n| Doc | `@doc/<path>` | `@.knowns/docs/<path>.md` |\n| Template | `@template/<name>` | `@.knowns/templates/<name>` |\n\n**Always follow refs recursively** to gather complete context before planning.\n\n---\n\n## Subtasks\n\n{{#if cli}}\n### CLI\n```bash\nknowns task create "Subtask title" --parent 48\n```\n\n**CRITICAL:** Use raw ID for `--parent`:\n```bash\n# CORRECT\nknowns task create "Title" --parent 48\n\n# WRONG\nknowns task create "Title" --parent task-48\n```\n{{/if}}\n{{#if mcp}}\n### MCP\n```json\nmcp__knowns__create_task({\n  "title": "Subtask title",\n  "parent": "parent-task-id"\n})\n```\n\n**CRITICAL:** Use raw ID (string) for all MCP tool calls.\n{{/if}}\n';
 
 // src/instructions/guidelines/unified/workflow-completion.md
 var workflow_completion_default = '# Task Completion\n\n## Definition of Done\n\nA task is **Done** when ALL of these are complete:\n\n{{#if cli}}\n### CLI\n| Requirement | Command |\n|-------------|---------|\n| All AC checked | `knowns task edit <id> --check-ac N` |\n| Notes added | `knowns task edit <id> --notes "Summary"` |\n| Timer stopped | `knowns time stop` |\n| Status = done | `knowns task edit <id> -s done` |\n| Tests pass | Run test suite |\n{{/if}}\n{{#if mcp}}\n### MCP\n| Requirement | How |\n|-------------|-----|\n| All AC checked | `mcp__knowns__update_task` with `checkAc` |\n| Notes added | `mcp__knowns__update_task` with `notes` |\n| Timer stopped | `mcp__knowns__stop_time` |\n| Status = done | `mcp__knowns__update_task` with `status: "done"` |\n| Tests pass | Run test suite |\n{{/if}}\n\n---\n\n## Completion Steps\n\n{{#if cli}}\n### CLI\n```bash\n# 1. Verify all AC are checked\nknowns task <id> --plain\n\n# 2. Add implementation notes\nknowns task edit <id> --notes $\'## Summary\nWhat was done and key decisions.\'\n\n# 3. Stop timer (REQUIRED!)\nknowns time stop\n\n# 4. Mark done\nknowns task edit <id> -s done\n```\n{{/if}}\n{{#if mcp}}\n### MCP\n```json\n// 1. Verify all AC are checked\nmcp__knowns__get_task({ "taskId": "<id>" })\n\n// 2. Add implementation notes\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "notes": "## Summary\\nWhat was done and key decisions."\n})\n\n// 3. Stop timer (REQUIRED!)\nmcp__knowns__stop_time({ "taskId": "<id>" })\n\n// 4. Mark done\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "status": "done"\n})\n```\n{{/if}}\n\n---\n\n## Post-Completion Changes\n\nIf user requests changes after task is done:\n\n{{#if cli}}\n### CLI\n```bash\nknowns task edit <id> -s in-progress    # Reopen\nknowns time start <id>                   # Restart timer\nknowns task edit <id> --ac "Fix: description"\nknowns task edit <id> --append-notes "Reopened: reason"\n```\n{{/if}}\n{{#if mcp}}\n### MCP\n```json\n// 1. Reopen task\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "status": "in-progress"\n})\n\n// 2. Restart timer\nmcp__knowns__start_time({ "taskId": "<id>" })\n\n// 3. Add AC for the fix\nmcp__knowns__update_task({\n  "taskId": "<id>",\n  "addAc": ["Fix: description"],\n  "appendNotes": "Reopened: reason"\n})\n```\n{{/if}}\n\nThen follow completion steps again.\n\n---\n\n## Checklist\n\n{{#if cli}}\n### CLI\n- [ ] All AC checked (`--check-ac`)\n- [ ] Notes added (`--notes`)\n- [ ] Timer stopped (`time stop`)\n- [ ] Tests pass\n- [ ] Status = done (`-s done`)\n{{/if}}\n{{#if mcp}}\n### MCP\n- [ ] All AC checked (`checkAc`)\n- [ ] Notes added (`notes`)\n- [ ] Timer stopped (`mcp__knowns__stop_time`)\n- [ ] Tests pass\n- [ ] Status = done (`mcp__knowns__update_task`)\n{{/if}}\n';
@@ -59566,10 +59566,10 @@ function getIDENames() {
 import { existsSync as existsSync3 } from "node:fs";
 import { mkdir as mkdir4, readFile as readFile5, writeFile as writeFile3 } from "node:fs/promises";
 import { dirname as dirname2, join as join5 } from "node:path";
-var import_prompts = __toESM(require_prompts3(), 1);
 var PROJECT_ROOT = process.cwd();
 var INSTRUCTION_FILES = [
   { path: "CLAUDE.md", name: "Claude Code", selected: true },
+  { path: "GEMINI.md", name: "Antigravity (Gemini)", selected: true },
   { path: "AGENTS.md", name: "Agent SDK", selected: true },
   {
     path: ".github/copilot-instructions.md",
@@ -59616,169 +59616,6 @@ ${guidelines}
   await writeFile3(fullPath, newContent, "utf-8");
   return { success: true, action: "updated" };
 }
-var agentsCommand = new Command("agents").description("Manage agent instruction files (CLAUDE.md, GEMINI.md, etc.)").enablePositionalOptions().passThroughOptions().option("--update-instructions", "Update agent instruction files (non-interactive)").option("--type <type>", "Guidelines type: cli or mcp", "cli").option("--files <files>", "Comma-separated list of files to update").action(
-  async (options2) => {
-    try {
-      if (options2.updateInstructions) {
-        const type = options2.type === "mcp" ? "mcp" : "cli";
-        const guidelines2 = getGuidelines(type);
-        let filesToUpdate = INSTRUCTION_FILES;
-        if (options2.files) {
-          const requestedFiles = options2.files.split(",").map((f) => f.trim());
-          filesToUpdate = INSTRUCTION_FILES.filter(
-            (f) => requestedFiles.includes(f.path) || requestedFiles.includes(f.name)
-          );
-        }
-        const label2 = `${type.toUpperCase()}`;
-        console.log(source_default.bold(`
-Updating agent instruction files (${label2})...
-`));
-        await updateFiles(filesToUpdate, guidelines2);
-        return;
-      }
-      console.log(source_default.bold("\n\u{1F916} Agent Instructions Manager\n"));
-      const typeResponse = await (0, import_prompts.default)({
-        type: "select",
-        name: "type",
-        message: "Select guidelines type:",
-        choices: [
-          {
-            title: "CLI",
-            value: "cli",
-            description: "CLI commands (knowns task edit, knowns doc view, etc.)"
-          },
-          {
-            title: "MCP",
-            value: "mcp",
-            description: "MCP tools (mcp__knowns__update_task, etc.)"
-          }
-        ],
-        initial: 0
-      });
-      if (!typeResponse.type) {
-        console.log(source_default.yellow("\n\u26A0\uFE0F  Cancelled"));
-        return;
-      }
-      const filesResponse = await (0, import_prompts.default)({
-        type: "multiselect",
-        name: "files",
-        message: "Select agent files to update:",
-        choices: INSTRUCTION_FILES.map((f) => ({
-          title: `${f.name} (${f.path})`,
-          value: f,
-          selected: f.selected
-        })),
-        hint: "- Space to select. Return to submit"
-      });
-      if (!filesResponse.files || filesResponse.files.length === 0) {
-        console.log(source_default.yellow("\n\u26A0\uFE0F  No files selected"));
-        return;
-      }
-      const label = typeResponse.type.toUpperCase();
-      const confirmResponse = await (0, import_prompts.default)({
-        type: "confirm",
-        name: "confirm",
-        message: `Update ${filesResponse.files.length} file(s) with ${label} guidelines?`,
-        initial: true
-      });
-      if (!confirmResponse.confirm) {
-        console.log(source_default.yellow("\n\u26A0\uFE0F  Cancelled"));
-        return;
-      }
-      const guidelines = getGuidelines(typeResponse.type);
-      console.log(source_default.bold(`
-Updating files with ${label} guidelines...
-`));
-      await updateFiles(filesResponse.files, guidelines);
-    } catch (error48) {
-      console.error(source_default.red("Error:"), error48 instanceof Error ? error48.message : String(error48));
-      process.exit(1);
-    }
-  }
-);
-async function updateFiles(files, guidelines) {
-  let createdCount = 0;
-  let appendedCount = 0;
-  let updatedCount = 0;
-  let errorCount = 0;
-  for (const file3 of files) {
-    try {
-      const result = await updateInstructionFile(file3.path, guidelines);
-      if (result.success) {
-        if (result.action === "created") {
-          createdCount++;
-          console.log(source_default.green(`\u2713 Created ${file3.name}: ${file3.path}`));
-        } else if (result.action === "appended") {
-          appendedCount++;
-          console.log(source_default.cyan(`\u2713 Appended ${file3.name}: ${file3.path}`));
-        } else {
-          updatedCount++;
-          console.log(source_default.green(`\u2713 Updated ${file3.name}: ${file3.path}`));
-        }
-      }
-    } catch (error48) {
-      errorCount++;
-      console.error(
-        source_default.red(`\u2717 Failed ${file3.name}: ${file3.path}`),
-        error48 instanceof Error ? error48.message : String(error48)
-      );
-    }
-  }
-  console.log(source_default.bold("\nSummary:"));
-  if (createdCount > 0) {
-    console.log(source_default.green(`  Created: ${createdCount}`));
-  }
-  if (appendedCount > 0) {
-    console.log(source_default.cyan(`  Appended: ${appendedCount}`));
-  }
-  if (updatedCount > 0) {
-    console.log(source_default.green(`  Updated: ${updatedCount}`));
-  }
-  if (errorCount > 0) {
-    console.log(source_default.red(`  Failed: ${errorCount}`));
-  }
-  console.log();
-}
-var guidelineCommand = new Command("guideline").description("Output guidelines for AI agents (use this at session start)").option("--cli", "Show CLI-specific guidelines (legacy)").option("--mcp", "Show MCP-specific guidelines (legacy)").option("--full", "Show full guidelines (all sections)").option("--compact", "Show compact guidelines (core + mistakes only)").option("--stage <stage>", "Show guidelines for specific stage: creation, execution, completion").option("--core", "Show core rules only").option("--commands", "Show commands reference only").option("--mistakes", "Show common mistakes only").action(
-  async (options2) => {
-    try {
-      if (options2.cli || options2.mcp) {
-        console.log(Guidelines.getFull());
-        return;
-      }
-      if (options2.core) {
-        console.log(Guidelines.core);
-        return;
-      }
-      if (options2.commands) {
-        console.log(Guidelines.commands);
-        return;
-      }
-      if (options2.mistakes) {
-        console.log(Guidelines.mistakes);
-        return;
-      }
-      if (options2.compact) {
-        console.log(Guidelines.getCompact());
-        return;
-      }
-      if (options2.stage) {
-        const stage = options2.stage;
-        if (!["creation", "execution", "completion"].includes(stage)) {
-          console.error("Error: Invalid stage. Use: creation, execution, or completion");
-          process.exit(1);
-        }
-        console.log(Guidelines.getForStage(stage));
-        return;
-      }
-      console.log(Guidelines.getFull());
-    } catch (error48) {
-      console.error("Error:", error48 instanceof Error ? error48.message : String(error48));
-      process.exit(1);
-    }
-  }
-);
-agentsCommand.addCommand(guidelineCommand);
 
 // src/commands/init.ts
 function mapPlatformId(initId) {
@@ -59871,6 +59708,46 @@ async function createMcpJsonFile(projectRoot, force = false) {
     console.log(source_default.green("\u2713 Created .mcp.json for Claude Code MCP auto-discovery"));
   }
 }
+async function createAntigravityMcpConfig(force = false) {
+  const { mkdirSync: mkdirSync2, writeFileSync: writeFileSync4, readFileSync: readFileSync5 } = await import("node:fs");
+  const { homedir: homedir4 } = await import("node:os");
+  const homeDir = homedir4();
+  const antigravityDir = join6(homeDir, ".gemini", "antigravity");
+  const mcpConfigPath = join6(antigravityDir, "mcp_config.json");
+  const mcpConfig = {
+    mcpServers: {
+      knowns: {
+        command: "npx",
+        args: ["-y", "knowns", "mcp"]
+      }
+    }
+  };
+  if (!existsSync4(antigravityDir)) {
+    mkdirSync2(antigravityDir, { recursive: true });
+  }
+  if (existsSync4(mcpConfigPath)) {
+    try {
+      const existing = JSON.parse(readFileSync5(mcpConfigPath, "utf-8"));
+      if (existing?.mcpServers?.knowns && !force) {
+        console.log(source_default.gray("  Antigravity MCP already has knowns configuration"));
+        return;
+      }
+      existing.mcpServers = {
+        ...existing.mcpServers,
+        ...mcpConfig.mcpServers
+      };
+      writeFileSync4(mcpConfigPath, JSON.stringify(existing, null, "	"), "utf-8");
+      const action = force ? "Updated" : "Added";
+      console.log(source_default.green(`\u2713 ${action} knowns in Antigravity MCP config`));
+    } catch {
+      writeFileSync4(mcpConfigPath, JSON.stringify(mcpConfig, null, "	"), "utf-8");
+      console.log(source_default.green("\u2713 Created Antigravity MCP config (replaced invalid file)"));
+    }
+  } else {
+    writeFileSync4(mcpConfigPath, JSON.stringify(mcpConfig, null, "	"), "utf-8");
+    console.log(source_default.green("\u2713 Created Antigravity MCP config (~/.gemini/antigravity/mcp_config.json)"));
+  }
+}
 async function updateGitignore(projectRoot, mode) {
   const { appendFileSync, readFileSync: readFileSync5, writeFileSync: writeFileSync4 } = await import("node:fs");
   const gitignorePath = join6(projectRoot, ".gitignore");
@@ -59957,7 +59834,7 @@ async function runWizard() {
   console.log(source_default.bold.cyan("\u{1F680} Knowns Project Setup Wizard"));
   console.log(source_default.gray("   Configure your project settings"));
   console.log();
-  const response = await (0, import_prompts2.default)(
+  const response = await (0, import_prompts.default)(
     [
       {
         type: "text",
@@ -60059,8 +59936,8 @@ var initCommand = new Command("init").description("Initialize .knowns/ folder in
     if (config2.gitTrackingMode === "git-ignored" || config2.gitTrackingMode === "none") {
       await updateGitignore(projectRoot, config2.gitTrackingMode);
     }
-    const fileStore2 = new FileStore(projectRoot);
-    const project = await fileStore2.initProject(config2.name, {
+    const fileStore = new FileStore(projectRoot);
+    const project = await fileStore.initProject(config2.name, {
       defaultPriority: config2.defaultPriority,
       defaultLabels: config2.defaultLabels,
       timeFormat: config2.timeFormat,
@@ -60097,16 +59974,36 @@ var initCommand = new Command("init").description("Initialize .knowns/ folder in
           }
         }
       }
-      await createMcpJsonFile(projectRoot, options2.force);
+      const hasClaudeCode = config2.platforms.includes("claude-code");
+      const hasAntigravity = config2.platforms.includes("antigravity");
+      if (hasClaudeCode) {
+        await createMcpJsonFile(projectRoot, options2.force);
+      }
+      if (hasAntigravity) {
+        await createAntigravityMcpConfig(options2.force);
+      }
       const guidelines = UnifiedGuidelines.getFull(true);
-      try {
-        const result = await updateInstructionFile("CLAUDE.md", guidelines);
-        if (result.success) {
-          const action = result.action === "created" ? "Created" : result.action === "appended" ? "Appended" : "Updated";
-          console.log(source_default.green(`\u2713 ${action}: CLAUDE.md (unified CLI + MCP guidelines)`));
+      if (hasClaudeCode) {
+        try {
+          const result = await updateInstructionFile("CLAUDE.md", guidelines);
+          if (result.success) {
+            const action = result.action === "created" ? "Created" : result.action === "appended" ? "Appended" : "Updated";
+            console.log(source_default.green(`\u2713 ${action}: CLAUDE.md (unified CLI + MCP guidelines)`));
+          }
+        } catch {
+          console.log(source_default.yellow("\u26A0\uFE0F  Skipped: CLAUDE.md"));
+        }
+      }
+      if (hasAntigravity) {
+        try {
+          const result = await updateInstructionFile("GEMINI.md", guidelines);
+          if (result.success) {
+            const action = result.action === "created" ? "Created" : result.action === "appended" ? "Appended" : "Updated";
+            console.log(source_default.green(`\u2713 ${action}: GEMINI.md (unified CLI + MCP guidelines)`));
+          }
+        } catch {
+          console.log(source_default.yellow("\u26A0\uFE0F  Skipped: GEMINI.md"));
         }
-      } catch {
-        console.log(source_default.yellow("\u26A0\uFE0F  Skipped: CLAUDE.md"));
       }
     }
     for (const platform of selectedPlatforms) {
@@ -60713,7 +60610,7 @@ function getFileStore() {
   }
   return new FileStore(projectRoot);
 }
-async function wouldCreateCycle(taskId, newParentId, fileStore2) {
+async function wouldCreateCycle(taskId, newParentId, fileStore) {
   if (taskId === newParentId) {
     return true;
   }
@@ -60722,7 +60619,7 @@ async function wouldCreateCycle(taskId, newParentId, fileStore2) {
     if (current === taskId) {
       return true;
     }
-    const parent = await fileStore2.getTask(current);
+    const parent = await fileStore.getTask(current);
     current = parent?.parent || "";
   }
   return false;
@@ -60737,7 +60634,7 @@ function collectNumbers(value, previous) {
   }
   return previous.concat([num]);
 }
-async function formatTask(task, fileStore2, plain = false) {
+async function formatTask(task, fileStore, plain = false) {
   if (plain) {
     const border = "-".repeat(50);
     const titleBorder = "=".repeat(50);
@@ -60858,7 +60755,7 @@ async function formatTask(task, fileStore2, plain = false) {
   if (task.subtasks.length > 0) {
     output.push(source_default.bold("Subtasks:"));
     for (const subtaskId of task.subtasks) {
-      const subtask = await fileStore2.getTask(subtaskId);
+      const subtask = await fileStore.getTask(subtaskId);
       if (subtask) {
         const statusIcon = getStatusIcon(subtask.status);
         const statusColor2 = getStatusColor(subtask.status);
@@ -60940,18 +60837,18 @@ function getStatusIcon(status) {
       return "\u25CB";
   }
 }
-async function getSubtaskProgress(task, fileStore2) {
+async function getSubtaskProgress(task, fileStore) {
   if (task.subtasks.length === 0) return "";
   let completed = 0;
   for (const subtaskId of task.subtasks) {
-    const subtask = await fileStore2.getTask(subtaskId);
+    const subtask = await fileStore.getTask(subtaskId);
     if (subtask && subtask.status === "done") {
       completed++;
     }
   }
   return ` (${completed}/${task.subtasks.length})`;
 }
-async function formatTaskTree(tasks, fileStore2, plain = false) {
+async function formatTaskTree(tasks, fileStore, plain = false) {
   const topLevelTasks = tasks.filter((t) => !t.parent);
   if (topLevelTasks.length === 0) {
     return plain ? "No tasks found" : source_default.gray("No tasks found");
@@ -60966,15 +60863,15 @@ async function formatTaskTree(tasks, fileStore2, plain = false) {
   }
   for (let i = 0; i < topLevelTasks.length; i++) {
     const isLast = i === topLevelTasks.length - 1;
-    await formatTaskNode(topLevelTasks[i], fileStore2, "", isLast, output, plain);
+    await formatTaskNode(topLevelTasks[i], fileStore, "", isLast, output, plain);
   }
   return output.join("\n");
 }
-async function formatTaskNode(task, fileStore2, prefix, isLast, output, plain, depth = 0) {
+async function formatTaskNode(task, fileStore, prefix, isLast, output, plain, depth = 0) {
   const connector = isLast ? "\u2514\u2500\u2500 " : "\u251C\u2500\u2500 ";
   const extension = isLast ? "    " : "\u2502   ";
   const statusIcon = getStatusIcon(task.status);
-  const progress = await getSubtaskProgress(task, fileStore2);
+  const progress = await getSubtaskProgress(task, fileStore);
   if (plain) {
     const indent = depth > 0 ? `${"  ".repeat(depth)}> ` : "";
     const statusDisplay = task.status.toUpperCase().replace("-", "_");
@@ -60988,15 +60885,15 @@ async function formatTaskNode(task, fileStore2, prefix, isLast, output, plain, d
   if (task.subtasks.length > 0) {
     for (let i = 0; i < task.subtasks.length; i++) {
       const subtaskId = task.subtasks[i];
-      const subtask = await fileStore2.getTask(subtaskId);
+      const subtask = await fileStore.getTask(subtaskId);
       if (subtask) {
         const isLastChild = i === task.subtasks.length - 1;
-        await formatTaskNode(subtask, fileStore2, prefix + extension, isLastChild, output, plain, depth + 1);
+        await formatTaskNode(subtask, fileStore, prefix + extension, isLastChild, output, plain, depth + 1);
       }
     }
   }
 }
-async function formatTaskChildren(task, fileStore2, plain = false) {
+async function formatTaskChildren(task, fileStore, plain = false) {
   const output = [];
   if (plain) {
     output.push(`Children of Task #${task.id}: ${task.title}`);
@@ -61009,7 +60906,7 @@ async function formatTaskChildren(task, fileStore2, plain = false) {
     let completed = 0;
     const total = task.subtasks.length;
     for (const subtaskId of task.subtasks) {
-      const subtask = await fileStore2.getTask(subtaskId);
+      const subtask = await fileStore.getTask(subtaskId);
       if (subtask) {
         if (subtask.status === "done") completed++;
         const statusDisplay = subtask.status.toUpperCase().replace("-", "_");
@@ -61028,7 +60925,7 @@ async function formatTaskChildren(task, fileStore2, plain = false) {
     }
     let completed = 0;
     for (const subtaskId of task.subtasks) {
-      const subtask = await fileStore2.getTask(subtaskId);
+      const subtask = await fileStore.getTask(subtaskId);
       if (subtask) {
         if (subtask.status === "done") completed++;
         const statusIcon = getStatusIcon(subtask.status);
@@ -61110,8 +61007,8 @@ function formatTaskList(tasks, plain = false) {
 var createCommand2 = new Command("create").description("Create a new task").argument("<title>", "Task title").option("-d, --description <text>", "Task description").option("--ac <criterion>", "Acceptance criterion (can be used multiple times)", collect, []).option("-l, --labels <labels>", "Comma-separated labels").option("-a, --assignee <name>", "Assignee (@username)").option("--priority <level>", "Priority: low, medium, high", "medium").option("-s, --status <status>", "Status", "todo").option("--parent <id>", "Parent task ID for subtasks").action(
   async (title, options2) => {
     try {
-      const fileStore2 = getFileStore();
-      const project = await fileStore2.getProject();
+      const fileStore = getFileStore();
+      const project = await fileStore.getProject();
       const allowedStatuses = project?.settings.statuses || DEFAULT_STATUSES;
       if (!isValidTaskStatus(options2.status, allowedStatuses)) {
         console.error(source_default.red(`\u2717 Invalid status: ${options2.status}`));
@@ -61128,7 +61025,7 @@ var createCommand2 = new Command("create").description("Create a new task").argu
         text,
         completed: false
       }));
-      const task = await fileStore2.createTask({
+      const task = await fileStore.createTask({
         title,
         description: options2.description ? normalizeRefs(options2.description) : void 0,
         status: options2.status,
@@ -61158,8 +61055,8 @@ var createCommand2 = new Command("create").description("Create a new task").argu
 var listCommand = new Command("list").description("List all tasks").option("--status <status>", "Filter by status").option("--assignee <name>", "Filter by assignee").option("-l, --labels <labels>", "Filter by labels (comma-separated)").option("--priority <level>", "Filter by priority").option("--tree", "Display tasks as tree hierarchy").option("--plain", "Plain text output for AI").action(
   async (options2) => {
     try {
-      const fileStore2 = getFileStore();
-      let tasks = await fileStore2.getAllTasks();
+      const fileStore = getFileStore();
+      let tasks = await fileStore.getAllTasks();
       if (options2.status) {
         tasks = tasks.filter((t) => t.status === options2.status);
       }
@@ -61174,7 +61071,7 @@ var listCommand = new Command("list").description("List all tasks").option("--st
         tasks = tasks.filter((t) => filterLabels.some((label) => t.labels.includes(label)));
       }
       if (options2.tree) {
-        console.log(await formatTaskTree(tasks, fileStore2, options2.plain));
+        console.log(await formatTaskTree(tasks, fileStore, options2.plain));
       } else {
         console.log(formatTaskList(tasks, options2.plain));
       }
@@ -61190,17 +61087,17 @@ var listCommand = new Command("list").description("List all tasks").option("--st
 var viewCommand = new Command("view").description("View task details").argument("<id>", "Task ID").option("--plain", "Plain text output for AI").option("--children", "Show detailed list of child tasks").action(async (rawId, options2) => {
   try {
     const id = normalizeTaskId(rawId);
-    const fileStore2 = getFileStore();
-    const task = await fileStore2.getTask(id);
+    const fileStore = getFileStore();
+    const task = await fileStore.getTask(id);
     if (!task) {
       console.error(source_default.red(`\u2717 Task ${id} not found`));
       process.exit(1);
     }
     if (options2.children) {
-      console.log(await formatTaskChildren(task, fileStore2, options2.plain));
+      console.log(await formatTaskChildren(task, fileStore, options2.plain));
       return;
     }
-    console.log(await formatTask(task, fileStore2, options2.plain));
+    console.log(await formatTask(task, fileStore, options2.plain));
   } catch (error48) {
     console.error(source_default.red("\u2717 Failed to view task"));
     if (error48 instanceof Error) {
@@ -61228,13 +61125,13 @@ var editCommand = new Command("edit").description("Edit task properties").argume
   async (rawId, options2) => {
     try {
       const id = normalizeTaskId(rawId);
-      const fileStore2 = getFileStore();
-      const task = await fileStore2.getTask(id);
+      const fileStore = getFileStore();
+      const task = await fileStore.getTask(id);
       if (!task) {
         console.error(source_default.red(`\u2717 Task ${id} not found`));
         process.exit(1);
       }
-      const project = await fileStore2.getProject();
+      const project = await fileStore.getProject();
       const allowedStatuses = project?.settings.statuses || DEFAULT_STATUSES;
       const updates = {};
       if (options2.title) {
@@ -61269,12 +61166,12 @@ var editCommand = new Command("edit").description("Edit task properties").argume
         if (options2.parent.toLowerCase() === "none") {
           updates.parent = void 0;
         } else {
-          const newParent = await fileStore2.getTask(options2.parent);
+          const newParent = await fileStore.getTask(options2.parent);
           if (!newParent) {
             console.error(source_default.red(`\u2717 Parent task ${options2.parent} not found`));
             process.exit(1);
           }
-          if (await wouldCreateCycle(id, options2.parent, fileStore2)) {
+          if (await wouldCreateCycle(id, options2.parent, fileStore)) {
             console.error(source_default.red("\u2717 Cannot set parent: would create circular dependency"));
             console.error(source_default.gray("  A task cannot be its own ancestor or descendant"));
             process.exit(1);
@@ -61328,7 +61225,7 @@ var editCommand = new Command("edit").description("Edit task properties").argume
         const separator = existingNotes ? "\n\n" : "";
         updates.implementationNotes = existingNotes + separator + normalizeRefs(options2.appendNotes);
       }
-      await fileStore2.updateTask(id, updates);
+      await fileStore.updateTask(id, updates);
       await notifyTaskUpdate(id);
       console.log(source_default.green(`\u2713 Updated task-${id}`));
       const changes = [];
@@ -61371,8 +61268,8 @@ var archiveCommand = new Command("archive").description("Archive a task").argume
       console.error(source_default.gray('  Run "knowns init" to initialize'));
       process.exit(1);
     }
-    const fileStore2 = getFileStore();
-    const task = await fileStore2.getTask(id);
+    const fileStore = getFileStore();
+    const task = await fileStore.getTask(id);
     if (!task) {
       console.error(source_default.red(`\u2717 Task ${id} not found`));
       process.exit(1);
@@ -61436,13 +61333,13 @@ var unarchiveCommand = new Command("unarchive").description("Restore archived ta
 var historyCommand = new Command("history").description("View task change history").argument("<id>", "Task ID").option("--plain", "Plain text output for AI").option("--limit <n>", "Limit number of entries", Number.parseInt).action(async (rawId, options2) => {
   try {
     const id = normalizeTaskId(rawId);
-    const fileStore2 = getFileStore();
-    const task = await fileStore2.getTask(id);
+    const fileStore = getFileStore();
+    const task = await fileStore.getTask(id);
     if (!task) {
       console.error(source_default.red(`\u2717 Task ${id} not found`));
       process.exit(1);
     }
-    let versions = await fileStore2.getTaskVersionHistory(id);
+    let versions = await fileStore.getTaskVersionHistory(id);
     versions = versions.sort((a, b) => b.version - a.version);
     if (options2.limit && options2.limit > 0) {
       versions = versions.slice(0, options2.limit);
@@ -61567,13 +61464,13 @@ function formatValuePlain(value) {
 var diffCommand = new Command("diff").description("Compare task versions").argument("<id>", "Task ID").option("-v, --ver <n>", "Compare current with specific version", Number.parseInt).option("--from <v>", "Start version for comparison", Number.parseInt).option("--to <v>", "End version for comparison", Number.parseInt).option("--plain", "Plain text output for AI").action(async (rawId, options2) => {
   try {
     const id = normalizeTaskId(rawId);
-    const fileStore2 = getFileStore();
-    const task = await fileStore2.getTask(id);
+    const fileStore = getFileStore();
+    const task = await fileStore.getTask(id);
     if (!task) {
       console.error(source_default.red(`\u2717 Task ${id} not found`));
       process.exit(1);
     }
-    const versions = await fileStore2.getTaskVersionHistory(id);
+    const versions = await fileStore.getTaskVersionHistory(id);
     if (versions.length === 0) {
       if (options2.plain) {
         console.log("no_versions: true");
@@ -61750,13 +61647,13 @@ function deepEqual(a, b) {
 var restoreCommand = new Command("restore").description("Restore task to a previous version").argument("<id>", "Task ID").requiredOption("-v, --ver <n>", "Version to restore to", Number.parseInt).option("-y, --yes", "Skip confirmation").option("--dry-run", "Preview changes without applying").action(async (rawId, options2) => {
   try {
     const id = normalizeTaskId(rawId);
-    const fileStore2 = getFileStore();
-    const task = await fileStore2.getTask(id);
+    const fileStore = getFileStore();
+    const task = await fileStore.getTask(id);
     if (!task) {
       console.error(source_default.red(`\u2717 Task ${id} not found`));
       process.exit(1);
     }
-    const versions = await fileStore2.getTaskVersionHistory(id);
+    const versions = await fileStore.getTaskVersionHistory(id);
     if (versions.length === 0) {
       console.error(source_default.red(`\u2717 No version history found for task-${id}`));
       process.exit(1);
@@ -61820,9 +61717,9 @@ var restoreCommand = new Command("restore").description("Restore task to a previ
       console.log(source_default.yellow("\u26A0 This will modify the task. Use --yes to confirm."));
       return;
     }
-    const _restored = await fileStore2.rollbackTask(id, options2.ver);
+    const _restored = await fileStore.rollbackTask(id, options2.ver);
     console.log(source_default.green(`\u2713 Restored task-${id} to version ${options2.ver}`));
-    console.log(source_default.gray(`  New version created: v${await fileStore2.getTaskCurrentVersion(id)}`));
+    console.log(source_default.gray(`  New version created: v${await fileStore.getTaskCurrentVersion(id)}`));
   } catch (error48) {
     console.error(source_default.red("\u2717 Failed to restore task"));
     if (error48 instanceof Error) {
@@ -61984,17 +61881,17 @@ var taskCommand = new Command("task").description("Manage tasks").argument("[id]
   }
   try {
     const id = normalizeTaskId(rawId);
-    const fileStore2 = getFileStore();
-    const task = await fileStore2.getTask(id);
+    const fileStore = getFileStore();
+    const task = await fileStore.getTask(id);
     if (!task) {
       console.error(source_default.red(`\u2717 Task ${id} not found`));
       process.exit(1);
     }
     if (options2.children) {
-      console.log(await formatTaskChildren(task, fileStore2, options2.plain));
+      console.log(await formatTaskChildren(task, fileStore, options2.plain));
       return;
     }
-    console.log(await formatTask(task, fileStore2, options2.plain));
+    console.log(await formatTask(task, fileStore, options2.plain));
   } catch (error48) {
     console.error(source_default.red("\u2717 Failed to view task"));
     if (error48 instanceof Error) {
@@ -62140,8 +62037,8 @@ function printColoredBoard(columns) {
 var boardCommand = new Command("board").description("Display Kanban board").option("--plain", "Plain text output for AI").option("--status <status>", "Filter by status").option("--assignee <name>", "Filter by assignee").action(
   async (options2) => {
     try {
-      const fileStore2 = getFileStore2();
-      let tasks = await fileStore2.getAllTasks();
+      const fileStore = getFileStore2();
+      let tasks = await fileStore.getAllTasks();
       tasks = tasks.filter((t) => !t.parent);
       if (options2.status) {
         tasks = tasks.filter((t) => t.status === options2.status);
@@ -62273,8 +62170,8 @@ var searchCommand = new Command("search").description("Search tasks and document
       let taskResults = [];
       let docResults = [];
       if (searchType === "task" || searchType === "all") {
-        const fileStore2 = getFileStore3();
-        const allTasks = await fileStore2.getAllTasks();
+        const fileStore = getFileStore3();
+        const allTasks = await fileStore.getAllTasks();
         taskResults = allTasks.filter((task) => {
           const text = `${task.title} ${task.description || ""} ${task.labels.join(" ")} ${task.id}`.toLowerCase();
           if (!text.includes(q)) {
@@ -64265,8 +64162,8 @@ var startCommand = new Command("start").description("Start timer for a task").ar
   try {
     const taskId = normalizeTaskId(rawTaskId);
     const projectRoot = getProjectRoot();
-    const fileStore2 = getFileStore4();
-    const task = await fileStore2.getTask(taskId);
+    const fileStore = getFileStore4();
+    const task = await fileStore.getTask(taskId);
     if (!task) {
       console.error(source_default.red(`\u2717 Task ${taskId} not found`));
       process.exit(1);
@@ -64303,7 +64200,7 @@ var startCommand = new Command("start").description("Start timer for a task").ar
 var stopCommand = new Command("stop").description("Stop timer and save time entry").argument("[taskId]", "Task ID (optional - prompts if multiple timers)").option("-a, --all", "Stop all timers").action(async (rawTaskId, options2) => {
   try {
     const projectRoot = getProjectRoot();
-    const fileStore2 = getFileStore4();
+    const fileStore = getFileStore4();
     const data = await loadTimeData(projectRoot);
     if (data.active.length === 0) {
       console.log(source_default.yellow("No active timers"));
@@ -64340,7 +64237,7 @@ var stopCommand = new Command("stop").description("Stop timer and save time entr
       const endTime = pausedAt ? new Date(pausedAt) : /* @__PURE__ */ new Date();
       const elapsed = endTime.getTime() - new Date(startedAt).getTime() - totalPausedMs;
       const seconds = Math.floor(elapsed / 1e3);
-      const task = await fileStore2.getTask(taskId);
+      const task = await fileStore.getTask(taskId);
       if (task) {
         const entry = {
           id: `te-${Date.now()}-${taskId}`,
@@ -64350,7 +64247,7 @@ var stopCommand = new Command("stop").description("Stop timer and save time entr
         };
         task.timeEntries.push(entry);
         task.timeSpent += seconds;
-        await fileStore2.updateTask(taskId, {
+        await fileStore.updateTask(taskId, {
           timeEntries: task.timeEntries,
           timeSpent: task.timeSpent
         });
@@ -64376,7 +64273,7 @@ var stopCommand = new Command("stop").description("Stop timer and save time entr
 var pauseCommand = new Command("pause").description("Pause timer").argument("[taskId]", "Task ID (optional - prompts if multiple timers)").option("-a, --all", "Pause all running timers").action(async (rawTaskId, options2) => {
   try {
     const projectRoot = getProjectRoot();
-    const fileStore2 = getFileStore4();
+    const fileStore = getFileStore4();
     const data = await loadTimeData(projectRoot);
     if (data.active.length === 0) {
       console.log(source_default.yellow("No active timers"));
@@ -64435,7 +64332,7 @@ var pauseCommand = new Command("pause").description("Pause timer").argument("[ta
 var resumeCommand = new Command("resume").description("Resume paused timer").argument("[taskId]", "Task ID (optional - prompts if multiple timers)").option("-a, --all", "Resume all paused timers").action(async (rawTaskId, options2) => {
   try {
     const projectRoot = getProjectRoot();
-    const fileStore2 = getFileStore4();
+    const fileStore = getFileStore4();
     const data = await loadTimeData(projectRoot);
     if (data.active.length === 0) {
       console.log(source_default.yellow("No active timers"));
@@ -64498,7 +64395,7 @@ var resumeCommand = new Command("resume").description("Resume paused timer").arg
 var statusCommand = new Command("status").description("Show active timer status").option("--plain", "Plain text output for AI").action(async (options2) => {
   try {
     const projectRoot = getProjectRoot();
-    const fileStore2 = getFileStore4();
+    const fileStore = getFileStore4();
     const data = await loadTimeData(projectRoot);
     if (data.active.length === 0) {
       console.log(options2?.plain ? "No active timers" : source_default.gray("No active timers"));
@@ -64526,7 +64423,7 @@ var statusCommand = new Command("status").description("Show active timer status"
         const status = timer.pausedAt ? source_default.yellow("(paused)") : source_default.green("(running)");
         let title = timer.taskTitle;
         if (!title) {
-          const task = await fileStore2.getTask(timer.taskId);
+          const task = await fileStore.getTask(timer.taskId);
           title = task?.title || "Unknown";
         }
         console.log(`  #${timer.taskId}: ${title}`);
@@ -64545,8 +64442,8 @@ var statusCommand = new Command("status").description("Show active timer status"
 var logCommand = new Command("log").description("Show time log for a task").argument("<taskId>", "Task ID").action(async (rawTaskId) => {
   try {
     const taskId = normalizeTaskId(rawTaskId);
-    const fileStore2 = getFileStore4();
-    const task = await fileStore2.getTask(taskId);
+    const fileStore = getFileStore4();
+    const task = await fileStore.getTask(taskId);
     if (!task) {
       console.error(source_default.red(`\u2717 Task ${taskId} not found`));
       process.exit(1);
@@ -64598,8 +64495,8 @@ function parseDuration(durationStr) {
 var addCommand = new Command("add").description("Manually add time entry to a task").argument("<taskId>", "Task ID").argument("<duration>", "Duration (e.g., 2h, 30m, 1h30m)").option("-n, --note <text>", "Note for this time entry").option("-d, --date <date>", "Date for time entry (default: now)").action(async (rawTaskId, durationStr, options2) => {
   try {
     const taskId = normalizeTaskId(rawTaskId);
-    const fileStore2 = getFileStore4();
-    const task = await fileStore2.getTask(taskId);
+    const fileStore = getFileStore4();
+    const task = await fileStore.getTask(taskId);
     if (!task) {
       console.error(source_default.red(`\u2717 Task ${taskId} not found`));
       process.exit(1);
@@ -64624,7 +64521,7 @@ var addCommand = new Command("add").description("Manually add time entry to a ta
     };
     task.timeEntries.push(entry);
     task.timeSpent += seconds;
-    await fileStore2.updateTask(taskId, {
+    await fileStore.updateTask(taskId, {
       timeEntries: task.timeEntries,
       timeSpent: task.timeSpent
     });
@@ -64644,8 +64541,8 @@ var addCommand = new Command("add").description("Manually add time entry to a ta
 var reportCommand = new Command("report").description("Generate time tracking report").option("--from <date>", "Start date (YYYY-MM-DD)").option("--to <date>", "End date (YYYY-MM-DD)").option("--by-label", "Group by label").option("--by-status", "Group by status").option("--csv", "Export as CSV").action(
   async (options2) => {
     try {
-      const fileStore2 = getFileStore4();
-      const tasks = await fileStore2.getAllTasks();
+      const fileStore = getFileStore4();
+      const tasks = await fileStore.getAllTasks();
       let fromDate = null;
       let toDate = null;
       if (options2.from) {
@@ -88117,7 +88014,7 @@ var glob2 = Object.assign(glob_, {
 glob2.glob = glob2;
 
 // src/codegen/runner.ts
-var import_prompts4 = __toESM(require_prompts3(), 1);
+var import_prompts3 = __toESM(require_prompts3(), 1);
 async function runTemplate(template, options2) {
   const result = {
     success: false,
@@ -88178,7 +88075,7 @@ async function collectPromptValues(promptDefs, prefilledValues, nonInteractive)
 }
 async function runPrompt(promptDef) {
   const promptConfig = buildPromptConfig(promptDef);
-  const response = await (0, import_prompts4.default)(promptConfig, {
+  const response = await (0, import_prompts3.default)(promptConfig, {
     onCancel: () => {
       throw new Error("Template cancelled by user");
     }
@@ -88585,7 +88482,7 @@ export function {{camelCase name}}() {
         res.status(404).json({ error: `Template not found: ${name}` });
         return;
       }
-      const prompts4 = template.config.prompts?.map((p) => ({
+      const prompts3 = template.config.prompts?.map((p) => ({
         name: p.name,
         message: p.message,
         type: p.type || "input",
@@ -88600,7 +88497,7 @@ export function {{camelCase name}}() {
           description: template.config.description,
           doc: template.config.doc,
           destination: template.config.destination || "./",
-          prompts: prompts4 || [],
+          prompts: prompts3 || [],
           files: files || [],
           messages: template.config.messages
         }
@@ -90828,13 +90725,13 @@ syncCommand.addCommand(agentSubcommand);
 syncCommand.addCommand(ideSubcommand);
 
 // src/commands/mcp.ts
-import { existsSync as existsSync33, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "node:fs";
-import { join as join38 } from "node:path";
+import { existsSync as existsSync34, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "node:fs";
+import { join as join39 } from "node:path";
 
 // src/mcp/server.ts
-import { existsSync as existsSync32 } from "node:fs";
+import { existsSync as existsSync33 } from "node:fs";
 import { readFile as readFile24 } from "node:fs/promises";
-import { join as join37 } from "node:path";
+import { join as join38 } from "node:path";
 
 // node_modules/zod/v3/helpers/util.js
 var util;
@@ -97898,8 +97795,207 @@ var import_gray_matter11 = __toESM(require_gray_matter(), 1);
 
 // src/mcp/utils.ts
 import { readFile as readFile20 } from "node:fs/promises";
-import { join as join32 } from "node:path";
+import { join as join33 } from "node:path";
 var import_gray_matter8 = __toESM(require_gray_matter(), 1);
+
+// src/mcp/handlers/project.ts
+import { existsSync as existsSync28, readdirSync as readdirSync2, statSync as statSync2 } from "node:fs";
+import { homedir as homedir2 } from "node:os";
+import { basename as basename4, join as join32 } from "node:path";
+var currentProjectRoot = null;
+function getProjectRoot3() {
+  if (currentProjectRoot) {
+    return currentProjectRoot;
+  }
+  if (process.env.KNOWNS_PROJECT_ROOT) {
+    return process.env.KNOWNS_PROJECT_ROOT;
+  }
+  return process.cwd();
+}
+function setProjectRoot(path3) {
+  currentProjectRoot = path3;
+}
+function getWorkspaceDirectories() {
+  const home = homedir2();
+  const dirs = [];
+  const commonPaths = [
+    join32(home, "Workspaces"),
+    join32(home, "workspace"),
+    join32(home, "projects"),
+    join32(home, "Projects"),
+    join32(home, "dev"),
+    join32(home, "Development"),
+    join32(home, "Code"),
+    join32(home, "code"),
+    join32(home, "repos"),
+    join32(home, "Repos"),
+    join32(home, "src"),
+    join32(home, "Documents", "Projects"),
+    join32(home, "Documents", "GitHub"),
+    join32(home, "GitHub")
+  ];
+  for (const path3 of commonPaths) {
+    if (existsSync28(path3)) {
+      dirs.push(path3);
+    }
+  }
+  return dirs;
+}
+function scanForKnownsProjects(baseDir, maxDepth = 2) {
+  const projects = [];
+  function scan(dir, depth) {
+    if (depth > maxDepth) return;
+    try {
+      const entries = readdirSync2(dir);
+      if (entries.includes(".knowns")) {
+        const knownsPath = join32(dir, ".knowns");
+        if (existsSync28(knownsPath) && statSync2(knownsPath).isDirectory()) {
+          projects.push(dir);
+          return;
+        }
+      }
+      for (const entry of entries) {
+        if (entry.startsWith(".") || entry === "node_modules" || entry === "vendor") {
+          continue;
+        }
+        const entryPath = join32(dir, entry);
+        try {
+          if (statSync2(entryPath).isDirectory()) {
+            scan(entryPath, depth + 1);
+          }
+        } catch {
+        }
+      }
+    } catch {
+    }
+  }
+  scan(baseDir, 0);
+  return projects;
+}
+function detectKnownsProjects() {
+  const workspaceDirs = getWorkspaceDirectories();
+  const allProjects = [];
+  const cwd = process.cwd();
+  if (existsSync28(join32(cwd, ".knowns"))) {
+    allProjects.push(cwd);
+  }
+  for (const dir of workspaceDirs) {
+    const projects = scanForKnownsProjects(dir);
+    for (const project of projects) {
+      if (!allProjects.includes(project)) {
+        allProjects.push(project);
+      }
+    }
+  }
+  return allProjects.sort().map((path3) => ({
+    path: path3,
+    name: basename4(path3)
+  }));
+}
+var projectTools = [
+  {
+    name: "detect_projects",
+    description: "Detect all Knowns projects on the system. Scans common workspace directories for projects with .knowns/ folder. Use this to find available projects when the current working directory is not set correctly.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        additionalPaths: {
+          type: "array",
+          items: { type: "string" },
+          description: "Additional directories to scan for projects"
+        }
+      }
+    }
+  },
+  {
+    name: "set_project",
+    description: "Set the current working project for all subsequent Knowns MCP operations. Use this after detect_projects to select which project to work with.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        projectRoot: {
+          type: "string",
+          description: "Absolute path to the project root directory (must contain .knowns/ folder)"
+        }
+      },
+      required: ["projectRoot"]
+    }
+  },
+  {
+    name: "get_current_project",
+    description: "Get the currently active project path and verify it's valid.",
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  }
+];
+function handleDetectProjects(input) {
+  let projects = detectKnownsProjects();
+  if (input.additionalPaths) {
+    for (const path3 of input.additionalPaths) {
+      if (existsSync28(path3)) {
+        const additional = scanForKnownsProjects(path3);
+        for (const project of additional) {
+          if (!projects.find((p) => p.path === project)) {
+            projects.push({ path: project, name: basename4(project) });
+          }
+        }
+      }
+    }
+  }
+  projects = projects.sort((a, b) => a.name.localeCompare(b.name));
+  const current = currentProjectRoot || process.env.KNOWNS_PROJECT_ROOT || null;
+  return {
+    projects,
+    currentProject: current,
+    note: projects.length === 0 ? "No Knowns projects found. Initialize a project with 'knowns init'." : projects.length === 1 ? "Found 1 project. Use set_project to activate it." : `Found ${projects.length} projects. Use set_project to select one.`
+  };
+}
+function handleSetProject(input) {
+  const { projectRoot } = input;
+  if (!existsSync28(projectRoot)) {
+    return {
+      success: false,
+      projectRoot,
+      message: `Path does not exist: ${projectRoot}`
+    };
+  }
+  const knownsPath = join32(projectRoot, ".knowns");
+  if (!existsSync28(knownsPath)) {
+    return {
+      success: false,
+      projectRoot,
+      message: `Not a Knowns project (no .knowns/ folder): ${projectRoot}`
+    };
+  }
+  setProjectRoot(projectRoot);
+  return {
+    success: true,
+    projectRoot,
+    message: `Project set to: ${projectRoot}. All subsequent operations will use this project.`
+  };
+}
+function handleGetCurrentProject() {
+  let source = "cwd";
+  let projectRoot = process.cwd();
+  if (currentProjectRoot) {
+    source = "explicit";
+    projectRoot = currentProjectRoot;
+  } else if (process.env.KNOWNS_PROJECT_ROOT) {
+    source = "env";
+    projectRoot = process.env.KNOWNS_PROJECT_ROOT;
+  }
+  const isValid2 = existsSync28(join32(projectRoot, ".knowns"));
+  return {
+    projectRoot,
+    isExplicitlySet: source === "explicit",
+    isValid: isValid2,
+    source
+  };
+}
+
+// src/mcp/utils.ts
 function parseDuration2(durationStr) {
   let totalSeconds = 0;
   const hoursMatch = durationStr.match(/(\d+)h/);
@@ -97930,8 +98026,8 @@ function formatDuration2(seconds) {
   return parts.length > 0 ? parts.join(" ") : "0s";
 }
 async function fetchLinkedDocs(task) {
-  const projectRoot = process.cwd();
-  const docsDir = join32(projectRoot, ".knowns", "docs");
+  const projectRoot = getProjectRoot3();
+  const docsDir = join33(projectRoot, ".knowns", "docs");
   const allContent = [task.description || "", task.implementationPlan || "", task.implementationNotes || ""].join("\n");
   const docRefs = resolveDocReferences(allContent, projectRoot);
   const linkedDocs = [];
@@ -97939,7 +98035,7 @@ async function fetchLinkedDocs(task) {
     if (!ref.exists) continue;
     try {
       const filename = ref.resolvedPath.replace("@.knowns/docs/", "");
-      const filepath = join32(docsDir, filename);
+      const filepath = join33(docsDir, filename);
       const fileContent = await readFile20(filepath, "utf-8");
       const { data, content } = (0, import_gray_matter8.default)(fileContent);
       linkedDocs.push({
@@ -98138,9 +98234,9 @@ var taskTools = [
     }
   }
 ];
-async function handleCreateTask(args2, fileStore2) {
+async function handleCreateTask(args2, fileStore) {
   const input = createTaskSchema.parse(args2);
-  const task = await fileStore2.createTask({
+  const task = await fileStore.createTask({
     title: input.title,
     description: input.description,
     status: input.status || "todo",
@@ -98163,10 +98259,10 @@ async function handleCreateTask(args2, fileStore2) {
     }
   });
 }
-async function handleGetTask(args2, fileStore2) {
+async function handleGetTask(args2, fileStore) {
   const input = getTaskSchema.parse(args2);
   const taskId = normalizeTaskId(input.taskId);
-  const task = await fileStore2.getTask(taskId);
+  const task = await fileStore.getTask(taskId);
   if (!task) {
     return errorResponse(`Task ${taskId} not found`);
   }
@@ -98189,10 +98285,10 @@ async function handleGetTask(args2, fileStore2) {
     }
   });
 }
-async function handleUpdateTask(args2, fileStore2) {
+async function handleUpdateTask(args2, fileStore) {
   const input = updateTaskSchema.parse(args2);
   const taskId = normalizeTaskId(input.taskId);
-  const currentTask = await fileStore2.getTask(taskId);
+  const currentTask = await fileStore.getTask(taskId);
   if (!currentTask) {
     return errorResponse(`Task ${taskId} not found`);
   }
@@ -98255,7 +98351,7 @@ async function handleUpdateTask(args2, fileStore2) {
     const separator = existingNotes ? "\n\n" : "";
     updates.implementationNotes = existingNotes + separator + input.appendNotes;
   }
-  const task = await fileStore2.updateTask(taskId, updates);
+  const task = await fileStore.updateTask(taskId, updates);
   await notifyTaskUpdate(task.id);
   return successResponse({
     task: {
@@ -98269,9 +98365,9 @@ async function handleUpdateTask(args2, fileStore2) {
     }
   });
 }
-async function handleListTasks(args2, fileStore2) {
+async function handleListTasks(args2, fileStore) {
   const input = listTasksSchema.parse(args2);
-  let tasks = await fileStore2.getAllTasks();
+  let tasks = await fileStore.getAllTasks();
   if (input.status) {
     tasks = tasks.filter((t) => t.status === input.status);
   }
@@ -98296,9 +98392,9 @@ async function handleListTasks(args2, fileStore2) {
     }))
   });
 }
-async function handleSearchTasks(args2, fileStore2) {
+async function handleSearchTasks(args2, fileStore) {
   const input = searchTasksSchema.parse(args2);
-  const tasks = await fileStore2.getAllTasks();
+  const tasks = await fileStore.getAllTasks();
   const query = input.query.toLowerCase();
   const results = tasks.filter(
     (t) => t.title.toLowerCase().includes(query) || t.description?.toLowerCase().includes(query) || t.labels.some((l) => l.toLowerCase().includes(query))
@@ -98315,9 +98411,9 @@ async function handleSearchTasks(args2, fileStore2) {
 }
 
 // src/mcp/handlers/time.ts
-import { existsSync as existsSync28 } from "node:fs";
+import { existsSync as existsSync29 } from "node:fs";
 import { readFile as readFile21, writeFile as writeFile15 } from "node:fs/promises";
-import { join as join33 } from "node:path";
+import { join as join34 } from "node:path";
 var startTimeSchema = external_exports.object({
   taskId: external_exports.string()
 });
@@ -98400,8 +98496,8 @@ var timeTools = [
   }
 ];
 async function loadTimeData2(projectRoot) {
-  const timePath = join33(projectRoot, ".knowns", "time.json");
-  if (!existsSync28(timePath)) {
+  const timePath = join34(projectRoot, ".knowns", "time.json");
+  if (!existsSync29(timePath)) {
     return { active: [] };
   }
   const content = await readFile21(timePath, "utf-8");
@@ -98415,17 +98511,17 @@ async function loadTimeData2(projectRoot) {
   return data;
 }
 async function saveTimeData2(projectRoot, data) {
-  const timePath = join33(projectRoot, ".knowns", "time.json");
+  const timePath = join34(projectRoot, ".knowns", "time.json");
   await writeFile15(timePath, JSON.stringify(data, null, 2), "utf-8");
 }
-async function handleStartTime(args2, fileStore2) {
+async function handleStartTime(args2, fileStore) {
   const input = startTimeSchema.parse(args2);
   const taskId = normalizeTaskId(input.taskId);
-  const task = await fileStore2.getTask(taskId);
+  const task = await fileStore.getTask(taskId);
   if (!task) {
     return errorResponse(`Task ${taskId} not found`);
   }
-  const data = await loadTimeData2(fileStore2.projectRoot);
+  const data = await loadTimeData2(fileStore.projectRoot);
   const existingTimer = data.active.find((t) => t.taskId === taskId);
   if (existingTimer) {
     return errorResponse(`Timer already running for task ${taskId}`);
@@ -98438,7 +98534,7 @@ async function handleStartTime(args2, fileStore2) {
     totalPausedMs: 0
   };
   data.active.push(newTimer);
-  await saveTimeData2(fileStore2.projectRoot, data);
+  await saveTimeData2(fileStore.projectRoot, data);
   await notifyTaskUpdate(taskId);
   await notifyTimeUpdate(data.active);
   return successResponse({
@@ -98447,14 +98543,14 @@ async function handleStartTime(args2, fileStore2) {
     activeTimers: data.active.length
   });
 }
-async function handleStopTime(args2, fileStore2) {
+async function handleStopTime(args2, fileStore) {
   const input = stopTimeSchema.parse(args2);
   const taskId = normalizeTaskId(input.taskId);
-  const task = await fileStore2.getTask(taskId);
+  const task = await fileStore.getTask(taskId);
   if (!task) {
     return errorResponse(`Task ${taskId} not found`);
   }
-  const data = await loadTimeData2(fileStore2.projectRoot);
+  const data = await loadTimeData2(fileStore.projectRoot);
   const timerIndex = data.active.findIndex((t) => t.taskId === taskId);
   if (timerIndex === -1) {
     return errorResponse(`No active timer for task ${taskId}`);
@@ -98471,12 +98567,12 @@ async function handleStopTime(args2, fileStore2) {
     duration: duration3
   };
   const newTimeSpent = task.timeSpent + duration3;
-  await fileStore2.updateTask(taskId, {
+  await fileStore.updateTask(taskId, {
     timeEntries: [...task.timeEntries, newEntry],
     timeSpent: newTimeSpent
   });
   data.active.splice(timerIndex, 1);
-  await saveTimeData2(fileStore2.projectRoot, data);
+  await saveTimeData2(fileStore.projectRoot, data);
   await notifyTaskUpdate(taskId);
   await notifyTimeUpdate(data.active.length > 0 ? data.active : null);
   return successResponse({
@@ -98486,10 +98582,10 @@ async function handleStopTime(args2, fileStore2) {
     activeTimers: data.active.length
   });
 }
-async function handleAddTime(args2, fileStore2) {
+async function handleAddTime(args2, fileStore) {
   const input = addTimeSchema.parse(args2);
   const taskId = normalizeTaskId(input.taskId);
-  const task = await fileStore2.getTask(taskId);
+  const task = await fileStore.getTask(taskId);
   if (!task) {
     return errorResponse(`Task ${taskId} not found`);
   }
@@ -98503,7 +98599,7 @@ async function handleAddTime(args2, fileStore2) {
     note: input.note || "Added via MCP"
   };
   const newTimeSpent = task.timeSpent + duration3;
-  await fileStore2.updateTask(taskId, {
+  await fileStore.updateTask(taskId, {
     timeEntries: [...task.timeEntries, newEntry],
     timeSpent: newTimeSpent
   });
@@ -98513,9 +98609,9 @@ async function handleAddTime(args2, fileStore2) {
     totalTime: formatDuration2(newTimeSpent)
   });
 }
-async function handleGetTimeReport(args2, fileStore2) {
+async function handleGetTimeReport(args2, fileStore) {
   const input = getTimeReportSchema.parse(args2);
-  const tasks = await fileStore2.getAllTasks();
+  const tasks = await fileStore.getAllTasks();
   let fromDate;
   let toDate;
   if (input.from) fromDate = new Date(input.from);
@@ -98597,8 +98693,8 @@ var boardTools = [
     }
   }
 ];
-async function handleGetBoard(fileStore2) {
-  const tasks = await fileStore2.getAllTasks();
+async function handleGetBoard(fileStore) {
+  const tasks = await fileStore.getAllTasks();
   const board = {
     todo: [],
     "in-progress": [],
@@ -98631,11 +98727,13 @@ async function handleGetBoard(fileStore2) {
 }
 
 // src/mcp/handlers/doc.ts
-import { existsSync as existsSync29 } from "node:fs";
+import { existsSync as existsSync30 } from "node:fs";
 import { mkdir as mkdir17, readFile as readFile22, readdir as readdir13, writeFile as writeFile16 } from "node:fs/promises";
-import { join as join34 } from "node:path";
+import { join as join35 } from "node:path";
 var import_gray_matter9 = __toESM(require_gray_matter(), 1);
-var DOCS_DIR4 = join34(process.cwd(), ".knowns", "docs");
+function getDocsDir() {
+  return join35(getProjectRoot3(), ".knowns", "docs");
+}
 var listDocsSchema = external_exports.object({
   tag: external_exports.string().optional()
 });
@@ -98785,8 +98883,8 @@ var docTools = [
   }
 ];
 async function ensureDocsDir2() {
-  if (!existsSync29(DOCS_DIR4)) {
-    await mkdir17(DOCS_DIR4, { recursive: true });
+  if (!existsSync30(getDocsDir())) {
+    await mkdir17(getDocsDir(), { recursive: true });
   }
 }
 function titleToFilename2(title) {
@@ -98794,13 +98892,13 @@ function titleToFilename2(title) {
 }
 async function getAllMdFiles2(dir, basePath = "") {
   const files = [];
-  if (!existsSync29(dir)) {
+  if (!existsSync30(dir)) {
     return files;
   }
   const entries = await readdir13(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const fullPath = join34(dir, entry.name);
-    const relativePath = normalizePath2(basePath ? join34(basePath, entry.name) : entry.name);
+    const fullPath = join35(dir, entry.name);
+    const relativePath = normalizePath2(basePath ? join35(basePath, entry.name) : entry.name);
     if (entry.isDirectory()) {
       const subFiles = await getAllMdFiles2(fullPath, relativePath);
       files.push(...subFiles);
@@ -98813,16 +98911,16 @@ async function getAllMdFiles2(dir, basePath = "") {
 async function resolveDocPath2(name) {
   await ensureDocsDir2();
   let filename = name.endsWith(".md") ? name : `${name}.md`;
-  let filepath = join34(DOCS_DIR4, filename);
-  if (existsSync29(filepath)) {
+  let filepath = join35(getDocsDir(), filename);
+  if (existsSync30(filepath)) {
     return { filepath, filename };
   }
   filename = `${titleToFilename2(name)}.md`;
-  filepath = join34(DOCS_DIR4, filename);
-  if (existsSync29(filepath)) {
+  filepath = join35(getDocsDir(), filename);
+  if (existsSync30(filepath)) {
     return { filepath, filename };
   }
-  const allFiles = await getAllMdFiles2(DOCS_DIR4);
+  const allFiles = await getAllMdFiles2(getDocsDir());
   const searchName = name.toLowerCase().replace(/\.md$/, "");
   const matchingFile = allFiles.find((file3) => {
     const fileNameOnly = file3.toLowerCase().replace(/\.md$/, "");
@@ -98831,7 +98929,7 @@ async function resolveDocPath2(name) {
   });
   if (matchingFile) {
     return {
-      filepath: join34(DOCS_DIR4, matchingFile),
+      filepath: join35(getDocsDir(), matchingFile),
       filename: matchingFile
     };
   }
@@ -98840,7 +98938,7 @@ async function resolveDocPath2(name) {
 async function handleListDocs(args2) {
   const input = listDocsSchema.parse(args2);
   await ensureDocsDir2();
-  const projectRoot = process.cwd();
+  const projectRoot = getProjectRoot3();
   const allDocs = await listAllDocs(projectRoot);
   if (allDocs.length === 0) {
     return successResponse({
@@ -98980,8 +99078,8 @@ async function handleGetDoc(args2) {
       }
     });
   }
-  const projectRoot = process.cwd();
-  const tasksDir = join34(projectRoot, ".knowns", "tasks");
+  const projectRoot = getProjectRoot3();
+  const tasksDir = join35(projectRoot, ".knowns", "tasks");
   const refs = await validateRefs(projectRoot, content, tasksDir);
   const brokenRefs = refs.filter((r) => !r.exists).map((r) => r.ref);
   return successResponse({
@@ -99001,18 +99099,18 @@ async function handleCreateDoc(args2) {
   const input = createDocSchema.parse(args2);
   await ensureDocsDir2();
   const filename = `${titleToFilename2(input.title)}.md`;
-  let targetDir = DOCS_DIR4;
+  let targetDir = getDocsDir();
   let relativePath = filename;
   if (input.folder) {
     const folderPath = input.folder.replace(/^\/|\/$/g, "");
-    targetDir = join34(DOCS_DIR4, folderPath);
-    relativePath = join34(folderPath, filename);
-    if (!existsSync29(targetDir)) {
+    targetDir = join35(getDocsDir(), folderPath);
+    relativePath = join35(folderPath, filename);
+    if (!existsSync30(targetDir)) {
       await mkdir17(targetDir, { recursive: true });
     }
   }
-  const filepath = join34(targetDir, filename);
-  if (existsSync29(filepath)) {
+  const filepath = join35(targetDir, filename);
+  if (existsSync30(filepath)) {
     return errorResponse(`Document already exists: ${relativePath}`);
   }
   const now = (/* @__PURE__ */ new Date()).toISOString();
@@ -99092,11 +99190,11 @@ ${input.appendContent}`;
 async function handleSearchDocs(args2) {
   const input = searchDocsSchema.parse(args2);
   await ensureDocsDir2();
-  const mdFiles = await getAllMdFiles2(DOCS_DIR4);
+  const mdFiles = await getAllMdFiles2(getDocsDir());
   const query = input.query.toLowerCase();
   const results = [];
   for (const file3 of mdFiles) {
-    const fileContent = await readFile22(join34(DOCS_DIR4, file3), "utf-8");
+    const fileContent = await readFile22(join35(getDocsDir(), file3), "utf-8");
     const { data, content } = (0, import_gray_matter9.default)(fileContent);
     const metadata = data;
     if (input.tag && !metadata.tags?.includes(input.tag)) {
@@ -99132,56 +99230,13 @@ async function handleSearchDocs(args2) {
   });
 }
 
-// src/mcp/handlers/guideline.ts
-var getGuidelineSchema = external_exports.object({
-  type: external_exports.enum(["unified", "cli", "mcp"]).optional().default("unified")
-});
-var guidelineTools = [
-  {
-    name: "get_guideline",
-    description: "Get usage guidelines for Knowns CLI/MCP. Call this at session start to understand how to use the tools correctly.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        type: {
-          type: "string",
-          enum: ["unified", "cli", "mcp"],
-          description: "Type of guidelines: unified (default, covers both), cli (CLI only), mcp (MCP only)"
-        }
-      }
-    }
-  }
-];
-async function handleGetGuideline(args2) {
-  const input = getGuidelineSchema.parse(args2 || {});
-  let guidelines;
-  switch (input.type) {
-    case "mcp":
-      guidelines = MCPGuidelines.getFull();
-      break;
-    case "cli":
-      guidelines = Guidelines.getFull();
-      break;
-    default:
-      guidelines = MCPGuidelines.getFull();
-      break;
-  }
-  return {
-    content: [
-      {
-        type: "text",
-        text: guidelines
-      }
-    ]
-  };
-}
-
 // src/mcp/handlers/template.ts
-import { existsSync as existsSync30 } from "node:fs";
+import { existsSync as existsSync31 } from "node:fs";
 import { mkdir as mkdir18, writeFile as writeFile17 } from "node:fs/promises";
-import { join as join35 } from "node:path";
-var TEMPLATES_DIR3 = join35(process.cwd(), ".knowns", "templates");
-var PROJECT_ROOT3 = process.cwd();
+import { join as join36 } from "node:path";
+function getTemplatesDir() {
+  return join36(getProjectRoot3(), ".knowns", "templates");
+}
 var listTemplatesSchema = external_exports.object({});
 var getTemplateSchema = external_exports.object({
   name: external_exports.string()
@@ -99287,7 +99342,7 @@ async function handleListTemplates(_args) {
     const templateList = [];
     for (const t of allTemplates) {
       try {
-        const loaded = await listTemplates(join35(t.path, ".."));
+        const loaded = await listTemplates(join36(t.path, ".."));
         const match2 = loaded.find((l) => l.name === t.name);
         templateList.push({
           name: t.name,
@@ -99324,7 +99379,7 @@ async function handleListTemplates(_args) {
 async function handleGetTemplate(args2) {
   const input = getTemplateSchema.parse(args2);
   try {
-    const resolved = await resolveTemplate(PROJECT_ROOT3, input.name);
+    const resolved = await resolveTemplate(getProjectRoot3(), input.name);
     if (!resolved) {
       return errorResponse(`Template not found: ${input.name}. Use list_templates to see available templates.`);
     }
@@ -99332,7 +99387,7 @@ async function handleGetTemplate(args2) {
     if (!template) {
       return errorResponse(`Failed to load template: ${input.name}`);
     }
-    const prompts4 = template.config.prompts?.map((p) => ({
+    const prompts3 = template.config.prompts?.map((p) => ({
       name: p.name,
       message: p.message,
       type: p.type || "text",
@@ -99361,7 +99416,7 @@ async function handleGetTemplate(args2) {
         description: template.config.description,
         doc: template.config.doc,
         // Linked documentation - AI should read this
-        prompts: prompts4 || [],
+        prompts: prompts3 || [],
         actions: actions || [],
         messages: template.config.messages
       },
@@ -99377,7 +99432,7 @@ async function handleRunTemplate(args2) {
   const input = runTemplateSchema.parse(args2);
   const dryRun = input.dryRun !== false;
   try {
-    const resolved = await resolveTemplate(PROJECT_ROOT3, input.name);
+    const resolved = await resolveTemplate(getProjectRoot3(), input.name);
     if (!resolved) {
       return errorResponse(`Template not found: ${input.name}. Use list_templates to see available templates.`);
     }
@@ -99401,7 +99456,7 @@ async function handleRunTemplate(args2) {
       }
     }
     const result = await runTemplate(template, {
-      projectRoot: PROJECT_ROOT3,
+      projectRoot: getProjectRoot3(),
       values,
       dryRun
     });
@@ -99430,11 +99485,11 @@ async function handleRunTemplate(args2) {
 async function handleCreateTemplate(args2) {
   const input = createTemplateSchema.parse(args2);
   try {
-    if (!existsSync30(TEMPLATES_DIR3)) {
-      await mkdir18(TEMPLATES_DIR3, { recursive: true });
+    if (!existsSync31(getTemplatesDir())) {
+      await mkdir18(getTemplatesDir(), { recursive: true });
     }
-    const templateDir = join35(TEMPLATES_DIR3, input.name);
-    if (existsSync30(templateDir)) {
+    const templateDir = join36(getTemplatesDir(), input.name);
+    if (existsSync31(templateDir)) {
       return errorResponse(`Template "${input.name}" already exists`);
     }
     await mkdir18(templateDir, { recursive: true });
@@ -99463,7 +99518,7 @@ messages:
   success: |
     \u2713 Created {{name}}!
 `;
-    await writeFile17(join35(templateDir, "_template.yaml"), configContent, "utf-8");
+    await writeFile17(join36(templateDir, "_template.yaml"), configContent, "utf-8");
     const exampleTemplate = `/**
  * {{pascalCase name}}
  * Generated from ${input.name} template
@@ -99473,7 +99528,7 @@ export function {{camelCase name}}() {
   console.log("Hello from {{name}}!");
 }
 `;
-    await writeFile17(join35(templateDir, "example.ts.hbs"), exampleTemplate, "utf-8");
+    await writeFile17(join36(templateDir, "example.ts.hbs"), exampleTemplate, "utf-8");
     return successResponse({
       message: `Created template: ${input.name}`,
       template: {
@@ -99496,9 +99551,9 @@ export function {{camelCase name}}() {
 
 // src/mcp/handlers/search.ts
 var import_gray_matter10 = __toESM(require_gray_matter(), 1);
-import { existsSync as existsSync31 } from "node:fs";
+import { existsSync as existsSync32 } from "node:fs";
 import { readFile as readFile23, readdir as readdir14 } from "node:fs/promises";
-import { join as join36 } from "node:path";
+import { join as join37 } from "node:path";
 var searchSchema = external_exports.object({
   query: external_exports.string(),
   type: external_exports.enum(["all", "task", "doc"]).optional(),
@@ -99585,12 +99640,12 @@ function calculateDocScore2(title, description, content, tags, query) {
 }
 async function getAllMdFiles3(dir, basePath = "") {
   const files = [];
-  if (!existsSync31(dir)) {
+  if (!existsSync32(dir)) {
     return files;
   }
   const entries = await readdir14(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const fullPath = join36(dir, entry.name);
+    const fullPath = join37(dir, entry.name);
     const relativePath = basePath ? `${basePath}/${entry.name}` : entry.name;
     if (entry.isDirectory()) {
       const subFiles = await getAllMdFiles3(fullPath, relativePath);
@@ -99601,8 +99656,8 @@ async function getAllMdFiles3(dir, basePath = "") {
   }
   return files;
 }
-async function searchTasks(fileStore2, query, filters) {
-  const allTasks = await fileStore2.getAllTasks();
+async function searchTasks(fileStore, query, filters) {
+  const allTasks = await fileStore.getAllTasks();
   const q = query.toLowerCase();
   return allTasks.filter((task) => {
     const text = `${task.title} ${task.description || ""} ${task.labels.join(" ")} ${task.id} ${task.implementationPlan || ""} ${task.implementationNotes || ""}`.toLowerCase();
@@ -99633,14 +99688,14 @@ async function searchTasks(fileStore2, query, filters) {
   })).sort((a, b) => b.score - a.score);
 }
 async function searchDocs2(docsDir, query, tagFilter) {
-  if (!existsSync31(docsDir)) {
+  if (!existsSync32(docsDir)) {
     return [];
   }
   const mdFiles = await getAllMdFiles3(docsDir);
   const q = query.toLowerCase();
   const results = [];
   for (const file3 of mdFiles) {
-    const fileContent = await readFile23(join36(docsDir, file3), "utf-8");
+    const fileContent = await readFile23(join37(docsDir, file3), "utf-8");
     const { data, content } = (0, import_gray_matter10.default)(fileContent);
     const metadata = data;
     if (tagFilter && !metadata.tags?.includes(tagFilter)) {
@@ -99673,15 +99728,15 @@ async function searchDocs2(docsDir, query, tagFilter) {
   }
   return results.sort((a, b) => b.score - a.score);
 }
-async function handleSearch(args2, fileStore2) {
+async function handleSearch(args2, fileStore) {
   const input = searchSchema.parse(args2);
   const searchType = input.type || "all";
   const limit = input.limit || 20;
-  const docsDir = join36(process.cwd(), ".knowns", "docs");
+  const docsDir = join37(getProjectRoot3(), ".knowns", "docs");
   let taskResults = [];
   let docResults = [];
   if (searchType === "all" || searchType === "task") {
-    taskResults = await searchTasks(fileStore2, input.query, {
+    taskResults = await searchTasks(fileStore, input.query, {
       status: input.status,
       priority: input.priority,
       assignee: input.assignee,
@@ -99709,7 +99764,16 @@ async function handleSearch(args2, fileStore2) {
 }
 
 // src/mcp/server.ts
-var fileStore = new FileStore(process.cwd());
+var fileStoreCache = /* @__PURE__ */ new Map();
+function getFileStore5() {
+  const projectRoot = getProjectRoot3();
+  let store = fileStoreCache.get(projectRoot);
+  if (!store) {
+    store = new FileStore(projectRoot);
+    fileStoreCache.set(projectRoot, store);
+  }
+  return store;
+}
 var server = new Server(
   {
     name: "knowns-mcp-server",
@@ -99723,11 +99787,11 @@ var server = new Server(
   }
 );
 var tools = [
+  ...projectTools,
   ...taskTools,
   ...timeTools,
   ...boardTools,
   ...docTools,
-  ...guidelineTools,
   ...templateTools,
   ...searchTools
 ];
@@ -99738,29 +99802,38 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
   const { name, arguments: args2 } = request.params;
   try {
     switch (name) {
+      // Project handlers (no FileStore needed)
+      case "detect_projects":
+        return { content: [{ type: "text", text: JSON.stringify(handleDetectProjects(args2 || {}), null, 2) }] };
+      case "set_project":
+        return {
+          content: [{ type: "text", text: JSON.stringify(handleSetProject(args2), null, 2) }]
+        };
+      case "get_current_project":
+        return { content: [{ type: "text", text: JSON.stringify(handleGetCurrentProject(), null, 2) }] };
       // Task handlers
       case "create_task":
-        return await handleCreateTask(args2, fileStore);
+        return await handleCreateTask(args2, getFileStore5());
       case "get_task":
-        return await handleGetTask(args2, fileStore);
+        return await handleGetTask(args2, getFileStore5());
       case "update_task":
-        return await handleUpdateTask(args2, fileStore);
+        return await handleUpdateTask(args2, getFileStore5());
       case "list_tasks":
-        return await handleListTasks(args2, fileStore);
+        return await handleListTasks(args2, getFileStore5());
       case "search_tasks":
-        return await handleSearchTasks(args2, fileStore);
+        return await handleSearchTasks(args2, getFileStore5());
       // Time handlers
       case "start_time":
-        return await handleStartTime(args2, fileStore);
+        return await handleStartTime(args2, getFileStore5());
       case "stop_time":
-        return await handleStopTime(args2, fileStore);
+        return await handleStopTime(args2, getFileStore5());
       case "add_time":
-        return await handleAddTime(args2, fileStore);
+        return await handleAddTime(args2, getFileStore5());
       case "get_time_report":
-        return await handleGetTimeReport(args2, fileStore);
+        return await handleGetTimeReport(args2, getFileStore5());
       // Board handlers
       case "get_board":
-        return await handleGetBoard(fileStore);
+        return await handleGetBoard(getFileStore5());
       // Doc handlers
       case "list_docs":
         return await handleListDocs(args2);
@@ -99772,9 +99845,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         return await handleUpdateDoc(args2);
       case "search_docs":
         return await handleSearchDocs(args2);
-      // Guideline handler
-      case "get_guideline":
-        return await handleGetGuideline(args2);
       // Template handlers
       case "list_templates":
         return await handleListTemplates(args2);
@@ -99786,7 +99856,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         return await handleCreateTemplate(args2);
       // Unified search handler
       case "search":
-        return await handleSearch(args2, fileStore);
+        return await handleSearch(args2, getFileStore5());
       default:
         return errorResponse(`Unknown tool: ${name}`);
     }
@@ -99795,8 +99865,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
   }
 });
 server.setRequestHandler(ListResourcesRequestSchema, async () => {
-  const tasks = await fileStore.getAllTasks();
-  const docsDir = join37(process.cwd(), ".knowns", "docs");
+  const tasks = await getFileStore5().getAllTasks();
+  const docsDir = join38(getProjectRoot3(), ".knowns", "docs");
   const taskResources = tasks.map((task) => ({
     uri: `knowns://task/${task.id}`,
     name: task.title,
@@ -99804,14 +99874,14 @@ server.setRequestHandler(ListResourcesRequestSchema, async () => {
     description: `Task #${task.id}: ${task.title}`
   }));
   const docResources = [];
-  if (existsSync32(docsDir)) {
+  if (existsSync33(docsDir)) {
     const { readdir: readdir16 } = await import("node:fs/promises");
     async function getAllMdFiles4(dir, basePath = "") {
       const files = [];
       const entries = await readdir16(dir, { withFileTypes: true });
       for (const entry of entries) {
-        const fullPath = join37(dir, entry.name);
-        const relativePath = normalizePath2(basePath ? join37(basePath, entry.name) : entry.name);
+        const fullPath = join38(dir, entry.name);
+        const relativePath = normalizePath2(basePath ? join38(basePath, entry.name) : entry.name);
         if (entry.isDirectory()) {
           const subFiles = await getAllMdFiles4(fullPath, relativePath);
           files.push(...subFiles);
@@ -99823,7 +99893,7 @@ server.setRequestHandler(ListResourcesRequestSchema, async () => {
     }
     const mdFiles = await getAllMdFiles4(docsDir);
     for (const file3 of mdFiles) {
-      const filepath = join37(docsDir, file3);
+      const filepath = join38(docsDir, file3);
       const content = await readFile24(filepath, "utf-8");
       const { data } = (0, import_gray_matter11.default)(content);
       docResources.push({
@@ -99843,7 +99913,7 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
   const taskMatch = uri.match(/^knowns:\/\/task\/(.+)$/);
   if (taskMatch) {
     const taskId = taskMatch[1];
-    const task = await fileStore.getTask(taskId);
+    const task = await getFileStore5().getTask(taskId);
     if (!task) {
       throw new Error(`Task ${taskId} not found`);
     }
@@ -99860,9 +99930,9 @@ server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
   const docMatch = uri.match(/^knowns:\/\/doc\/(.+)$/);
   if (docMatch) {
     const docPath = docMatch[1];
-    const docsDir = join37(process.cwd(), ".knowns", "docs");
-    const filepath = join37(docsDir, `${docPath}.md`);
-    if (!existsSync32(filepath)) {
+    const docsDir = join38(getProjectRoot3(), ".knowns", "docs");
+    const filepath = join38(docsDir, `${docPath}.md`);
+    if (!existsSync33(filepath)) {
       throw new Error(`Documentation ${docPath} not found`);
     }
     const content = await readFile24(filepath, "utf-8");
@@ -99944,13 +100014,13 @@ async function setupClaudeCode() {
   return false;
 }
 function createProjectMcpJson(projectRoot) {
-  const mcpJsonPath = join38(projectRoot, ".mcp.json");
+  const mcpJsonPath = join39(projectRoot, ".mcp.json");
   const mcpConfig = {
     mcpServers: {
       knowns: getMcpConfig()
     }
   };
-  if (existsSync33(mcpJsonPath)) {
+  if (existsSync34(mcpJsonPath)) {
     try {
       const existing = JSON.parse(readFileSync3(mcpJsonPath, "utf-8"));
       if (existing?.mcpServers?.knowns) {
@@ -99994,12 +100064,9 @@ var mcpCommand = new Command("mcp").description("Start MCP server for AI agent i
     return;
   }
   const projectRoot = findProjectRoot();
-  if (!projectRoot) {
-    console.error(source_default.red("Error: Not in a Knowns project"));
-    console.error(source_default.gray("Run 'knowns init' to initialize a project"));
-    process.exit(1);
+  if (projectRoot) {
+    process.chdir(projectRoot);
   }
-  process.chdir(projectRoot);
   try {
     await startMcpServer({ verbose: options2.verbose });
   } catch (error48) {
@@ -100050,11 +100117,11 @@ function showConfigInfo() {
 }
 
 // src/commands/template.ts
-import { existsSync as existsSync34 } from "node:fs";
+import { existsSync as existsSync35 } from "node:fs";
 import { mkdir as mkdir19, writeFile as writeFile18 } from "node:fs/promises";
-import { join as join39 } from "node:path";
-var TEMPLATES_DIR4 = ".knowns/templates";
-function getProjectRoot3() {
+import { join as join40 } from "node:path";
+var TEMPLATES_DIR3 = ".knowns/templates";
+function getProjectRoot4() {
   const projectRoot = findProjectRoot();
   if (!projectRoot) {
     console.error(source_default.red("\u2717 Not a knowns project"));
@@ -100063,12 +100130,12 @@ function getProjectRoot3() {
   }
   return projectRoot;
 }
-function getTemplatesDir(projectRoot) {
-  return join39(projectRoot, TEMPLATES_DIR4);
+function getTemplatesDir2(projectRoot) {
+  return join40(projectRoot, TEMPLATES_DIR3);
 }
 async function ensureTemplatesDir(projectRoot) {
-  const templatesDir = getTemplatesDir(projectRoot);
-  if (!existsSync34(templatesDir)) {
+  const templatesDir = getTemplatesDir2(projectRoot);
+  if (!existsSync35(templatesDir)) {
     await mkdir19(templatesDir, { recursive: true });
   }
   return templatesDir;
@@ -100076,7 +100143,7 @@ async function ensureTemplatesDir(projectRoot) {
 var templateCommand = new Command("template").description("Manage code generation templates").enablePositionalOptions();
 var listCommand4 = new Command("list").description("List available templates (local + imported)").option("--plain", "Plain text output for AI").option("--local", "Show only local templates").option("--imported", "Show only imported templates").action(async (options2) => {
   try {
-    const projectRoot = getProjectRoot3();
+    const projectRoot = getProjectRoot4();
     const allTemplates = await listAllTemplates(projectRoot);
     let templates = allTemplates;
     if (options2.local) {
@@ -100096,7 +100163,7 @@ var listCommand4 = new Command("list").description("List available templates (lo
     const templatesWithDesc = [];
     for (const t of templates) {
       try {
-        const loaded = await listTemplates(join39(t.path, ".."));
+        const loaded = await listTemplates(join40(t.path, ".."));
         const match2 = loaded.find((l) => l.name === t.name);
         templatesWithDesc.push({
           ref: t.ref,
@@ -100183,7 +100250,7 @@ var listCommand4 = new Command("list").description("List available templates (lo
 });
 var runCommand = new Command("run").description("Run a template to generate files").argument("<name>", "Template name (supports import prefix, e.g., 'knowns/component')").option("--dry-run", "Preview without writing files").option("-f, --force", "Overwrite existing files").option("--plain", "Plain text output for AI").allowUnknownOption(true).action(async (name, options2, command) => {
   try {
-    const projectRoot = getProjectRoot3();
+    const projectRoot = getProjectRoot4();
     const resolved = await resolveTemplate(projectRoot, name);
     if (!resolved) {
       console.error(source_default.red(`\u2717 Template not found: ${name}`));
@@ -100269,10 +100336,10 @@ function printRunResult(result, options2) {
 }
 var createCommand4 = new Command("create").description("Create a new template scaffold").argument("<name>", "Template name").option("-d, --description <desc>", "Template description").action(async (name, options2) => {
   try {
-    const projectRoot = getProjectRoot3();
+    const projectRoot = getProjectRoot4();
     const templatesDir = await ensureTemplatesDir(projectRoot);
-    const templateDir = join39(templatesDir, name);
-    if (existsSync34(templateDir)) {
+    const templateDir = join40(templatesDir, name);
+    if (existsSync35(templateDir)) {
       console.error(source_default.red(`\u2717 Template "${name}" already exists`));
       process.exit(1);
     }
@@ -100303,7 +100370,7 @@ messages:
   success: |
     \u2713 Created {{name}}!
 `;
-    await writeFile18(join39(templateDir, "_template.yaml"), configContent, "utf-8");
+    await writeFile18(join40(templateDir, "_template.yaml"), configContent, "utf-8");
     const exampleTemplate = `/**
  * {{pascalCase name}}
  * Generated from ${name} template
@@ -100313,10 +100380,10 @@ export function {{camelCase name}}() {
   console.log("Hello from {{name}}!");
 }
 `;
-    await writeFile18(join39(templateDir, "example.ts.hbs"), exampleTemplate, "utf-8");
+    await writeFile18(join40(templateDir, "example.ts.hbs"), exampleTemplate, "utf-8");
     console.log();
     console.log(source_default.green(`\u2713 Created template: ${name}`));
-    console.log(source_default.gray(`  Location: ${TEMPLATES_DIR4}/${name}/`));
+    console.log(source_default.gray(`  Location: ${TEMPLATES_DIR3}/${name}/`));
     console.log();
     console.log(source_default.cyan("Files created:"));
     console.log(source_default.gray("  - _template.yaml (config)"));
@@ -100334,7 +100401,7 @@ export function {{camelCase name}}() {
 });
 var viewCommand3 = new Command("view").description("View template details").argument("<name>", "Template name (supports import prefix, e.g., 'knowns/component')").option("--plain", "Plain text output for AI").action(async (name, options2) => {
   try {
-    const projectRoot = getProjectRoot3();
+    const projectRoot = getProjectRoot4();
     const resolved = await resolveTemplate(projectRoot, name);
     if (!resolved) {
       console.error(source_default.red(`\u2717 Template not found: ${name}`));
@@ -100464,11 +100531,11 @@ templateCommand.argument("[name]", "Template name (shorthand for view)").option(
 });
 
 // src/commands/skill.ts
-import { existsSync as existsSync35 } from "node:fs";
+import { existsSync as existsSync36 } from "node:fs";
 import { mkdir as mkdir20, writeFile as writeFile19 } from "node:fs/promises";
-import { join as join40 } from "node:path";
+import { join as join41 } from "node:path";
 var SKILLS_DIR = ".knowns/skills";
-function getProjectRoot4() {
+function getProjectRoot5() {
   const projectRoot = findProjectRoot();
   if (!projectRoot) {
     console.error(source_default.red("\u2717 Not a knowns project"));
@@ -100478,11 +100545,11 @@ function getProjectRoot4() {
   return projectRoot;
 }
 function getSkillsDir(projectRoot) {
-  return join40(projectRoot, SKILLS_DIR);
+  return join41(projectRoot, SKILLS_DIR);
 }
 async function ensureSkillsDir(projectRoot) {
   const skillsDir = getSkillsDir(projectRoot);
-  if (!existsSync35(skillsDir)) {
+  if (!existsSync36(skillsDir)) {
     await mkdir20(skillsDir, { recursive: true });
   }
   return skillsDir;
@@ -100490,9 +100557,9 @@ async function ensureSkillsDir(projectRoot) {
 var skillCommand = new Command("skill").description("Manage AI skills").enablePositionalOptions();
 var listCommand5 = new Command("list").description("List available skills").option("--plain", "Plain text output for AI").action(async (options2) => {
   try {
-    const projectRoot = getProjectRoot4();
+    const projectRoot = getProjectRoot5();
     const skillsDir = getSkillsDir(projectRoot);
-    if (!existsSync35(skillsDir)) {
+    if (!existsSync36(skillsDir)) {
       if (options2.plain) {
         console.log("No skills found");
       } else {
@@ -100534,10 +100601,10 @@ var listCommand5 = new Command("list").description("List available skills").opti
 });
 var createCommand5 = new Command("create").description("Create a new skill").argument("<name>", "Skill name").option("-d, --description <desc>", "Skill description").action(async (name, options2) => {
   try {
-    const projectRoot = getProjectRoot4();
+    const projectRoot = getProjectRoot5();
     const skillsDir = await ensureSkillsDir(projectRoot);
-    const skillDir = join40(skillsDir, name);
-    if (existsSync35(skillDir)) {
+    const skillDir = join41(skillsDir, name);
+    if (existsSync36(skillDir)) {
       console.error(source_default.red(`\u2717 Skill "${name}" already exists`));
       process.exit(1);
     }
@@ -100568,7 +100635,7 @@ Describe when this skill should be used.
 knowns task list
 \`\`\`
 `;
-    await writeFile19(join40(skillDir, "SKILL.md"), skillContent, "utf-8");
+    await writeFile19(join41(skillDir, "SKILL.md"), skillContent, "utf-8");
     console.log();
     console.log(source_default.green(`\u2713 Created skill: ${name}`));
     console.log(source_default.gray(`  Location: ${SKILLS_DIR}/${name}/SKILL.md`));
@@ -100584,7 +100651,7 @@ knowns task list
 });
 var viewCommand4 = new Command("view").description("View skill details").argument("<name>", "Skill name").option("--plain", "Plain text output for AI").action(async (name, options2) => {
   try {
-    const projectRoot = getProjectRoot4();
+    const projectRoot = getProjectRoot5();
     const skillsDir = getSkillsDir(projectRoot);
     const skill = await loadSkillByName(skillsDir, name);
     if (!skill) {
@@ -100618,9 +100685,9 @@ var viewCommand4 = new Command("view").description("View skill details").argumen
 });
 var syncCommand2 = new Command("sync").description("Sync skills to AI platforms").option("-p, --platform <platforms>", "Platforms to sync (comma-separated)").option("-f, --force", "Force overwrite existing files").option("--dry-run", "Preview without writing files").option("--plain", "Plain text output for AI").action(async (options2) => {
   try {
-    const projectRoot = getProjectRoot4();
+    const projectRoot = getProjectRoot5();
     const skillsDir = getSkillsDir(projectRoot);
-    if (!existsSync35(skillsDir)) {
+    if (!existsSync36(skillsDir)) {
       console.error(source_default.red("\u2717 No skills directory found"));
       console.error(source_default.gray(`  Create skills in ${SKILLS_DIR}/`));
       process.exit(1);
@@ -100699,14 +100766,14 @@ var syncCommand2 = new Command("sync").description("Sync skills to AI platforms"
 });
 var statusCommand2 = new Command("status").description("Check skill sync status").option("--plain", "Plain text output for AI").action(async (options2) => {
   try {
-    const projectRoot = getProjectRoot4();
+    const projectRoot = getProjectRoot5();
     const skillsDir = getSkillsDir(projectRoot);
-    const skills = existsSync35(skillsDir) ? await listSkills(skillsDir) : [];
+    const skills = existsSync36(skillsDir) ? await listSkills(skillsDir) : [];
     if (options2.plain) {
       console.log(`Skills: ${skills.length}`);
       for (const platform of PLATFORMS) {
-        const targetPath = join40(projectRoot, platform.targetDir);
-        const exists = existsSync35(targetPath);
+        const targetPath = join41(projectRoot, platform.targetDir);
+        const exists = existsSync36(targetPath);
         console.log(`${platform.name}: ${exists ? "present" : "not found"}`);
       }
     } else {
@@ -100716,8 +100783,8 @@ var statusCommand2 = new Command("status").description("Check skill sync status"
       console.log(source_default.bold("Platforms:"));
       console.log(source_default.gray("\u2500".repeat(50)));
       for (const platform of PLATFORMS) {
-        const targetPath = join40(projectRoot, platform.targetDir);
-        const exists = existsSync35(targetPath);
+        const targetPath = join41(projectRoot, platform.targetDir);
+        const exists = existsSync36(targetPath);
         const status = exists ? source_default.green("\u2713 Present") : source_default.gray("\u25CB Not synced");
         console.log(`  ${platform.name.padEnd(15)} ${platform.targetDir.padEnd(20)} ${status}`);
       }
@@ -100744,7 +100811,7 @@ skillCommand.argument("[name]", "Skill name (shorthand for view)").option("--pla
 });
 
 // src/commands/import.ts
-function getProjectRoot5() {
+function getProjectRoot6() {
   const projectRoot = findProjectRoot();
   if (!projectRoot) {
     console.error(source_default.red("\u2717 Not a knowns project"));
@@ -100818,7 +100885,7 @@ var importCommand = new Command("import").description("Import templates and docs
 var addCommand2 = new Command("add").description("Import from a source (git, npm, or local path)").argument("<source>", "Source to import (git URL, npm package, or local path)").option("-n, --name <name>", "Custom name for the import").option("-t, --type <type>", "Source type: git, npm, or local").option("-r, --ref <ref>", "Git branch/tag or npm version").option("--include <patterns...>", "Include only these file patterns").option("--exclude <patterns...>", "Exclude these file patterns").option("--link", "Create symlink for local imports (instead of copying)").option("-f, --force", "Overwrite existing import").option("--dry-run", "Preview without importing").option("--plain", "Plain text output for AI").action(
   async (source, options2) => {
     try {
-      const projectRoot = getProjectRoot5();
+      const projectRoot = getProjectRoot6();
       if (!options2.plain && !options2.dryRun) {
         console.log(source_default.cyan(`
 Importing from: ${source}
@@ -100854,7 +100921,7 @@ Importing from: ${source}
 );
 var listCommand6 = new Command("list").description("List imported sources").option("--plain", "Plain text output for AI").action(async (options2) => {
   try {
-    const projectRoot = getProjectRoot5();
+    const projectRoot = getProjectRoot6();
     const imports = await getImportsWithMetadata(projectRoot);
     if (imports.length === 0) {
       if (options2.plain) {
@@ -100906,7 +100973,7 @@ var listCommand6 = new Command("list").description("List imported sources").opti
 var syncCommand3 = new Command("sync").description("Sync imports from their sources").argument("[name]", "Import name to sync (syncs all if not specified)").option("-f, --force", "Force overwrite locally modified files").option("--dry-run", "Preview without syncing").option("--plain", "Plain text output for AI").action(
   async (name, options2) => {
     try {
-      const projectRoot = getProjectRoot5();
+      const projectRoot = getProjectRoot6();
       if (name) {
         if (!options2.plain && !options2.dryRun) {
           console.log(source_default.cyan(`
@@ -100967,7 +101034,7 @@ Syncing: ${name}
 var removeCommand = new Command("remove").description("Remove an imported source").argument("<name>", "Import name to remove").option("--delete", "Also delete imported files").option("--plain", "Plain text output for AI").action(
   async (name, options2) => {
     try {
-      const projectRoot = getProjectRoot5();
+      const projectRoot = getProjectRoot6();
       const result = await removeImport(projectRoot, name, options2.delete);
       if (options2.plain) {
         console.log(`Removed: ${name}`);
@@ -101020,10 +101087,10 @@ importCommand.argument("[source]", "Source to import (shorthand for 'import add'
 });
 
 // src/utils/update-notifier.ts
-import { existsSync as existsSync36, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "node:fs";
+import { existsSync as existsSync37, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "node:fs";
 import { mkdir as mkdir21 } from "node:fs/promises";
-import { homedir as homedir2 } from "node:os";
-import { dirname as dirname8, join as join41 } from "node:path";
+import { homedir as homedir3 } from "node:os";
+import { dirname as dirname8, join as join42 } from "node:path";
 var DEFAULT_TTL_MS = 60 * 60 * 1e3;
 var DEFAULT_TIMEOUT_MS = 2e3;
 var hasNotifiedThisProcess = false;
@@ -101037,10 +101104,10 @@ function detectPackageManager(cwd) {
   if (ua.startsWith("yarn/")) return "yarn";
   if (ua.startsWith("bun/")) return "bun";
   if (ua.startsWith("npm/")) return "npm";
-  if (existsSync36(join41(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (existsSync36(join41(cwd, "yarn.lock"))) return "yarn";
-  if (existsSync36(join41(cwd, "bun.lock"))) return "bun";
-  if (existsSync36(join41(cwd, "package-lock.json"))) return "npm";
+  if (existsSync37(join42(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync37(join42(cwd, "yarn.lock"))) return "yarn";
+  if (existsSync37(join42(cwd, "bun.lock"))) return "bun";
+  if (existsSync37(join42(cwd, "package-lock.json"))) return "npm";
   return "npm";
 }
 function compareVersions(a, b) {
@@ -101064,7 +101131,7 @@ function shouldSkip(args2, force) {
 }
 function getGlobalCachePath(explicit) {
   if (explicit) return explicit;
-  return join41(homedir2(), ".knowns", "cli-cache.json");
+  return join42(homedir3(), ".knowns", "cli-cache.json");
 }
 function readCache(cachePath) {
   try {
@@ -101080,7 +101147,7 @@ function readCache(cachePath) {
 }
 async function writeCache(cachePath, data) {
   const dir = dirname8(cachePath);
-  if (dir && !existsSync36(dir)) {
+  if (dir && !existsSync37(dir)) {
     await mkdir21(dir, { recursive: true });
   }
   writeFileSync3(cachePath, JSON.stringify(data, null, 2), "utf-8");
@@ -101149,7 +101216,7 @@ async function notifyCliUpdate(options2) {
 // package.json
 var package_default = {
   name: "knowns",
-  version: "0.10.5",
+  version: "0.10.6",
   description: "AI-native task and documentation management for dev teams",
   module: "index.ts",
   type: "module",
@@ -101315,7 +101382,6 @@ program2.addCommand(timeCommand);
 program2.addCommand(docCommand);
 program2.addCommand(configCommand);
 program2.addCommand(syncCommand);
-program2.addCommand(agentsCommand);
 program2.addCommand(mcpCommand);
 program2.addCommand(templateCommand);
 program2.addCommand(skillCommand);