@cairnkeep/cli 2.15.4 → 2.17.0

package/CHANGELOG.md

@@ -5,6 +5,50 @@ All notable user-facing changes are documented here. This project follows
 
 ## [Unreleased]
 
+## [2.17.0] - 2026-08-29
+
+### Added
+
+- Frozen, offline retrieval benchmark with substring and deterministic mock-
+  embedding goldens, quality/cost/latency metrics, mutation accounting, and
+  forbidden-result leakage checks.
+- Progressive context-pack hierarchy and derived summary cache, the
+  `context_pack_tree` MCP tool, and opt-in hierarchical search detail and
+  sanitized explanation traces. Compatible flat content search remains the
+  default.
+- Opt-in, privacy-preserving context-usage receipts linked to work evidence.
+- Review-gated `cairn proposals create|list|show|apply|doctor` workflow for
+  promoting redacted trajectory candidates into reviewed durable memory.
+- Provider-neutral domain retrieval with an explicitly gated, read-only
+  OpenViking adapter; AnythingLLM remains the default provider.
+
+### Changed
+
+- Context-pack search can return stable result and chunk digests when requested,
+  without changing the default response shape.
+- `cairn doctor` validates progressive context-cache records while preserving
+  immutable pack objects, project pins, and skill-approval authority.
+
+## [2.16.0] - 2026-08-27
+
+### Added
+
+- Add dependency-free terminal selectors to `cairn setup`: arrow-key choices
+  for Git and memory, Space-toggle checkboxes for harnesses, and a selectable
+  final confirmation. Escape and Ctrl-C cancel safely.
+
+### Changed
+
+- Keep the existing text-question fallback for limited terminals and preserve
+  every deterministic setup flag for scripts, CI, policies, and overlays.
+- Treat redirected output as non-interactive even when standard input is still
+  a TTY, preventing hidden prompts in automation.
+
+### Fixed
+
+- Keep capability-logging smoke fixtures relative to the test date so the
+  retention contract cannot fail merely because a hard-coded date aged out.
+
 ## [2.15.4] - 2026-08-19
 
 ### Changed

package/CONTRIBUTING.md

@@ -37,6 +37,18 @@ npm run check:public
 Some integration verifiers require optional sibling tools or configured API
 endpoints. They are not part of the default offline test suite.
 
+## Repository map
+
+- `mcp-memory-server/` contains the MCP server, storage owners, schemas, and
+  Node-based CLI implementations.
+- `bin/cairn` is the installed command entry point.
+- `templates/` contains project scaffolding and managed instruction assets.
+- `claude/`, `opencode/`, `pi/`, and `kimi/` contain harness-specific operating
+  assets.
+- `scripts/` contains sync, lifecycle, packaging, and contract checks.
+- `docs/` contains the versioned user and operator references indexed from
+  [the documentation hub](docs/README.md).
+
 ## Pull requests
 
 - Create a focused branch from `main`.