doc: fix build

hindsight-docs/blog/2026-02-09-resolving-memory-conflicts.md

@@ -8,12 +8,14 @@ date: 2026-02-09
 
 # How We Solved Memory Conflicts in Hindsight
 
-One of the hardest problems we tackled in Hindsight was dealing with contradictions. When you're building a memory system for AI agents, reality isn't static. It evolves. 
+One of the hardest problems we tackled in Hindsight was dealing with contradictions. When you're building a memory system for AI agents, reality isn't static. It evolves.
 
 A CRM agent might learn that "Acme Corp is a key prospect" in January, then encounter "Acme Corp is now a paying customer" in March. Naive approaches either lose the history or drown in duplicate facts.
 
 We needed a system that could handle this gracefully. Here's how we built it.
 
+<!-- truncate -->
+
 ## **The Core Problem: Facts vs. Knowledge**
 
 Early on, we made a distinction that shaped the way we store and receive memories: raw facts aren't the same as consolidated knowledge. Facts are immediate observations; what an agent learns in a single interaction. Knowledge is durable understanding extracted from those facts over time.

hindsight-docs/blog/2026-02-13-version-0-4-11.md

@@ -7,6 +7,8 @@ date: 2026-02-13
 
 Hindsight 0.4.11 focuses on production-ready deployments with improved flexibility and observability.
 
