knowns 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.2] - 2024-12-26
+
+### Added
+- New `src/constants/knowns-guidelines.ts` file containing system prompt as TypeScript constant
+- Auto-sync of Knowns guidelines to AI instruction files during `knowns init`
+- Third step in "Next steps" output: "Update AI instructions: knowns agents --update-instructions"
+
+### Changed
+- Refactored `agents` command to use bundled constant instead of reading from CLAUDE.md
+- CLAUDE.md is now a target file (not source) - gets updated like other AI instruction files
+- Exported `updateInstructionFile()` and `INSTRUCTION_FILES` from agents.ts for reusability
+- System prompt now bundled into binary, eliminating file I/O during sync
+
+### Improved
+- Faster agent instruction updates (no file reads required)
+- More reliable init process - new projects get AI instructions automatically
+- Simplified architecture: single source of truth for guidelines in codebase
+
 ## [0.1.1] - 2024-12-26
 
 ### Added
@@ -51,5 +69,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - CLAUDE.md with complete guidelines for AI agents
 - Example workflows and patterns
 
+[0.1.2]: https://github.com/knowns-dev/knowns/compare/v0.1.1...v0.1.2
 [0.1.1]: https://github.com/knowns-dev/knowns/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/knowns-dev/knowns/releases/tag/v0.1.0

package/dist/index.js

@@ -5341,8 +5341,8 @@ var require_commander = __commonJS((exports) => {
 });
 
 // src/commands/init.ts
-import { existsSync } from "fs";
-import { join as join3 } from "path";
+import { existsSync as existsSync2 } from "fs";
+import { join as join4 } from "path";
 
 // src/storage/file-store.ts
 import { mkdir as mkdir2, readdir } from "fs/promises";
@@ -6506,12 +6506,381 @@ var {
   Help
 } = import__.default;
 
