release: v0.22.0 — Codex SessionStart parity, remind-to-use-kindex, hermetic tests

Highlights (see CHANGELOG.md):
- Codex SessionStart parity: Codex sessions now get the same auto-primed
  context + "use kindex"/.kin directive as Claude (kin prime --adapter codex).
- reminders.remind_kindex_usage flag + .kin discovery/commit guidance.
- Stigmergic pheromone ranking + session-end reinforcement; opt-in Sim supervisor.
- Hermetic test suite (no ambient provider keys leaking into pytest).

Bumps version in pyproject.toml, __init__.py, server.json, README badge, docs.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: jmcentire

CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to Kindex are documented here. Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [0.22.0] - 2026-06-08
+
+### Added
+- **Codex SessionStart parity** — `kin setup-codex-hooks` now installs a SessionStart hook so Codex sessions begin with the same auto-primed context and "use kindex" directive as Claude Code. `kin prime` gained `--adapter {plain,claude,codex}`; `--adapter codex` emits the `hookSpecificOutput.additionalContext` envelope Codex ingests.
+- **`reminders.remind_kindex_usage`** (default `true`) — toggle the injected "use kindex" session directive; set `false` per-project in `.kin/config [reminders]` to suppress the nudge.
+- **Project-graph (`.kin/`) guidance** in the session directive — agents are told to discover the `.kin/` directory for the files they touch (not just the cwd root) and to stage/commit `.kin/` changes alongside the related code.
+- **Stigmergic pheromone ranking and session-end reinforcement** — injection trails (deposit / reinforce / decay) feed an auto-ramping ranking signal, and an opt-in session-end grader reinforces the injections the agent actually used (`attention.pheromone_*`, `attention.reinforce_*`).
+- **Sim supervisory check-in** (opt-in) — an async supervisor that periodically reviews the conversation window and surfaces guidance through the attention channel (`kin sim`, `[sim]` config).
+
+### Fixed
+- Test suite is now hermetic: provider API keys no longer leak from the ambient environment into tests, fixing a flaky extraction-dedup test and preventing accidental live-API calls (and spend) during `pytest`.
+
 ## [0.21.3] - 2026-05-30
 
 ### Changed

README.md

@@ -2,10 +2,10 @@
 
 [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
 [![MIT License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![v0.21.3](https://img.shields.io/badge/version-0.21.3-purple.svg)](https://github.com/jmcentire/kindex/releases)
+[![v0.22.0](https://img.shields.io/badge/version-0.22.0-purple.svg)](https://github.com/jmcentire/kindex/releases)
 [![PyPI](https://img.shields.io/pypi/v/kindex.svg)](https://pypi.org/project/kindex/)
 [![MCP Market](https://img.shields.io/badge/MCP%20Market-kindex-blue.svg)](https://mcpmarket.com/server/kindex)
-[![Tests](https://img.shields.io/badge/tests-1084%20passing-brightgreen.svg)](#)
+[![Tests](https://img.shields.io/badge/tests-1122%20passing-brightgreen.svg)](#)
 [![MCP Plugin](https://img.shields.io/badge/MCP-Plugin-orange.svg)](#install-as-agent-mcp-plugin)
 
 **The memory layer AI coding agents don't have.**
@@ -84,6 +84,8 @@ kin setup-agents-md --install --global
 kin ingest codex-sessions   # optional: backfill saved Codex sessions
 ```
 
+`setup-codex-hooks` installs a **SessionStart** hook (alongside the prompt/tool attention hooks), so Codex begins each session with the same auto-primed context and "use kindex" / `.kin` directive as Claude Code.
+
 Or hand-edit `~/.codex/config.toml`:
 ```toml
 [mcp_servers.kindex]

docs/index.html

@@ -265,7 +265,7 @@ <h1><span>kin</span>dex</h1>
       </div>
     </div>
     <div class="badges">
-      <span class="badge green">v0.21.3</span>
+      <span class="badge green">v0.22.0</span>
       <span class="badge orange">MCP Plugin</span>
       <span class="badge blue">45 MCP Tools</span>
       <span class="badge purple">63 CLI Commands</span>
@@ -732,7 +732,7 @@ <h3>Infrastructure</h3>
       MIT License &middot;
       Free
     </p>
-    <p style="margin-top: 8px;">v0.21.3 &middot; MCP Plugin &middot; 45 MCP Tools &middot; 63 CLI Commands &middot; 1084 Tests</p>
+    <p style="margin-top: 8px;">v0.22.0 &middot; MCP Plugin &middot; 45 MCP Tools &middot; 63 CLI Commands &middot; 1122 Tests</p>
     <p style="margin-top: 8px;">Made by <a href="https://github.com/jmcentire">Jeremy McEntire</a></p>
     <p style="margin-top: 8px;">
       <a href="https://exemplar.tools">exemplar.tools</a> &middot;

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "kindex"
-version = "0.21.3"
+version = "0.22.0"
 description = "The memory layer Claude Code doesn't have — persistent knowledge graph for AI workflows"
 readme = "README.md"
 requires-python = ">=3.10"

server.json

@@ -3,7 +3,7 @@
   "name": "io.github.jmcentire/kindex",
   "title": "Kindex",
   "description": "Persistent knowledge graph and MCP server for AI workflows with git-tracked project context.",
-  "version": "0.21.3",
+  "version": "0.22.0",
   "repository": {
     "url": "https://github.com/jmcentire/kindex",
     "source": "github"
@@ -13,7 +13,7 @@
     {
       "registryType": "pypi",
       "identifier": "kindex",
-      "version": "0.21.3",
+      "version": "0.22.0",
       "runtimeHint": "pipx",
       "transport": {
         "type": "stdio"

src/kindex/__init__.py

@@ -1,3 +1,3 @@
 """Kindex — Knowledge graph that learns from your conversations."""
 
-__version__ = "0.21.3"
+__version__ = "0.22.0"