blog: co-brand Copilot cover with the official GitHub Copilot mark

Add the GitHub Copilot logo (top-left lockup + terminal title bar) so the cover reads as a Copilot x Hindsight co-brand. Co-Authored-By: Claude Opus 4.8 <[email protected]>
blog: Give GitHub Copilot CLI a memory of your codebase
2026-07-29 15:56:16 -04:00 · 2026-07-29 15:47:39 -04:00 · 2026-07-29 18:14:45 +02:00 · 2026-07-29 18:09:56 +02:00 · 2026-07-29 16:58:47 +02:00 · 2026-07-29 16:58:04 +02:00
382 changed files with 2000 additions and 770 deletions
@@ -159,6 +159,18 @@ If any files in `hindsight-api-slim/hindsight_api/api/` were changed:
 - Were the client SDKs regenerated? (`./scripts/generate-clients.sh`)
 - Were the control plane proxy routes updated? (`hindsight-control-plane/src/app/api/`)

+### 7a. Check TS/Python wrapper-client parity
+
+Two of the generated SDKs ship a **hand-written, maintained convenience wrapper** on top of the auto-generated low-level client — and *only* these two:
+- **TypeScript**: `hindsight-clients/typescript/src/index.ts` (`HindsightClient`)
+- **Python**: `hindsight-clients/python/hindsight_client/hindsight_client.py` (`Hindsight`)
+
+(The Rust/Go/etc. clients are generated-only — no wrapper to keep in sync.)
+
+These wrappers are what most third-party consumers actually call, and they must expose the same surface. **If a change touches one wrapper's method — adds/removes a parameter, changes a default, forwards a new query/body field — the equivalent method in the *other* wrapper must get the same change in the same (or an immediately-following) PR.** A parameter that exists in the generated SDK but is dropped by one wrapper silently strips it for every consumer of that language (this is exactly what #2975 / #3042 fixed for `detail`/`tags_match`/`limit`/`offset` on `listMentalModels`/`getMentalModel`). **Should fix** — flag any wrapper method that gains capabilities in one language but not the other, and add a matching mapping regression test on both sides.
+
+Note: the `client-coverage-check` CI tool only validates **request-body** fields, not GET **query** parameters — so query-param parity gaps are *not* caught automatically and must be checked by hand here.
+
 ### 7b. Check API-layer data-access boundary

 For each changed handler in `hindsight-api-slim/hindsight_api/api/` (e.g. `http.py`, `mcp.py`):
@@ -2,8 +2,8 @@ apiVersion: v2
 name: hindsight
 description: Hindsight helm chart
 type: application
-version: 0.8.5
-appVersion: "0.8.5"
+version: 0.8.6
+appVersion: "0.8.6"
 keywords:
  - ai
  - memory
