fix(skill): handle changelog as directory, add agno/hermes integrations, rebase on main

Author: nicoloboschi

scripts/generate-docs-skill.sh

@@ -159,7 +159,7 @@ done
 
 # Process standalone pages (e.g. best-practices, faq) from src/pages/
 print_info "Processing standalone pages..."
-for page in best-practices faq changelog; do
+for page in best-practices faq; do
     for ext in md mdx; do
         src="$PAGES_DIR/$page.$ext"
         if [ -f "$src" ]; then
@@ -175,6 +175,38 @@ for page in best-practices faq changelog; do
     done
 done
 
+# Process changelog — may be a single file or a directory
+if [ -f "$PAGES_DIR/changelog.md" ] || [ -f "$PAGES_DIR/changelog.mdx" ]; then
+    for ext in md mdx; do
+        src="$PAGES_DIR/changelog.$ext"
+        if [ -f "$src" ]; then
+            dest="$REFS_DIR/changelog.md"
+            mkdir -p "$(dirname "$dest")"
+            if [[ "$src" == *.mdx ]]; then
+                convert_mdx_to_md "$src" "$dest"
+            else
+                cp "$src" "$dest"
+            fi
+            print_info "Included page: changelog.$ext"
+        fi
+    done
+elif [ -d "$PAGES_DIR/changelog" ]; then
+    find "$PAGES_DIR/changelog" -type f \( -name "*.md" -o -name "*.mdx" \) | while read -r file; do
+        rel="${file#$PAGES_DIR/}"
+        dest="$REFS_DIR/$rel"
+        if [[ "$file" == *.mdx ]]; then
+            dest="${dest%.mdx}.md"
+        fi
+        mkdir -p "$(dirname "$dest")"
+        if [[ "$file" == *.mdx ]]; then
+            convert_mdx_to_md "$file" "$dest"
+        else
+            cp "$file" "$dest"
+        fi
+        print_info "Included changelog: ${file#$PAGES_DIR/changelog/}"
+    done
+fi
+
 # Copy OpenAPI spec into the skill
 OPENAPI_SRC="$ROOT_DIR/hindsight-docs/static/openapi.json"
 if [ -f "$OPENAPI_SRC" ]; then
@@ -217,7 +249,7 @@ All documentation is in `references/` organized by category:
 references/
 ├── best-practices.md # START HERE — missions, tags, formats, anti-patterns
 ├── faq.md            # Common questions and decisions
-├── changelog.md      # Release history and version changes
+├── changelog/        # Release history and version changes (index.md + integrations/)
 ├── openapi.json      # Full OpenAPI spec — endpoint schemas, request/response models
 ├── developer/
 │   ├── api/          # Core operations: retain, recall, reflect, memory banks

skills/hindsight-docs/SKILL.md

@@ -28,7 +28,7 @@ All documentation is in `references/` organized by category:
 references/
 ├── best-practices.md # START HERE — missions, tags, formats, anti-patterns
 ├── faq.md            # Common questions and decisions
-├── changelog.md      # Release history and version changes
+├── changelog/        # Release history and version changes (index.md + integrations/)
 ├── openapi.json      # Full OpenAPI spec — endpoint schemas, request/response models
 ├── developer/
 │   ├── api/          # Core operations: retain, recall, reflect, memory banks

…s/hindsight-docs/references/changelog.md …sight-docs/references/changelog/index.mdskills/hindsight-docs/references/changelog.md renamed to skills/hindsight-docs/references/changelog/index.md skills/hindsight-docs/references/changelog.md renamed to skills/hindsight-docs/references/changelog/index.md

@@ -8,6 +8,39 @@ 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).
 
