Overview

Roadmap & Changelog

hev ask is at 0.3.4 today. What’s planned comes from the engineering RFCs, and the changelog below records what shipped in each tagged release.

🗺️ Roadmap

🌐 Host-neutral delivery beyond Astro (RFC 0004) — a client-side keyword overlay, an ask digest bundle step, and a hostable answer endpoint, so Docusaurus, VitePress, and MkDocs get the same overlay.
🧭 Default digest discovery (RFC 0005) — ask walks up to find the nearest .hev-ask/ (and honors $HEV_ASK_DIGEST_DIR), the way git and cargo find their roots.
🔌 Pluggable LLM tracing (RFC 0007) — pick the tracing backend like the inference provider; one OTLP adapter reaches Datadog, LangSmith, and Braintrust, while PostHog stays native.

🧠 Embeddings for paraphrase recall — a vector path for questions that share no tokens with your docs; the known fix for the keyword recall ceiling, deferred on purpose until analytics show it’s needed.
🔮 Ask across all local digests (RFC 0006) — a registry of every .hev-ask/ on your machine plus model-routed retrieval, so one question reaches the right docs across projects without choosing a digest first.

Keyword ranking overhaul, so results rank by relevance instead of raw token overlap (see how ranking works):

🎯 IDF-weighted scoring, BM25 length-normalization, and a 3× boost for heading and title matches.
🧹 Stopword filtering and full-phrase-only glossary expansion, so common words stop flooding the results.
🧵 Cleaner answer turn when a large digest is searched rather than inlined.

🧭 Big-digest routing. Large digests are searched instead of inlined, keeping the answer loop within budget on sites with thousands of sections.
🪶 One verb per operation in the CLI: tree to map, cat to read, grep to search, folding the older ls, sections, head, section, overview, and search verbs.
🛠️ Binary-based, cross-agent build-digest skill, so the offline build runs the same way under any coding agent.
📈 Outbound-click analytics on GitHub links.

🌳 The digest became a committed markdown tree with filesystem read verbs (RFC 0002). One small file per section, reviewable per PR. (breaking)
🔌 MCP collapsed to one hydrate tool (RFC 0003): it fetches the whole tree to local disk, then the agent reads it with the file tools it already has. (breaking)
🧪 Provider-pluggable inference. OpenAI and OpenRouter joined Anthropic, with tabbed provider examples and Shiki syntax highlighting.
🏷️ hevask.com became the canonical domain, and the homepage pivoted to the agent-first pitch.
📜 The engineering RFC process was established (RFCs 0001–0004).

The first public release.

⌘ The ⌘K overlay: instant keyword search over heading anchors, plus a grounded Claude answer streamed on Enter, every result deep-linked to the exact section.
🌲 The ask digest and the ask CLI, renamed from the knowledge graph. The committed artifact grounds the answer loop and ranks keyword results.
💡 Suggested questions baked into the digest at build time.
📊 PostHog $ai_generation tracing for the answer loop.
📦 Published to npm as @hevmind/ask, with platform binaries for the ask CLI.