@@ -1,6 +1,6 @@
 {
  "name": "@vectorize-io/hindsight-all",
-  "version": "0.8.5",
+  "version": "0.8.6",
  "description": "Node.js programmatic lifecycle manager for Hindsight — embeds a local hindsight daemon in a Node application. Pair with @vectorize-io/hindsight-client for memory operations.",
  "main": "dist/index.js",
  "types": "dist/index.d.ts",
@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"

 [project]
 name = "hindsight-all-slim"
-version = "0.8.5"
+version = "0.8.6"
 description = "Hindsight: Agent Memory That Works Like Human Memory - Slim All-in-One Bundle"
 readme = "README.md"
 requires-python = ">=3.11"
 dependencies = [
-    "hindsight-api-slim==0.8.5",
+    "hindsight-api-slim==0.8.6",
    "hindsight-client>=0.0.7",
    "hindsight-embed>=0.1.0",
 ]
@@ -4,12 +4,12 @@ build-backend = "hatchling.build"

 [project]
 name = "hindsight-all"
-version = "0.8.5"
+version = "0.8.6"
 description = "Hindsight: Agent Memory That Works Like Human Memory - All-in-One Bundle"
 readme = "README.md"
 requires-python = ">=3.11"
 dependencies = [
-    "hindsight-api-slim[all]==0.8.5",
+    "hindsight-api-slim[all]==0.8.6",
    "hindsight-client>=0.0.7",
    "hindsight-embed>=0.1.0",
 ]
@@ -21,7 +21,7 @@ hindsight-embed = { workspace = true }

 [project.optional-dependencies]
 local-llm = [
-    "hindsight-api-slim[local-llm]==0.8.5",
+    "hindsight-api-slim[local-llm]==0.8.6",
 ]
 test = [
    "pytest>=7.0.0",
@@ -53,4 +53,4 @@ __all__ = [
    "RemoteTEICrossEncoder",
    "LLMConfig",
 ]
-__version__ = "0.8.5"
+__version__ = "0.8.6"
@@ -956,6 +956,12 @@ class ReflectRequest(BaseModel):
        description="Compound tag filter using boolean groups. Groups in the list are AND-ed. "
        "Each group is a leaf {tags, match} or compound {and: [...]}, {or: [...]}, {not: ...}.",
    )
+    apply_all_directives: bool = Field(
+        default=False,
+        description="Apply every active directive regardless of tags. By default directives are "
+        "scoped like memories: untagged directives always apply, and tagged directives apply only "
+        "when the request's tags match them. Set true to apply all active directives, ignoring tag scope.",
+    )
    fact_types: list[Literal["world", "experience", "observation"]] | None = Field(
        default=None,
        description="Filter which fact types are retrieved during reflect. None means all types (world, experience, observation).",
@@ -4349,6 +4355,7 @@ def _register_routes(app: FastAPI):
                        tags=request.tags,
                        tags_match=request.tags_match,
                        tag_groups=request.tag_groups,
+                        apply_all_directives=request.apply_all_directives,
                        fact_types=request.fact_types,
                        exclude_mental_models=request.exclude_mental_models,
                        exclude_mental_model_ids=request.exclude_mental_model_ids,
@@ -9911,6 +9911,7 @@ class MemoryEngine(MemoryEngineInterface):
        tags: list[str] | None = None,
        tags_match: TagsMatch = "any",
        tag_groups: list[TagGroup] | None = None,
+        apply_all_directives: bool = False,
        exclude_mental_model_ids: list[str] | None = None,
        fact_types: list[str] | None = None,
        exclude_mental_models: bool = False,
@@ -9947,6 +9948,11 @@ class MemoryEngine(MemoryEngineInterface):
            response_schema: Optional JSON Schema for structured output (not yet supported)
            tags: Optional tags to filter memories
            tags_match: How to match tags - "any" (OR), "all" (AND)
+            apply_all_directives: When True, apply every active directive regardless of
+                tags, ignoring the request's tag scope for directives. When False
+                (default), directives are scoped like memories: untagged directives
+                always apply and tagged directives apply only when the request's tags
+                match them.
            exclude_mental_model_ids: Optional list of mental model IDs to exclude from search
                (used when refreshing a mental model to avoid circular reference)

@@ -10134,19 +10140,31 @@ class MemoryEngine(MemoryEngineInterface):
            async with backend.acquire() as conn:
                return await tool_expand(conn, bank_id, memory_ids, depth)

-        # Load directives from the dedicated directives table
-        # Directives are hard rules that must be followed in all responses
-        # Use isolation_mode=True to prevent tag-scoped directives from leaking into untagged operations
-        # Use the same tags_match as the reflect request so directives respect the same scoping rules
-        directives_raw = await self.list_directives(
-            bank_id=bank_id,
-            tags=tags,
-            tags_match=tags_match,
-            tag_groups=tag_groups,
-            active_only=True,
-            request_context=request_context,
-            isolation_mode=True,
-        )
+        # Load directives from the dedicated directives table.
+        # Directives are hard rules that must be followed in all responses.
+        if apply_all_directives:
+            # Caller opted out of tag scoping: apply every active directive regardless
+            # of the request's tags (no tag filter, isolation off).
+            directives_raw = await self.list_directives(
+                bank_id=bank_id,
+                active_only=True,
+                request_context=request_context,
+                isolation_mode=False,
+            )
+        else:
+            # Scope directives like memories: untagged directives always apply, tagged
+            # ones only when the reflect tags match. isolation_mode keeps tag-scoped
+            # directives from leaking into an untagged reflect. Use the same tags_match
+            # as the reflect request so directives respect the same scoping rules.
+            directives_raw = await self.list_directives(
+                bank_id=bank_id,
+                tags=tags,
+                tags_match=tags_match,
+                tag_groups=tag_groups,
+                active_only=True,
+                request_context=request_context,
+                isolation_mode=True,
+            )
        directives = directives_raw
        if directives:
            logger.info(f"[REFLECT {reflect_id}] Loaded {len(directives)} directives")
@@ -95,8 +95,10 @@ async def tool_search_mental_models(
    params: list[Any] = [bank_id, str(query_embedding), max_results]
    next_param = 4

-    # Use the centralized tag filtering logic
-    if tags:
+    # Exact matching treats absent or empty tags as the global scope. Do not
+    # skip the filter, or mental models would see every scope while the other
+    # reflect retrieval tools correctly see only untagged data.
+    if tags or tags_match == "exact":
        tag_clause, tag_params, next_param = build_tags_where_clause(tags, param_offset=next_param, match=tags_match)
        filters += f" {tag_clause}"
        params.extend(tag_params)
@@ -1020,6 +1020,7 @@ def _register_reflect(mcp: FastMCP, memory: MemoryEngine, config: MCPToolsConfig
            response_schema: dict | None = None,
            tags: list[str] | None = None,
            tags_match: str = "any",
+            apply_all_directives: bool = False,
            include_based_on: bool = False,
            include_trace: bool = False,
            bank_id: str | None = None,
@@ -1051,6 +1052,7 @@ def _register_reflect(mcp: FastMCP, memory: MemoryEngine, config: MCPToolsConfig
                response_schema: Optional JSON schema for structured output. When provided, the response includes a 'structured_output' field.
                tags: Optional tags to filter memories by (e.g., ['project:alpha'])
                tags_match: How to match tags - 'any' (match any tag) or 'all' (match all tags). Default: 'any'
+                apply_all_directives: Apply every active directive regardless of tags. By default directives are scoped like memories (untagged always apply; tagged apply only when tags match). Set true to apply all directives, ignoring tag scope.
                include_based_on: Include source facts used for synthesis. Defaults to false because broad reflections can exceed MCP client result limits.
                include_trace: Include the reflection's internal trace fields (tool_trace/llm_trace and directives_applied). Defaults to false because the trace can be tens of KB and overflow MCP client context; enable only for debugging.
                bank_id: Optional bank to reflect in (defaults to session bank). Use for cross-bank operations.
@@ -1069,6 +1071,7 @@ def _register_reflect(mcp: FastMCP, memory: MemoryEngine, config: MCPToolsConfig
                    "budget": budget_enum,
                    "context": context,
                    "max_tokens": max_tokens,
+                    "apply_all_directives": apply_all_directives,
                    "request_context": _get_request_context(config),
                }
                if response_schema is not None:
@@ -1112,6 +1115,7 @@ def _register_reflect(mcp: FastMCP, memory: MemoryEngine, config: MCPToolsConfig
            response_schema: dict | None = None,
            tags: list[str] | None = None,
            tags_match: str = "any",
+            apply_all_directives: bool = False,
            include_based_on: bool = False,
            include_trace: bool = False,
        ) -> dict:
@@ -1142,6 +1146,7 @@ def _register_reflect(mcp: FastMCP, memory: MemoryEngine, config: MCPToolsConfig
                response_schema: Optional JSON schema for structured output. When provided, the response includes a 'structured_output' field.
                tags: Optional tags to filter memories by (e.g., ['project:alpha'])
                tags_match: How to match tags - 'any' (match any tag) or 'all' (match all tags). Default: 'any'
+                apply_all_directives: Apply every active directive regardless of tags. By default directives are scoped like memories (untagged always apply; tagged apply only when tags match). Set true to apply all directives, ignoring tag scope.
                include_based_on: Include source facts used for synthesis. Defaults to false because broad reflections can exceed MCP client result limits.
                include_trace: Include the reflection's internal trace fields (tool_trace/llm_trace and directives_applied). Defaults to false because the trace can be tens of KB and overflow MCP client context; enable only for debugging.
            """
@@ -1159,6 +1164,7 @@ def _register_reflect(mcp: FastMCP, memory: MemoryEngine, config: MCPToolsConfig
                    "budget": budget_enum,
                    "context": context,
                    "max_tokens": max_tokens,
+                    "apply_all_directives": apply_all_directives,
                    "request_context": _get_request_context(config),
                }
                if response_schema is not None:
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"

 [project]
 name = "hindsight-api-slim"
-version = "0.8.5"
+version = "0.8.6"
 description = "Hindsight: Agent Memory That Works Like Human Memory"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -588,6 +588,54 @@ class TestDirectivesInReflect:
        # Cleanup
        await memory.delete_bank(bank_id, request_context=request_context)

+    async def test_apply_all_directives_overrides_tag_isolation(self, memory: MemoryEngine, request_context):
+        """apply_all_directives=True loads every directive regardless of the reflect tag scope."""
+        bank_id = f"test-directive-apply-all-{uuid.uuid4().hex[:8]}"
+
+        await memory.get_bank_profile(bank_id, request_context=request_context)
+
+        # Untagged + tagged directives in the bank.
+        await memory.create_directive(
+            bank_id=bank_id,
+            name="General Policy",
+            content="You MUST include the exact phrase 'MEMO-VERIFIED' somewhere in your response.",
+            request_context=request_context,
+        )
+        await memory.create_directive(
+            bank_id=bank_id,
+            name="Tagged Policy",
+            content="You MUST include the exact phrase 'PROJECT-X-CLASSIFIED' somewhere in your response.",
+            tags=["project-x"],
+            request_context=request_context,
+        )
+
+        # No reflect tags: default isolation drops the tagged directive...
+        default_result = await memory.reflect_async(
+            bank_id=bank_id,
+            query="What color is the sky?",
+            request_context=request_context,
+        )
+        default_names = [d.name for d in default_result.directives_applied]
+        assert "Tagged Policy" not in default_names, (
+            f"Tagged directive should be isolated out by default. Applied: {default_names}"
+        )
+
+        # ...but apply_all_directives=True loads both, ignoring tag scope.
+        all_result = await memory.reflect_async(
+            bank_id=bank_id,
+            query="What color is the sky?",
+            apply_all_directives=True,
+            request_context=request_context,
+        )
+        all_names = [d.name for d in all_result.directives_applied]
+        assert "General Policy" in all_names, f"Untagged directive should be loaded. Applied: {all_names}"
+        assert "Tagged Policy" in all_names, (
+            f"Tagged directive should be loaded when apply_all_directives=True. Applied: {all_names}"
+        )
+
+        # Cleanup
+        await memory.delete_bank(bank_id, request_context=request_context)
+
    async def test_reflect_based_on_structure(self, memory: MemoryEngine, request_context):
        """Test that reflect returns correct based_on structure with directives and memories separated."""
        bank_id = f"test-reflect-based-on-{uuid.uuid4().hex[:8]}"
@@ -2,11 +2,16 @@

 import re
 import uuid
+from unittest.mock import AsyncMock, MagicMock

 import pytest

 from hindsight_api.engine.reflect.agent import _execute_tool, _summarize_input
-from hindsight_api.engine.reflect.tools import _document_metadata_from_retain_params, tool_expand
+from hindsight_api.engine.reflect.tools import (
+    _document_metadata_from_retain_params,
+    tool_expand,
+    tool_search_mental_models,
+)


 class _FakeReflectConnection:
@@ -92,6 +97,33 @@ class _FakeMultiMemoryConnection:
        raise AssertionError(f"Unexpected query: {normalized_query}")


+@pytest.mark.asyncio
+@pytest.mark.parametrize("tags", [None, []], ids=["omitted", "empty"])
+async def test_tool_search_mental_models_exact_empty_scope_selects_global_models(
+    tags: list[str] | None,
+) -> None:
+    """An exact empty scope must exclude tagged mental models."""
+    conn = MagicMock()
+    conn.fetch = AsyncMock(return_value=[])
+
+    result = await tool_search_mental_models(
+        memory_engine=MagicMock(),
+        conn=conn,
+        bank_id="test-global-mental-model-scope",
+        query="global summary",
+        query_embedding=[0.1, 0.2],
+        tags=tags,
+        tags_match="exact",
+    )
+
+    fetch_call = conn.fetch.await_args
+    assert fetch_call is not None
+    query, *args = fetch_call.args
+    assert "(tags IS NULL OR tags = '{}')" in re.sub(r"\s+", " ", query).strip()
+    assert args == ["test-global-mental-model-scope", "[0.1, 0.2]", 5]
+    assert result["mental_models"] == []
+
+
@pytest.mark.asyncio
 async def test_tool_expand_pairs_each_memory_id_with_its_own_memory() -> None:
    """An invalid memory_id must not shift the memories returned for the ids after it."""
@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"

 [project]
 name = "hindsight-api"
-version = "0.8.5"
+version = "0.8.6"
 description = "Hindsight: Agent Memory That Works Like Human Memory"
 readme = "README.md"
 requires-python = ">=3.11"
 dependencies = [
-    "hindsight-api-slim[all]==0.8.5",
+    "hindsight-api-slim[all]==0.8.6",
 ]

 [tool.uv.sources]
@@ -123,6 +123,7 @@ min_scores = "Complex nested per-stage score floors (semantic/keyword/reranker/f
 include = "Flattened into --include-facts and related flags."
 response_schema = "Exposed as --schema (path to a JSON schema file)."
 tag_groups = "Complex nested tag filter not yet exposed in the CLI; use --tags / --tags-match for simple cases."
+apply_all_directives = "Directive tag-scope override; exposed via the API, SDKs, and control plane, not the end-user CLI yet."

 [fields.retain_memories]
 items = "Constructed from the single positional content argument on `memory retain`."
@@ -1,6 +1,6 @@
 [package]
 name = "hindsight-cli"
-version = "0.8.5"
+version = "0.8.6"
 edition = "2021"
 authors = ["Hindsight Team"]
 description = "A beautiful CLI for Hindsight - semantic memory system"
@@ -346,6 +346,7 @@ impl App {
                            tags: None,
                            tags_match: TagsMatch::Any,
                            tag_groups: None,
+                            apply_all_directives: false,
                            fact_types: None,
                            exclude_mental_models: false,
                            exclude_mental_model_ids: None,
@@ -408,6 +408,7 @@ pub fn reflect(
        tags: if tags.is_empty() { None } else { Some(tags) },
        tags_match: parse_tags_match(&tags_match),
        tag_groups: None,
+        apply_all_directives: false,
        fact_types: mapped_fact_types,
        exclude_mental_models,
        exclude_mental_model_ids,
@@ -7,7 +7,7 @@ info:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  title: Hindsight HTTP API
-  version: 0.8.5
+  version: 0.8.6
 servers:
 - url: /
 paths:
@@ -7689,6 +7689,14 @@ components:
            $ref: '#/components/schemas/MentalModelTrigger_Input_tag_groups_inner'
          nullable: true
          type: array
+        apply_all_directives:
+          default: false
+          description: "Apply every active directive regardless of tags. By default\
+            \ directives are scoped like memories: untagged directives always apply,\
+            \ and tagged directives apply only when the request's tags match them.\
+            \ Set true to apply all active directives, ignoring tag scope."
+          title: Apply All Directives
+          type: boolean
        fact_types:
          items:
            enum:
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -41,7 +41,7 @@ var (
 	queryDescape    = strings.NewReplacer( "%5B", "[", "%5D", "]" )
 )

-// APIClient manages communication with the Hindsight HTTP API API v0.8.5
+// APIClient manages communication with the Hindsight HTTP API API v0.8.6
 // In most cases there should be only one, shared, APIClient.
 type APIClient struct {
 	cfg    *Configuration
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -3,7 +3,7 @@ Hindsight HTTP API

 HTTP API for Hindsight

-API version: 0.8.5
+API version: 0.8.6
 */

 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
BenandClaude Opus 4.8	beaf96d079	blog: co-brand Copilot cover with the official GitHub Copilot mark Add the GitHub Copilot logo (top-left lockup + terminal title bar) so the cover reads as a Copilot x Hindsight co-brand. Co-Authored-By: Claude Opus 4.8 <[email protected]>	2026-07-29 15:56:16 -04:00
BenandClaude Opus 4.8	c2e59b5b55	blog: Give GitHub Copilot CLI a memory of your codebase Tutorial for hindsight-copilot-cli (published, v0.1.0): persistent memory for GitHub Copilot CLI via hooks. Recall on sessionStart, retain on agentStop/sessionEnd, subagents seeded with baseline project memory. Grounded in the integration source; documents the once-per-session recall limitation honestly. Co-Authored-By: Claude Opus 4.8 <[email protected]>	2026-07-29 15:47:39 -04:00
Nicolò Boschi	6268654bf6	docs: changelog and blog post for v0.8.6 (#3051 ) * docs: changelog and blog post for v0.8.6 * docs: focus 0.8.6 blog post on new features * docs: lead 0.8.6 blog with the entity timeline * docs: use entity timeline gif in 0.8.6 blog post * docs: drop embedded-engine bullet from 0.8.6 blog post * chore(docs-skill): sync openapi version to 0.8.6	2026-07-29 18:14:45 +02:00
Nicolò Boschi	08995e3013	Release v0.8.6 - Update version to 0.8.6 in all components - Regenerate OpenAPI spec and client SDKs - Python packages: hindsight-api, hindsight-dev, hindsight-all, hindsight-embed - Python client: hindsight-clients/python - TypeScript client: hindsight-clients/typescript - hindsight-all npm wrapper: hindsight-all-npm - Rust CLI: hindsight-cli - Control Plane: hindsight-control-plane - Helm chart - Sync documentation to version-0.8	2026-07-29 18:09:56 +02:00
Nicolò Boschi	3a1841c421	feat(control-plane): add document tag filtering and unify facet chips (#3049 ) Documents list -------------- The documents table exposed only a document-ID search, even though `GET /banks/{id}/documents` has supported `tags` + `tags_match` all along. Wires those through the control-plane proxy and the client, and adds the tag filter (with autocomplete and an any/all toggle) to the toolbar. Both UI modes map to their `*_strict` variant, since the non-strict ones deliberately include untagged documents and read as a broken filter. Also fixes two things found while working on it: - The filter toolbar lived inside the "has results" branch, so a filter matching nothing removed the only means of clearing it. - Two effects both called `loadDocuments`, one debounced and one not, so every keystroke issued two requests. The table is reworked around what it is actually scanned for: updated-at moves under the document ID, created-at is dropped (it duplicated updated-at for nearly every document, and both remain in the dialog), tags and metadata share one column, and size / memory-units get fixed right-aligned columns. `table-fixed` is what makes the declared widths hold — under auto layout the long mono IDs sized the first column themselves, so `truncate` never engaged. Facet chips ----------- Tags, entities and metadata were styled independently in each view: tags were blue in the memory dialog, amber in the documents table and purple in directives, while entities reused the tag blue so the two were indistinguishable. The memories table had them inverted relative to the dialog. `ui/facet-chip` is now the single place all three are rendered, adopted across 13 components. Colour does not carry the kind. Several revisions tried a saturated fill per kind and each read as busy at chip size, duplicating what the `#` and `key=` prefixes and the header legend already say. Kinds are separated by form, over one quiet neutral treatment in three tonal variants; the brand cyan is spent only on an active filter, as an outline. Tokens live in globals.css so both themes resolve through the `.dark` block. That also sidesteps a pre-existing issue: the app is on Tailwind v4, where `dark:` compiles to a prefers-color-scheme media query, but themes are switched with a `.dark` class and no `@custom-variant dark` is declared — so literal `dark:` utilities only fire when the OS agrees. That still affects ~115 utilities elsewhere and is left for a separate change. Layout ------ - Bank page used `min-h-screen`, so the page grew past the viewport and scrolled the header and sidebar away instead of scrolling `main`. - TagFilterInput put applied chips inline with the input and the match toggle, which came apart past two or three tags. Chips now get their own row, and `flex-1 min-w-0` is baked in: without it the block's flex-basis was the max-content width of the chips row, so one long tag collapsed the sibling search input to nothing.	2026-07-29 16:58:47 +02:00
Nicolò Boschi	94f4adfbed	fix(control-plane): bind the `dark:` variant to the .dark class (#3050 ) Tailwind v4 changed the default meaning of `dark:`: it now compiles to `@media (prefers-color-scheme: dark)` unless a `@custom-variant` says otherwise. This app switches themes by toggling a `.dark` class on <html> (lib/theme-context.tsx) and never declared one, so every literal `dark:` utility was keyed to the OS setting rather than the in-app toggle — it fired only when the two happened to agree, and never at all for a user on a light OS. The CSS-variable half of theming always worked, since the `.dark` block overrides the tokens directly. That is what made this easy to miss: backgrounds and foregrounds flipped correctly while ~145 literal `dark:` utilities silently did nothing. They are almost entirely `dark:text--400` lightened text plus `dark:prose-invert` for rendered markdown, i.e. exactly the "make this readable on a dark surface" cases. Measured on the LLM Requests table, the `success` badge (`text-green-800 dark:text-green-300` on `bg-green-500/10`): before 1.17:1 — effectively invisible after 12.81:1 Every utility affected was audited: all 145 are dark-appropriate values (lightened text, darker `bg--900/30` fills, stronger borders, `prose-invert`). None were tuned to compensate for the variant being inert, so switching it on corrects them rather than inverting anything. Contrast was re-checked across the affected elements — on the bank config page, all 25 elements carrying a `dark:` class pass at 7.02:1 or better. Verified with a production build, since `@custom-variant` is parsed at build time.	2026-07-29 16:58:04 +02:00
Nicolò Boschi	70c09adcf0	fix(clients): expose mental model query controls in python wrapper (#3047 ) Mirror the TypeScript wrapper fix (#3042) on the Python side: the hand-written Hindsight wrapper's list_mental_models forwarded only tags, and get_mental_model forwarded no query at all, so Python consumers silently inherited the server's detail=full default and could not use tag-match or pagination — even though the generated MentalModelsApi already supports all of them. Forward tags_match/detail/limit/offset on list_mental_models and detail on get_mental_model, and add mapping regression tests so a refactor cannot restore the dropped controls. Follow-up to #2975 / #3042 (Python-wrapper parity).	2026-07-29 16:00:47 +02:00
Sanderhoff-alt	c5643fdf5c	fix(reflect): apply exact empty scope to mental models (#3039 ) Apply the exact tag filter even when the requested tag list is empty. This keeps mental-model retrieval aligned with facts and observations. Add a regression test that verifies the generated query selects only the untagged global scope.	2026-07-29 15:56:59 +02:00
Nicolò Boschi	6a460d2c9a	feat(reflect): add apply_all_directives to bypass directive tag scoping (#3031 ) (#3046 ) * feat(reflect): add apply_all_directives to bypass directive tag scoping (#3031) Directives are tag-scoped like memories: a reflect with no tags loads only untagged directives, and tagged directives apply only when the request's tags match. This is deliberate (isolation_mode), but it means an operator's tag-organized directives silently never reach an untagged reflect — 45% of standing rules in the deployment reported in #3031. Add an opt-in `apply_all_directives` flag on the reflect request (default false, preserving current behavior). When true, every active directive is loaded regardless of tags, ignoring tag scope. Wired through the HTTP API, both MCP reflect variants, and the engine. Also correct the docs, which claimed directives are "always" enforced without mentioning tag scoping. Regenerated OpenAPI, clients (Go/Python/TS/Rust), and the docs skill mirror; updated the control-plane reflect proxy + api.ts types. * chore(cli): record apply_all_directives CLI-coverage exemption The reflect field is intentionally not exposed as a CLI flag (available via the REST API, SDKs, and control plane). Record the exemption so cli-coverage-check passes, matching the existing tag_groups entry.	2026-07-29 15:39:50 +02:00