knowns 0.2.0 → 0.3.0

package/dist/index.js

@@ -3313,10 +3313,10 @@ var require_stringify = __commonJS({
       data = Object.assign({}, file3.data, data);
       const open = opts.delimiters[0];
       const close = opts.delimiters[1];
-      const matter5 = engine.stringify(data, options2).trim();
+      const matter6 = engine.stringify(data, options2).trim();
       let buf = "";
-      if (matter5 !== "{}") {
-        buf = newline(open) + newline(matter5) + newline(close);
+      if (matter6 !== "{}") {
+        buf = newline(open) + newline(matter6) + newline(close);
       }
       if (typeof file3.excerpt === "string" && file3.excerpt !== "") {
         if (str2.indexOf(file3.excerpt.trim()) === -1) {
@@ -3422,19 +3422,19 @@ var require_gray_matter = __commonJS({
     var toFile = require_to_file();
     var parse4 = require_parse();
     var utils = require_utils();
-    function matter5(input, options2) {
+    function matter6(input, options2) {
       if (input === "") {
         return { data: {}, content: input, excerpt: "", orig: input };
       }
       let file3 = toFile(input);
-      const cached2 = matter5.cache[file3.content];
+      const cached2 = matter6.cache[file3.content];
       if (!options2) {
         if (cached2) {
           file3 = Object.assign({}, cached2);
           file3.orig = cached2.orig;
           return file3;
         }
-        matter5.cache[file3.content] = file3;
+        matter6.cache[file3.content] = file3;
       }
       return parseMatter(file3, options2);
     }
@@ -3456,7 +3456,7 @@ var require_gray_matter = __commonJS({
       }
       str2 = str2.slice(openLen);
       const len = str2.length;
-      const language = matter5.language(str2, opts);
+      const language = matter6.language(str2, opts);
       if (language.name) {
         file3.language = language.name;
         str2 = str2.slice(language.raw.length);
@@ -3491,24 +3491,24 @@ var require_gray_matter = __commonJS({
       }
       return file3;
     }
-    matter5.engines = engines2;
-    matter5.stringify = function(file3, data, options2) {
-      if (typeof file3 === "string") file3 = matter5(file3, options2);
+    matter6.engines = engines2;
+    matter6.stringify = function(file3, data, options2) {
+      if (typeof file3 === "string") file3 = matter6(file3, options2);
       return stringify(file3, data, options2);
     };
-    matter5.read = function(filepath, options2) {
+    matter6.read = function(filepath, options2) {
       const str2 = fs.readFileSync(filepath, "utf8");
-      const file3 = matter5(str2, options2);
+      const file3 = matter6(str2, options2);
       file3.path = filepath;
       return file3;
     };
-    matter5.test = function(str2, options2) {
+    matter6.test = function(str2, options2) {
       return utils.startsWith(str2, defaults(options2).delimiters[0]);
     };
-    matter5.language = function(str2, options2) {
+    matter6.language = function(str2, options2) {
       const opts = defaults(options2);
       const open = opts.delimiters[0];
-      if (matter5.test(str2)) {
+      if (matter6.test(str2)) {
         str2 = str2.slice(open.length);
       }
       const language = str2.slice(0, str2.search(/\r?\n/));
@@ -3517,11 +3517,11 @@ var require_gray_matter = __commonJS({
         name: language ? language.trim() : ""
       };
     };
-    matter5.cache = {};
-    matter5.clearCache = function() {
-      matter5.cache = {};
+    matter6.cache = {};
+    matter6.clearCache = function() {
+      matter6.cache = {};
     };
-    module2.exports = matter5;
+    module2.exports = matter6;
   }
 });
 
@@ -30381,7 +30381,7 @@ var require_view = __commonJS({
     var dirname4 = path.dirname;
     var basename3 = path.basename;
     var extname = path.extname;
-    var join14 = path.join;
+    var join19 = path.join;
     var resolve = path.resolve;
     module2.exports = View;
     function View(name, options2) {
@@ -30443,12 +30443,12 @@ var require_view = __commonJS({
     };
     View.prototype.resolve = function resolve2(dir, file3) {
       var ext = this.ext;
-      var path2 = join14(dir, file3);
+      var path2 = join19(dir, file3);
       var stat3 = tryStat(path2);
       if (stat3 && stat3.isFile()) {
         return path2;
       }
-      path2 = join14(dir, basename3(file3, ext), "index" + ext);
+      path2 = join19(dir, basename3(file3, ext), "index" + ext);
       stat3 = tryStat(path2);
       if (stat3 && stat3.isFile()) {
         return path2;
@@ -32186,11 +32186,11 @@ var require_router = __commonJS({
     var slice = Array.prototype.slice;
     var flatten = Array.prototype.flat;
     var methods = METHODS.map((method) => method.toLowerCase());
-    module2.exports = Router;
+    module2.exports = Router9;
     module2.exports.Route = Route;
-    function Router(options2) {
-      if (!(this instanceof Router)) {
-        return new Router(options2);
+    function Router9(options2) {
+      if (!(this instanceof Router9)) {
+        return new Router9(options2);
       }
       const opts = options2 || {};
       function router(req, res, next) {
@@ -32204,9 +32204,9 @@ var require_router = __commonJS({
       router.stack = [];
       return router;
     }
-    Router.prototype = function() {
+    Router9.prototype = function() {
     };
-    Router.prototype.param = function param(name, fn) {
+    Router9.prototype.param = function param(name, fn) {
       if (!name) {
         throw new TypeError("argument name is required");
       }
@@ -32226,7 +32226,7 @@ var require_router = __commonJS({
       params.push(fn);
       return this;
     };
-    Router.prototype.handle = function handle(req, res, callback) {
+    Router9.prototype.handle = function handle(req, res, callback) {
       if (!callback) {
         throw new TypeError("argument callback is required");
       }
@@ -32353,7 +32353,7 @@ var require_router = __commonJS({
         }
       }
     };
-    Router.prototype.use = function use(handler) {
+    Router9.prototype.use = function use(handler) {
       let offset = 0;
       let path = "/";
       if (typeof handler !== "function") {
@@ -32386,7 +32386,7 @@ var require_router = __commonJS({
       }
       return this;
     };
-    Router.prototype.route = function route(path) {
+    Router9.prototype.route = function route(path) {
       const route2 = new Route(path);
       const layer = new Layer(path, {
         sensitive: this.caseSensitive,
@@ -32401,7 +32401,7 @@ var require_router = __commonJS({
       return route2;
     };
     methods.concat("all").forEach(function(method) {
-      Router.prototype[method] = function(path) {
+      Router9.prototype[method] = function(path) {
         const route = this.route(path);
         route[method].apply(route, slice.call(arguments, 1));
         return this;
@@ -32584,7 +32584,7 @@ var require_application = __commonJS({
     var compileTrust = require_utils4().compileTrust;
     var resolve = __require("node:path").resolve;
     var once = require_once();
-    var Router = require_router();
+    var Router9 = require_router();
     var slice = Array.prototype.slice;
     var flatten = Array.prototype.flat;
     var app = exports2 = module2.exports = {};
@@ -32600,7 +32600,7 @@ var require_application = __commonJS({
         enumerable: true,
         get: function getrouter() {
           if (router === null) {
-            router = new Router({
+            router = new Router9({
               caseSensitive: this.enabled("case sensitive routing"),
               strict: this.enabled("strict routing")
             });
@@ -34093,7 +34093,7 @@ var require_send = __commonJS({
     var Stream = __require("stream");
     var util = __require("util");
     var extname = path.extname;
-    var join14 = path.join;
+    var join19 = path.join;
     var normalize = path.normalize;
     var resolve = path.resolve;
     var sep = path.sep;
@@ -34265,7 +34265,7 @@ var require_send = __commonJS({
           return res;
         }
         parts = path2.split(sep);
-        path2 = normalize(join14(root, path2));
+        path2 = normalize(join19(root, path2));
       } else {
         if (UP_PATH_REGEXP.test(path2)) {
           debug('malicious path "%s"', path2);
@@ -34398,7 +34398,7 @@ var require_send = __commonJS({
           if (err) return self.onStatError(err);
           return self.error(404);
         }
-        var p = join14(path2, self._index[i]);
+        var p = join19(path2, self._index[i]);
         debug('stat "%s"', p);
         fs.stat(p, function(err2, stat3) {
           if (err2) return next(err2);
@@ -35138,7 +35138,7 @@ var require_express = __commonJS({
     var EventEmitter = __require("node:events").EventEmitter;
     var mixin = require_merge_descriptors();
     var proto2 = require_application();
-    var Router = require_router();
+    var Router9 = require_router();
     var req = require_request();
     var res = require_response();
     exports2 = module2.exports = createApplication;
@@ -35160,8 +35160,8 @@ var require_express = __commonJS({
     exports2.application = proto2;
     exports2.request = req;
     exports2.response = res;
-    exports2.Route = Router.Route;
-    exports2.Router = Router;
+    exports2.Route = Router9.Route;
+    exports2.Router = Router9;
     exports2.json = bodyParser.json;
     exports2.raw = bodyParser.raw;
     exports2.static = require_serve_static();
@@ -38791,7 +38791,7 @@ import { existsSync as existsSync2 } from "node:fs";
 import { basename, join as join4 } from "node:path";
 
 // src/storage/file-store.ts
-import { mkdir as mkdir2, readdir, unlink as unlink2 } from "node:fs/promises";
+import { mkdir as mkdir2, readdir, rename, unlink as unlink2 } from "node:fs/promises";
 import { join as join2 } from "node:path";
 
 // src/models/task.ts
@@ -39279,6 +39279,8 @@ var FileStore = class {
   // .knowns/
   tasksPath;
   // .knowns/tasks/
+  archivePath;
+  // .knowns/archive/
   projectPath;
   // .knowns/config.json
   timeEntriesPath;
@@ -39288,6 +39290,7 @@ var FileStore = class {
     this.projectRoot = projectRoot;
     this.basePath = join2(projectRoot, ".knowns");
     this.tasksPath = join2(this.basePath, "tasks");
+    this.archivePath = join2(this.basePath, "archive");
     this.projectPath = join2(this.basePath, "config.json");
     this.timeEntriesPath = join2(this.basePath, "time-entries.json");
     this.versionStore = new VersionStore(projectRoot);
@@ -39462,6 +39465,7 @@ var FileStore = class {
         await this.addSubtask(newParent, id);
       }
     }
+    const oldFileName = updates.title && updates.title !== task.title ? await this.findTaskFile(id) : null;
     const updatedTask = {
       ...task,
       ...updates,
@@ -39470,6 +39474,10 @@ var FileStore = class {
       updatedAt: /* @__PURE__ */ new Date()
     };
     await this.versionStore.recordVersion(id, task, updatedTask, author);
+    if (oldFileName) {
+      const oldFilePath = join2(this.tasksPath, oldFileName);
+      await unlink2(oldFilePath);
+    }
     await this.saveTask(updatedTask);
     if (updates.timeEntries !== void 0) {
       const allTimeEntries = await this.loadTimeEntries();
@@ -39489,6 +39497,66 @@ var FileStore = class {
     const filePath = join2(this.tasksPath, fileName);
     await unlink2(filePath);
   }
+  /**
+   * Archive task - move to archive folder
+   */
+  async archiveTask(id) {
+    const task = await this.getTask(id);
+    if (!task) {
+      throw new Error(`Task ${id} not found`);
+    }
+    const fileName = await this.findTaskFile(id);
+    if (!fileName) {
+      throw new Error(`Task file for ${id} not found`);
+    }
+    await mkdir2(this.archivePath, { recursive: true });
+    const oldPath = join2(this.tasksPath, fileName);
+    const newPath = join2(this.archivePath, fileName);
+    await rename(oldPath, newPath);
+    return task;
+  }
+  /**
+   * Unarchive task - restore from archive folder
+   */
+  async unarchiveTask(id) {
+    try {
+      const files = await readdir(this.archivePath);
+      const taskFile = files.find((f) => f.startsWith(`task-${id} -`));
+      if (!taskFile) {
+        throw new Error(`Archived task ${id} not found`);
+      }
+      const archiveFilePath = join2(this.archivePath, taskFile);
+      const tasksFilePath = join2(this.tasksPath, taskFile);
+      await rename(archiveFilePath, tasksFilePath);
+      return await this.getTask(id);
+    } catch (error46) {
+      console.error(`Failed to unarchive task ${id}:`, error46);
+      throw error46;
+    }
+  }
+  /**
+   * Batch archive tasks - archive all done tasks older than specified duration
+   * @param olderThanMs - Duration in milliseconds (tasks done before now - olderThanMs will be archived)
+   * @returns Array of archived tasks
+   */
+  async batchArchiveTasks(olderThanMs) {
+    const allTasks = await this.getAllTasks();
+    const now = Date.now();
+    const cutoffTime = now - olderThanMs;
+    const tasksToArchive = allTasks.filter(
+      (task) => task.status === "done" && new Date(task.updatedAt).getTime() < cutoffTime
+    );
+    const archivedTasks = [];
+    for (const task of tasksToArchive) {
+      try {
+        await this.archiveTask(task.id);
+        archivedTasks.push(task);
+      } catch (error46) {
+        console.error(`Failed to archive task ${task.id}:`, error46);
+      }
+    }
+    return archivedTasks;
+  }
   /**
    * Save task to file
    */
@@ -39507,11 +39575,18 @@ var FileStore = class {
   }
   /**
    * Find task file by ID
+   * Warns if multiple files with same ID are found (indicates a bug)
    */
   async findTaskFile(id) {
     try {
       const files = await readdir(this.tasksPath);
-      return files.find((f) => f.startsWith(`task-${id} -`)) || null;
+      const matchingFiles = files.filter((f) => f.startsWith(`task-${id} -`));
+      if (matchingFiles.length > 1) {
+        console.warn(
+          `Warning: Found ${matchingFiles.length} files for task-${id}. This may cause data inconsistency. Files: ${matchingFiles.join(", ")}`
+        );
+      }
+      return matchingFiles[0] || null;
     } catch (_error) {
       return null;
     }
@@ -40148,10 +40223,10 @@ When starting a new session or working on an unfamiliar project:
 knowns doc list --plain
 
 # 2. Read essential project docs (prioritize these)
-knowns doc view "README" --plain           # Project overview
-knowns doc view "ARCHITECTURE" --plain     # System design
-knowns doc view "CONVENTIONS" --plain      # Coding standards
-knowns doc view "API" --plain              # API specifications
+knowns doc "README" --plain                # Project overview
+knowns doc "ARCHITECTURE" --plain          # System design
+knowns doc "CONVENTIONS" --plain           # Coding standards
+knowns doc "API" --plain                   # API specifications
 
 # 3. Review current task backlog
 knowns task list --plain
@@ -40162,17 +40237,17 @@ knowns task list --status in-progress --plain
 
 \`\`\`bash
 # 1. View the task details
-knowns task view <id> --plain
+knowns task <id> --plain
 
 # 2. Follow ALL refs in the task (see Reference System section)
-# @.knowns/tasks/task-44 - ... \u2192 knowns task view 44 --plain
-# @.knowns/docs/patterns/module.md \u2192 knowns doc view "patterns/module" --plain
+# @.knowns/tasks/task-44 - ... \u2192 knowns task 44 --plain
+# @.knowns/docs/patterns/module.md \u2192 knowns doc "patterns/module" --plain
 
 # 3. Search for additional related documentation
 knowns search "<keywords from task>" --type doc --plain
 
 # 4. Read ALL related docs before planning
-knowns doc view "<related-doc>" --plain
+knowns doc "<related-doc>" --plain
 
 # 5. Check for similar completed tasks (learn from history)
 knowns search "<keywords>" --type task --status done --plain
@@ -40210,10 +40285,15 @@ Tasks and docs can contain **references** to other tasks/docs. AI agents MUST un
 
 ### Reference Formats
 
-| Type | User Input | System Output | CLI Command |
-|------|------------|---------------|-------------|
-| **Task ref** | \`@task-<id>\` | \`@.knowns/tasks/task-<id> - <title>.md\` | \`knowns task view <id> --plain\` |
-| **Doc ref** | \`@doc/<path>\` | \`@.knowns/docs/<path>.md\` | \`knowns doc view "<path>" --plain\` |
+| Type | When Writing (Input) | When Reading (Output) | CLI Command |
+|------|---------------------|----------------------|-------------|
+| **Task ref** | \`@task-<id>\` | \`@.knowns/tasks/task-<id> - <title>.md\` | \`knowns task <id> --plain\` |
+| **Doc ref** | \`@doc/<path>\` | \`@.knowns/docs/<path>.md\` | \`knowns doc <path> --plain\` |
+
+> **CRITICAL for AI Agents**:
+> - When **WRITING** refs (in descriptions, plans, notes): Use \`@task-<id>\` and \`@doc/<path>\`
+> - When **READING** output from \`--plain\`: You'll see \`@.knowns/tasks/...\` and \`@.knowns/docs/...\`
+> - **NEVER write** the output format (\`@.knowns/...\`) - always use input format (\`@task-<id>\`, \`@doc/<path>\`)
 
 ### How to Follow Refs
 
@@ -40225,16 +40305,16 @@ When you read a task and see refs in system output format, follow them:
 # @.knowns/docs/patterns/module.md
 
 # Follow task ref (extract ID from task-<id>)
-knowns task view 44 --plain
+knowns task 44 --plain
 
 # Follow doc ref (extract path, remove .md)
-knowns doc view "patterns/module" --plain
+knowns doc "patterns/module" --plain
 \`\`\`
 
 ### Parsing Rules
 
-1. **Task refs**: \`@.knowns/tasks/task-<id> - ...\` \u2192 extract \`<id>\` \u2192 \`knowns task view <id> --plain\`
-2. **Doc refs**: \`@.knowns/docs/<path>.md\` \u2192 extract \`<path>\` \u2192 \`knowns doc view "<path>" --plain\`
+1. **Task refs**: \`@.knowns/tasks/task-<id> - ...\` \u2192 extract \`<id>\` \u2192 \`knowns task <id> --plain\`
+2. **Doc refs**: \`@.knowns/docs/<path>.md\` \u2192 extract \`<path>\` \u2192 \`knowns doc "<path>" --plain\`
 
 ### Recursive Following
 
@@ -40260,20 +40340,20 @@ Task 42
 
 \`\`\`bash
 # 1. Read the task
-$ knowns task view 42 --plain
+$ knowns task 42 --plain
 
 # Output contains:
 # @.knowns/tasks/task-44 - CLI Task Create Command.md
 # @.knowns/docs/README.md
 
 # 2. Follow task ref
-$ knowns task view 44 --plain
+$ knowns task 44 --plain
 
 # 3. Follow doc ref
-$ knowns doc view "README" --plain
+$ knowns doc "README" --plain
 
 # 4. If README contains more refs, follow them too
-# @.knowns/docs/patterns/module.md \u2192 knowns doc view "patterns/module" --plain
+# @.knowns/docs/patterns/module.md \u2192 knowns doc "patterns/module" --plain
 
 # Now you have complete context
 \`\`\`
@@ -40292,7 +40372,12 @@ knowns init [name]
 knowns task create "Title" -d "Description" --ac "Criterion 1" --ac "Criterion 2"
 
 # View task (ALWAYS use --plain for AI)
-knowns task view <id> --plain
+knowns task <id> --plain                    # Shorthand
+knowns task view <id> --plain               # Full command
+
+# View doc (ALWAYS use --plain for AI)
+knowns doc <path> --plain                   # Shorthand
+knowns doc view "<path>" --plain            # Full command
 
 # List tasks
 knowns task list --plain
@@ -40322,9 +40407,9 @@ $ knowns doc list --plain
 # DOC: email-templates.md
 
 # 0b. Read essential project docs
-$ knowns doc view "README" --plain
-$ knowns doc view "ARCHITECTURE" --plain
-$ knowns doc view "CONVENTIONS" --plain
+$ knowns doc "README" --plain
+$ knowns doc "ARCHITECTURE" --plain
+$ knowns doc "CONVENTIONS" --plain
 
 # Now the agent understands project context and conventions
 
@@ -40356,7 +40441,7 @@ $ knowns search "password security" --type doc --plain
 # DOC: email-templates.md (score: 0.78)
 
 # 4. Read the documentation
-$ knowns doc view "security-patterns" --plain
+$ knowns doc "security-patterns" --plain
 
 # 5. Create implementation plan (SHARE WITH USER, WAIT FOR APPROVAL)
 $ knowns task edit AUTH-042 --plan $'1. Review security patterns (see @doc/security-patterns)
@@ -40436,8 +40521,8 @@ knowns time start <id>
 knowns search "authentication" --type doc --plain
 
 # View relevant documents
-knowns doc view "API Guidelines" --plain
-knowns doc view "Security Patterns" --plain
+knowns doc "API Guidelines" --plain
+knowns doc "Security Patterns" --plain
 
 # Also check for similar completed tasks
 knowns search "auth" --type task --status done --plain
@@ -40524,7 +40609,8 @@ knowns task edit <id> --notes "Implementation summary"
 knowns task edit <id> --append-notes "Progress update"
 
 # View & List
-knowns task view <id> --plain                        # ALWAYS use --plain
+knowns task <id> --plain                             # Shorthand (ALWAYS use --plain)
+knowns task view <id> --plain                        # Full command
 knowns task list --plain
 knowns task list --status in-progress --plain
 knowns task list --assignee @me --plain
@@ -40555,7 +40641,8 @@ knowns time report --by-label --csv > report.csv
 # List & View
 knowns doc list --plain
 knowns doc list --tag architecture --plain
-knowns doc view "Doc Name" --plain
+knowns doc <path> --plain                          # Shorthand (ALWAYS use --plain)
+knowns doc view "<path>" --plain                   # Full command
 
 # Create (with optional folder)
 knowns doc create "Title" -d "Description" -t "tags"
@@ -40662,7 +40749,7 @@ Implemented JWT auth using jsonwebtoken library.
 | \`Error: No active timer\` | Calling \`time stop\` without active timer | Start timer first: \`knowns time start <id>\` |
 | \`Error: Timer already running\` | Starting timer when one is active | Stop current: \`knowns time stop\` |
 | \`Error: Invalid status\` | Wrong status format | Use lowercase with hyphens: \`in-progress\`, not \`In Progress\` |
-| \`Error: AC index out of range\` | Checking non-existent criterion | View task first: \`knowns task view <id> --plain\` |
+| \`Error: AC index out of range\` | Checking non-existent criterion | View task first: \`knowns task <id> --plain\` |
 | \`Error: Document not found\` | Wrong document name | Run \`knowns doc list --plain\` to find correct name |
 | \`Error: Not initialized\` | Running commands without init | Run \`knowns init\` first |
 
@@ -40676,7 +40763,7 @@ knowns --version
 knowns status
 
 # View raw task data (for debugging)
-knowns task view <id> --json
+knowns task <id> --json
 
 # Check timer status
 knowns time status
@@ -40740,6 +40827,7 @@ Use **lowercase with hyphens**:
 | Plan without checking docs | Read docs before planning |
 | Ignore similar completed tasks | Search done tasks for patterns |
 | Missing doc links in description/plan | Link docs using \`@doc/<path>\` |
+| Write refs as \`@.knowns/docs/...\` or \`@.knowns/tasks/...\` | Use input format: \`@doc/<path>\`, \`@task-<id>\` |
 | Forget \`--plain\` flag | Always use \`--plain\` for AI |
 | Code before plan approval | Share plan, WAIT for approval |
 | Mark done without all criteria | Check ALL criteria first |
@@ -40747,8 +40835,8 @@ Use **lowercase with hyphens**:
 | Use \`"In Progress"\` or \`"Done"\` | Use \`in-progress\`, \`done\` |
 | Use \`@yourself\` | Use \`@me\` or specific username |
 | Ignore refs in task description | Follow ALL refs (\`@.knowns/...\`) before planning |
-| See \`@.knowns/docs/...\` but don't read | Use \`knowns doc view "<path>" --plain\` |
-| See \`@.knowns/tasks/task-X\` but don't check | Use \`knowns task view X --plain\` for context |
+| See \`@.knowns/docs/...\` but don't read | Use \`knowns doc "<path>" --plain\` |
+| See \`@.knowns/tasks/task-X\` but don't check | Use \`knowns task X --plain\` for context |
 | Follow only first-level refs | Recursively follow nested refs until complete |
 
 ---
@@ -40806,7 +40894,7 @@ EOF
 - [ ] ALL refs in task followed (\`@.knowns/...\`)
 - [ ] Nested refs recursively followed until complete context gathered
 - [ ] Related docs searched: \`knowns search "keyword" --type doc --plain\`
-- [ ] ALL relevant docs read: \`knowns doc view "Doc Name" --plain\`
+- [ ] ALL relevant docs read: \`knowns doc "Doc Name" --plain\`
 - [ ] Similar done tasks reviewed for patterns
 - [ ] Task assigned to self: \`-a @me\`
 - [ ] Status set to in-progress: \`-s in-progress\`
@@ -40835,16 +40923,16 @@ EOF
 \`\`\`bash
 # === AGENT INITIALIZATION (Once per session) ===
 knowns doc list --plain
-knowns doc view "README" --plain
-knowns doc view "ARCHITECTURE" --plain
-knowns doc view "CONVENTIONS" --plain
+knowns doc "README" --plain
+knowns doc "ARCHITECTURE" --plain
+knowns doc "CONVENTIONS" --plain
 
 # === FULL WORKFLOW ===
 knowns task create "Title" -d "Description" --ac "Criterion"
 knowns task edit <id> -s in-progress -a @me
 knowns time start <id>
 knowns search "keyword" --type doc --plain
-knowns doc view "Doc Name" --plain
+knowns doc "Doc Name" --plain
 knowns search "keyword" --type task --status done --plain  # Learn from history
 knowns task edit <id> --plan $'1. Step (see @doc/file)\\n2. Step'
 # ... wait for approval, then implement ...
@@ -40854,7 +40942,7 @@ knowns time stop
 knowns task edit <id> -s done
 
 # === VIEW & SEARCH ===
-knowns task view <id> --plain
+knowns task <id> --plain                                   # Shorthand for view
 knowns task list --plain
 knowns task list --status in-progress --assignee @me --plain
 knowns search "query" --plain
@@ -40868,7 +40956,7 @@ knowns time report --from "2025-12-01" --to "2025-12-31"
 
 # === DOCUMENTATION ===
 knowns doc list --plain
-knowns doc view "path/doc-name" --plain
+knowns doc "path/doc-name" --plain                         # Shorthand for view
 knowns doc create "Title" -d "Description" -t "tags" -f "folder"
 knowns doc edit "doc-name" -c "New content"
 knowns doc edit "doc-name" -a "Appended content"
@@ -41219,6 +41307,8 @@ function findProjectRoot(startPath = process.cwd()) {
 // src/utils/mention-refs.ts
 var TASK_MENTION_REGEX = /@task-(\d+)/g;
 var DOC_MENTION_REGEX = /@docs?\/([^\s|)]+)/g;
+var OUTPUT_TASK_REGEX = /@\.knowns\/tasks\/task-(\d+)(?:\s*-\s*[^@\n]+?\.md|\.md)/g;
+var OUTPUT_DOC_REGEX = /@\.knowns\/docs\/([^\s@]+?)\.md(?:\s*-\s*[^@\n]+)?/g;
 function sanitizeTitle(title) {
   return title.replace(/[<>:"/\\|?*]/g, "").replace(/\s+/g, " ").trim().slice(0, 50);
 }
@@ -41251,6 +41341,12 @@ function buildTaskMap(tasks) {
   }
   return map2;
 }
+function normalizeRefs(text) {
+  let result = text;
+  result = result.replace(new RegExp(OUTPUT_TASK_REGEX.source, "g"), (match, taskId) => `@task-${taskId}`);
+  result = result.replace(new RegExp(OUTPUT_DOC_REGEX.source, "g"), (match, docPath) => `@doc/${docPath}`);
+  return result;
+}
 
 // src/utils/notify-server.ts
 import { existsSync as existsSync5, readFileSync } from "node:fs";
@@ -41285,6 +41381,18 @@ async function notifyTaskUpdate(taskId) {
   } catch {
   }
 }
+async function notifyRefresh() {
+  try {
+    const port = getServerPort();
+    await fetch(`http://localhost:${port}/api/notify`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ type: "tasks:refresh" }),
+      signal: AbortSignal.timeout(1e3)
+    });
+  } catch {
+  }
+}
 async function notifyDocUpdate(docPath) {
   try {
     const port = getServerPort();
@@ -41297,6 +41405,18 @@ async function notifyDocUpdate(docPath) {
   } catch {
   }
 }
+async function notifyTimeUpdate(active) {
+  try {
+    const port = getServerPort();
+    await fetch(`http://localhost:${port}/api/notify`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ type: "time:updated", active }),
+      signal: AbortSignal.timeout(1e3)
+    });
+  } catch {
+  }
+}
 
 // src/commands/task.ts
 function getFileStore() {
@@ -41675,7 +41795,7 @@ var createCommand2 = new Command("create").description("Create a new task").argu
       }));
       const task = await fileStore.createTask({
         title,
-        description: options2.description,
+        description: options2.description ? normalizeRefs(options2.description) : void 0,
         status: options2.status,
         priority: options2.priority,
         assignee: options2.assignee,
@@ -41780,7 +41900,7 @@ var editCommand = new Command("edit").description("Edit task properties").argume
         updates.title = options2.title;
       }
       if (options2.description) {
-        updates.description = options2.description;
+        updates.description = normalizeRefs(options2.description);
       }
       if (options2.status) {
         if (!isValidTaskStatus(options2.status, allowedStatuses)) {
@@ -41857,15 +41977,15 @@ var editCommand = new Command("edit").description("Edit task properties").argume
         updates.acceptanceCriteria = criteria;
       }
       if (options2.plan) {
-        updates.implementationPlan = options2.plan;
+        updates.implementationPlan = normalizeRefs(options2.plan);
       }
       if (options2.notes) {
-        updates.implementationNotes = options2.notes;
+        updates.implementationNotes = normalizeRefs(options2.notes);
       }
       if (options2.appendNotes) {
         const existingNotes = task.implementationNotes || "";
         const separator = existingNotes ? "\n\n" : "";
-        updates.implementationNotes = existingNotes + separator + options2.appendNotes;
+        updates.implementationNotes = existingNotes + separator + normalizeRefs(options2.appendNotes);
       }
       await fileStore.updateTask(id, updates);
       await notifyTaskUpdate(id);
@@ -41929,6 +42049,7 @@ var archiveCommand = new Command("archive").description("Archive a task").argume
     const content = await file(oldPath).text();
     await write(newPath, content);
     await unlink3(oldPath);
+    await notifyRefresh();
     console.log(source_default.green(`\u2713 Archived task-${id}: ${task.title}`));
   } catch (error46) {
     console.error(source_default.red("\u2717 Failed to archive task"));
@@ -41959,6 +42080,7 @@ var unarchiveCommand = new Command("unarchive").description("Restore archived ta
     const content = await file(archivePath).text();
     await write(tasksFilePath, content);
     await unlink3(archivePath);
+    await notifyRefresh();
     console.log(source_default.green(`\u2713 Restored task-${id}`));
   } catch (error46) {
     console.error(source_default.red("\u2717 Failed to restore task"));
@@ -42363,7 +42485,27 @@ var restoreCommand = new Command("restore").description("Restore task to a previ
     process.exit(1);
   }
 });
-var taskCommand = new Command("task").description("Manage tasks");
+var taskCommand = new Command("task").description("Manage tasks").argument("[id]", "Task ID (shorthand for 'task view <id>')").option("--plain", "Plain text output for AI").action(async (id, options2) => {
+  if (!id) {
+    taskCommand.help();
+    return;
+  }
+  try {
+    const fileStore = getFileStore();
+    const task = await fileStore.getTask(id);
+    if (!task) {
+      console.error(source_default.red(`\u2717 Task ${id} not found`));
+      process.exit(1);
+    }
+    console.log(await formatTask(task, fileStore, options2.plain));
+  } catch (error46) {
+    console.error(source_default.red("\u2717 Failed to view task"));
+    if (error46 instanceof Error) {
+      console.error(source_default.red(`  ${error46.message}`));
+    }
+    process.exit(1);
+  }
+});
 taskCommand.addCommand(createCommand2);
 taskCommand.addCommand(listCommand);
 taskCommand.addCommand(viewCommand);
@@ -42818,6 +42960,13 @@ var startCommand = new Command("start").description("Start timer for a task").ar
       totalPausedMs: 0
     };
     await saveTimeData(projectRoot, data);
+    await notifyTimeUpdate({
+      taskId,
+      taskTitle: task.title,
+      startedAt: data.active.startedAt,
+      pausedAt: null,
+      totalPausedMs: 0
+    });
     console.log(source_default.green(`\u23F1  Started timer for #${taskId}: ${task.title}`));
   } catch (error46) {
     console.error(source_default.red("\u2717 Failed to start timer"));
@@ -42858,6 +43007,7 @@ var stopCommand = new Command("stop").description("Stop current timer and save t
     }
     data.active = null;
     await saveTimeData(projectRoot, data);
+    await notifyTimeUpdate(null);
     console.log(source_default.green(`\u23F9  Stopped timer for #${taskId}`));
     console.log(source_default.gray(`   Duration: ${formatDuration(seconds)}`));
   } catch (error46) {
@@ -42871,6 +43021,7 @@ var stopCommand = new Command("stop").description("Stop current timer and save t
 var pauseCommand = new Command("pause").description("Pause current timer").action(async () => {
   try {
     const projectRoot = getProjectRoot();
+    const fileStore = getFileStore4();
     const data = await loadTimeData(projectRoot);
     if (!data.active) {
       console.log(source_default.yellow("No active timer"));
@@ -42882,6 +43033,14 @@ var pauseCommand = new Command("pause").description("Pause current timer").actio
     }
     data.active.pausedAt = (/* @__PURE__ */ new Date()).toISOString();
     await saveTimeData(projectRoot, data);
+    const task = await fileStore.getTask(data.active.taskId);
+    await notifyTimeUpdate({
+      taskId: data.active.taskId,
+      taskTitle: task?.title || "",
+      startedAt: data.active.startedAt,
+      pausedAt: data.active.pausedAt,
+      totalPausedMs: data.active.totalPausedMs
+    });
     console.log(source_default.yellow(`\u23F8  Paused timer for #${data.active.taskId}`));
   } catch (error46) {
     console.error(source_default.red("\u2717 Failed to pause timer"));
@@ -42894,6 +43053,7 @@ var pauseCommand = new Command("pause").description("Pause current timer").actio
 var resumeCommand = new Command("resume").description("Resume paused timer").action(async () => {
   try {
     const projectRoot = getProjectRoot();
+    const fileStore = getFileStore4();
     const data = await loadTimeData(projectRoot);
     if (!data.active) {
       console.log(source_default.yellow("No active timer"));
@@ -42907,6 +43067,14 @@ var resumeCommand = new Command("resume").description("Resume paused timer").act
     data.active.totalPausedMs += pausedDuration;
     data.active.pausedAt = null;
     await saveTimeData(projectRoot, data);
+    const task = await fileStore.getTask(data.active.taskId);
+    await notifyTimeUpdate({
+      taskId: data.active.taskId,
+      taskTitle: task?.title || "",
+      startedAt: data.active.startedAt,
+      pausedAt: null,
+      totalPausedMs: data.active.totalPausedMs
+    });
     console.log(source_default.green(`\u25B6  Resumed timer for #${data.active.taskId}`));
   } catch (error46) {
     console.error(source_default.red("\u2717 Failed to resume timer"));
@@ -43175,20 +43343,18 @@ timeCommand.addCommand(addCommand);
 timeCommand.addCommand(reportCommand);
 
 // src/commands/browser.ts
-import { existsSync as existsSync8 } from "node:fs";
-import { mkdir as mkdir6, readFile as readFile5, writeFile as writeFile4 } from "node:fs/promises";
-import { join as join11 } from "node:path";
+import { existsSync as existsSync12 } from "node:fs";
+import { mkdir as mkdir6, readFile as readFile8, writeFile as writeFile6 } from "node:fs/promises";
+import { join as join16 } from "node:path";
 
 // src/server/index.ts
 import { spawn } from "node:child_process";
-import { existsSync as existsSync7 } from "node:fs";
-import { mkdir as mkdir5, readFile as readFile4, readdir as readdir4, writeFile as writeFile3 } from "node:fs/promises";
+import { existsSync as existsSync11, realpathSync } from "node:fs";
 import { createServer } from "node:http";
-import { basename as basename2, dirname as dirname3, join as join10, relative } from "node:path";
+import { basename as basename2, dirname as dirname3, join as join15 } from "node:path";
 import { fileURLToPath } from "node:url";
 var import_cors = __toESM(require_lib2(), 1);
-var import_express = __toESM(require_express2(), 1);
-var import_gray_matter3 = __toESM(require_gray_matter(), 1);
+var import_express9 = __toESM(require_express2(), 1);
 
 // node_modules/ws/wrapper.mjs
 var import_stream = __toESM(require_stream(), 1);
@@ -43197,151 +43363,161 @@ var import_sender = __toESM(require_sender(), 1);
 var import_websocket = __toESM(require_websocket(), 1);
 var import_websocket_server = __toESM(require_websocket_server(), 1);
 
-// src/server/index.ts
-var isBun2 = typeof globalThis.Bun !== "undefined";
-async function startServer(options2) {
-  const { port, projectRoot, open } = options2;
-  const store = new FileStore(projectRoot);
-  const clients = /* @__PURE__ */ new Set();
-  const broadcast = (data) => {
-    const msg = JSON.stringify(data);
-    for (const client of clients) {
-      if (client.readyState === 1) {
-        client.send(msg);
-      }
-    }
-  };
-  const currentFile = fileURLToPath(import.meta.url);
-  const currentDir = dirname3(currentFile);
-  let packageRoot = currentDir;
-  const normalizedDir = currentDir.replace(/[/\\]+$/, "");
-  const dirName = basename2(normalizedDir);
-  if (dirName === "dist") {
-    packageRoot = join10(currentDir, "..");
-  } else if (normalizedDir.includes("/src/server") || normalizedDir.includes("\\src\\server")) {
-    packageRoot = join10(currentDir, "..", "..");
-  }
-  const uiDistPath = join10(packageRoot, "dist", "ui");
-  if (!existsSync7(join10(uiDistPath, "index.html"))) {
-    throw new Error(`UI build not found at ${uiDistPath}. Run 'bun run build:ui' first.`);
-  }
-  const app = (0, import_express.default)();
-  app.use((0, import_cors.default)());
-  app.use(import_express.default.json());
-  const httpServer = createServer(app);
-  const wss = new import_websocket_server.default({ server: httpServer, path: "/ws" });
-  wss.on("connection", (ws) => {
-    clients.add(ws);
-    ws.on("close", () => {
-      clients.delete(ws);
-    });
-    ws.on("error", (error46) => {
-      console.error("WebSocket error:", error46);
-      clients.delete(ws);
-    });
-  });
-  app.use(
-    "/assets",
-    import_express.default.static(join10(uiDistPath, "assets"), {
-      maxAge: "1y",
-      immutable: true
-    })
-  );
-  app.get("/api/tasks", async (_req, res) => {
+// src/server/middleware/error-handler.ts
+function errorHandler(err, _req, res, _next) {
+  console.error("Server error:", err);
+  res.status(500).json({ error: err.message });
+}
+
+// src/server/routes/index.ts
+var import_express8 = __toESM(require_express2(), 1);
+
+// src/server/routes/activities.ts
+var import_express = __toESM(require_express2(), 1);
+function createActivityRoutes(ctx) {
+  const router = (0, import_express.Router)();
+  const { store } = ctx;
+  router.get("/", async (req, res) => {
     try {
+      const limit = Number.parseInt(req.query.limit || "50", 10);
+      const type = req.query.type;
       const tasks = await store.getAllTasks();
-      res.json(tasks);
-    } catch (error46) {
-      console.error("Error getting tasks:", error46);
-      res.status(500).json({ error: String(error46) });
-    }
-  });
-  app.get("/api/tasks/:id/history", async (req, res) => {
-    try {
-      const taskId = req.params.id;
-      const history = await store.getTaskVersionHistory(taskId);
-      res.json({ versions: history });
+      const allActivities = [];
+      for (const task of tasks) {
+        const versions = await store.getTaskVersionHistory(task.id);
+        for (const version2 of versions) {
+          if (type) {
+            const hasMatchingChange = version2.changes.some((c) => c.field === type);
+            if (!hasMatchingChange) continue;
+          }
+          allActivities.push({
+            taskId: task.id,
+            taskTitle: task.title,
+            version: version2.version,
+            timestamp: version2.timestamp,
+            author: version2.author,
+            changes: version2.changes
+          });
+        }
+      }
+      allActivities.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+      const limited = allActivities.slice(0, limit);
+      res.json({ activities: limited });
     } catch (error46) {
-      console.error("Error getting task history:", error46);
+      console.error("Error getting activities:", error46);
       res.status(500).json({ error: String(error46) });
     }
   });
-  app.get("/api/tasks/:id", async (req, res) => {
+  return router;
+}
+
+// src/server/routes/config.ts
+var import_express2 = __toESM(require_express2(), 1);
+import { existsSync as existsSync7 } from "node:fs";
+import { readFile as readFile4, writeFile as writeFile3 } from "node:fs/promises";
+import { join as join10 } from "node:path";
+function createConfigRoutes(ctx) {
+  const router = (0, import_express2.Router)();
+  const { store } = ctx;
+  const configPath = join10(store.projectRoot, ".knowns", "config.json");
+  router.get("/", async (_req, res) => {
     try {
-      const task = await store.getTask(req.params.id);
-      if (!task) {
-        res.status(404).json({ error: "Task not found" });
+      if (!existsSync7(configPath)) {
+        res.json({
+          config: {
+            name: "Knowns",
+            defaultPriority: "medium",
+            defaultLabels: [],
+            timeFormat: "24h",
+            visibleColumns: ["todo", "in-progress", "done"]
+          }
+        });
         return;
       }
-      res.json(task);
-    } catch (error46) {
-      console.error("Error getting task:", error46);
-      res.status(500).json({ error: String(error46) });
-    }
-  });
-  app.put("/api/tasks/:id", async (req, res) => {
-    try {
-      const updates = req.body;
-      const task = await store.updateTask(req.params.id, updates);
-      broadcast({ type: "tasks:updated", task });
-      res.json(task);
-    } catch (error46) {
-      console.error("Error updating task:", error46);
-      res.status(500).json({ error: String(error46) });
-    }
-  });
-  app.post("/api/tasks", async (req, res) => {
-    try {
-      const data = req.body;
-      const task = await store.createTask(data);
-      broadcast({ type: "tasks:updated", task });
-      res.status(201).json(task);
+      const content = await readFile4(configPath, "utf-8");
+      const data = JSON.parse(content);
+      const settings = data.settings || {};
+      const config2 = {
+        name: data.name,
+        id: data.id,
+        createdAt: data.createdAt,
+        ...settings
+      };
+      if (!config2.visibleColumns) {
+        config2.visibleColumns = ["todo", "in-progress", "done"];
+      }
+      res.json({ config: config2 });
     } catch (error46) {
-      console.error("Error creating task:", error46);
+      console.error("Error getting config:", error46);
       res.status(500).json({ error: String(error46) });
     }
   });
-  app.post("/api/notify", async (req, res) => {
+  router.post("/", async (req, res) => {
     try {
-      const { taskId, type, docPath } = req.body;
-      if (taskId) {
-        const task = await store.getTask(taskId);
-        if (task) {
-          broadcast({ type: "tasks:updated", task });
-          res.json({ success: true });
-          return;
-        }
-      } else if (type === "tasks:refresh") {
-        broadcast({ type: "tasks:refresh" });
-        res.json({ success: true });
-        return;
-      } else if (type === "docs:updated" && docPath) {
-        broadcast({ type: "docs:updated", docPath });
-        res.json({ success: true });
-        return;
-      } else if (type === "docs:refresh") {
-        broadcast({ type: "docs:refresh" });
-        res.json({ success: true });
-        return;
+      const config2 = req.body;
+      let existingData = {};
+      if (existsSync7(configPath)) {
+        const content = await readFile4(configPath, "utf-8");
+        existingData = JSON.parse(content);
       }
-      res.status(400).json({ success: false, error: "Invalid notify request" });
+      const { name, ...settings } = config2;
+      const merged = {
+        ...existingData,
+        name: name || existingData.name,
+        settings
+      };
+      await writeFile3(configPath, JSON.stringify(merged, null, 2), "utf-8");
+      res.json({ success: true });
     } catch (error46) {
-      console.error("[Server] Notify error:", error46);
+      console.error("Error saving config:", error46);
       res.status(500).json({ error: String(error46) });
     }
   });
-  app.get("/api/docs", async (_req, res) => {
+  return router;
+}
+
+// src/server/routes/docs.ts
+var import_express3 = __toESM(require_express2(), 1);
+var import_gray_matter3 = __toESM(require_gray_matter(), 1);
+import { existsSync as existsSync8 } from "node:fs";
+import { mkdir as mkdir5, readFile as readFile5, writeFile as writeFile4 } from "node:fs/promises";
+import { join as join12 } from "node:path";
+
+// src/server/utils/markdown.ts
+import { readdir as readdir4 } from "node:fs/promises";
+import { join as join11, relative } from "node:path";
+async function findMarkdownFiles(dir, baseDir) {
+  const files = [];
+  const entries = await readdir4(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = join11(dir, entry.name);
+    if (entry.isDirectory()) {
+      const subFiles = await findMarkdownFiles(fullPath, baseDir);
+      files.push(...subFiles);
+    } else if (entry.isFile() && entry.name.endsWith(".md")) {
+      const relativePath = relative(baseDir, fullPath);
+      files.push(relativePath);
+    }
+  }
+  return files;
+}
+
+// src/server/routes/docs.ts
+function createDocRoutes(ctx) {
+  const router = (0, import_express3.Router)();
+  const { store, broadcast } = ctx;
+  const docsDir = join12(store.projectRoot, ".knowns", "docs");
+  router.get("/", async (_req, res) => {
     try {
-      const docsDir = join10(store.projectRoot, ".knowns", "docs");
-      if (!existsSync7(docsDir)) {
+      if (!existsSync8(docsDir)) {
         res.json({ docs: [] });
         return;
       }
       const mdFiles = await findMarkdownFiles(docsDir, docsDir);
       const docs = await Promise.all(
         mdFiles.map(async (relativePath) => {
-          const fullPath = join10(docsDir, relativePath);
-          const content = await readFile4(fullPath, "utf-8");
+          const fullPath = join12(docsDir, relativePath);
+          const content = await readFile5(fullPath, "utf-8");
           const { data, content: docContent } = (0, import_gray_matter3.default)(content);
           const pathParts = relativePath.split("/");
           const filename = pathParts[pathParts.length - 1];
@@ -43361,20 +43537,19 @@ async function startServer(options2) {
       res.status(500).json({ error: String(error46) });
     }
   });
-  app.get("/api/docs/{*path}", async (req, res) => {
+  router.get("/{*path}", async (req, res) => {
     try {
       const docPath = Array.isArray(req.params.path) ? req.params.path.join("/") : req.params.path;
-      const docsDir = join10(store.projectRoot, ".knowns", "docs");
-      const fullPath = join10(docsDir, docPath);
+      const fullPath = join12(docsDir, docPath);
       if (!fullPath.startsWith(docsDir)) {
         res.status(400).json({ error: "Invalid path" });
         return;
       }
-      if (!existsSync7(fullPath)) {
+      if (!existsSync8(fullPath)) {
         res.status(404).json({ error: "Document not found" });
         return;
       }
-      const content = await readFile4(fullPath, "utf-8");
+      const content = await readFile5(fullPath, "utf-8");
       const { data, content: docContent } = (0, import_gray_matter3.default)(content);
       const pathParts = docPath.split("/");
       const filename = pathParts[pathParts.length - 1];
@@ -43395,57 +43570,9 @@ async function startServer(options2) {
       res.status(500).json({ error: String(error46) });
     }
   });
-  app.put("/api/docs/{*path}", async (req, res) => {
+  router.post("/", async (req, res) => {
     try {
-      const docPath = Array.isArray(req.params.path) ? req.params.path.join("/") : req.params.path;
-      const docsDir = join10(store.projectRoot, ".knowns", "docs");
-      const fullPath = join10(docsDir, docPath);
-      if (!fullPath.startsWith(docsDir)) {
-        res.status(400).json({ error: "Invalid path" });
-        return;
-      }
-      if (!existsSync7(fullPath)) {
-        res.status(404).json({ error: "Document not found" });
-        return;
-      }
-      const data = req.body;
-      const { content, title, description, tags } = data;
-      const existingContent = await readFile4(fullPath, "utf-8");
-      const { data: existingData } = (0, import_gray_matter3.default)(existingContent);
-      const now = (/* @__PURE__ */ new Date()).toISOString();
-      const updatedFrontmatter = {
-        ...existingData,
-        title: title ?? existingData.title,
-        description: description ?? existingData.description,
-        tags: tags ?? existingData.tags,
-        updatedAt: now
-      };
-      const newFileContent = import_gray_matter3.default.stringify(content ?? "", updatedFrontmatter);
-      await writeFile3(fullPath, newFileContent, "utf-8");
-      const pathParts = docPath.split("/");
-      const filename = pathParts[pathParts.length - 1];
-      const folder = pathParts.length > 1 ? pathParts.slice(0, -1).join("/") : "";
-      const updatedDoc = {
-        filename,
-        path: docPath,
-        folder,
-        title: updatedFrontmatter.title || filename.replace(/\.md$/, ""),
-        description: updatedFrontmatter.description || "",
-        tags: updatedFrontmatter.tags || [],
-        metadata: updatedFrontmatter,
-        content: content ?? ""
-      };
-      broadcast({ type: "docs:updated", doc: updatedDoc });
-      res.json(updatedDoc);
-    } catch (error46) {
-      console.error("Error updating doc:", error46);
-      res.status(500).json({ error: String(error46) });
-    }
-  });
-  app.post("/api/docs", async (req, res) => {
-    try {
-      const docsDir = join10(store.projectRoot, ".knowns", "docs");
-      if (!existsSync7(docsDir)) {
+      if (!existsSync8(docsDir)) {
         await mkdir5(docsDir, { recursive: true });
       }
       const data = req.body;
@@ -43459,16 +43586,16 @@ async function startServer(options2) {
       let targetDir;
       if (folder?.trim()) {
         const cleanFolder = folder.trim().replace(/^\/+|\/+$/g, "");
-        targetDir = join10(docsDir, cleanFolder);
-        filepath = join10(targetDir, filename);
+        targetDir = join12(docsDir, cleanFolder);
+        filepath = join12(targetDir, filename);
       } else {
         targetDir = docsDir;
-        filepath = join10(docsDir, filename);
+        filepath = join12(docsDir, filename);
       }
-      if (!existsSync7(targetDir)) {
+      if (!existsSync8(targetDir)) {
         await mkdir5(targetDir, { recursive: true });
       }
-      if (existsSync7(filepath)) {
+      if (existsSync8(filepath)) {
         res.status(409).json({ error: "Document with this title already exists in this folder" });
         return;
       }
@@ -43481,7 +43608,7 @@ async function startServer(options2) {
         tags: tags || []
       };
       const markdown = import_gray_matter3.default.stringify(content || "", frontmatter);
-      await writeFile3(filepath, markdown, "utf-8");
+      await writeFile4(filepath, markdown, "utf-8");
       res.status(201).json({
         success: true,
         filename,
@@ -43494,93 +43621,107 @@ async function startServer(options2) {
       res.status(500).json({ error: String(error46) });
     }
   });
-  app.get("/api/config", async (_req, res) => {
+  router.put("/{*path}", async (req, res) => {
     try {
-      const configPath = join10(store.projectRoot, ".knowns", "config.json");
-      if (!existsSync7(configPath)) {
-        res.json({
-          config: {
-            name: "Knowns",
-            defaultPriority: "medium",
-            defaultLabels: [],
-            timeFormat: "24h",
-            visibleColumns: ["todo", "in-progress", "done"]
-          }
-        });
+      const docPath = Array.isArray(req.params.path) ? req.params.path.join("/") : req.params.path;
+      const fullPath = join12(docsDir, docPath);
+      if (!fullPath.startsWith(docsDir)) {
+        res.status(400).json({ error: "Invalid path" });
         return;
       }
-      const content = await readFile4(configPath, "utf-8");
-      const data = JSON.parse(content);
-      const settings = data.settings || {};
-      const config2 = {
-        name: data.name,
-        id: data.id,
-        createdAt: data.createdAt,
-        ...settings
-      };
-      if (!config2.visibleColumns) {
-        config2.visibleColumns = ["todo", "in-progress", "done"];
-      }
-      res.json({ config: config2 });
-    } catch (error46) {
-      console.error("Error getting config:", error46);
-      res.status(500).json({ error: String(error46) });
-    }
-  });
-  app.post("/api/config", async (req, res) => {
-    try {
-      const config2 = req.body;
-      const configPath = join10(store.projectRoot, ".knowns", "config.json");
-      let existingData = {};
-      if (existsSync7(configPath)) {
-        const content = await readFile4(configPath, "utf-8");
-        existingData = JSON.parse(content);
+      if (!existsSync8(fullPath)) {
+        res.status(404).json({ error: "Document not found" });
+        return;
       }
-      const { name, ...settings } = config2;
-      const merged = {
+      const data = req.body;
+      const { content, title, description, tags } = data;
+      const existingContent = await readFile5(fullPath, "utf-8");
+      const { data: existingData } = (0, import_gray_matter3.default)(existingContent);
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      const updatedFrontmatter = {
         ...existingData,
-        name: name || existingData.name,
-        settings
+        title: title ?? existingData.title,
+        description: description ?? existingData.description,
+        tags: tags ?? existingData.tags,
+        updatedAt: now
       };
-      await writeFile3(configPath, JSON.stringify(merged, null, 2), "utf-8");
-      res.json({ success: true });
+      const newFileContent = import_gray_matter3.default.stringify(content ?? "", updatedFrontmatter);
+      await writeFile4(fullPath, newFileContent, "utf-8");
+      const pathParts = docPath.split("/");
+      const filename = pathParts[pathParts.length - 1];
+      const folder = pathParts.length > 1 ? pathParts.slice(0, -1).join("/") : "";
+      const updatedDoc = {
+        filename,
+        path: docPath,
+        folder,
+        title: updatedFrontmatter.title || filename.replace(/\.md$/, ""),
+        description: updatedFrontmatter.description || "",
+        tags: updatedFrontmatter.tags || [],
+        metadata: updatedFrontmatter,
+        content: content ?? ""
+      };
+      broadcast({ type: "docs:updated", doc: updatedDoc });
+      res.json(updatedDoc);
     } catch (error46) {
-      console.error("Error saving config:", error46);
+      console.error("Error updating doc:", error46);
       res.status(500).json({ error: String(error46) });
     }
   });
-  app.get("/api/activities", async (req, res) => {
+  return router;
+}
+
+// src/server/routes/notify.ts
+var import_express4 = __toESM(require_express2(), 1);
+function createNotifyRoutes(ctx) {
+  const router = (0, import_express4.Router)();
+  const { store, broadcast } = ctx;
+  router.post("/", async (req, res) => {
     try {
-      const limit = Number.parseInt(req.query.limit || "50", 10);
-      const type = req.query.type;
-      const tasks = await store.getAllTasks();
-      const allActivities = [];
-      for (const task of tasks) {
-        const versions = await store.getTaskVersionHistory(task.id);
-        for (const version2 of versions) {
-          if (type) {
-            const hasMatchingChange = version2.changes.some((c) => c.field === type);
-            if (!hasMatchingChange) continue;
-          }
-          allActivities.push({
-            taskId: task.id,
-            taskTitle: task.title,
-            version: version2.version,
-            timestamp: version2.timestamp,
-            author: version2.author,
-            changes: version2.changes
-          });
+      const { taskId, type, docPath } = req.body;
+      if (taskId) {
+        const task = await store.getTask(taskId);
+        if (task) {
+          broadcast({ type: "tasks:updated", task });
+          res.json({ success: true });
+          return;
         }
+      } else if (type === "tasks:refresh") {
+        broadcast({ type: "tasks:refresh" });
+        res.json({ success: true });
+        return;
+      } else if (type === "docs:updated" && docPath) {
+        broadcast({ type: "docs:updated", docPath });
+        res.json({ success: true });
+        return;
+      } else if (type === "docs:refresh") {
+        broadcast({ type: "docs:refresh" });
+        res.json({ success: true });
+        return;
+      } else if (type === "time:updated") {
+        const { active } = req.body;
+        broadcast({ type: "time:updated", active });
+        res.json({ success: true });
+        return;
       }
-      allActivities.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
-      const limited = allActivities.slice(0, limit);
-      res.json({ activities: limited });
+      res.status(400).json({ success: false, error: "Invalid notify request" });
     } catch (error46) {
-      console.error("Error getting activities:", error46);
+      console.error("[Server] Notify error:", error46);
       res.status(500).json({ error: String(error46) });
     }
   });
-  app.get("/api/search", async (req, res) => {
+  return router;
+}
+
+// src/server/routes/search.ts
+var import_express5 = __toESM(require_express2(), 1);
+var import_gray_matter4 = __toESM(require_gray_matter(), 1);
+import { existsSync as existsSync9 } from "node:fs";
+import { readFile as readFile6 } from "node:fs/promises";
+import { join as join13 } from "node:path";
+function createSearchRoutes(ctx) {
+  const router = (0, import_express5.Router)();
+  const { store } = ctx;
+  router.get("/", async (req, res) => {
     try {
       const query = req.query.q;
       if (!query) {
@@ -43601,14 +43742,14 @@ async function startServer(options2) {
         ].join(" ").toLowerCase();
         return searchText.includes(q);
       });
-      const docsDir = join10(store.projectRoot, ".knowns", "docs");
+      const docsDir = join13(store.projectRoot, ".knowns", "docs");
       const docResults = [];
-      if (existsSync7(docsDir)) {
+      if (existsSync9(docsDir)) {
         const mdFiles = await findMarkdownFiles(docsDir, docsDir);
         for (const relativePath of mdFiles) {
-          const fullPath = join10(docsDir, relativePath);
-          const content = await readFile4(fullPath, "utf-8");
-          const { data, content: docContent } = (0, import_gray_matter3.default)(content);
+          const fullPath = join13(docsDir, relativePath);
+          const content = await readFile6(fullPath, "utf-8");
+          const { data, content: docContent } = (0, import_gray_matter4.default)(content);
           const searchText = `${data.title || ""} ${data.description || ""} ${data.tags?.join(" ") || ""} ${docContent}`.toLowerCase();
           if (searchText.includes(q)) {
             const pathParts = relativePath.split("/");
@@ -43630,10 +43771,343 @@ async function startServer(options2) {
       res.status(500).json({ error: String(error46) });
     }
   });
+  return router;
+}
+
+// src/server/routes/tasks.ts
+var import_express6 = __toESM(require_express2(), 1);
+function createTaskRoutes(ctx) {
+  const router = (0, import_express6.Router)();
+  const { store, broadcast } = ctx;
+  router.get("/", async (_req, res) => {
+    try {
+      const tasks = await store.getAllTasks();
+      res.json(tasks);
+    } catch (error46) {
+      console.error("Error getting tasks:", error46);
+      res.status(500).json({ error: String(error46) });
+    }
+  });
+  router.get("/:id/history", async (req, res) => {
+    try {
+      const taskId = req.params.id;
+      const history = await store.getTaskVersionHistory(taskId);
+      res.json({ versions: history });
+    } catch (error46) {
+      console.error("Error getting task history:", error46);
+      res.status(500).json({ error: String(error46) });
+    }
+  });
+  router.get("/:id", async (req, res) => {
+    try {
+      const task = await store.getTask(req.params.id);
+      if (!task) {
+        res.status(404).json({ error: "Task not found" });
+        return;
+      }
+      res.json(task);
+    } catch (error46) {
+      console.error("Error getting task:", error46);
+      res.status(500).json({ error: String(error46) });
+    }
+  });
+  router.post("/", async (req, res) => {
+    try {
+      const data = req.body;
+      const task = await store.createTask(data);
+      broadcast({ type: "tasks:updated", task });
+      res.status(201).json(task);
+    } catch (error46) {
+      console.error("Error creating task:", error46);
+      res.status(500).json({ error: String(error46) });
+    }
+  });
+  router.post("/batch-archive", async (req, res) => {
+    try {
+      const { olderThanMs } = req.body;
+      if (typeof olderThanMs !== "number" || olderThanMs < 0) {
+        res.status(400).json({ error: "olderThanMs must be a positive number" });
+        return;
+      }
+      const archivedTasks = await store.batchArchiveTasks(olderThanMs);
+      broadcast({ type: "tasks:batch-archived", tasks: archivedTasks });
+      res.json({ success: true, count: archivedTasks.length, tasks: archivedTasks });
+    } catch (error46) {
+      console.error("Error batch archiving tasks:", error46);
+      res.status(500).json({ error: String(error46) });
+    }
+  });
+  router.put("/:id", async (req, res) => {
+    try {
+      const updates = req.body;
+      const task = await store.updateTask(req.params.id, updates);
+      broadcast({ type: "tasks:updated", task });
+      res.json(task);
+    } catch (error46) {
+      console.error("Error updating task:", error46);
+      res.status(500).json({ error: String(error46) });
+    }
+  });
+  router.post("/:id/archive", async (req, res) => {
+    try {
+      const task = await store.archiveTask(req.params.id);
+      broadcast({ type: "tasks:archived", task });
+      res.json({ success: true, task });
+    } catch (error46) {
+      console.error("Error archiving task:", error46);
+      res.status(500).json({ error: String(error46) });
+    }
+  });
+  router.post("/:id/unarchive", async (req, res) => {
+    try {
+      const task = await store.unarchiveTask(req.params.id);
+      broadcast({ type: "tasks:unarchived", task });
+      res.json({ success: true, task });
+    } catch (error46) {
+      console.error("Error unarchiving task:", error46);
+      res.status(500).json({ error: String(error46) });
+    }
+  });
+  return router;
+}
+
+// src/server/routes/time.ts
+var import_express7 = __toESM(require_express2(), 1);
+import { existsSync as existsSync10 } from "node:fs";
+import { readFile as readFile7, writeFile as writeFile5 } from "node:fs/promises";
+import { join as join14 } from "node:path";
+function createTimeRoutes(ctx) {
+  const router = (0, import_express7.Router)();
+  const { store, broadcast } = ctx;
+  const timePath = join14(store.projectRoot, ".knowns", "time.json");
+  async function loadTimeData2() {
+    if (!existsSync10(timePath)) {
+      return { active: null };
+    }
+    const content = await readFile7(timePath, "utf-8");
+    return JSON.parse(content);
+  }
+  async function saveTimeData2(data) {
+    await writeFile5(timePath, JSON.stringify(data, null, 2), "utf-8");
+  }
+  router.get("/status", async (_req, res) => {
+    try {
+      const data = await loadTimeData2();
+      if (!data.active) {
+        res.json({ active: null });
+        return;
+      }
+      const task = await store.getTask(data.active.taskId);
+      res.json({
+        active: {
+          ...data.active,
+          taskTitle: task?.title || "Unknown Task"
+        }
+      });
+    } catch (error46) {
+      console.error("Error getting time status:", error46);
+      res.status(500).json({ error: String(error46) });
+    }
+  });
+  router.post("/start", async (req, res) => {
+    try {
+      const { taskId } = req.body;
+      if (!taskId) {
+        res.status(400).json({ error: "taskId is required" });
+        return;
+      }
+      const task = await store.getTask(taskId);
+      if (!task) {
+        res.status(404).json({ error: `Task ${taskId} not found` });
+        return;
+      }
+      const data = await loadTimeData2();
+      if (data.active) {
+        res.status(409).json({
+          error: `Timer already running for task #${data.active.taskId}`,
+          activeTaskId: data.active.taskId
+        });
+        return;
+      }
+      data.active = {
+        taskId,
+        startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        pausedAt: null,
+        totalPausedMs: 0
+      };
+      await saveTimeData2(data);
+      broadcast({ type: "time:updated", active: { ...data.active, taskTitle: task.title } });
+      res.json({
+        success: true,
+        active: { ...data.active, taskTitle: task.title }
+      });
+    } catch (error46) {
+      console.error("Error starting timer:", error46);
+      res.status(500).json({ error: String(error46) });
+    }
+  });
+  router.post("/stop", async (req, res) => {
+    try {
+      const data = await loadTimeData2();
+      if (!data.active) {
+        res.status(400).json({ error: "No active timer" });
+        return;
+      }
+      const { taskId, startedAt, pausedAt, totalPausedMs } = data.active;
+      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 store.getTask(taskId);
+      if (task) {
+        const entry = {
+          id: `te-${Date.now()}`,
+          startedAt: new Date(startedAt),
+          endedAt: endTime,
+          duration: seconds
+        };
+        task.timeEntries.push(entry);
+        task.timeSpent += seconds;
+        await store.updateTask(taskId, {
+          timeEntries: task.timeEntries,
+          timeSpent: task.timeSpent
+        });
+        broadcast({ type: "tasks:updated", task });
+      }
+      data.active = null;
+      await saveTimeData2(data);
+      broadcast({ type: "time:updated", active: null });
+      res.json({
+        success: true,
+        duration: seconds,
+        taskId
+      });
+    } catch (error46) {
+      console.error("Error stopping timer:", error46);
+      res.status(500).json({ error: String(error46) });
+    }
+  });
+  router.post("/pause", async (_req, res) => {
+    try {
+      const data = await loadTimeData2();
+      if (!data.active) {
+        res.status(400).json({ error: "No active timer" });
+        return;
+      }
+      if (data.active.pausedAt) {
+        res.status(400).json({ error: "Timer is already paused" });
+        return;
+      }
+      data.active.pausedAt = (/* @__PURE__ */ new Date()).toISOString();
+      await saveTimeData2(data);
+      const task = await store.getTask(data.active.taskId);
+      broadcast({ type: "time:updated", active: { ...data.active, taskTitle: task?.title } });
+      res.json({
+        success: true,
+        active: { ...data.active, taskTitle: task?.title }
+      });
+    } catch (error46) {
+      console.error("Error pausing timer:", error46);
+      res.status(500).json({ error: String(error46) });
+    }
+  });
+  router.post("/resume", async (_req, res) => {
+    try {
+      const data = await loadTimeData2();
+      if (!data.active) {
+        res.status(400).json({ error: "No active timer" });
+        return;
+      }
+      if (!data.active.pausedAt) {
+        res.status(400).json({ error: "Timer is not paused" });
+        return;
+      }
+      const pausedDuration = Date.now() - new Date(data.active.pausedAt).getTime();
+      data.active.totalPausedMs += pausedDuration;
+      data.active.pausedAt = null;
+      await saveTimeData2(data);
+      const task = await store.getTask(data.active.taskId);
+      broadcast({ type: "time:updated", active: { ...data.active, taskTitle: task?.title } });
+      res.json({
+        success: true,
+        active: { ...data.active, taskTitle: task?.title }
+      });
+    } catch (error46) {
+      console.error("Error resuming timer:", error46);
+      res.status(500).json({ error: String(error46) });
+    }
+  });
+  return router;
+}
+
+// src/server/routes/index.ts
+function createRoutes(ctx) {
+  const router = (0, import_express8.Router)();
+  router.use("/tasks", createTaskRoutes(ctx));
+  router.use("/docs", createDocRoutes(ctx));
+  router.use("/config", createConfigRoutes(ctx));
+  router.use("/search", createSearchRoutes(ctx));
+  router.use("/activities", createActivityRoutes(ctx));
+  router.use("/notify", createNotifyRoutes(ctx));
+  router.use("/time", createTimeRoutes(ctx));
+  return router;
+}
+
+// src/server/index.ts
+var isBun2 = typeof globalThis.Bun !== "undefined";
+async function startServer(options2) {
+  const { port, projectRoot, open } = options2;
+  const store = new FileStore(projectRoot);
+  const clients = /* @__PURE__ */ new Set();
+  const broadcast = (data) => {
+    const msg = JSON.stringify(data);
+    for (const client of clients) {
+      if (client.readyState === 1) {
+        client.send(msg);
+      }
+    }
+  };
+  const currentFile = realpathSync(fileURLToPath(import.meta.url));
+  const currentDir = dirname3(currentFile);
+  let packageRoot = currentDir;
+  const normalizedDir = currentDir.replace(/[/\\]+$/, "");
+  const dirName = basename2(normalizedDir);
+  if (dirName === "dist") {
+    packageRoot = join15(currentDir, "..");
+  } else if (normalizedDir.includes("/src/server") || normalizedDir.includes("\\src\\server")) {
+    packageRoot = join15(currentDir, "..", "..");
+  }
+  const uiDistPath = join15(packageRoot, "dist", "ui");
+  if (!existsSync11(join15(uiDistPath, "index.html"))) {
+    throw new Error(`UI build not found at ${uiDistPath}. Run 'bun run build:ui' first.`);
+  }
+  const app = (0, import_express9.default)();
+  app.use((0, import_cors.default)());
+  app.use(import_express9.default.json());
+  const httpServer = createServer(app);
+  const wss = new import_websocket_server.default({ server: httpServer, path: "/ws" });
+  wss.on("connection", (ws) => {
+    clients.add(ws);
+    ws.on("close", () => {
+      clients.delete(ws);
+    });
+    ws.on("error", (error46) => {
+      console.error("WebSocket error:", error46);
+      clients.delete(ws);
+    });
+  });
+  app.use(
+    "/assets",
+    import_express9.default.static(join15(uiDistPath, "assets"), {
+      maxAge: "1y",
+      immutable: true
+    })
+  );
+  app.use("/api", createRoutes({ store, broadcast }));
+  app.use(errorHandler);
   app.get("/{*path}", (_req, res) => {
-    const indexPath = join10(uiDistPath, "index.html");
-    if (existsSync7(indexPath)) {
-      res.sendFile(indexPath);
+    const indexPath = join15(uiDistPath, "index.html");
+    if (existsSync11(indexPath)) {
+      res.sendFile("index.html", { root: uiDistPath });
     } else {
       res.status(404).send("Not Found");
     }
@@ -43667,41 +44141,26 @@ async function startServer(options2) {
     });
   });
 }
-async function findMarkdownFiles(dir, baseDir) {
-  const files = [];
-  const entries = await readdir4(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    const fullPath = join10(dir, entry.name);
-    if (entry.isDirectory()) {
-      const subFiles = await findMarkdownFiles(fullPath, baseDir);
-      files.push(...subFiles);
-    } else if (entry.isFile() && entry.name.endsWith(".md")) {
-      const relativePath = relative(baseDir, fullPath);
-      files.push(relativePath);
-    }
-  }
-  return files;
-}
 
 // src/commands/browser.ts
 var DEFAULT_PORT2 = 6420;
 var CONFIG_FILE = ".knowns/config.json";
 async function saveServerPort(projectRoot, port) {
-  const configPath = join11(projectRoot, CONFIG_FILE);
-  const knownsDir = join11(projectRoot, ".knowns");
-  if (!existsSync8(knownsDir)) {
+  const configPath = join16(projectRoot, CONFIG_FILE);
+  const knownsDir = join16(projectRoot, ".knowns");
+  if (!existsSync12(knownsDir)) {
     await mkdir6(knownsDir, { recursive: true });
   }
   try {
     let config2 = {};
-    if (existsSync8(configPath)) {
-      const content = await readFile5(configPath, "utf-8");
+    if (existsSync12(configPath)) {
+      const content = await readFile8(configPath, "utf-8");
       config2 = JSON.parse(content);
     }
     const settings = config2.settings || {};
     settings.serverPort = port;
     config2.settings = settings;
-    await writeFile4(configPath, JSON.stringify(config2, null, 2), "utf-8");
+    await writeFile6(configPath, JSON.stringify(config2, null, 2), "utf-8");
   } catch {
   }
 }
@@ -43733,17 +44192,17 @@ var browserCommand = new Command("browser").description("Open web UI for task ma
 });
 
 // src/commands/doc.ts
-import { existsSync as existsSync9 } from "node:fs";
-import { mkdir as mkdir7, readFile as readFile6, readdir as readdir5, writeFile as writeFile5 } from "node:fs/promises";
-import { join as join12 } from "node:path";
-var import_gray_matter4 = __toESM(require_gray_matter(), 1);
-var DOCS_DIR = join12(process.cwd(), ".knowns", "docs");
+import { existsSync as existsSync13 } from "node:fs";
+import { mkdir as mkdir7, readFile as readFile9, readdir as readdir5, writeFile as writeFile7 } from "node:fs/promises";
+import { join as join17 } from "node:path";
+var import_gray_matter5 = __toESM(require_gray_matter(), 1);
+var DOCS_DIR = join17(process.cwd(), ".knowns", "docs");
 async function getAllMdFiles(dir, basePath = "") {
   const files = [];
   const entries = await readdir5(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const fullPath = join12(dir, entry.name);
-    const relativePath = basePath ? join12(basePath, entry.name) : entry.name;
+    const fullPath = join17(dir, entry.name);
+    const relativePath = basePath ? join17(basePath, entry.name) : entry.name;
     if (entry.isDirectory()) {
       const subFiles = await getAllMdFiles(fullPath, relativePath);
       files.push(...subFiles);
@@ -43754,13 +44213,39 @@ async function getAllMdFiles(dir, basePath = "") {
   return files;
 }
 async function ensureDocsDir() {
-  if (!existsSync9(DOCS_DIR)) {
+  if (!existsSync13(DOCS_DIR)) {
     await mkdir7(DOCS_DIR, { recursive: true });
   }
 }
 function titleToFilename(title) {
   return title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
 }
+async function resolveDocPath(name) {
+  await ensureDocsDir();
+  let filename = name.endsWith(".md") ? name : `${name}.md`;
+  let filepath = join17(DOCS_DIR, filename);
+  if (!existsSync13(filepath)) {
+    filename = `${titleToFilename(name)}.md`;
+    filepath = join17(DOCS_DIR, filename);
+  }
+  if (!existsSync13(filepath)) {
+    const allFiles = await getAllMdFiles(DOCS_DIR);
+    const searchName = name.toLowerCase().replace(/\.md$/, "");
+    const matchingFile = allFiles.find((file3) => {
+      const fileNameOnly = file3.toLowerCase().replace(/\.md$/, "");
+      const fileBaseName = file3.split("/").pop()?.toLowerCase().replace(/\.md$/, "");
+      return fileNameOnly === searchName || fileBaseName === searchName || file3 === name;
+    });
+    if (matchingFile) {
+      filename = matchingFile;
+      filepath = join17(DOCS_DIR, matchingFile);
+    }
+  }
+  if (!existsSync13(filepath)) {
+    return null;
+  }
+  return { filepath, filename };
+}
 var createCommand3 = new Command("create").description("Create a new documentation file").argument("<title>", "Document title").option("-d, --description <text>", "Document description").option("-t, --tags <tags>", "Comma-separated tags").option("-f, --folder <path>", "Folder path (e.g., guides, patterns/auth)").option("--plain", "Plain text output for AI").action(async (title, options2) => {
   try {
     await ensureDocsDir();
@@ -43769,14 +44254,14 @@ var createCommand3 = new Command("create").description("Create a new documentati
     let relativePath = filename;
     if (options2.folder) {
       const folderPath = options2.folder.replace(/^\/|\/$/g, "");
-      targetDir = join12(DOCS_DIR, folderPath);
-      relativePath = join12(folderPath, filename);
-      if (!existsSync9(targetDir)) {
+      targetDir = join17(DOCS_DIR, folderPath);
+      relativePath = join17(folderPath, filename);
+      if (!existsSync13(targetDir)) {
         await mkdir7(targetDir, { recursive: true });
       }
     }
-    const filepath = join12(targetDir, filename);
-    if (existsSync9(filepath)) {
+    const filepath = join17(targetDir, filename);
+    if (existsSync13(filepath)) {
       console.error(source_default.red(`\u2717 Document already exists: ${relativePath}`));
       process.exit(1);
     }
@@ -43787,13 +44272,13 @@ var createCommand3 = new Command("create").description("Create a new documentati
       updatedAt: now
     };
     if (options2.description) {
-      metadata.description = options2.description;
+      metadata.description = normalizeRefs(options2.description);
     }
     if (options2.tags) {
       metadata.tags = options2.tags.split(",").map((t) => t.trim());
     }
-    const content = import_gray_matter4.default.stringify("# Content\n\nWrite your documentation here.\n", metadata);
-    await writeFile5(filepath, content, "utf-8");
+    const content = import_gray_matter5.default.stringify("# Content\n\nWrite your documentation here.\n", metadata);
+    await writeFile7(filepath, content, "utf-8");
     await notifyDocUpdate(relativePath);
     if (options2.plain) {
       console.log(`Created: ${relativePath}`);
@@ -43821,8 +44306,8 @@ var listCommand2 = new Command("list").description("List all documentation files
     }
     const docs = [];
     for (const file3 of mdFiles) {
-      const content = await readFile6(join12(DOCS_DIR, file3), "utf-8");
-      const { data } = (0, import_gray_matter4.default)(content);
+      const content = await readFile9(join17(DOCS_DIR, file3), "utf-8");
+      const { data } = (0, import_gray_matter5.default)(content);
       docs.push({
         filename: file3,
         metadata: data
@@ -43880,12 +44365,12 @@ var viewCommand2 = new Command("view").description("View a documentation file").
   try {
     await ensureDocsDir();
     let filename = name.endsWith(".md") ? name : `${name}.md`;
-    let filepath = join12(DOCS_DIR, filename);
-    if (!existsSync9(filepath)) {
+    let filepath = join17(DOCS_DIR, filename);
+    if (!existsSync13(filepath)) {
       filename = `${titleToFilename(name)}.md`;
-      filepath = join12(DOCS_DIR, filename);
+      filepath = join17(DOCS_DIR, filename);
     }
-    if (!existsSync9(filepath)) {
+    if (!existsSync13(filepath)) {
       const allFiles = await getAllMdFiles(DOCS_DIR);
       const searchName = name.toLowerCase().replace(/\.md$/, "");
       const matchingFile = allFiles.find((file3) => {
@@ -43895,15 +44380,15 @@ var viewCommand2 = new Command("view").description("View a documentation file").
       });
       if (matchingFile) {
         filename = matchingFile;
-        filepath = join12(DOCS_DIR, matchingFile);
+        filepath = join17(DOCS_DIR, matchingFile);
       }
     }
-    if (!existsSync9(filepath)) {
+    if (!existsSync13(filepath)) {
       console.error(source_default.red(`\u2717 Documentation not found: ${name}`));
       process.exit(1);
     }
-    const fileContent = await readFile6(filepath, "utf-8");
-    const { data, content } = (0, import_gray_matter4.default)(fileContent);
+    const fileContent = await readFile9(filepath, "utf-8");
+    const { data, content } = (0, import_gray_matter5.default)(fileContent);
     const metadata = data;
     if (options2.plain) {
       const border = "-".repeat(50);
@@ -43989,13 +44474,13 @@ var editCommand2 = new Command("edit").description("Edit a documentation file (m
     try {
       await ensureDocsDir();
       let filename = name.endsWith(".md") ? name : `${name}.md`;
-      let filepath = join12(DOCS_DIR, filename);
-      if (!existsSync9(filepath)) {
+      let filepath = join17(DOCS_DIR, filename);
+      if (!existsSync13(filepath)) {
         const baseName = name.includes("/") ? name : titleToFilename(name);
         filename = baseName.endsWith(".md") ? baseName : `${baseName}.md`;
-        filepath = join12(DOCS_DIR, filename);
+        filepath = join17(DOCS_DIR, filename);
       }
-      if (!existsSync9(filepath)) {
+      if (!existsSync13(filepath)) {
         const allFiles = await getAllMdFiles(DOCS_DIR);
         const searchName = name.toLowerCase().replace(/\.md$/, "");
         const matchingFile = allFiles.find((file3) => {
@@ -44005,31 +44490,31 @@ var editCommand2 = new Command("edit").description("Edit a documentation file (m
         });
         if (matchingFile) {
           filename = matchingFile;
-          filepath = join12(DOCS_DIR, matchingFile);
+          filepath = join17(DOCS_DIR, matchingFile);
         }
       }
-      if (!existsSync9(filepath)) {
+      if (!existsSync13(filepath)) {
         console.error(source_default.red(`\u2717 Documentation not found: ${name}`));
         process.exit(1);
       }
-      const fileContent = await readFile6(filepath, "utf-8");
-      const { data, content } = (0, import_gray_matter4.default)(fileContent);
+      const fileContent = await readFile9(filepath, "utf-8");
+      const { data, content } = (0, import_gray_matter5.default)(fileContent);
       const metadata = data;
       if (options2.title) metadata.title = options2.title;
-      if (options2.description) metadata.description = options2.description;
+      if (options2.description) metadata.description = normalizeRefs(options2.description);
       if (options2.tags) metadata.tags = options2.tags.split(",").map((t) => t.trim());
       metadata.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
       let updatedContent = content;
       if (options2.content) {
-        updatedContent = options2.content;
+        updatedContent = normalizeRefs(options2.content);
       }
       if (options2.append) {
         updatedContent = `${content.trimEnd()}
 
-${options2.append}`;
+${normalizeRefs(options2.append)}`;
       }
-      const newFileContent = import_gray_matter4.default.stringify(updatedContent, metadata);
-      await writeFile5(filepath, newFileContent, "utf-8");
+      const newFileContent = import_gray_matter5.default.stringify(updatedContent, metadata);
+      await writeFile7(filepath, newFileContent, "utf-8");
       await notifyDocUpdate(filename);
       if (options2.plain) {
         console.log(`Updated: ${filename}`);
@@ -44045,12 +44530,109 @@ ${options2.append}`;
     }
   }
 );
-var docCommand = new Command("doc").description("Manage documentation").addCommand(createCommand3).addCommand(listCommand2).addCommand(viewCommand2).addCommand(editCommand2);
+var docCommand = new Command("doc").description("Manage documentation").argument("[name]", "Document name (shorthand for 'doc view <name>')").option("--plain", "Plain text output for AI").action(async (name, options2) => {
+  if (!name) {
+    docCommand.help();
+    return;
+  }
+  try {
+    const resolved = await resolveDocPath(name);
+    if (!resolved) {
+      console.error(source_default.red(`\u2717 Documentation not found: ${name}`));
+      process.exit(1);
+    }
+    const { filepath, filename } = resolved;
+    const fileContent = await readFile9(filepath, "utf-8");
+    const { data, content } = (0, import_gray_matter5.default)(fileContent);
+    const metadata = data;
+    if (options2.plain) {
+      const border = "-".repeat(50);
+      const titleBorder = "=".repeat(50);
+      const projectRoot = process.cwd();
+      console.log(`File: ${projectRoot}/.knowns/docs/${filename}`);
+      console.log();
+      console.log(metadata.title);
+      console.log(titleBorder);
+      console.log();
+      console.log(`Created: ${metadata.createdAt}`);
+      console.log(`Updated: ${metadata.updatedAt}`);
+      if (metadata.tags && metadata.tags.length > 0) {
+        console.log(`Tags: ${metadata.tags.join(", ")}`);
+      }
+      if (metadata.description) {
+        console.log();
+        console.log("Description:");
+        console.log(border);
+        console.log(metadata.description);
+      }
+      console.log();
+      console.log("Content:");
+      console.log(border);
+      const linkPattern = /\[([^\]]+)\]\(([^)]+)\)/g;
+      let enhancedContent = content.trimEnd();
+      const linksToAdd = [];
+      let match;
+      while ((match = linkPattern.exec(content)) !== null) {
+        const _linkText = match[1];
+        const linkTarget = match[2];
+        const fullMatch = match[0];
+        if (linkTarget.startsWith("http://") || linkTarget.startsWith("https://")) {
+          continue;
+        }
+        if (linkTarget.startsWith("../")) {
+          continue;
+        }
+        let resolvedFilename = linkTarget.replace(/^\.\//, "");
+        if (!resolvedFilename.endsWith(".md")) {
+          resolvedFilename = `${resolvedFilename}.md`;
+        }
+        const resolvedPath = `@.knowns/docs/${resolvedFilename}`;
+        linksToAdd.push({
+          original: fullMatch,
+          resolved: resolvedPath
+        });
+      }
+      for (const { original, resolved: resolved2 } of linksToAdd) {
+        enhancedContent = enhancedContent.replace(original, resolved2);
+      }
+      const knownProjectRoot = findProjectRoot();
+      if (knownProjectRoot) {
+        const fileStore = new FileStore(knownProjectRoot);
+        const allTasks = await fileStore.getAllTasks();
+        const taskMap = buildTaskMap(allTasks);
+        enhancedContent = transformMentionsToRefs(enhancedContent, taskMap);
+      }
+      console.log(enhancedContent);
+    } else {
+      console.log(source_default.bold(`
+\u{1F4C4} ${metadata.title}
+`));
+      if (metadata.description) {
+        console.log(source_default.gray(metadata.description));
+        console.log();
+      }
+      if (metadata.tags && metadata.tags.length > 0) {
+        console.log(source_default.gray(`Tags: ${metadata.tags.join(", ")}`));
+      }
+      console.log(source_default.gray(`Updated: ${new Date(metadata.updatedAt).toLocaleString()}`));
+      console.log(source_default.gray("-".repeat(60)));
+      console.log(content);
+      console.log();
+    }
+  } catch (error46) {
+    console.error(source_default.red("Error viewing documentation:"), error46 instanceof Error ? error46.message : String(error46));
+    process.exit(1);
+  }
+});
+docCommand.addCommand(createCommand3);
+docCommand.addCommand(listCommand2);
+docCommand.addCommand(viewCommand2);
+docCommand.addCommand(editCommand2);
 
 // src/commands/config.ts
-import { existsSync as existsSync10 } from "node:fs";
-import { mkdir as mkdir8, readFile as readFile7, writeFile as writeFile6 } from "node:fs/promises";
-import { join as join13 } from "node:path";
+import { existsSync as existsSync14 } from "node:fs";
+import { mkdir as mkdir8, readFile as readFile10, writeFile as writeFile8 } from "node:fs/promises";
+import { join as join18 } from "node:path";
 
 // node_modules/zod/v4/classic/external.js
 var external_exports = {};
@@ -57607,12 +58189,12 @@ function getProjectRoot2() {
   return projectRoot;
 }
 async function loadConfig(projectRoot) {
-  const configPath = join13(projectRoot, CONFIG_FILE2);
-  if (!existsSync10(configPath)) {
+  const configPath = join18(projectRoot, CONFIG_FILE2);
+  if (!existsSync14(configPath)) {
     return { ...DEFAULT_CONFIG };
   }
   try {
-    const content = await readFile7(configPath, "utf-8");
+    const content = await readFile10(configPath, "utf-8");
     const data = JSON.parse(content);
     const settings = data.settings || {};
     const validated = ConfigSchema.parse(settings);
@@ -57626,22 +58208,22 @@ async function loadConfig(projectRoot) {
   }
 }
 async function saveConfig(projectRoot, config2) {
-  const configPath = join13(projectRoot, CONFIG_FILE2);
-  const knownsDir = join13(projectRoot, ".knowns");
-  if (!existsSync10(knownsDir)) {
+  const configPath = join18(projectRoot, CONFIG_FILE2);
+  const knownsDir = join18(projectRoot, ".knowns");
+  if (!existsSync14(knownsDir)) {
     await mkdir8(knownsDir, { recursive: true });
   }
   try {
     let existingData = {};
-    if (existsSync10(configPath)) {
-      const content = await readFile7(configPath, "utf-8");
+    if (existsSync14(configPath)) {
+      const content = await readFile10(configPath, "utf-8");
       existingData = JSON.parse(content);
     }
     const merged = {
       ...existingData,
       settings: config2
     };
-    await writeFile6(configPath, JSON.stringify(merged, null, 2), "utf-8");
+    await writeFile8(configPath, JSON.stringify(merged, null, 2), "utf-8");
   } catch (error46) {
     console.error(source_default.red("\u2717 Failed to save config"));
     if (error46 instanceof Error) {
@@ -57785,7 +58367,7 @@ var configCommand = new Command("config").description("Manage configuration sett
 // package.json
 var package_default = {
   name: "knowns",
-  version: "0.2.0",
+  version: "0.3.0",
   description: "CLI tool for dev teams to manage tasks and documentation",
   module: "index.ts",
   type: "module",
@@ -57810,13 +58392,13 @@ var package_default = {
     url: "https://github.com/knowns-dev/knowns/issues"
   },
   scripts: {
-    dev: "bun run --watch src/index.ts browser --no-open",
+    dev: "npx tsx src/index.ts browser --no-open",
     watch: "nodemon",
     build: "npm run build:cli && npm run build:ui",
     "build:cli": "node scripts/build-cli.js",
     "build:ui": "vite build",
-    start: "bun run src/index.ts",
-    mcp: "bun run src/mcp/server.ts",
+    start: "npx tsx src/index.ts",
+    mcp: "npx tsx src/mcp/server.ts",
     test: "vitest run",
     lint: "biome check .",
     "lint:fix": "biome check --write .",
@@ -57824,15 +58406,25 @@ var package_default = {
     prepare: "husky"
   },
   dependencies: {
+    "@dnd-kit/core": "^6.3.1",
+    "@dnd-kit/sortable": "^10.0.0",
+    "@dnd-kit/utilities": "^3.2.2",
     "@modelcontextprotocol/sdk": "^1.25.1",
+    "@radix-ui/react-checkbox": "^1.3.3",
     "@radix-ui/react-collapsible": "^1.1.12",
     "@radix-ui/react-dialog": "^1.1.15",
+    "@radix-ui/react-dropdown-menu": "^2.1.16",
+    "@radix-ui/react-label": "^2.1.8",
     "@radix-ui/react-navigation-menu": "^1.2.14",
     "@radix-ui/react-popover": "^1.1.15",
+    "@radix-ui/react-progress": "^1.1.8",
     "@radix-ui/react-scroll-area": "^1.2.10",
+    "@radix-ui/react-select": "^2.2.6",
     "@radix-ui/react-separator": "^1.1.8",
     "@radix-ui/react-slot": "^1.2.4",
     "@radix-ui/react-tooltip": "^1.2.8",
+    "@tanstack/react-table": "^8.21.3",
+    "@types/cors": "^2.8.19",
     "@uiw/react-md-editor": "^4.0.11",
     chalk: "^5.3.0",
     "class-variance-authority": "^0.7.1",
@@ -57841,6 +58433,7 @@ var package_default = {
     commander: "^12.1.0",
     cors: "^2.8.5",
     express: "^5.2.1",
+    "framer-motion": "^12.23.26",
     "gray-matter": "^4.0.3",
     "lucide-react": "^0.562.0",
     marked: "^17.0.1",
@@ -57848,7 +58441,9 @@ var package_default = {
     react: "^19.2.3",
     "react-diff-viewer": "^3.1.1",
     "react-dom": "^19.2.3",
+    sonner: "^2.0.7",
     "tailwind-merge": "^3.4.0",
+    "tunnel-rat": "^0.1.2",
     turndown: "^7.2.2",
     "unist-util-visit": "^5.0.0",
     ws: "^8.18.3",
@@ -57864,6 +58459,7 @@ var package_default = {
     "@types/react-dom": "^19.2.3",
     "@types/ws": "^8.18.1",
     "@vitejs/plugin-react": "^5.1.2",
+    "@vitest/coverage-v8": "^4.0.16",
     autoprefixer: "^10.4.23",
     concurrently: "^9.2.1",
     esbuild: "^0.27.2",