v0.19.2

v0.19.2

0.19.2 is a patch release focused on semantic search stability, especially on Windows, while also improving CI and release reliability.

Highlights

• Improved semantic search setup in non-interactive environments such as CI or terminals without TTY support.
• Added multi-platform smoke tests for knowns-embed, with a strong focus on Windows runtime validation.
• Expanded test coverage for sync, semantic search, and related MCP workflows.

Changed

• Semantic search setup now behaves more reliably when running in non-interactive environments.
• The CI pipeline now builds and validates the sidecar across macOS, Linux, Windows x64, and Windows ARM.
• The build and release flow now includes real runtime checks for the Windows sidecar before publishing artifacts.

Fixed

• Reduced the risk of shipping semantic search artifacts that fail at runtime on Windows.
• Improved early failure detection for semantic search and sync workflows through E2E and smoke tests.
• Increased release stability by validating that the sidecar not only exists in published packages, but also runs successfully.

Testing

• Added CI smoke tests for knowns-embed across multiple platforms.
• Added test coverage for:
• knowns sync --instructions
• knowns sync --skills
• semantic CLI subset
• semantic MCP subset

Notes

• There are no breaking changes in this release.
• This release prioritizes stability and reliability over new feature work.

Full Changelog: v0.19.1...v0.19.2

v0.19.1

v0.19.1 - CI and Semantic Search Stabilization

✨ Added

• Added cross-platform sidecar smoke checks in PR CI for all Bun targets: darwin x64/arm64, linux x64/arm64, and windows x64/arm64
• Added end-to-end CLI coverage for knowns sync --instructions --platform claude and knowns sync --skills
• Added semantic search subsets to PR CI so semantic CLI and MCP search flows are exercised in pull requests

🔄 Changed

• Updated CI runner selection for Darwin x64 sidecar smoke to use the Intel macOS runner label already used by publish workflow
• Adjusted Unix sidecar smoke execution to export bundle-local dynamic library paths before launching the compiled sidecar
• Refined PR CI coverage so sidecar packaging/runtime validation and semantic search validation run as separate targeted checks

🐛 Fixed

• Fixed semantic model download in non-interactive environments by avoiding Bubble Tea setup UI when running without a TTY
• Fixed CI failures where semantic CLI tests fell back to keyword-only mode because model setup could not complete in GitHub Actions
• Fixed sidecar smoke regressions on Unix runners caused by missing runtime loader paths when executing packaged sidecar binaries directly

---

Contributors

@howznguyen

Full Changelog: v0.19.0...v0.19.1

v0.19.0

v0.19.0 - Tree-sitter Sidecar Runtime for Search

✨ Added

• New Bun-based sidecar runtime for symbol extraction, parsing, and embedding support across supported platforms
• Tree-sitter-driven symbol extraction pipeline, candidate discovery helpers, and sidecar server/build assets under sidecar/
• Sidecar runtime plumbing in the CLI, including setup/download flow updates and tunnel/cloudflared helpers for runtime-managed services
• Spec doc for the tree-sitter sidecar design and rollout

🔄 Changed

• Search and indexing flows now use the new sidecar-based embedding/runtime path instead of the previous ONNX implementation
• Runtime queue, MCP server integration, install scripts, and update/browser/runtime commands were updated to support sidecar packaging and execution
• Publish workflow, Makefile, and release packaging now build and ship sidecar bundles alongside the main CLI artifacts

🐛 Fixed

• Improved cross-platform search/runtime consistency by removing the older ONNX/stub split and standardizing parsing and embedding behavior behind the sidecar runtime
• Tightened AST indexing coverage and runtime-related tests around parser candidates, browser/search flows, and sidecar-backed indexing behavior

---

Contributors

@howznguyen

Full Changelog: v0.18.4...v0.19.0

v0.18.4

v0.18.4 - Semantic References & Working Memory

✨ Added

• Semantic reference model and resolution flow for knowledge links such as references, implements, blocked-by, related, depends, and follows
• New reference resolution and rewrite helpers in storage and reference packages, with dedicated tests
• knowns resolve CLI support for resolving semantic references directly
• Working memory store and MCP/server support for session-scoped memory operations
• New semantic reference badge rendering in the editor and richer release/spec docs for the feature set

🔄 Changed

• Search, graph, docs, and MCP flows now surface semantic references more consistently across backend and web UI
• Memory APIs and the Memory page were reworked to separate persistent memory from working memory, with improved create/view/edit flows
• Graph filtering and legends now support semantic relation edge types and clearer impact exploration
• Installer and publish workflow assets were updated to include the new runtime/reference-related behavior
• User and developer docs were refreshed for semantic references, mention playground usage, and related workflows

🐛 Fixed

• Improved document reference resolution and validation behavior so semantic links are interpreted more reliably across storage, routes, and search
• Tightened tests around MCP search, doc storage, graph routes, runtime memory, and reference resolution to reduce regressions in the new reference pipeline

