doc: changelog for 0.4.8 (#283)

* doc: changelog for 0.4.8 * improve docs
2026-02-03 14:04:55 +01:00 · 2026-02-03 14:04:55 +01:00 · a24941f83b
commit a24941f83b
parent 21b25fe8fe
2 changed files with 66 additions and 41 deletions
--- a/hindsight-docs/docs/developer/models.md
+++ b/hindsight-docs/docs/developer/models.md
@ -158,21 +158,16 @@ Use your ChatGPT Plus or Pro subscription for Hindsight without separate OpenAI
 4. **Configure Hindsight:**
   ```bash
   export HINDSIGHT_API_LLM_PROVIDER=openai-codex
-   export HINDSIGHT_API_LLM_MODEL=gpt-5.2-codex  # or gpt-5.1-codex
+   # export HINDSIGHT_API_LLM_MODEL=gpt-5.1-codex  # defaults to gpt-5.2-codex
   # No API key needed - reads from ~/.codex/auth.json automatically
   ```

 5. **Start Hindsight:**
   ```bash
-   ./scripts/dev/start-api.sh
+   hindsight-api
   ```

-**Available Models:**
- `gpt-5.2-codex` - Latest frontier agentic coding model (default)
- `gpt-5.2` - Latest frontier model
- `gpt-5.1-codex` - Previous generation coding model
- `gpt-5.1-codex-max` - Maximum context variant
- `gpt-5.1-codex-mini` - Lightweight variant
+You can use any model supported by OpenAI Codex CLI

 **Important Notes:**
 - OAuth tokens are stored in `~/.codex/auth.json`
@ -186,9 +181,6 @@ If authentication fails:
 ```bash
 # Re-login to refresh tokens
 codex auth login
-
-# Check auth file exists and has correct format
-cat ~/.codex/auth.json | python3 -c "import json, sys; d=json.load(sys.stdin); print('auth_mode:', d.get('auth_mode')); print('has tokens:', 'tokens' in d)"
 ```

 ---
@ -225,50 +217,22 @@ Use your Claude Pro or Max subscription for Hindsight without separate Anthropic
 4. **Configure Hindsight:**
   ```bash
   export HINDSIGHT_API_LLM_PROVIDER=claude-code
-   export HINDSIGHT_API_LLM_MODEL=claude-sonnet-4-5-20250929
   # No API key needed - uses claude auth login credentials
   ```

 5. **Start Hindsight:**
   ```bash
-   ./scripts/dev/start-api.sh
+   hindsight-api
   ```

-**Available Models:**
- `claude-sonnet-4-5-20250929` - Latest Claude Sonnet (default)
- `claude-opus-4-20250514` - Claude Opus for complex tasks
- `claude-sonnet-3-5-20241022` - Previous generation Sonnet
- Any model supported by Claude Code CLI
+You can use any model supported by Claude Code CLI.

 **Important Notes:**
 - Authentication handled by Claude Agent SDK (uses bundled CLI)
 - Credentials managed securely by Claude Code
 - Usage billed to your Claude subscription (not separate API costs)
- Includes Claude Agent SDK as dependency (auto-installed)
 - For personal development use only (see Claude Terms of Service)

-**Troubleshooting:**
-
-If authentication fails:
-```bash
-# Re-login to refresh credentials
-claude auth login
-
-# Check Claude CLI is working
-claude --version
-
-# Test authentication directly
-claude query "test"
-```
-
-If the SDK is not found:
-```bash
-# Install Claude Agent SDK
-pip install claude-agent-sdk
-# Or with uv
-uv add claude-agent-sdk
-```
-
 ---

 ## Embedding Model
--- a/hindsight-docs/src/pages/changelog.md
+++ b/hindsight-docs/src/pages/changelog.md
@ -8,6 +8,67 @@ This changelog highlights user-facing changes only. Internal maintenance, CI/CD,

 For full release details, see [GitHub Releases](https://github.com/vectorize-io/hindsight/releases).

+## [0.4.8](https://github.com/vectorize-io/hindsight/releases/tag/v0.4.8)
+
+**Features**
+
+- Added profile support for `hindsight-embed`, enabling separate embedding configurations/workspaces. ([`6c7f057`](https://github.com/vectorize-io/hindsight/commit/6c7f057))
+- Added support for additional LLM backends, including OpenAI Codex and Claude Code. ([`539190b`](https://github.com/vectorize-io/hindsight/commit/539190b))
+
+**Improvements**
+
+- Enhanced OpenClaw and `hindsight-embed` parameter/config options for easier configuration and better defaults. ([`749478d`](https://github.com/vectorize-io/hindsight/commit/749478d))
+- Added OpenClaw plugin configuration options to select LLM provider and model. ([`8564135`](https://github.com/vectorize-io/hindsight/commit/8564135))
+- Server now prints its version during startup to simplify debugging and support requests. ([`1499ce5`](https://github.com/vectorize-io/hindsight/commit/1499ce5))
+- Improved tracing/debuggability by propagating request context through asynchronous background tasks. ([`44d9125`](https://github.com/vectorize-io/hindsight/commit/44d9125))
+- Added stronger validation and context for mental model create/refresh operations to prevent invalid requests. ([`35127d5`](https://github.com/vectorize-io/hindsight/commit/35127d5))
+
+**Bug Fixes**
+
+- Improved embedding CLI experience with richer logs and isolated profiles to avoid cross-contamination between runs. ([`794a743`](https://github.com/vectorize-io/hindsight/commit/794a743))
+- Operation validation now runs correctly in the worker process, preventing invalid background operations from slipping through. ([`96f0e54`](https://github.com/vectorize-io/hindsight/commit/96f0e54))
+- Fixed unreliable behavior when using a custom PostgreSQL schema. ([`3825506`](https://github.com/vectorize-io/hindsight/commit/3825506))
+
+## [0.4.7](https://github.com/vectorize-io/hindsight/releases/tag/v0.4.7)
+
+**Features**
+
+- Add extension hooks to validate and customize mental model operations. ([`9c3fda7`](https://github.com/vectorize-io/hindsight/commit/9c3fda7))
+- Add support for using an external embedding API provider in OpenClaw plugin (with additional OpenClaw compatibility fixes). ([`4b57b82`](https://github.com/vectorize-io/hindsight/commit/4b57b82))
+
+**Improvements**
+
+- Speed up container startup by preloading the tiktoken encoding during Docker image builds. ([`039944c`](https://github.com/vectorize-io/hindsight/commit/039944c))
+
+**Bug Fixes**
+
+- Prevent PostgreSQL insert failures by stripping null bytes from text fields before saving. ([`ef9d3a1`](https://github.com/vectorize-io/hindsight/commit/ef9d3a1))
+- Fix worker schema selection so it uses the correct default database schema. ([`d788a55`](https://github.com/vectorize-io/hindsight/commit/d788a55))
+- Honor an already-set HINDSIGHT_API_DATABASE_URL instead of overwriting it in the hindsight-embed workflow. ([`f0cb192`](https://github.com/vectorize-io/hindsight/commit/f0cb192))
+
+## [0.4.6](https://github.com/vectorize-io/hindsight/releases/tag/v0.4.6)
+
+**Improvements**
+
+- Improved OpenClaw configuration setup to make embedding integration easier to configure. ([`27498f9`](https://github.com/vectorize-io/hindsight/commit/27498f9))
+
+**Bug Fixes**
+
+- Fixed OpenClaw embedding version binding/versioning to prevent mismatches when using the embed integration. ([`1163b1f`](https://github.com/vectorize-io/hindsight/commit/1163b1f))
+
+## [0.4.5](https://github.com/vectorize-io/hindsight/releases/tag/v0.4.5)
+
+**Bug Fixes**
+
+- Fixed occasional failures when retaining memories asynchronously with timestamps. ([`cbb8fc6`](https://github.com/vectorize-io/hindsight/commit/cbb8fc6))
+
+## [0.4.4](https://github.com/vectorize-io/hindsight/releases/tag/v0.4.4)
+
+**Bug Fixes**
+
+- Fixed async “retain” operations failing when a timestamp is provided. ([`35f0984`](https://github.com/vectorize-io/hindsight/commit/35f0984))
+- Corrected the OpenClaw daemon integration name to “openclaw” (previously “openclawd”). ([`b364bc3`](https://github.com/vectorize-io/hindsight/commit/b364bc3))
+
 ## [0.4.3](https://github.com/vectorize-io/hindsight/releases/tag/v0.4.3)

 **Features**