Cortex

v1.2.0 Feature

This release adds 3 notable features for engineering teams evaluating rollout.

Published 7d MCP Developer Tools

View tool

✓ No known CVEs patched

Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

ai-agents docker fastapi karpathy-inspired karpathy-llm-wiki knowledge-base

+8 more

knowledge-graph knowledge-management llm llm-wiki markdown mcp python qmd

ReleasePort's take

Moderate signal

editorial:auto 6d

v1.2.0 introduces a feedback vault collection with tools and REST endpoints, optional Teams adaptive‑card notifications after feedback notes, daily activity logs mirroring key events, folder‑based node typing, and configurable search tuning via new environment variables.

Why it matters: The release adds observable telemetry (feedback vault, daily logs) and operational controls (Teams alerts, searchable cache tuning), enabling developers and SREs to monitor and react to system behavior more effectively.

Summary

AI summary

Default search mode switched to hybrid; QMD container crash and empty‑result caching bugs fixed.

Changes in this release

Type	Severity	Summary	CVE
Breaking	High	Changes default search mode to hybrid from keyword. Changes default search mode to hybrid from keyword. Source: llm_adapter@2026-06-13 Confidence: high	—
Feature
Feature	Low	Adds feedback vault collection with tools and REST endpoints. Adds feedback vault collection with tools and REST endpoints. Source: llm_adapter@2026-06-13 Confidence: high	—
Feature	Low	Adds optional Teams notifications posting adaptive cards after feedback notes. Adds optional Teams notifications posting adaptive cards after feedback notes. Source: llm_adapter@2026-06-13 Confidence: high	—
Feature	Low	Adds daily activity log mirroring vault_write, vault_ingest, and compile events. Adds daily activity log mirroring vault_write, vault_ingest, and compile events. Source: llm_adapter@2026-06-13 Confidence: high	—
Feature	Low	Adds folder‑based node typing for agents/, sessions/, and daily/ without suffixes. Adds folder‑based node typing for agents/, sessions/, and daily/ without suffixes. Source: llm_adapter@2026-06-13 Confidence: high	—
Feature	Low	Adds configurable search tuning via CORTEX_QMD_CACHE_TTL_SECONDS and CORTEX_QMD_SEARCH_TIMEOUT_SECONDS. Adds configurable search tuning via CORTEX_QMD_CACHE_TTL_SECONDS and CORTEX_QMD_SEARCH_TIMEOUT_SECONDS. Source: llm_adapter@2026-06-13 Confidence: high	—
Performance	Medium	Memoizes QMD path index per graph mutation to avoid rebuilding on every search. Memoizes QMD path index per graph mutation to avoid rebuilding on every search. Source: llm_adapter@2026-06-13 Confidence: high	—
Performance	Low	Offloads vault_read note parsing to a separate thread for non‑blocking concurrent MCP requests. Offloads vault_read note parsing to a separate thread for non‑blocking concurrent MCP requests. Source: granite4.1:30b@2026-06-13-audit Confidence: low	—
Bugfix
Bugfix	Medium	Fixes QMD container failure due to missing qmd binary after install. Fixes QMD container failure due to missing qmd binary after install. Source: llm_adapter@2026-06-13 Confidence: high	—
Bugfix	Medium	Fixes hybrid searches being silently truncated by hardcoded 30s timeout. Fixes hybrid searches being silently truncated by hardcoded 30s timeout. Source: llm_adapter@2026-06-13 Confidence: high	—
Bugfix	Medium	Fixes cached search failures by no longer caching empty result sets. Fixes cached search failures by no longer caching empty result sets. Source: llm_adapter@2026-06-13 Confidence: high	—

Full changelog

Added

Feedback vault collection: New feedback/ folder with vault_feedback and vault_list_feedbacks MCP tools plus REST endpoints, capturing user/agent feedback on vault quality with status and related_paths.
Microsoft Teams notifications: Optional TEAMS_WEBHOOK_URL posts an adaptive card after each new feedback note; optional TEAMS_APP_BASE_URL adds a "View in Cortex" link.
Daily activity log: Every vault_write, vault_ingest, and successful compile is mirrored into daily/<UTC-date>.md as a greppable ## [HH:MM] event | summary entry with a [[wiki-stem]] wikilink. Writes to daily/, feedback/, and .cortex/ are excluded to avoid self-reference.
Folder-based node typing: Files under agents/, sessions/, and daily/ are classified as AGENT_DEF, SESSION, and the new NodeType.DAILY without requiring a filename suffix. Frontmatter type: and the existing .agent.md/.session.md suffixes still take precedence/work.
Configurable search tuning: CORTEX_QMD_CACHE_TTL_SECONDS (result-cache TTL, default 30s) and CORTEX_QMD_SEARCH_TIMEOUT_SECONDS (search request timeout, default 120s).

Changed

Default search mode is now hybrid (was keyword). Clients that don't pass an explicit mode now get the best-quality BM25 + vector + re-ranking results. Set CORTEX_QMD_SEARCH_MODE=keyword to restore the previous fast-but-shallow default. Latency is mitigated by the result cache and the HTTP QMD container.

Fixed

QMD container returned no results: The image installed qmd via npm install -g ., which created a global symlink into a build directory deleted in the same layer — leaving a dangling qmd binary so every search failed with spawn qmd ENOENT and silently returned []. Now installed from a packed tarball with a build-time qmd --version smoke check.
Hybrid searches silently truncated: QMD HTTP searches hit a hardcoded 30s timeout on CPU-only hosts and returned [] while QMD was still working. Timeout is now configurable (default 120s).
Cached search failures: Empty result sets (transport errors/timeouts) are no longer cached, preventing a transient failure from blanking search for the full cache TTL.

Performance

Memoized QMD path index: build_path_index_from_graph is cached per graph mutation and no longer rebuilt on every search/read.
Non-blocking reads: vault_read offloads note parsing to a thread so concurrent MCP requests no longer serialize behind file I/O.

View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track Cortex

Get notified when new releases ship.

About Cortex

All releases →