knowcards: v0.4.0

Highlights

• Added a Pi extension that fetches relevant card titles before the agent starts and reflects when the session shuts down.
• Added knowcards install pi with support for both project-local and --global installation.

Improvements

• Documented the automatic fetch/reflect lifecycle across Pi, Claude Code, Cursor, and Codex.
• Separated card storage and retrieval into the memory layer, with session fetch and reflection handled by the harness.
• Renamed the Claude Code, Cursor, and Codex adapter exports from *-inject to *-fetch to match the updated terminology.

knowcards: v0.3.0

0.3.0 (2026-08-20)

Features

• cap reflect proposes and add update/delete CLI (4f593c2)

knowcards: v0.2.0

Highlights

• Knowledge injection is now title-first, providing each matching card’s slug, title, and optional “use when” guidance. Agents can fetch full card text with knowcards query or the MCP query tool.
• Prompt injection is capped at 8 cards and 8,000 characters, reducing unnecessary context usage.
• Retrieval now uses a streamlined MiniSearch ranking path, with prefix matching limited to short queries for more focused results.

Improvements

• Claude Code and Codex avoid reinjecting the same card slugs within a session.
• Cursor avoids rewriting its context rules when retrieved content is short or unchanged.
• Empty retrieval results no longer add host context.
• Reflection hooks skip runs when the transcript contains no file edits, reducing unnecessary follow-up turns.
• Documentation now clearly describes knowcards’ memory layers and the separation between filesystem memory and host adapters.
• The optional init command remains available but is hidden from CLI help; propose continues to create card directories as needed.
• Harbor A/B evaluation now uses four official SWE-bench Verified tasks covering pytest, requests, pylint, and Sphinx.
• Evaluation comparisons now separate uncached prompt tokens from cache tokens and report agent execution time instead of total Harbor wall-clock time.

Fixes

• Retrieval skips corrupt card files instead of failing the entire query.
• Claude Code, Cursor, and Codex hooks now fail open so hook errors do not interrupt host workflows.
• Stop-hook safeguards prevent repeated reflection when a hook is already active, including Cursor looped follow-ups.

knowcards: v0.1.0

0.1.0 (2026-08-12)

Features

• add knowcards agent skill and auto-create card dirs (4df030a)
• add npm release tooling and switch retrieval to MiniSearch (3ab2d2b)
• add session hooks install and agent-follow-up reflect (06b6486)
• eval: add Harbor with/without knowledge-cards A/B (903d10b)
• markdown cards, FTS+RRF retrieval, MCP stdio, and Harbor refresh (649cb66)
• scaffold minimal knowledge cards library (831e232)
• session hooks install and agent-follow-up reflect (a891c68)
• ship as knowcards CLI and refresh docs (72cb4bc)
• tune reflect prompt for codebase environment learning (48fe557)