---

Contributors

@howznguyen

Full Changelog: v0.18.3...v0.18.4

v0.18.3

v0.18.3 - Runtime Adapter Install, MCP-First Retrieval & Search Improvements

✨ Added

• Unified runtime adapter install package for global hook/plugin setup across claude-code, codex, kiro, and opencode
• runtime-memory CLI command for direct runtime memory hook invocation
• Kiro native runtime-memory hook (.kiro/hooks/knowns-runtime-memory.kiro.hook)
• Specs: multi-store semantic memory retrieval and unified runtime adapter install
• Design system reference doc for SVG diagrams, Web UI, and knowns.sh visual consistency
• README SVG diagrams: architecture, capabilities, cover, knowledge-graph, mcp-integration, multi-platform, template-pipeline, workflow

🔄 Changed

• All agent skills and compatibility shims now prefer MCP retrieve tool over CLI, with CLI as fallback
• Search engine improvements: chunker source-type awareness, vecstore type filtering, sqlite store optimizations, and sync refinements
• Init flow updated with runtime discovery, adapter install integration, and MCP-first guidance generation
• Docs refreshed: commands, configuration, semantic-search, mcp-integration, user-guide, developer-guide, web-ui

🐛 Fixed

• Search type filtering now applies at the vector store level so --type memory queries are not crowded out by unrelated doc/task chunks

---

Contributors

@howznguyen

Full Changelog: v0.18.2...v0.18.3

v0.18.2

v0.18.2 - Shared Runtime Queue, Script Updates & Stability Fixes

✨ Added

• Shared global runtime queue for background semantic/code indexing work, with project-scoped queues, lease tracking, idle shutdown, and runtime status reporting
• Installer metadata persisted under ~/.knowns/install.json for official shell and PowerShell installs
• Script-managed self-update flow for knowns update, including runtime version awareness and safer runtime restart behavior after upgrades
• MCP and runtime process logs under ~/.knowns/logs, including per-process MCP logs and bounded log rotation

🔄 Changed

• MCP write paths now keep source-of-truth writes synchronous while enqueueing follow-up indexing, watch-triggered work, and reindex tasks to the shared runtime
• knowns watch and related background indexing flows now reuse shared runtime infrastructure instead of spawning redundant heavyweight work
• Shell installer now defaults to ~/.knowns/bin, reducing the need for sudo and avoiding password prompts for script-managed installs on macOS and Linux
• Background indexing now uses queue pacing, debounce windows, duplicate coalescing, and lower ONNX thread defaults to reduce CPU spikes

🐛 Fixed

• Fixed runtime memory injection scoring so prompt hooks only inject memories with actual prompt relevance instead of matching only on runtime/context tokens
• Fixed Windows and race-sensitive test behavior by forcing test commands and MCP e2e flows to run with inline runtime mode instead of leaving shared runtime processes behind
• Fixed MCP/background work stability issues caused by inline indexing pressure, stale runtime reuse, and oversized shared log growth

---

Contributors

@howznguyen

Full Changelog: v0.18.1...v0.18.2

v0.18.1

v0.18.1 - Release Docs, MCP Schema & Update Guidance

✨ Added

• Public docs for the v0.18.0 feature set, including workspace-aware browser mode, code intelligence commands, code graph usage, and chat/runtime UX updates
• Installer README examples for pinning a specific version with KNOWNS_VERSION on both shell and PowerShell installers

🔄 Changed

• README and command guides now describe the shipped knowns code ingest, knowns code watch, knowns code search, knowns code deps, and knowns code symbols workflows
• Browser and web UI docs now cover workspace switching, project scanning, code watcher mode, and richer graph/chat capabilities

🐛 Fixed

• Fixed MCP tool schema for knowns_retrieve so sourceTypes declares array item types and no longer triggers array schema missing items
• Fixed Homebrew upgrade guidance to use brew upgrade knowns-dev/tap/knowns consistently in the CLI notifier and release/install messaging

---

Contributors

@howznguyen

Full Changelog: v0.18.0...v0.18.1

v0.18.0

v0.18.0 - Workspace Switching, Code Intelligence & Chat UX

✨ Added

• AST-based code intelligence with symbol indexing, relationship edges, neighbor discovery, and dedicated tests
• New code-focused CLI and MCP capabilities for code search, code graph exploration, ingest, and file watching/sync flows
• Dedicated Code Graph experience in the web UI with new graph toolbar, legend, styling, and detail panel improvements
• Welcome page and chat timeline dialog to improve session onboarding and chat history navigation
• Workspace picker and server-side workspace switching improvements, including broader browser/server test coverage
• Search benchmarking utilities and new research/spec docs for retrieval, graph UX, and chat runtime upgrades

🔄 Changed