+<!-- truncate -->
+
 - [**Hierarchical Configuration**](#hierarchical-configuration): Customize operational settings per memory bank.
 - [**LiteLLM SDK Integration**](#litellm-sdk-integration): Direct API access without proxy server.
 - [**Expanded Database Support**](#expanded-database-support): TimescaleDB pg_textsearch and additional Postgres extensions.
@@ -14,8 +16,6 @@ Hindsight 0.4.11 focuses on production-ready deployments with improved flexibili
 - [**MCP Mental Models**](#mcp-mental-models): Full lifecycle management via Model Context Protocol.
 - [**Documentation Skill**](#documentation-skill): Build documentation-aware assistants.
 
-<!-- truncate -->
-
 ## Upgrade Today
 
 ```bash

hindsight-docs/blog/2026-02-18-version-0-4-12.md

@@ -7,13 +7,13 @@ date: 2026-02-18
 
 Hindsight 0.4.12 expands what you can ingest, cuts ingestion costs, and broadens where you can run it.
 
+<!-- truncate -->
+
 - [**File Ingestion**](#file-ingestion): Retain PDFs, images, and Office documents directly.
 - [**Batch API for Async Retain**](#batch-api-for-async-retain): Cut LLM ingestion costs by 50% using OpenAI and Groq Batch APIs.
 - [**Go Client SDK**](#go-client-sdk): Idiomatic Go client with functional options and full API coverage.
 - [**DiskANN Vector Indexing**](#diskann-vector-indexing): pgvectorscale and Azure pg_diskann support for large-scale deployments.
 
-<!-- truncate -->
-
 ## Upgrade Today
 
 ```bash

hindsight-docs/docs/cookbook/index.mdx

@@ -15,8 +15,8 @@ import RecipeCarousel from '@site/src/components/RecipeCarousel';
 
 Learn how to build with Hindsight through practical examples:
 
-- **[Recipes](#recipes)** - Step-by-step guides and patterns for common use cases
-- **[Applications](#applications)** - Complete, runnable applications demonstrating Hindsight integration
+- **Recipes** - Step-by-step guides and patterns for common use cases
+- **Applications** - Complete, runnable applications demonstrating Hindsight integration
 
 <RecipeCarousel
   title="Recipes"

hindsight-docs/docs/developer/api/retain.mdx

@@ -112,7 +112,7 @@ Tags control **visibility scoping** — which memories are visible during recall
 
 Use consistent naming patterns to keep tag filtering predictable. Common conventions: `user:<id>` for per-user scoping, `session:<id>` for session isolation, `room:<id>` for chat rooms, `topic:<name>` for category filtering. The bank also exposes a list-tags endpoint that returns all tags with their memory counts, useful for UI autocomplete or wildcard expansion.
 
-See [Recall API](./recall#filter-by-tags) for filtering by tags during retrieval.
+See [Recall API](./recall#tags) for filtering by tags during retrieval.
 
 ### Response
 

hindsight-docs/docs/developer/installation.md

@@ -107,7 +107,7 @@ Install it with: pip install sentence-transformers
 ```
 :::
 
-See [Configuration](./configuration#embeddings-and-reranking) for all embedding provider options.
+See [Configuration](./configuration#embeddings) for all embedding provider options.
 
 ### Available Tags
 

hindsight-docs/examples/api/memory-banks.mjs

@@ -32,6 +32,22 @@ await client.updateBankConfig('architect-bank', {
 // [/docs:bank-with-disposition]
 
 
+// [docs:bank-background]
+await client.createBank('my-bank');
+await client.updateBankConfig('my-bank', {
+    reflectMission: 'I am a research assistant specializing in machine learning.',
+});
+// [/docs:bank-background]
+
+
+// [docs:bank-mission]
+await client.createBank('my-bank');
+await client.updateBankConfig('my-bank', {
+    reflectMission: "You're a senior software architect - keep track of system designs, technology decisions, and architectural patterns.",
+});
+// [/docs:bank-mission]
+
+
 // [docs:update-bank-config]
 await client.updateBankConfig('my-bank', {
     retainMission: 'Always include technical decisions, API design choices, and architectural trade-offs. Ignore meeting logistics and social exchanges.',

hindsight-docs/examples/api/memory-banks.py

@@ -37,6 +37,35 @@ client.update_bank_config(
 # [/docs:bank-with-disposition]
 
 
+# [docs:bank-background]
+client.create_bank(bank_id="my-bank")
+client.update_bank_config(
+    "my-bank",
+    reflect_mission="I am a research assistant specializing in machine learning.",
+)
+# [/docs:bank-background]
+
+
+# [docs:bank-mission]
+client.create_bank(bank_id="my-bank")
+client.update_bank_config(
+    "my-bank",
+    reflect_mission="You're a senior software architect - keep track of system designs, "
+            "technology decisions, and architectural patterns.",
+)
+# [/docs:bank-mission]
+
+
+# [docs:bank-support-agent]
+client.create_bank(bank_id="support-bank")
+client.update_bank_config(
+    "support-bank",
+    observations_mission="I am a customer support agent. Track customer preferences, "
+            "recurring issues, and resolution history to provide consistent, personalized support.",
+)
+# [/docs:bank-support-agent]
+
+
 # [docs:update-bank-config]
 client.update_bank_config(
     "my-bank",

hindsight-docs/versioned_docs/version-0.4/cookbook/index.mdx

@@ -15,8 +15,8 @@ import RecipeCarousel from '@site/src/components/RecipeCarousel';
 
 Learn how to build with Hindsight through practical examples:
 
-- **[Recipes](#recipes)** - Step-by-step guides and patterns for common use cases
-- **[Applications](#applications)** - Complete, runnable applications demonstrating Hindsight integration
+- **Recipes** - Step-by-step guides and patterns for common use cases
+- **Applications** - Complete, runnable applications demonstrating Hindsight integration
 
 <RecipeCarousel
   title="Recipes"

hindsight-docs/versioned_docs/version-0.4/developer/api/retain.mdx

@@ -112,7 +112,7 @@ Tags control **visibility scoping** — which memories are visible during recall
 
 Use consistent naming patterns to keep tag filtering predictable. Common conventions: `user:<id>` for per-user scoping, `session:<id>` for session isolation, `room:<id>` for chat rooms, `topic:<name>` for category filtering. The bank also exposes a list-tags endpoint that returns all tags with their memory counts, useful for UI autocomplete or wildcard expansion.
 
-See [Recall API](./recall#filter-by-tags) for filtering by tags during retrieval.
+See [Recall API](./recall#tags) for filtering by tags during retrieval.
 
 ### Response
 

hindsight-docs/versioned_docs/version-0.4/developer/installation.md

@@ -107,7 +107,7 @@ Install it with: pip install sentence-transformers
 ```
 :::
 
-See [Configuration](./configuration#embeddings-and-reranking) for all embedding provider options.
+See [Configuration](./configuration#embeddings) for all embedding provider options.
 
 ### Available Tags