Changelog

All notable changes to Knowns CLI.

v0.3.1 (2025-12-30)

Fixed

• Kanban Drag-Drop: Fixed cards not being droppable into empty columns
  • Implemented custom multi-strategy collision detection algorithm
  • Strategy 1: Pointer position detection (most intuitive for users)
  • Strategy 2: Rectangle intersection for overlapping elements
  • Strategy 3: Extended bounds with 150px buffer for near-column detection
  • Strategy 4: Closest corners fallback for edge cases
  • Dragging is now much smoother and easier

Changed

• MCP Integration Docs: Updated with complete tool reference
  • Added all 15 MCP tools with parameters
  • Added time tracking and board tools
  • Added troubleshooting section for --verbose and --info flags

v0.3.0 (2025-12-29)

New Features

• CLI Shorthand Commands: New concise syntax for common operations

  • knowns task <id> - Shorthand for knowns task view <id>
  • knowns doc <path> - Shorthand for knowns doc view <path>
  • Reduces typing while maintaining full command compatibility

• New UI Components (shadcn/ui):

  • Badge, Card, Checkbox, Label, Progress, Select components
  • Data Table with sorting, filtering, and pagination
  • Dropdown Menu for context actions
  • Kanban board components (Column, Card, Board)
  • Sonner for toast notifications

• New React Contexts:

  • ConfigContext - Global configuration state management
  • TimeTrackerContext - Time tracking state across components
  • UIPreferencesContext - User UI preferences persistence

• Server Architecture:

  • src/server/middleware/ - Request processing middleware
  • src/server/routes/ - Modular route handlers
  • src/server/utils/ - Server utility functions

• Documentation:

  • docs/developer-guide.md - Developer setup and contribution guide
  • docs/user-guide.md - End-user documentation

Architecture Changes

• UI Architecture: Migrated to Atomic Design pattern

  • atoms/ - Basic UI building blocks (buttons, inputs, icons)
  • molecules/ - Composed components (form fields, cards)
  • organisms/ - Complex UI sections (forms, lists, modals)
  • templates/ - Page layout templates

• Server Refactoring: Modularized monolithic server

  • Split 567-line server/index.ts into focused modules
  • Cleaner separation of concerns

• Page Components: Simplified and optimized

  • TasksPage - Reduced from 700+ to ~300 lines
  • KanbanPage - Enhanced board functionality

Bug Fixes

• Dialog/Sheet accessibility and styling issues resolved
• Mention reference parsing improved for reliability
• WebSocket notification handling enhanced

v0.2.1 (2025-12-28)

Bug Fixes

• Web UI Static Files: Fixed NotFoundError when running knowns browser from global install
  • Bun creates symlinks in ~/.bun/bin/ which broke path resolution for UI files
  • Added realpathSync to resolve symlinks before computing paths

v0.2.0 (2025-12-27)

Documentation

• Added comprehensive project documentation:
  • PHILOSOPHY.md - 10 core principles guiding Knowns design
  • ARCHITECTURE.md - Technical overview, diagrams, data flow
  • CONTRIBUTING.md - Contribution guidelines aligned with philosophy
• New guides in /docs folder:
  • commands.md - Full CLI command reference
  • workflow.md - Task lifecycle guide
  • reference-system.md - How @doc/ and @task- linking works
  • web-ui.md - Kanban board and document browser guide
  • mcp-integration.md - Claude Desktop MCP setup
  • configuration.md - Project structure and options
  • ai-workflow.md - Guide for AI agents

README Improvements

• Added TL;DR section for quick understanding
• Added comparison table vs Notion/Jira/Obsidian
• Added "How it works" 3-step explanation
• Added Roadmap section with Self-Hosted Team Sync (planned)

Requirements

• Node.js >= 18.0.0 now required

v0.1.8 (2025-12-27)

Added

• Node.js Runtime Support: Browser command now works with both Bun and Node.js
  • Migrated server from Bun.serve() to Express + ws
  • Added express, ws, and cors dependencies
  • WebSocket real-time sync works on both runtimes
• Bun Compatibility Layer: New src/utils/bun-compat.ts utility
• Build Scripts: Added scripts/build-cli.js using esbuild
• Testing: Migrated from bun test to vitest (76 tests passing)

Fixed

• File Deletion: Fixed improper file deletion (clearing instead of deleting)
• Browser Command: Fixed browser opening on non-Bun runtimes
• Server Path Detection: Fixed import.meta.dir undefined error with Node.js

v0.1.7 (2025-12-27)

Fixed

• Web UI: Fixed layout breaking with long parent task titles
  • Truncated long titles in dropdowns
  • Added proper text truncation with CSS classes

v0.1.6 (2025-12-27)

Added

• Real-time Sync: CLI/AI changes now sync to Web UI in real-time via WebSocket
• Custom Server Port: Server port is now saved to config when using -p option
• Doc CLI: Added --folder, --content, and --append options

Fixed

• Web UI: Fixed Assignee dropdown not working inside modal

v0.1.5 (2025-12-26)

Fixed

• Kanban Board: Fixed columns with many tasks not being scrollable

Added

• Build Process: UI now dynamically displays version from package.json

v0.1.3 (2025-12-26)

Fixed

• Browser Command: Fixed UI path detection when running from installed package
• GitHub Actions: Fixed release creation permissions error

Added

• Build Process: UI files now built and included in npm package

v0.1.0 - v0.1.2

Initial Release Features

• Task Management: Create, edit, view, and list tasks with acceptance criteria
• Documentation: Nested folders with Markdown support
• Time Tracking: Built-in timers with start/stop/pause
• Reference System: Link docs and tasks with @doc/ and @task- syntax
• Search: Full-text search across tasks and documents
• Web UI: Kanban board and document browser (knowns browser)
• AI Integration: MCP Server support and agent instruction sync
• Commands:
  • knowns init - Initialize project
  • knowns task - Task management commands
  • knowns doc - Documentation commands
  • knowns search - Global search
  • knowns browser - Web UI
  • knowns agents - Agent instruction sync
  • knowns time - Time tracking
  • knowns mcp - MCP server

Installation

To update to the latest version:

npm update -g knowns

Links

• GitHub Repository
• npm Package
• Report Issues