• Upgraded chat runtime and message rendering to better support tool calls, shell output, sub-agents, and richer thread interactions
• Expanded search engine and server routes to support code-aware retrieval alongside existing knowledge/doc search flows
• Updated browser/server integration, route wiring, and configuration plumbing to support workspace-aware behavior end to end
• Refined agent skill instructions and internal guidance for planning, implementation, review, research, and debugging workflows

🐛 Fixed

• OpenCode client/runtime handling is more robust, with added tests around client behavior and browser command flows
• Graph, search, validation, storage, and API route handling received targeted fixes alongside the new workspace/code features
• Publish workflow and package metadata were adjusted to keep release/build behavior aligned with the new runtime changes

---

Contributors

@howznguyen

Full Changelog: v0.17.1...v0.18.0

v0.17.1

v0.17.1 - MCP Fixes & Working Memory Persistence

🐛 Fixed

• create_task MCP handler now properly saves plan and notes fields (were being silently ignored)
• update_doc MCP handler no longer clears content when sending empty string content: ""
• Working memory now persists to .knowns/.working-memory/ directory instead of RAM-only, surviving restarts and compacts
• clear_working_memory properly removes working memory files from disk

---

Contributors

@howznguyen

Full Changelog: v0.17.0...v0.17.1

v0.17.0

v0.17.0 - Memory System & Knowledge Graph

✨ Highlights

• 🧠 3-Layer Memory System — Working, project, and global memory layers for agents. Store patterns, decisions, and conventions that persist across sessions via CLI (knowns memory) and full MCP tool coverage (add_memory, list_memories, search_memories, promote_memory, add_working_memory).
• 🕸️ Knowledge Graph UI — New Graph page visualizes relationships between tasks, docs, and memories as an interactive network. Click any node to open a detail panel with full context.
• 📈 Semantic Search Quality — Model-specific embedding prefixes (EmbedQuery/EmbedDocument) for bge, nomic, and e5; H1 content loss fixed; tokenizer-based chunk splitting; ChunkVersion auto-reindex on version mismatch.
• 🔄 knowns update Command — New CLI command to check for and install the latest version of Knowns.
• 🔌 Custom Provider UI — Add custom OpenCode-compatible providers (base URL, models, headers, API key) directly from the provider connect dialog.

---

🚀 Added

• knowns memory CLI command — list, view, add, update, delete, and search memory entries across layers
• add_memory / get_memory / update_memory / delete_memory / list_memories / search_memories MCP tools (project + global layers)
• promote_memory / demote_memory MCP tools for cross-layer promotion (project → global)
• add_working_memory / get_working_memory / list_working_memories / delete_working_memory / clear_working_memory MCP tools (session-scoped, in-memory)
• MemoryEntry model with id, title, layer, category, tags, content, metadata, createdAt, updatedAt
• MemoryStore file-backed storage under .knowns/memory/ with semantic search indexing
• GET /api/memories, POST /api/memories, PATCH /api/memories/:id, DELETE /api/memories/:id REST endpoints
• GET /api/graph endpoint — returns nodes and edges for tasks, docs, and memories with relationship inference
• Graph page (/graph) with force-directed network visualization and node type filtering
• Graph detail panel — click any node to see title, type, tags, excerpt, and outbound links
• Memory page (/memory) — list and browse all memory entries by layer and category
• knowns update CLI command — checks GitHub releases and installs the latest binary
• OpenCode auto-detection during knowns init wizard — skips download if already installed
• Custom provider step in ProviderConnectDialog — provider ID, display name, base URL, models, optional headers and API key
• Sidebar navigation entries for Graph and Memory pages
• kn-extract skill: new Step 5 saves memory entry alongside extracted doc
• kn-init skill: Step 3.6 loads project memory at session start
• kn-research skill: Step 2 searches project memory before completed tasks

---

📝 Changed

• knowns search — improved result ranking with model-aware embedding prefixes
• Chunker now uses tokenizer-based token counting with configurable overlap; splits oversized task chunks
• ChunkVersion bumped — mismatched indexes are automatically wiped and reindexed on next sync
• KNOWNS.md / compatibility shims — added Memory Usage section with usage guidelines for agents
• Skills (kn-extract, kn-init, kn-research) updated to include memory steps in their workflows
• knowns sync — content-based out-of-sync detection replaces .version file mechanism
• MDRender components (CopyablePre, CopyableTable, StableHeading) moved to module scope to fix React reconciliation key warnings
• .air.toml dev server switched from pre-built binary to go run ./cmd/knowns/main.go

---

🐛 Fixed

• H1 heading content captured correctly in chunker (was being dropped before the first H2)
• Code block language detection in chunker prevented false heading matches inside fenced blocks
• execLookPath in mcpCommand() now injectable — CI test failures caused by knowns not being in PATH resolved
• Chat scroll uses useLayoutEffect for instant initial positioning (no flash of bottom-scrolled content)
• Mention badge re-rendering stabilized with stable useMemo refs
• sync.go import sync no longer races on concurrent file writes

---

Contributors

@howznguyen

Full Changelog: v0.16.3...v0.17.0