+## Integration Changelogs
+
+| Integration | Package | Description |
+|---|---|---|
+| [LiteLLM](integrations/litellm.md) | `hindsight-litellm` | Universal LLM memory via LiteLLM (100+ providers) |
+| [Pydantic AI](integrations/pydantic-ai.md) | `hindsight-pydantic-ai` | Persistent memory tools for Pydantic AI agents |
+| [CrewAI](integrations/crewai.md) | `hindsight-crewai` | Persistent memory for CrewAI agents |
+| [AI SDK](integrations/ai-sdk.md) | `@vectorize-io/hindsight-ai-sdk` | Memory integration for Vercel AI SDK |
+| [Chat SDK](integrations/chat.md) | `@vectorize-io/hindsight-chat` | Memory integration for Vercel Chat SDK |
+| [OpenClaw](integrations/openclaw.md) | `@vectorize-io/hindsight-openclaw` | Hindsight memory plugin for OpenClaw |
+
+## [0.4.19](https://github.com/vectorize-io/hindsight/releases/tag/v0.4.19)
+
+**Features**
+
+- TypeScript client now works in Deno environments. ([`72c25c97`](https://github.com/vectorize-io/hindsight/commit/72c25c97))
+- Added Agno integration to use Hindsight as a memory toolkit. ([`8c378b98`](https://github.com/vectorize-io/hindsight/commit/8c378b98))
+- Added Hermes Agent integration (hindsight-hermes) for persistent memory. ([`ef90842f`](https://github.com/vectorize-io/hindsight/commit/ef90842f))
+- Expanded retain behavior with new `verbatim` and `chunks` extraction modes and named retain strategies. ([`e4f8a157`](https://github.com/vectorize-io/hindsight/commit/e4f8a157))
+
+**Improvements**
+
+- Improved local reranker performance/efficiency with FP16 and bucketed batching, plus compatibility with Transformers 5.x. ([`e7da7d0e`](https://github.com/vectorize-io/hindsight/commit/e7da7d0e))
+
+**Bug Fixes**
+
+- Prevented silent memory loss when consolidation fails (failed consolidations are tracked and can be recovered). ([`28dac7c7`](https://github.com/vectorize-io/hindsight/commit/28dac7c7))
+- Fixed Docker control-plane startup to respect the configured control-plane hostname. ([`8a64dc8d`](https://github.com/vectorize-io/hindsight/commit/8a64dc8d))
+- Database cleanup migration now removes orphaned observation memory units to avoid inconsistent memory state. ([`f09ad9de`](https://github.com/vectorize-io/hindsight/commit/f09ad9de))
+- Deleting a document now also deletes linked memory units to prevent leftover/stale memory entries. ([`f27bd953`](https://github.com/vectorize-io/hindsight/commit/f27bd953))
+- Fixed MCP middleware to send an Accept header, preventing 406 response errors in some setups. ([`836fd81e`](https://github.com/vectorize-io/hindsight/commit/836fd81e))
+- Improved compatibility with Gemini tool-calling by preserving thought signature metadata to avoid failures on gemini-3.1-flash-lite-preview. ([`21f9f46c`](https://github.com/vectorize-io/hindsight/commit/21f9f46c))
+
 ## [0.4.18](https://github.com/vectorize-io/hindsight/releases/tag/v0.4.18)
 
 **Features**

skills/hindsight-docs/references/changelog/integrations/ai-sdk.md

@@ -0,0 +1,11 @@
+---
+hide_table_of_contents: true
+---
+
+# AI SDK Integration Changelog
+
+Changelog for [`@vectorize-io/hindsight-ai-sdk`](https://www.npmjs.com/package/@vectorize-io/hindsight-ai-sdk) — memory integration for Vercel AI SDK.
+
+For the source code, see [`hindsight-integrations/ai-sdk`](https://github.com/vectorize-io/hindsight/tree/main/hindsight-integrations/ai-sdk).
+
+← [Back to main changelog](../index.md)

skills/hindsight-docs/references/changelog/integrations/chat.md

@@ -0,0 +1,11 @@
+---
+hide_table_of_contents: true
+---
+
+# Chat SDK Integration Changelog
+
+Changelog for [`@vectorize-io/hindsight-chat`](https://www.npmjs.com/package/@vectorize-io/hindsight-chat) — memory integration for Vercel Chat SDK.
+
+For the source code, see [`hindsight-integrations/chat`](https://github.com/vectorize-io/hindsight/tree/main/hindsight-integrations/chat).
+
+← [Back to main changelog](../index.md)

skills/hindsight-docs/references/changelog/integrations/crewai.md

@@ -0,0 +1,11 @@
+---
+hide_table_of_contents: true
+---
+
+# CrewAI Integration Changelog
+
+Changelog for [`hindsight-crewai`](https://pypi.org/project/hindsight-crewai/) — persistent memory for CrewAI agents.
+
+For the source code, see [`hindsight-integrations/crewai`](https://github.com/vectorize-io/hindsight/tree/main/hindsight-integrations/crewai).
+
+← [Back to main changelog](../index.md)

skills/hindsight-docs/references/changelog/integrations/litellm.md

@@ -0,0 +1,11 @@
+---
+hide_table_of_contents: true
+---
+
+# LiteLLM Integration Changelog
+
+Changelog for [`hindsight-litellm`](https://pypi.org/project/hindsight-litellm/) — universal LLM memory integration via LiteLLM.
+
+For the source code, see [`hindsight-integrations/litellm`](https://github.com/vectorize-io/hindsight/tree/main/hindsight-integrations/litellm).
+
+← [Back to main changelog](../index.md)

skills/hindsight-docs/references/changelog/integrations/openclaw.md

@@ -0,0 +1,11 @@
+---
+hide_table_of_contents: true
+---
+
+# OpenClaw Integration Changelog
+
+Changelog for [`@vectorize-io/hindsight-openclaw`](https://www.npmjs.com/package/@vectorize-io/hindsight-openclaw) — Hindsight memory plugin for OpenClaw.
+
+For the source code, see [`hindsight-integrations/openclaw`](https://github.com/vectorize-io/hindsight/tree/main/hindsight-integrations/openclaw).
+
+← [Back to main changelog](../index.md)

skills/hindsight-docs/references/changelog/integrations/pydantic-ai.md

@@ -0,0 +1,11 @@
+---
+hide_table_of_contents: true
+---
+
+# Pydantic AI Integration Changelog
+
+Changelog for [`hindsight-pydantic-ai`](https://pypi.org/project/hindsight-pydantic-ai/) — persistent memory tools for Pydantic AI agents.
+
+For the source code, see [`hindsight-integrations/pydantic-ai`](https://github.com/vectorize-io/hindsight/tree/main/hindsight-integrations/pydantic-ai).
+
+← [Back to main changelog](../index.md)

skills/hindsight-docs/references/developer/api/documents.md

@@ -79,6 +79,12 @@ hindsight memory retain my-bank "Meeting notes content..." --doc-id notes-2024-0
 hindsight memory retain-files my-bank docs/
 ```
 
+### Go
+
+```go
+# Section 'document-retain' not found in api/documents.go
+```
+
 ## Update Documents
 
 Re-retaining with the same document_id **replaces** the old content:
@@ -125,6 +131,12 @@ hindsight memory retain my-bank "Project deadline: March 31" --doc-id project-pl
 hindsight memory retain my-bank "Project deadline: April 15 (extended)" --doc-id project-plan
 ```
 
+### Go
+
+```go
+# Section 'document-update' not found in api/documents.go
+```
+
 ## Get Document
 
 Retrieve a document's original text and metadata. This is useful for expanding document context after a recall operation returns memories with document references.
@@ -179,6 +191,12 @@ console.log(`Created: ${doc.created_at}`);
 hindsight document get my-bank meeting-2024-03-15
 ```
 
+### Go
+
+```go
+# Section 'document-get' not found in api/documents.go
+```
+
 ## Update Document
 
 Update mutable fields on an existing document without re-processing the content. Currently supports updating `tags`.
@@ -225,6 +243,12 @@ hindsight document update-tags my-bank meeting-2024-03-15 --tags team-a --tags t
 hindsight document update-tags my-bank meeting-2024-03-15
 ```
 
+### Go
+
+```go
+# Section 'document-update' not found in api/documents.go
+```
+
 :::info Observations are re-consolidated
 When tags change, any consolidated observations derived from the document's memories are invalidated and queued for re-consolidation under the new tags. Co-source memories from other documents that shared those observations are also reset.
 ## Delete Document
@@ -271,6 +295,12 @@ console.log(`Deleted ${deleteResult.memory_units_deleted} memories`);
 hindsight document delete my-bank meeting-2024-03-15
 ```
 
+### Go
+
+```go
+# Section 'document-delete' not found in api/documents.go
+```
+
 :::warning
 Deleting a document permanently removes all memories extracted from it. This action cannot be undone.
 ## List Documents
@@ -373,6 +403,12 @@ hindsight document list my-bank --q report
 hindsight document list my-bank --tags team-a --tags team-b
 ```
 
+### Go
+
+```go
+# Section 'document-list' not found in api/documents.go
+```
+
 ### Filtering Options
 
 | Parameter | Description |