+// src/constants/knowns-guidelines.ts
+var KNOWNS_GUIDELINES = `<!-- KNOWNS GUIDELINES START -->
+# Knowns CLI Guidelines
+
+## Core Principle
+
+**NEVER edit .md files directly. ALL operations MUST use CLI commands.**
+
+---
+
+## Project Structure
+
+\`\`\`
+.knowns/
+\u251C\u2500\u2500 tasks/              # Task files: task-<id> - <title>.md
+\u251C\u2500\u2500 docs/               # Documentation (supports nested folders)
+\u2514\u2500\u2500 decisions/          # Architecture decision records
+\`\`\`
+
+---
+
+## Task Management
+
+### Task Lifecycle
+
+1. **Create** \u2192 \`knowns task create "Title" -d "Description" --ac "Criterion 1" --ac "Criterion 2"\`
+2. **Start** \u2192 \`knowns task edit <id> -s "In Progress" -a @yourself\`
+3. **Work** \u2192 Check acceptance criteria as you complete them
+4. **Complete** \u2192 Mark status as Done after all criteria met
+
+### Critical Commands
+
+\`\`\`bash
+# View task (always use --plain for AI)
+knowns task view <id> --plain
+
+# List tasks
+knowns task list --plain
+knowns task list -s "In Progress" --plain
+
+# Search tasks/docs
+knowns search "query" --plain
+knowns search "query" --type task --plain
+
+# Edit task
+knowns task edit <id> -s "In Progress" -a @agent
+knowns task edit <id> -t "New Title"
+knowns task edit <id> -d "Description"
+
+# Acceptance criteria
+knowns task edit <id> --ac "New criterion"
+knowns task edit <id> --check-ac 1
+knowns task edit <id> --check-ac 1 --check-ac 2 --check-ac 3
+knowns task edit <id> --uncheck-ac 2
+knowns task edit <id> --remove-ac 3
+
+# Implementation
+knowns task edit <id> --plan $'1. Step one\\n2. Step two'
+knowns task edit <id> --notes "Implementation summary"
+knowns task edit <id> --append-notes $'Additional note\\nAnother line'
+\`\`\`
+
+### Multi-line Input (Shell-specific)
+
+**Bash/Zsh** - Use \`$'...\\n...'\`:
+\`\`\`bash
+knowns task edit 42 --desc $'Line 1\\nLine 2\\n\\nLine 3'
+knowns task edit 42 --plan $'1. First\\n2. Second'
+knowns task edit 42 --notes $'Done A\\nDoing B'
+\`\`\`
+
+**PowerShell** - Use backtick-n:
+\`\`\`powershell
+knowns task edit 42 --notes "Line1\`nLine2"
+\`\`\`
+
+**Portable** - Use printf:
+\`\`\`bash
+knowns task edit 42 --notes "$(printf 'Line1\\nLine2')"
+\`\`\`
+
+---
+
+## Task Workflow
+
+### Step 1: Take Task
+\`\`\`bash
+knowns task edit <id> -s "In Progress" -a @yourself
+\`\`\`
+
+### Step 2: Create Plan
+\`\`\`bash
+knowns task edit <id> --plan $'1. Research\\n2. Implement\\n3. Test'
+\`\`\`
+
+**IMPORTANT**: Share plan with user and wait for approval before coding.
+
+### Step 3: Implementation
+Write code, then check acceptance criteria:
+\`\`\`bash
+knowns task edit <id> --check-ac 1 --check-ac 2 --check-ac 3
+\`\`\`
+
+### Step 4: Add Notes (PR Description)
+\`\`\`bash
+knowns task edit <id> --notes $'Implemented using X pattern\\nUpdated tests\\nReady for review'
+\`\`\`
+
+Or append progressively:
+\`\`\`bash
+knowns task edit <id> --append-notes "Completed feature X"
+knowns task edit <id> --append-notes "Added tests"
+\`\`\`
+
+### Step 5: Complete
+\`\`\`bash
+knowns task edit <id> -s Done
+\`\`\`
+
+---
+
+## Definition of Done
+
+Task is Done ONLY when ALL items are complete:
+
+**Via CLI:**
+1. All acceptance criteria checked: \`--check-ac <index>\`
+2. Implementation notes added: \`--notes "..."\`
+3. Status set to Done: \`-s Done\`
+
+**Via Code:**
+4. Tests pass
+5. Documentation updated
+6. Code reviewed
+7. No regressions
+
+---
+
+## Documentation Management
+
+### Commands
+
+\`\`\`bash
+# List all docs (includes nested folders)
+knowns doc list --plain
+
+# View document
+knowns doc view <name> --plain
+knowns doc view patterns/guards --plain
+knowns doc view patterns/guards.md --plain
+
+# Create document
+knowns doc create "Title" -d "Description" -t "tag1,tag2"
+
+# Edit metadata
+knowns doc edit <name> -t "New Title" -d "New Description"
+\`\`\`
+
+### Document Links
+
+In \`--plain\` mode, markdown links are replaced with resolved paths:
+- \`[guards.md](./patterns/guards.md)\` \u2192 \`@.knowns/docs/patterns/guards.md\`
+
+---
+
+## Task Structure
+
+### Title
+Brief, clear summary of the task.
+
+### Description
+Explains WHY and WHAT (not HOW). Provides context.
+
+### Acceptance Criteria
+**Outcome-oriented**, testable, user-focused criteria.
+
+Good:
+- "User can login with valid credentials"
+- "System processes 1000 requests/sec without errors"
+
+Bad:
+- "Add function handleLogin() in auth.ts" (implementation detail)
+
+### Implementation Plan (added during work)
+**HOW** to solve the task. Added AFTER taking the task, BEFORE coding.
+
+### Implementation Notes (PR description)
+Summary of what was done, suitable for PR. Added AFTER completion.
+
+---
+
+## Common Mistakes
+
+| Wrong | Right |
+|-------|-------|
+| Edit .md files directly | Use \`knowns task edit\` |
+| Change \`- [ ]\` to \`- [x]\` in file | Use \`--check-ac <index>\` |
+| Add plan during creation | Add plan when starting work |
+| Mark Done without all criteria | Check ALL criteria first |
+
+---
+
+## Search
+
+\`\`\`bash
+# Search everything
+knowns search "auth" --plain
+
+# Search tasks only
+knowns search "login" --type task --plain
+
+# Search with filters
+knowns search "api" --status "In Progress" --plain
+knowns search "bug" --priority high --plain
+\`\`\`
+
+---
+
+## Required Patterns
+
+### When Starting Task
+\`\`\`bash
+# Step 1: Assign and set in progress
+knowns task edit <id> -s "In Progress" -a @yourself
+
+# Step 2: Add implementation plan
+knowns task edit <id> --plan $'1. Research codebase\\n2. Implement\\n3. Test'
+
+# Step 3: Share plan with user, WAIT for approval
+# Step 4: Start coding only after approval
+\`\`\`
+
+### When Completing Task
+\`\`\`bash
+# Step 1: Check all acceptance criteria
+knowns task edit <id> --check-ac 1 --check-ac 2 --check-ac 3
+
+# Step 2: Add implementation notes (PR description)
+knowns task edit <id> --notes $'Summary of changes\\nTesting approach\\nFollow-up needed'
+
+# Step 3: Mark as done
+knowns task edit <id> -s Done
+\`\`\`
+
+### Only Implement What's In Acceptance Criteria
+If you need to do more:
+1. Update AC first: \`knowns task edit <id> --ac "New requirement"\`
+2. Or create new task: \`knowns task create "Additional feature"\`
+
+---
+
+## Tips
+
+- Always use \`--plain\` flag for AI-readable output
+- AC flags accept multiple values: \`--check-ac 1 --check-ac 2\`
+- Mixed operations work: \`--check-ac 1 --uncheck-ac 2 --remove-ac 3\`
+- Use \`$'...\\n...'\` for multi-line input in Bash/Zsh
+- Related docs show as \`@.knowns/docs/path/to/file.md\` in plain mode
+
+---
+
+## Full Help
+
+\`\`\`bash
+knowns --help
+knowns task --help
+knowns doc --help
+knowns search --help
+\`\`\`
+<!-- KNOWNS GUIDELINES END -->
+`;
+
+// src/commands/agents.ts
+import { existsSync } from "fs";
+import { mkdir as mkdir3, readFile, writeFile } from "fs/promises";
+import { dirname, join as join3 } from "path";
+var PROJECT_ROOT = process.cwd();
+var INSTRUCTION_FILES = [
+  { path: "CLAUDE.md", name: "Claude Code" },
+  { path: "AGENTS.md", name: "Agent SDK" },
+  { path: "GEMINI.md", name: "Gemini" },
+  { path: ".github/copilot-instructions.md", name: "GitHub Copilot" }
+];
+async function updateInstructionFile(filePath, guidelines) {
+  const fullPath = join3(PROJECT_ROOT, filePath);
+  const startMarker = "<!-- KNOWNS GUIDELINES START -->";
+  const endMarker = "<!-- KNOWNS GUIDELINES END -->";
+  const dir = dirname(fullPath);
+  if (!existsSync(dir)) {
+    await mkdir3(dir, { recursive: true });
+  }
+  if (!existsSync(fullPath)) {
+    await writeFile(fullPath, guidelines, "utf-8");
+    return { success: true, action: "created" };
+  }
+  const content = await readFile(fullPath, "utf-8");
+  const startIndex = content.indexOf(startMarker);
+  const endIndex = content.indexOf(endMarker);
+  if (startIndex === -1 || endIndex === -1) {
+    const newContent2 = `${content.trimEnd()}
+
+${guidelines}
+`;
+    await writeFile(fullPath, newContent2, "utf-8");
+    return { success: true, action: "appended" };
+  }
+  const before = content.substring(0, startIndex);
+  const after = content.substring(endIndex + endMarker.length);
+  const newContent = before + guidelines + after;
+  await writeFile(fullPath, newContent, "utf-8");
+  return { success: true, action: "updated" };
+}
+var updateInstructionsCommand = new Command("agents").description("Manage agent instruction files").option("--update-instructions", "Update agent instruction files").action(async (options2) => {
+  if (!options2.updateInstructions) {
+    console.log(source_default.yellow("No action specified. Use --update-instructions to update files."));
+    console.log(source_default.gray(`
+Example: knowns agents --update-instructions`));
+    return;
+  }
+  try {
+    console.log(source_default.bold(`
+Updating agent instruction files...
+`));
+    let createdCount = 0;
+    let appendedCount = 0;
+    let updatedCount = 0;
+    let errorCount = 0;
+    for (const file of INSTRUCTION_FILES) {
+      try {
+        const result = await updateInstructionFile(file.path, KNOWNS_GUIDELINES);
+        if (result.success) {
+          if (result.action === "created") {
+            createdCount++;
+            console.log(source_default.green(`\u2713 Created ${file.name}: ${file.path}`));
+          } else if (result.action === "appended") {
+            appendedCount++;
+            console.log(source_default.cyan(`\u2713 Appended ${file.name}: ${file.path}`));
+          } else {
+            updatedCount++;
+            console.log(source_default.green(`\u2713 Updated ${file.name}: ${file.path}`));
+          }
+        }
+      } catch (error) {
+        errorCount++;
+        console.error(source_default.red(`\u2717 Failed ${file.name}: ${file.path}`), error instanceof Error ? error.message : String(error));
+      }
+    }
+    console.log(source_default.bold(`
+Summary:`));
+    if (createdCount > 0) {
+      console.log(source_default.green(`  Created: ${createdCount}`));
+    }
+    if (appendedCount > 0) {
+      console.log(source_default.cyan(`  Appended: ${appendedCount}`));
+    }
+    if (updatedCount > 0) {
+      console.log(source_default.green(`  Updated: ${updatedCount}`));
+    }
+    if (errorCount > 0) {
+      console.log(source_default.red(`  Failed: ${errorCount}`));
+    }
+    console.log();
+  } catch (error) {
+    console.error(source_default.red("Error updating instruction files:"), error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  }
+});
+var agentsCommand = updateInstructionsCommand;
+
 // src/commands/init.ts
 var initCommand = new Command("init").description("Initialize .knowns/ folder in current directory").argument("[name]", "Project name", "My Project").action(async (name) => {
   try {
     const projectRoot = process.cwd();
-    const knownsPath = join3(projectRoot, ".knowns");
-    if (existsSync(knownsPath)) {
+    const knownsPath = join4(projectRoot, ".knowns");
+    if (existsSync2(knownsPath)) {
       console.log(source_default.yellow("\u26A0\uFE0F  Project already initialized"));
       console.log(source_default.gray(`   Location: ${knownsPath}`));
       return;
@@ -6522,9 +6891,28 @@ var initCommand = new Command("init").description("Initialize .knowns/ folder in
     console.log(source_default.gray(`  Name: ${project.name}`));
     console.log(source_default.gray(`  Location: ${knownsPath}`));
     console.log();
+    console.log(source_default.bold("Updating AI instruction files..."));
+    console.log();
+    let syncedCount = 0;
+    for (const file of INSTRUCTION_FILES) {
+      try {
+        const result = await updateInstructionFile(file.path, KNOWNS_GUIDELINES);
+        if (result.success) {
+          syncedCount++;
+          const action = result.action === "created" ? "Created" : result.action === "appended" ? "Appended" : "Updated";
+          console.log(source_default.green(`\u2713 ${action} ${file.name}: ${file.path}`));
+        }
+      } catch (error) {
+        console.log(source_default.yellow(`\u26A0\uFE0F  Skipped ${file.name}: ${file.path}`));
+      }
+    }
+    console.log();
+    console.log(source_default.green(`\u2713 Synced guidelines to ${syncedCount} AI instruction file(s)`));
+    console.log();
     console.log(source_default.cyan("Next steps:"));
     console.log(source_default.gray('  1. Create a task: knowns task create "My first task"'));
     console.log(source_default.gray("  2. List tasks: knowns task list"));
+    console.log(source_default.gray("  3. Update AI instructions: knowns agents --update-instructions"));
   } catch (error) {
     console.error(source_default.red("\u2717 Failed to initialize project"));
     if (error instanceof Error) {
@@ -6534,12 +6922,12 @@ var initCommand = new Command("init").description("Initialize .knowns/ folder in
   }
 });
 // src/commands/task.ts
-import { mkdir as mkdir3, readdir as readdir2, unlink } from "fs/promises";
-import { join as join6 } from "path";
+import { mkdir as mkdir4, readdir as readdir2, unlink } from "fs/promises";
+import { join as join7 } from "path";
 
 // src/utils/doc-links.ts
-import { existsSync as existsSync2 } from "fs";
-import { join as join4 } from "path";
+import { existsSync as existsSync3 } from "fs";
+import { join as join5 } from "path";
 function parseMarkdownLinks(text) {
   const linkPattern = /\[([^\]]+)\]\(([^)]+)\)/g;
   const links = [];
@@ -6555,7 +6943,7 @@ function parseMarkdownLinks(text) {
 function resolveDocReferences(content, projectRoot) {
   const links = parseMarkdownLinks(content);
   const docReferences = [];
-  const docsDir = join4(projectRoot, ".knowns", "docs");
+  const docsDir = join5(projectRoot, ".knowns", "docs");
   for (const link of links) {
     if (link.target.startsWith("http://") || link.target.startsWith("https://")) {
       continue;
@@ -6568,8 +6956,8 @@ function resolveDocReferences(content, projectRoot) {
     if (!filename.endsWith(".md")) {
       filename = `${filename}.md`;
     }
-    const resolvedPath = join4(docsDir, filename);
-    const exists = existsSync2(resolvedPath);
+    const resolvedPath = join5(docsDir, filename);
+    const exists = existsSync3(resolvedPath);
     docReferences.push({
       text: link.text,
       filename: link.target,
@@ -6599,16 +6987,16 @@ function formatDocReferences(references, options2 = {}) {
 }
 
 // src/utils/find-project-root.ts
-import { existsSync as existsSync3 } from "fs";
-import { dirname, join as join5 } from "path";
+import { existsSync as existsSync4 } from "fs";
+import { dirname as dirname2, join as join6 } from "path";
 function findProjectRoot(startPath = process.cwd()) {
   let currentPath = startPath;
   for (let i = 0;i < 20; i++) {
-    const knownsPath = join5(currentPath, ".knowns");
-    if (existsSync3(knownsPath)) {
+    const knownsPath = join6(currentPath, ".knowns");
+    if (existsSync4(knownsPath)) {
       return currentPath;
     }
-    const parentPath = dirname(currentPath);
+    const parentPath = dirname2(currentPath);
     if (parentPath === currentPath) {
       return null;
     }
@@ -7223,17 +7611,17 @@ var archiveCommand = new Command("archive").description("Archive a task").argume
       console.error(source_default.red(`\u2717 Task ${id} not found`));
       process.exit(1);
     }
-    const archiveDir = join6(projectRoot, ".knowns", "archive");
-    await mkdir3(archiveDir, { recursive: true });
-    const tasksPath = join6(projectRoot, ".knowns", "tasks");
+    const archiveDir = join7(projectRoot, ".knowns", "archive");
+    await mkdir4(archiveDir, { recursive: true });
+    const tasksPath = join7(projectRoot, ".knowns", "tasks");
     const files = await readdir2(tasksPath);
     const taskFile = files.find((f) => f.startsWith(`task-${id} -`));
     if (!taskFile) {
       console.error(source_default.red(`\u2717 Task file for ${id} not found`));
       process.exit(1);
     }
-    const oldPath = join6(tasksPath, taskFile);
-    const newPath = join6(archiveDir, taskFile);
+    const oldPath = join7(tasksPath, taskFile);
+    const newPath = join7(archiveDir, taskFile);
     const content = await Bun.file(oldPath).text();
     await Bun.write(newPath, content);
     await unlink(oldPath);
@@ -7254,16 +7642,16 @@ var unarchiveCommand = new Command("unarchive").description("Restore archived ta
       console.error(source_default.gray('  Run "knowns init" to initialize'));
       process.exit(1);
     }
-    const archiveDir = join6(projectRoot, ".knowns", "archive");
-    const tasksPath = join6(projectRoot, ".knowns", "tasks");
+    const archiveDir = join7(projectRoot, ".knowns", "archive");
+    const tasksPath = join7(projectRoot, ".knowns", "tasks");
     const files = await readdir2(archiveDir);
     const taskFile = files.find((f) => f.startsWith(`task-${id} -`));
     if (!taskFile) {
       console.error(source_default.red(`\u2717 Archived task ${id} not found`));
       process.exit(1);
     }
-    const archivePath = join6(archiveDir, taskFile);
-    const tasksFilePath = join6(tasksPath, taskFile);
+    const archivePath = join7(archiveDir, taskFile);
+    const tasksFilePath = join7(tasksPath, taskFile);
     const content = await Bun.file(archivePath).text();
     await Bun.write(tasksFilePath, content);
     await unlink(archivePath);
@@ -7854,9 +8242,9 @@ var boardCommand = new Command("board").description("Display Kanban board").opti
   }
 });
 // src/commands/search.ts
-import { existsSync as existsSync4 } from "fs";
-import { readFile, readdir as readdir3 } from "fs/promises";
-import { join as join7 } from "path";
+import { existsSync as existsSync5 } from "fs";
+import { readFile as readFile2, readdir as readdir3 } from "fs/promises";
+import { join as join8 } from "path";
 var import_gray_matter2 = __toESM(require_gray_matter(), 1);
 function getFileStore3() {
   const projectRoot = findProjectRoot();
@@ -7908,8 +8296,8 @@ function calculateDocScore(doc, query) {
   return score;
 }
 async function searchDocs(query, projectRoot) {
-  const docsDir = join7(projectRoot, ".knowns", "docs");
-  if (!existsSync4(docsDir)) {
+  const docsDir = join8(projectRoot, ".knowns", "docs");
+  if (!existsSync5(docsDir)) {
     return [];
   }
   try {
@@ -7917,7 +8305,7 @@ async function searchDocs(query, projectRoot) {
     const mdFiles = files.filter((f) => f.endsWith(".md"));
     const results = [];
     for (const file of mdFiles) {
-      const content = await readFile(join7(docsDir, file), "utf-8");
+      const content = await readFile2(join8(docsDir, file), "utf-8");
       const { data, content: docContent } = import_gray_matter2.default(content);
       const metadata = data;
       const doc = {
@@ -8500,9 +8888,9 @@ timeCommand.addCommand(addCommand);
 timeCommand.addCommand(reportCommand);
 // src/server/index.ts
 import { watch } from "fs";
-import { existsSync as existsSync5 } from "fs";
-import { mkdir as mkdir4, readFile as readFile2, readdir as readdir4, writeFile } from "fs/promises";
-import { join as join8, relative } from "path";
+import { existsSync as existsSync6 } from "fs";
+import { mkdir as mkdir5, readFile as readFile3, readdir as readdir4, writeFile as writeFile2 } from "fs/promises";
+import { join as join9, relative } from "path";
 var import_gray_matter3 = __toESM(require_gray_matter(), 1);
 var buildVersion = Date.now();
 async function startServer(options2) {
@@ -8515,9 +8903,9 @@ async function startServer(options2) {
       client.send(msg);
     }
   };
-  const uiPath = join8(projectRoot, "src", "ui");
-  const entrypoint = join8(uiPath, "index.html");
-  const buildDir = join8(projectRoot, ".knowns", "ui-build");
+  const uiPath = join9(projectRoot, "src", "ui");
+  const entrypoint = join9(uiPath, "index.html");
+  const buildDir = join9(projectRoot, ".knowns", "ui-build");
   const entryFile = Bun.file(entrypoint);
   if (!await entryFile.exists()) {
     throw new Error(`UI entry point not found: ${entrypoint}`);
@@ -8526,7 +8914,7 @@ async function startServer(options2) {
     console.log("Building UI...");
     const startTime = Date.now();
     const buildResult = await Bun.build({
-      entrypoints: [join8(uiPath, "main.tsx")],
+      entrypoints: [join9(uiPath, "main.tsx")],
       outdir: buildDir,
       target: "browser",
       minify: false,
@@ -8540,7 +8928,7 @@ async function startServer(options2) {
       return false;
     }
     const cssResult = await Bun.build({
-      entrypoints: [join8(uiPath, "index.css")],
+      entrypoints: [join9(uiPath, "index.css")],
       outdir: buildDir,
       target: "browser",
       minify: false
@@ -8594,7 +8982,7 @@ async function startServer(options2) {
         return handleAPI(req, url, store, broadcast);
       }
       if (url.pathname === "/main.js" || url.pathname.startsWith("/main.js?")) {
-        const file = Bun.file(join8(buildDir, "main.js"));
+        const file = Bun.file(join9(buildDir, "main.js"));
         if (await file.exists()) {
           return new Response(file, {
             headers: {
@@ -8605,7 +8993,7 @@ async function startServer(options2) {
         }
       }
       if (url.pathname === "/index.css" || url.pathname.startsWith("/index.css?")) {
-        const file = Bun.file(join8(buildDir, "index.css"));
+        const file = Bun.file(join9(buildDir, "index.css"));
         if (await file.exists()) {
           return new Response(file, {
             headers: {
@@ -8708,7 +9096,7 @@ async function findMarkdownFiles(dir, baseDir) {
   const files = [];
   const entries = await readdir4(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const fullPath = join8(dir, entry.name);
+    const fullPath = join9(dir, entry.name);
     if (entry.isDirectory()) {
       const subFiles = await findMarkdownFiles(fullPath, baseDir);
       files.push(...subFiles);
@@ -8761,14 +9149,14 @@ async function handleAPI(req, url, store, broadcast) {
       });
     }
     if (url.pathname === "/api/docs" && req.method === "GET") {
-      const docsDir = join8(store.projectRoot, ".knowns", "docs");
-      if (!existsSync5(docsDir)) {
+      const docsDir = join9(store.projectRoot, ".knowns", "docs");
+      if (!existsSync6(docsDir)) {
         return new Response(JSON.stringify({ docs: [] }), { headers });
       }
       const mdFiles = await findMarkdownFiles(docsDir, docsDir);
       const docs = await Promise.all(mdFiles.map(async (relativePath) => {
-        const fullPath = join8(docsDir, relativePath);
-        const content = await readFile2(fullPath, "utf-8");
+        const fullPath = join9(docsDir, relativePath);
+        const content = await readFile3(fullPath, "utf-8");
         const { data, content: docContent } = import_gray_matter3.default(content);
         const pathParts = relativePath.split("/");
         const filename = pathParts[pathParts.length - 1];
@@ -8784,9 +9172,9 @@ async function handleAPI(req, url, store, broadcast) {
       return new Response(JSON.stringify({ docs }), { headers });
     }
     if (url.pathname === "/api/docs" && req.method === "POST") {
-      const docsDir = join8(store.projectRoot, ".knowns", "docs");
-      if (!existsSync5(docsDir)) {
-        await mkdir4(docsDir, { recursive: true });
+      const docsDir = join9(store.projectRoot, ".knowns", "docs");
+      if (!existsSync6(docsDir)) {
+        await mkdir5(docsDir, { recursive: true });
       }
       const data = await req.json();
       const { title, description, tags, content, folder } = data;
@@ -8801,16 +9189,16 @@ async function handleAPI(req, url, store, broadcast) {
       let targetDir;
       if (folder?.trim()) {
         const cleanFolder = folder.trim().replace(/^\/+|\/+$/g, "");
-        targetDir = join8(docsDir, cleanFolder);
-        filepath = join8(targetDir, filename);
+        targetDir = join9(docsDir, cleanFolder);
+        filepath = join9(targetDir, filename);
       } else {
         targetDir = docsDir;
-        filepath = join8(docsDir, filename);
+        filepath = join9(docsDir, filename);
       }
-      if (!existsSync5(targetDir)) {
-        await mkdir4(targetDir, { recursive: true });
+      if (!existsSync6(targetDir)) {
+        await mkdir5(targetDir, { recursive: true });
       }
-      if (existsSync5(filepath)) {
+      if (existsSync6(filepath)) {
         return new Response(JSON.stringify({ error: "Document with this title already exists in this folder" }), {
           status: 409,
           headers
@@ -8825,7 +9213,7 @@ async function handleAPI(req, url, store, broadcast) {
         tags: tags || []
       };
       const markdown = import_gray_matter3.default.stringify(content || "", frontmatter);
-      await writeFile(filepath, markdown, "utf-8");
+      await writeFile2(filepath, markdown, "utf-8");
       return new Response(JSON.stringify({
         success: true,
         filename,
@@ -8835,8 +9223,8 @@ async function handleAPI(req, url, store, broadcast) {
       }), { status: 201, headers });
     }
     if (url.pathname === "/api/config" && req.method === "GET") {
-      const configPath = join8(store.projectRoot, ".knowns", "config.json");
-      if (!existsSync5(configPath)) {
+      const configPath = join9(store.projectRoot, ".knowns", "config.json");
+      if (!existsSync6(configPath)) {
         return new Response(JSON.stringify({
           config: {
             defaultPriority: "medium",
@@ -8846,7 +9234,7 @@ async function handleAPI(req, url, store, broadcast) {
           }
         }), { headers });
       }
-      const content = await readFile2(configPath, "utf-8");
+      const content = await readFile3(configPath, "utf-8");
       const config = JSON.parse(content);
       if (!config.visibleColumns) {
         config.visibleColumns = ["todo", "in-progress", "done"];
@@ -8855,8 +9243,8 @@ async function handleAPI(req, url, store, broadcast) {
     }
     if (url.pathname === "/api/config" && req.method === "POST") {
       const config = await req.json();
-      const configPath = join8(store.projectRoot, ".knowns", "config.json");
-      await writeFile(configPath, JSON.stringify(config, null, 2), "utf-8");
+      const configPath = join9(store.projectRoot, ".knowns", "config.json");
+      await writeFile2(configPath, JSON.stringify(config, null, 2), "utf-8");
       return new Response(JSON.stringify({ success: true }), { headers });
     }
     if (url.pathname === "/api/search" && req.method === "GET") {
@@ -8878,13 +9266,13 @@ async function handleAPI(req, url, store, broadcast) {
         ].join(" ").toLowerCase();
         return searchText.includes(q);
       });
-      const docsDir = join8(store.projectRoot, ".knowns", "docs");
+      const docsDir = join9(store.projectRoot, ".knowns", "docs");
       const docResults = [];
-      if (existsSync5(docsDir)) {
+      if (existsSync6(docsDir)) {
         const files = await readdir4(docsDir);
         const mdFiles = files.filter((f) => f.endsWith(".md"));
         for (const file of mdFiles) {
-          const content = await readFile2(join8(docsDir, file), "utf-8");
+          const content = await readFile3(join9(docsDir, file), "utf-8");
           const { data, content: docContent } = import_gray_matter3.default(content);
           const searchText = `${data.title || ""} ${data.description || ""} ${data.tags?.join(" ") || ""} ${docContent}`.toLowerCase();
           if (searchText.includes(q)) {
@@ -8936,17 +9324,17 @@ var browserCommand = new Command("browser").description("Open web UI for task ma
   }
 });
 // src/commands/doc.ts
-import { existsSync as existsSync6 } from "fs";
-import { mkdir as mkdir5, readFile as readFile3, readdir as readdir5, writeFile as writeFile2 } from "fs/promises";
-import { join as join9 } from "path";
+import { existsSync as existsSync7 } from "fs";
+import { mkdir as mkdir6, readFile as readFile4, readdir as readdir5, writeFile as writeFile3 } from "fs/promises";
+import { join as join10 } from "path";
 var import_gray_matter4 = __toESM(require_gray_matter(), 1);
-var DOCS_DIR = join9(process.cwd(), ".knowns", "docs");
+var DOCS_DIR = join10(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 = join9(dir, entry.name);
-    const relativePath = basePath ? join9(basePath, entry.name) : entry.name;
+    const fullPath = join10(dir, entry.name);
+    const relativePath = basePath ? join10(basePath, entry.name) : entry.name;
     if (entry.isDirectory()) {
       const subFiles = await getAllMdFiles(fullPath, relativePath);
       files.push(...subFiles);
@@ -8957,8 +9345,8 @@ async function getAllMdFiles(dir, basePath = "") {
   return files;
 }
 async function ensureDocsDir() {
-  if (!existsSync6(DOCS_DIR)) {
-    await mkdir5(DOCS_DIR, { recursive: true });
+  if (!existsSync7(DOCS_DIR)) {
+    await mkdir6(DOCS_DIR, { recursive: true });
   }
 }
 function titleToFilename(title) {
@@ -8968,8 +9356,8 @@ var createCommand3 = new Command("create").description("Create a new documentati
   try {
     await ensureDocsDir();
     const filename = `${titleToFilename(title)}.md`;
-    const filepath = join9(DOCS_DIR, filename);
-    if (existsSync6(filepath)) {
+    const filepath = join10(DOCS_DIR, filename);
+    if (existsSync7(filepath)) {
       console.error(source_default.red(`\u2717 Document already exists: ${filename}`));
       process.exit(1);
     }
@@ -8989,7 +9377,7 @@ var createCommand3 = new Command("create").description("Create a new documentati
 
 Write your documentation here.
 `, metadata);
-    await writeFile2(filepath, content, "utf-8");
+    await writeFile3(filepath, content, "utf-8");
     if (options2.plain) {
       console.log(`Created: ${filename}`);
     } else {
@@ -9016,7 +9404,7 @@ var listCommand2 = new Command("list").description("List all documentation files
     }
     const docs = [];
     for (const file of mdFiles) {
-      const content = await readFile3(join9(DOCS_DIR, file), "utf-8");
+      const content = await readFile4(join10(DOCS_DIR, file), "utf-8");
       const { data } = import_gray_matter4.default(content);
       docs.push({
         filename: file,
@@ -9075,12 +9463,12 @@ var viewCommand2 = new Command("view").description("View a documentation file").
   try {
     await ensureDocsDir();
     let filename = name.endsWith(".md") ? name : `${name}.md`;
-    let filepath = join9(DOCS_DIR, filename);
-    if (!existsSync6(filepath)) {
+    let filepath = join10(DOCS_DIR, filename);
+    if (!existsSync7(filepath)) {
       filename = `${titleToFilename(name)}.md`;
-      filepath = join9(DOCS_DIR, filename);
+      filepath = join10(DOCS_DIR, filename);
     }
-    if (!existsSync6(filepath)) {
+    if (!existsSync7(filepath)) {
       const allFiles = await getAllMdFiles(DOCS_DIR);
       const searchName = name.toLowerCase().replace(/\.md$/, "");
       const matchingFile = allFiles.find((file) => {
@@ -9090,14 +9478,14 @@ var viewCommand2 = new Command("view").description("View a documentation file").
       });
       if (matchingFile) {
         filename = matchingFile;
-        filepath = join9(DOCS_DIR, matchingFile);
+        filepath = join10(DOCS_DIR, matchingFile);
       }
     }
-    if (!existsSync6(filepath)) {
+    if (!existsSync7(filepath)) {
       console.error(source_default.red(`\u2717 Documentation not found: ${name}`));
       process.exit(1);
     }
-    const fileContent = await readFile3(filepath, "utf-8");
+    const fileContent = await readFile4(filepath, "utf-8");
     const { data, content } = import_gray_matter4.default(fileContent);
     const metadata = data;
     if (options2.plain) {
@@ -9176,16 +9564,16 @@ var editCommand2 = new Command("edit").description("Edit a documentation file me
   try {
     await ensureDocsDir();
     let filename = name.endsWith(".md") ? name : `${name}.md`;
-    let filepath = join9(DOCS_DIR, filename);
-    if (!existsSync6(filepath)) {
+    let filepath = join10(DOCS_DIR, filename);
+    if (!existsSync7(filepath)) {
       filename = `${titleToFilename(name)}.md`;
-      filepath = join9(DOCS_DIR, filename);
+      filepath = join10(DOCS_DIR, filename);
     }
-    if (!existsSync6(filepath)) {
+    if (!existsSync7(filepath)) {
       console.error(source_default.red(`\u2717 Documentation not found: ${name}`));
       process.exit(1);
     }
-    const fileContent = await readFile3(filepath, "utf-8");
+    const fileContent = await readFile4(filepath, "utf-8");
     const { data, content } = import_gray_matter4.default(fileContent);
     const metadata = data;
     if (options2.title)
@@ -9196,7 +9584,7 @@ var editCommand2 = new Command("edit").description("Edit a documentation file me
       metadata.tags = options2.tags.split(",").map((t) => t.trim());
     metadata.updatedAt = new Date().toISOString();
     const newContent = import_gray_matter4.default.stringify(content, metadata);
-    await writeFile2(filepath, newContent, "utf-8");
+    await writeFile3(filepath, newContent, "utf-8");
     console.log(source_default.green(`\u2713 Updated documentation: ${source_default.bold(filename)}`));
   } catch (error) {
     console.error(source_default.red("Error editing documentation:"), error instanceof Error ? error.message : String(error));
@@ -9205,9 +9593,9 @@ var editCommand2 = new Command("edit").description("Edit a documentation file me
 });
 var docCommand = new Command("doc").description("Manage documentation").addCommand(createCommand3).addCommand(listCommand2).addCommand(viewCommand2).addCommand(editCommand2);
 // src/commands/config.ts
-import { existsSync as existsSync7 } from "fs";
-import { mkdir as mkdir6, readFile as readFile4, writeFile as writeFile3 } from "fs/promises";
-import { join as join10 } from "path";
+import { existsSync as existsSync8 } from "fs";
+import { mkdir as mkdir7, readFile as readFile5, writeFile as writeFile4 } from "fs/promises";
+import { join as join11 } from "path";
 
 // node_modules/zod/v4/classic/external.js
 var exports_external = {};
@@ -22647,12 +23035,12 @@ function getProjectRoot2() {
   return projectRoot;
 }
 async function loadConfig(projectRoot) {
-  const configPath = join10(projectRoot, CONFIG_FILE);
-  if (!existsSync7(configPath)) {
+  const configPath = join11(projectRoot, CONFIG_FILE);
+  if (!existsSync8(configPath)) {
     return { ...DEFAULT_CONFIG };
   }
   try {
-    const content = await readFile4(configPath, "utf-8");
+    const content = await readFile5(configPath, "utf-8");
     const data = JSON.parse(content);
     const validated = ConfigSchema.parse(data);
     return { ...DEFAULT_CONFIG, ...validated };
@@ -22665,13 +23053,13 @@ async function loadConfig(projectRoot) {
   }
 }
 async function saveConfig(projectRoot, config2) {
-  const configPath = join10(projectRoot, CONFIG_FILE);
-  const knownsDir = join10(projectRoot, ".knowns");
-  if (!existsSync7(knownsDir)) {
-    await mkdir6(knownsDir, { recursive: true });
+  const configPath = join11(projectRoot, CONFIG_FILE);
+  const knownsDir = join11(projectRoot, ".knowns");
+  if (!existsSync8(knownsDir)) {
+    await mkdir7(knownsDir, { recursive: true });
   }
   try {
-    await writeFile3(configPath, JSON.stringify(config2, null, 2), "utf-8");
+    await writeFile4(configPath, JSON.stringify(config2, null, 2), "utf-8");
   } catch (error46) {
     console.error(source_default.red("\u2717 Failed to save config"));
     if (error46 instanceof Error) {
@@ -22813,128 +23201,9 @@ var resetCommand = new Command("reset").description("Reset configuration to defa
   }
 });
 var configCommand = new Command("config").description("Manage configuration settings").addCommand(listCommand3).addCommand(getCommand).addCommand(setCommand).addCommand(resetCommand);
-// src/commands/agents.ts
-import { existsSync as existsSync8 } from "fs";
-import { mkdir as mkdir7, readFile as readFile5, writeFile as writeFile4 } from "fs/promises";
-import { dirname as dirname2, join as join11 } from "path";
-var PROJECT_ROOT = process.cwd();
-var CLAUDE_MD = join11(PROJECT_ROOT, "CLAUDE.md");
-var INSTRUCTION_FILES = [
-  { path: "CLAUDE.md", name: "Claude Code" },
-  { path: "AGENTS.md", name: "Agent SDK" },
-  { path: "GEMINI.md", name: "Gemini" },
-  { path: ".github/copilot-instructions.md", name: "GitHub Copilot" }
-];
-function extractGuidelines(content) {
-  const startMarker = "<!-- KNOWNS GUIDELINES START -->";
-  const endMarker = "<!-- KNOWNS GUIDELINES END -->";
-  const startIndex = content.indexOf(startMarker);
-  const endIndex = content.indexOf(endMarker);
-  if (startIndex === -1 || endIndex === -1) {
-    return null;
-  }
-  return content.substring(startIndex, endIndex + endMarker.length);
-}
-async function updateInstructionFile(filePath, guidelines) {
-  const fullPath = join11(PROJECT_ROOT, filePath);
-  const startMarker = "<!-- KNOWNS GUIDELINES START -->";
-  const endMarker = "<!-- KNOWNS GUIDELINES END -->";
-  const dir = dirname2(fullPath);
-  if (!existsSync8(dir)) {
-    await mkdir7(dir, { recursive: true });
-  }
-  if (!existsSync8(fullPath)) {
-    await writeFile4(fullPath, guidelines, "utf-8");
-    return { success: true, action: "created" };
-  }
-  const content = await readFile5(fullPath, "utf-8");
-  const startIndex = content.indexOf(startMarker);
-  const endIndex = content.indexOf(endMarker);
-  if (startIndex === -1 || endIndex === -1) {
-    const newContent2 = `${content.trimEnd()}
-
-${guidelines}
-`;
-    await writeFile4(fullPath, newContent2, "utf-8");
-    return { success: true, action: "appended" };
-  }
-  const before = content.substring(0, startIndex);
-  const after = content.substring(endIndex + endMarker.length);
-  const newContent = before + guidelines + after;
-  await writeFile4(fullPath, newContent, "utf-8");
-  return { success: true, action: "updated" };
-}
-var updateInstructionsCommand = new Command("agents").description("Manage agent instruction files").option("--update-instructions", "Update agent instruction files").action(async (options2) => {
-  if (!options2.updateInstructions) {
-    console.log(source_default.yellow("No action specified. Use --update-instructions to update files."));
-    console.log(source_default.gray(`
-Example: knowns agents --update-instructions`));
-    return;
-  }
-  try {
-    if (!existsSync8(CLAUDE_MD)) {
-      console.error(source_default.red("Error: CLAUDE.md not found in project root"));
-      console.error(source_default.gray("The source file must exist with <!-- KNOWNS GUIDELINES START --> markers"));
-      process.exit(1);
-    }
-    const claudeContent = await readFile5(CLAUDE_MD, "utf-8");
-    const guidelines = extractGuidelines(claudeContent);
-    if (!guidelines) {
-      console.error(source_default.red("Error: No guidelines found in CLAUDE.md"));
-      console.error(source_default.gray("Ensure CLAUDE.md contains <!-- KNOWNS GUIDELINES START --> and <!-- KNOWNS GUIDELINES END --> markers"));
-      process.exit(1);
-    }
-    console.log(source_default.bold(`
-Updating agent instruction files...
-`));
-    let createdCount = 0;
-    let appendedCount = 0;
-    let updatedCount = 0;
-    let errorCount = 0;
-    for (const file2 of INSTRUCTION_FILES) {
-      try {
-        const result = await updateInstructionFile(file2.path, guidelines);
-        if (result.success) {
-          if (result.action === "created") {
-            createdCount++;
-            console.log(source_default.green(`\u2713 Created ${file2.name}: ${file2.path}`));
-          } else if (result.action === "appended") {
-            appendedCount++;
-            console.log(source_default.cyan(`\u2713 Appended ${file2.name}: ${file2.path}`));
-          } else {
-            updatedCount++;
-            console.log(source_default.green(`\u2713 Updated ${file2.name}: ${file2.path}`));
-          }
-        }
-      } catch (error46) {
-        errorCount++;
-        console.error(source_default.red(`\u2717 Failed ${file2.name}: ${file2.path}`), error46 instanceof Error ? error46.message : String(error46));
-      }
-    }
-    console.log(source_default.bold(`
-Summary:`));
-    if (createdCount > 0) {
-      console.log(source_default.green(`  Created: ${createdCount}`));
-    }
-    if (appendedCount > 0) {
-      console.log(source_default.cyan(`  Appended: ${appendedCount}`));
-    }
-    if (updatedCount > 0) {
-      console.log(source_default.green(`  Updated: ${updatedCount}`));
-    }
-    if (errorCount > 0) {
-      console.log(source_default.red(`  Failed: ${errorCount}`));
-    }
-    console.log();
-  } catch (error46) {
-    console.error(source_default.red("Error updating instruction files:"), error46 instanceof Error ? error46.message : String(error46));
-    process.exit(1);
-  }
-});
-var agentsCommand = updateInstructionsCommand;
 // src/index.ts
 var program2 = new Command;
-program2.name("knowns").description("CLI tool for dev teams to manage tasks, track time, and sync").version("0.1.0");
+program2.name("knowns").description("CLI tool for dev teams to manage tasks, track time, and sync").version("0.1.2");
 program2.addCommand(initCommand);
 program2.addCommand(taskCommand);
 program2.addCommand(boardCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "knowns",
-	"version": "0.1.1",
+	"version": "0.1.2",
 	"description": "CLI tool for dev teams to manage tasks and documentation",
 	"module": "index.ts",
 	"type": "module",