ltcai 7.4.0 → 7.5.0

package/README.md

@@ -69,42 +69,42 @@ You need Lattice AI when:
 Choose the owner of the Brain. The profile is not a SaaS account by default; it
 is the local identity for the knowledge you keep.
 
-![Login](output/release/v7.0.0/screenshots/01-login.png)
+![Login](output/release/v7.5.0/screenshots/01-login.png)
 
 ### 2. Environment Analysis
 
 See what kind of local AI experience this computer can support before choosing a
 model.
 
-![Environment Analysis](output/release/v7.0.0/screenshots/02-environment-analysis.png)
+![Environment Analysis](output/release/v7.5.0/screenshots/02-environment-analysis.png)
 
 ### 3. Recommended Models
 
 Start with a short list: safest recommendation, faster model, stronger model.
 Advanced details stay available without overwhelming first-time users.
 
-![Recommended Models](output/release/v7.0.0/screenshots/03-recommended-models.png)
+![Recommended Models](output/release/v7.5.0/screenshots/03-recommended-models.png)
 
 ### 4. Install And Load
 
 Download and load only after consent. Lattice explains model size, local
 execution, and network use before work starts.
 
-![Install and Load](output/release/v7.0.0/screenshots/04-install-load-progress.png)
+![Install and Load](output/release/v7.5.0/screenshots/04-install-load-progress.png)
 
 ### 5. Brain Chat
 
 Talk normally. Useful decisions and context become memory, then appear later as
 topics, relationships, and graph structure.
 
-![Brain Chat Home](output/release/v7.0.0/screenshots/05-brain-chat-home.png)
+![Brain Chat Home](output/release/v7.5.0/screenshots/05-brain-chat-home.png)
 
 ### 6. Review Center
 
 Automation results are staged for review before they become durable decisions.
 Snooze, unsnooze, run now, approve, and dismiss actions stay explicit.
 
-![Review Center](output/release/v7.0.0/screenshots/13-review-center.png)
+![Review Center](output/release/v7.5.0/screenshots/13-review-center.png)
 
 ## Brain Depths
 
@@ -120,10 +120,10 @@ The user travels inward from everyday memory to deeper structure:
 
 Walkthrough:
 
-![v7.0.0 Living Brain walkthrough](output/release/v7.0.0/gifs/v7.0.0-living-brain-walkthrough.gif)
+![v7.5.0 Living Brain walkthrough](output/release/v7.5.0/gifs/v7.5.0-living-brain-walkthrough.gif)
 
 Screenshot index and capture notes:
-[output/release/v7.0.0/SCREENSHOT_INDEX.md](output/release/v7.0.0/SCREENSHOT_INDEX.md)
+[output/release/v7.5.0/SCREENSHOT_INDEX.md](output/release/v7.5.0/SCREENSHOT_INDEX.md)
 
 ## Install
 
@@ -200,33 +200,34 @@ See [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) for developer workflow details.
 
 ## Current Release
 
-The current release is **7.4.0 Runtime Contract Convergence & Corpus Retrieval**:
+The current release is **7.5.0 Runtime Debt Burn-down & Release Risk Cleanup**:
 
 - Agent runs, workflow runs, audit events, and realtime events now carry the
   `agent-run-contract/v1` family envelope, so replay, admin review, and live
   feeds can inspect run identity, runtime, status, timeline, and artifacts
   through one contract shape.
-- Persisted queued/running/terminal agent and workflow rows refresh their
-  contract on every state transition, including cancellation and interruption.
-- Audit rows keep their existing admin fields while adding redacted contract
-  metadata; realtime SSE events keep `area`, `event_type`, `workspace_id`, and
-  `payload` while adding the same contract family.
+- AgentRuntime and realtime API responses now expose compact `contracts` views
+  so downstream consumers can read the common envelope instead of re-parsing
+  surface-specific records.
 - Brain quality evaluation now runs a real KnowledgeGraphStore + SearchService
-  corpus fixture with judged queries, recall, precision, NDCG, and must-include
-  hit-rate thresholds.
+  corpus fixture with 250+ records, judged queries, recall, precision, NDCG,
+  and must-include hit-rate thresholds.
+- Release risk cleanup removes stale-artifact upload ambiguity, clears npm audit
+  findings, and updates the Tauri 2 stack so the old `block v0.1.6`
+  future-incompatibility warning is gone.
 
-Expected artifacts for 7.4.0 release must use exact filenames:
+Expected artifacts for 7.5.0 release must use exact filenames:
 
-- `dist/ltcai-7.4.0-py3-none-any.whl`
-- `dist/ltcai-7.4.0.tar.gz`
-- `ltcai-7.4.0.tgz`
-- `dist/ltcai-7.4.0.vsix`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_7.4.0_aarch64.dmg`
+- `dist/ltcai-7.5.0-py3-none-any.whl`
+- `dist/ltcai-7.5.0.tar.gz`
+- `ltcai-7.5.0.tgz`
+- `dist/ltcai-7.5.0.vsix`
+- `src-tauri/target/release/bundle/dmg/Lattice AI_7.5.0_aarch64.dmg`
 
 Do not upload `dist/*`. Package registry publishing remains owner-run.
 
 See [docs/ROADMAP_RECOMMENDATIONS.md](docs/ROADMAP_RECOMMENDATIONS.md) for the
-strategic roadmap slices applied through 7.4.0 and the follow-up tracks.
+strategic roadmap slices applied through 7.5.0 and the follow-up tracks.
 
 ## Known Limitations
 
@@ -243,6 +244,7 @@ strategic roadmap slices applied through 7.4.0 and the follow-up tracks.
 
 | Version | Theme |
 | --- | --- |
+| 7.5.0 | Runtime Debt Burn-down & Release Risk Cleanup: API consumers get normalized contract views, retrieval quality uses a 250+ record corpus fixture, stale artifact risk is removed, npm audit is clean, and Tauri is updated past the old block warning |
 | 7.4.0 | Runtime Contract Convergence & Corpus Retrieval: agent/workflow/audit/realtime records share the agent-run-contract/v1 family, and retrieval quality gates run against a real corpus-scale fixture |
 | 7.3.0 | Runtime Contract & Retrieval Quality: shared agent-run contract across runtimes plus deterministic hybrid recall/ranking regression gates |
 | 7.2.0 | Runtime Trust Baseline: agent run preview/readiness, simulation-mode guardrails, live ToolRegistry manifest/diagnostics, and tests for dispatch/governance/catalog drift |

package/docs/CHANGELOG.md

@@ -4,6 +4,32 @@ The top entry is either the current unreleased main-branch work or the current
 release line. Older entries are historical and may describe behavior as it
 existed at that release.
 
+## [7.5.0] - 2026-06-20
+
+> Runtime Debt Burn-down & Release Risk Cleanup. Turns the 7.4.0 contract
+> envelope into a consumed API surface, expands retrieval quality to a 250+
+> record local corpus fixture, and removes release/security warnings.
+
+### Added
+- `extract_contract`, `require_contract`, `contract_view`, and `contract_views`
+  helpers for consumers that need a surface-agnostic `agent-run-contract/v1`
+  projection.
+- AgentRuntime status/list/detail/events and realtime feed responses now expose
+  compact `contracts` views alongside legacy payloads.
+- Deterministic 250+ record retrieval benchmark corpus while keeping 12 judged
+  queries and real `KnowledgeGraphStore` + `SearchService` execution.
+- Refreshed README release evidence screenshots and walkthrough GIF under
+  `output/release/v7.5.0/`.
+
+### Changed
+- Tauri Rust/CLI dependencies are updated within the Tauri 2 line, removing the
+  old transitive `block v0.1.6` future-incompatibility warning.
+- npm dependency overrides move `js-yaml` to a non-vulnerable version; `npm
+  audit` reports 0 vulnerabilities.
+- CI lint compatibility is restored for the Brain quality gate script.
+- Package/runtime/static metadata is synchronized to 7.5.0; package publish and
+  deployment remain owner-run only.
+
 ## [7.4.0] - 2026-06-20
 
 > Runtime Contract Convergence & Corpus Retrieval. Completes the

package/docs/ROADMAP_RECOMMENDATIONS.md

@@ -30,6 +30,19 @@ small release-sized work. The operating principle stays unchanged:
   Knowledge Graph corpus and scores SearchService hybrid retrieval with judged
   queries, recall, precision, NDCG, and must-include hit-rate thresholds.
 
+## 7.5.0 Applied Slice
+
+7.5.0 burns down the remaining 7.4.0 risk instead of deferring it:
+
+- Contract consumption: AgentRuntime and realtime feed APIs now emit compact
+  `contracts` views so UI, replay, admin, and export consumers can depend on the
+  shared family envelope directly.
+- Retrieval scale: the corpus fixture now runs against 250+ local records while
+  keeping judged queries, graded relevance, and must-include expectations.
+- Release trust: stale artifact mixing is handled through clean exact-version
+  artifact generation, npm audit findings are cleared, and the Tauri 2 stack is
+  updated past the old `block v0.1.6` future-incompatibility warning.
+
 ## Near-Term Tracks
 
 1. Retrieval quality and scale
@@ -43,7 +56,8 @@ small release-sized work. The operating principle stays unchanged:
    - Surface conflict resolution for contradictory memories.
 
 3. Runtime convergence
-   - Drive UI run/replay/admin views from the shared contract family.
+   - Migrate remaining UI run/replay/admin components to read the API-level
+     compact contract views as their primary source.
    - Keep simulation mode explicit and never record it as product success.
    - Route tools through explicit registry/governance contracts.
 

package/lattice_brain/__init__.py

@@ -26,7 +26,7 @@ from .storage import (
     storage_from_env,
 )
 
-__version__ = "7.4.0"
+__version__ = "7.5.0"
 
 __all__ = [
     "AgentRuntime",

package/lattice_brain/retrieval_benchmark_fixtures.py

@@ -1,11 +1,11 @@
-"""Corpus-scale retrieval fixture for the 7.4.0 Brain quality gate."""
+"""Corpus-scale retrieval fixture for the 7.5.0 Brain quality gate."""
 
 from __future__ import annotations
 
-FIXTURE_NAME = "7.4.0-corpus-scale-hybrid-retrieval"
+FIXTURE_NAME = "7.5.0-corpus-scale-hybrid-retrieval"
 TOP_K = 5
 
-DOCUMENTS = [
+CORE_DOCUMENTS = [
     {"id": "doc:agent-runtime-contract", "type": "Decision", "title": "Agent runtime contract", "content": "Workflow run, agent run, audit event, and realtime event records must carry the agent-run-contract/v1 family envelope with run id, runtime, status, timeline, and artifacts."},
     {"id": "doc:workflow-observability", "type": "Document", "title": "Workflow observability", "content": "Workflow Designer persists queued, running, awaiting approval, cancelled, interrupted, partial, failed, and ok runs with replayable timeline events."},
     {"id": "doc:audit-trust", "type": "Security", "title": "Audit trust", "content": "Audit events are append-only, redacted before persistence, and linked to execution contracts for admin review without leaking secrets."},
@@ -33,24 +33,60 @@ DOCUMENTS = [
     {"id": "doc:docker-tauri", "type": "Deployment", "title": "Deployment operations", "content": "Docker Compose deployment, one-click installation, Tauri auto-updates, rollback support, and exact release artifacts improve operations."},
     {"id": "doc:model-routing", "type": "Runtime", "title": "Model orchestration", "content": "Ollama, LM Studio, MLX, and cloud models need automatic fallback, routing, and replaceable model boundaries."},
     {"id": "doc:strict-quality", "type": "Quality", "title": "Strict code quality", "content": "Async-first architecture, dependency injection, centralized exceptions, mypy or pyright, TypeScript strict mode, E2E tests, and property tests reduce regressions."},
-    {"id": "distractor:theme-editor", "type": "Distractor", "title": "Theme editor", "content": "Color palettes, typography, and sidebar icon sizing are useful but unrelated to retrieval contract benchmarks."},
-    {"id": "distractor:calendar", "type": "Distractor", "title": "Calendar reminders", "content": "Calendar reminders and meeting agenda formatting are integrations but not the runtime event contract path."},
+    {"id": "distractor:theme-editor", "type": "Distractor", "title": "Theme editor", "content": "Color palettes, typography, and sidebar icon sizing are useful visual polish topics."},
+    {"id": "distractor:calendar", "type": "Distractor", "title": "Calendar reminders", "content": "Calendar reminders and meeting agenda formatting are productivity integrations."},
     {"id": "distractor:billing", "type": "Distractor", "title": "Billing invoices", "content": "Invoices, payment receipts, and subscription emails can be stored but are not the Brain quality gate."},
-    {"id": "distractor:mobile-shell", "type": "Distractor", "title": "Mobile shell", "content": "A mobile companion can improve access but should not replace local-first desktop retrieval and run observability."},
-    {"id": "distractor:marketing", "type": "Distractor", "title": "Marketing landing page", "content": "Landing pages and hero copy do not prove durable knowledge or agent runtime correctness."},
+    {"id": "distractor:mobile-shell", "type": "Distractor", "title": "Mobile shell", "content": "A mobile companion can improve access with push notifications and offline cache."},
+    {"id": "distractor:marketing", "type": "Distractor", "title": "Marketing landing page", "content": "Landing pages and hero copy shape positioning and campaign messaging."},
 ]
 
+_DISTRACTOR_TOPICS = [
+    ("finance", "quarterly planning", "budget variance vendor renewal procurement forecast"),
+    ("design", "component polish", "spacing typography icon density color token accessibility"),
+    ("support", "customer escalation", "ticket triage priority response macro satisfaction"),
+    ("ops", "incident rotation", "oncall handoff status page maintenance window"),
+    ("sales", "pipeline review", "lead scoring opportunity stage forecast account"),
+    ("calendar", "meeting schedule", "agenda reminder availability invite followup"),
+    ("email", "inbox policy", "thread label archive template unsubscribe"),
+    ("mobile", "companion shell", "push notification offline cache deep link"),
+    ("billing", "invoice lifecycle", "receipt tax subscription entitlement payment"),
+    ("analytics", "dashboard report", "cohort funnel metric annotation export"),
+    ("theme", "appearance settings", "palette contrast sidebar density motion"),
+    ("legal", "compliance packet", "clause obligation renewal signature counterparty"),
+]
+
+
+def _generated_distractors() -> list[dict[str, str]]:
+    """Create a deterministic local corpus large enough to exercise ranking."""
+    docs: list[dict[str, str]] = []
+    for batch in range(20):
+        for topic, title, terms in _DISTRACTOR_TOPICS:
+            docs.append({
+                "id": f"distractor:{topic}:{batch:02d}",
+                "type": "Distractor",
+                "title": f"{title.title()} {batch + 1}",
+                "content": (
+                    f"{title} note {batch + 1}. This record discusses {terms}. "
+                    "It is intentionally unrelated to the judged Brain quality topics "
+                    "and exists to make local ranking tests compete against realistic noise."
+                ),
+            })
+    return docs
+
+
+DOCUMENTS = CORE_DOCUMENTS + _generated_distractors()
+
 QUERIES = [
     {"query": "agent workflow audit realtime contract run status timeline", "relevant": {"doc:agent-runtime-contract": 3, "doc:workflow-observability": 2, "doc:audit-trust": 2, "doc:realtime-feed": 2}, "must_include": ["doc:agent-runtime-contract"]},
     {"query": "workflow queued running cancelled interrupted replay approval", "relevant": {"doc:workflow-observability": 3, "doc:agentic-hitl": 2}, "must_include": ["doc:workflow-observability"]},
-    {"query": "audit log redacted secrets admin review contract", "relevant": {"doc:audit-trust": 3, "doc:security-zero-trust": 2}, "must_include": ["doc:audit-trust"]},
+    {"query": "audit log redacted secrets admin review contract", "relevant": {"doc:audit-trust": 3}, "must_include": ["doc:audit-trust"]},
     {"query": "SSE realtime workspace event payload sequence contract", "relevant": {"doc:realtime-feed": 3, "doc:agent-runtime-contract": 2}, "must_include": ["doc:realtime-feed"]},
     {"query": "hybrid retrieval keyword vector graph weighted scoped search", "relevant": {"doc:hybrid-search": 3, "doc:knowledge-graph": 2, "doc:retrieval-benchmark": 2}, "must_include": ["doc:hybrid-search"]},
-    {"query": "corpus scale recall precision ndcg judged queries", "relevant": {"doc:retrieval-benchmark": 3, "doc:hybrid-search": 2}, "must_include": ["doc:retrieval-benchmark"]},
+    {"query": "corpus scale recall precision ndcg judged queries", "relevant": {"doc:retrieval-benchmark": 3}, "must_include": ["doc:retrieval-benchmark"]},
     {"query": "local first model independent durable memory brain proof citation", "relevant": {"doc:local-first": 3, "doc:brain-proof": 2}, "must_include": ["doc:local-first"]},
-    {"query": "incremental indexing duplicate conflict merge background ingestion", "relevant": {"doc:incremental-ingestion": 3, "doc:vector-index-evolution": 2}, "must_include": ["doc:incremental-ingestion"]},
-    {"query": "workspace admin profile organization members roles permissions", "relevant": {"doc:workspace-admin": 3, "doc:security-zero-trust": 2}, "must_include": ["doc:workspace-admin"]},
+    {"query": "incremental indexing duplicate conflict merge background ingestion", "relevant": {"doc:incremental-ingestion": 3}, "must_include": ["doc:incremental-ingestion"]},
+    {"query": "workspace admin profile organization members roles permissions", "relevant": {"doc:workspace-admin": 3}, "must_include": ["doc:workspace-admin"]},
     {"query": "tool registry separation dependency injection runtime context", "relevant": {"doc:tool-registry": 3, "doc:server-decomposition": 2, "doc:config-centralization": 2}, "must_include": ["doc:tool-registry"]},
-    {"query": "human in the loop approval review queue rollback", "relevant": {"doc:agentic-hitl": 3, "doc:workflow-observability": 2}, "must_include": ["doc:agentic-hitl"]},
+    {"query": "human in the loop approval review queue rollback", "relevant": {"doc:agentic-hitl": 3}, "must_include": ["doc:agentic-hitl"]},
     {"query": "model routing ollama lm studio mlx cloud fallback replaceable", "relevant": {"doc:model-routing": 3, "doc:local-first": 2}, "must_include": ["doc:model-routing"]},
 ]

package/lattice_brain/runtime/agent_runtime.py

@@ -37,7 +37,7 @@ from .multi_agent import (
     MULTI_AGENT_VERSION,
     ROLE_AGENT_IDS,
 )
-from .contracts import multi_agent_contract
+from .contracts import contract_view, contract_views, extract_contract, multi_agent_contract
 
 ROLE_DESCRIPTIONS = {
     "researcher": "Gathers workspace context and memory for the goal.",
@@ -227,6 +227,7 @@ class AgentRuntime:
             "roles": self.roles(),
             "agents": self._roster(runs),
             "runs": runs[:25],
+            "contracts": contract_views(runs[:25]),
         }
 
     def preview(
@@ -282,13 +283,27 @@ class AgentRuntime:
 
     # ── events / state ────────────────────────────────────────────────────
     def list_runs(self, *, scope: Optional[str] = None) -> Dict[str, Any]:
-        return self._store.list_agents(workspace_id=scope)
+        listing = self._store.list_agents(workspace_id=scope)
+        runs = list(listing.get("runs") or [])
+        payload = dict(listing)
+        payload["contracts"] = contract_views(runs)
+        return payload
 
     def get_run(self, run_id: str, *, scope: Optional[str] = None) -> Dict[str, Any]:
-        return {"run": self._store.get_agent_run(run_id, workspace_id=scope)}
+        run = self._store.get_agent_run(run_id, workspace_id=scope)
+        payload = {"run": run}
+        contract = extract_contract(run)
+        if contract is not None:
+            payload["contract"] = contract_view(contract)
+        return payload
 
     def replay(self, run_id: str, *, scope: Optional[str] = None) -> Dict[str, Any]:
-        return {"replay": self._store.replay_agent_run(run_id, workspace_id=scope)}
+        replay = self._store.replay_agent_run(run_id, workspace_id=scope)
+        payload = {"replay": replay}
+        contract = extract_contract(replay)
+        if contract is not None:
+            payload["contract"] = contract_view(contract)
+        return payload
 
     def events(self, run_id: str, *, scope: Optional[str] = None) -> Dict[str, Any]:
         run = self._store.get_agent_run(run_id, workspace_id=scope)
@@ -300,6 +315,7 @@ class AgentRuntime:
             "current_role": run.get("current_role"),
             "timeline": run.get("timeline") or [],
             "handoffs": run.get("handoffs") or [],
+            "contract": contract_view(run),
         }
 
     # ── execution ─────────────────────────────────────────────────────────

package/lattice_brain/runtime/contracts.py

@@ -30,7 +30,7 @@ from __future__ import annotations
 
 from dataclasses import dataclass, field
 from datetime import datetime
-from typing import Any, Dict, List, Optional
+from typing import Any, Dict, Iterable, List, Optional
 
 
 def runtime_timestamp() -> str:
@@ -52,6 +52,22 @@ CONTRACT_KINDS = ("agent_run", "workflow_run", "audit_event", "realtime_event")
 
 # The envelope keys every family member is guaranteed to expose.
 CONTRACT_ENVELOPE_KEYS = ("family", "schema_version", "kind", "id", "status", "timestamp")
+CONTRACT_VIEW_KEYS = (
+    "family",
+    "schema_version",
+    "kind",
+    "id",
+    "run_id",
+    "agent_id",
+    "runtime",
+    "mode",
+    "status",
+    "goal",
+    "current_role",
+    "timestamp",
+    "is_terminal",
+    "blocking_reasons",
+)
 
 _SCHEMA_FOR_KIND = {
     "agent_run": AGENT_RUN_SCHEMA,
@@ -102,6 +118,44 @@ def is_contract_member(record: Any) -> bool:
     return all(key in record for key in CONTRACT_ENVELOPE_KEYS)
 
 
+def extract_contract(record: Any) -> Optional[Dict[str, Any]]:
+    """Return the normalized family contract carried by ``record``.
+
+    Consumers should call this instead of branching on whether they received an
+    agent run, workflow run, audit row, or realtime event. The function accepts
+    either a raw contract dict or a surface record with a nested ``contract``.
+    """
+    if is_contract_member(record):
+        return dict(record)
+    if isinstance(record, dict) and is_contract_member(record.get("contract")):
+        return dict(record["contract"])
+    return None
+
+
+def require_contract(record: Any) -> Dict[str, Any]:
+    """Return a valid family contract or raise a precise error."""
+    contract = extract_contract(record)
+    if contract is None:
+        raise ValueError("record is missing an agent-run-contract/v1 family contract")
+    return contract
+
+
+def contract_view(record: Any) -> Dict[str, Any]:
+    """Return a compact, surface-agnostic view for API and UI consumers."""
+    contract = require_contract(record)
+    return {key: contract.get(key) for key in CONTRACT_VIEW_KEYS if key in contract}
+
+
+def contract_views(records: Iterable[Any]) -> List[Dict[str, Any]]:
+    """Return compact views for every valid contract in ``records``."""
+    views: List[Dict[str, Any]] = []
+    for record in records:
+        contract = extract_contract(record)
+        if contract is not None:
+            views.append({key: contract.get(key) for key in CONTRACT_VIEW_KEYS if key in contract})
+    return views
+
+
 @dataclass(frozen=True)
 class AgentRunContract:
     run_id: Optional[str]

package/lattice_brain/runtime/multi_agent.py

@@ -21,7 +21,7 @@ from typing import Any, Callable, Dict, List, Optional
 from .contracts import multi_agent_contract
 
 
-MULTI_AGENT_VERSION = "7.4.0"
+MULTI_AGENT_VERSION = "7.5.0"
 
 AGENT_ROLES = ("researcher", "planner", "executor", "reviewer", "release")
 CORE_PIPELINE = ("planner", "executor", "reviewer")

package/latticeai/__init__.py

@@ -1,3 +1,3 @@
 """Lattice AI - modular server package."""
 
-__version__ = "7.4.0"
+__version__ = "7.5.0"

package/latticeai/api/agents.py

@@ -111,7 +111,7 @@ def create_agents_router(
     async def agent_runs(request: Request):
         require_user(request)
         scope = gate_read(request)
-        return store.list_agents(workspace_id=scope)
+        return runtime.list_runs(scope=scope)
 
     @router.get("/agents/api/handoffs")
     async def agent_handoffs(request: Request, run_id: str = ""):
@@ -124,7 +124,7 @@ def create_agents_router(
         require_user(request)
         scope = gate_read(request)
         try:
-            return {"run": store.get_agent_run(run_id, workspace_id=scope)}
+            return runtime.get_run(run_id, scope=scope)
         except FileNotFoundError as exc:
             raise HTTPException(status_code=404, detail=f"Agent run not found: {run_id}") from exc
 
@@ -133,7 +133,7 @@ def create_agents_router(
         require_user(request)
         scope = gate_read(request)
         try:
-            return {"replay": store.replay_agent_run(run_id, workspace_id=scope)}
+            return runtime.replay(run_id, scope=scope)
         except FileNotFoundError as exc:
             raise HTTPException(status_code=404, detail=f"Agent run not found: {run_id}") from exc
 

package/latticeai/api/realtime.py

@@ -17,6 +17,7 @@ from fastapi.responses import StreamingResponse
 from pydantic import BaseModel
 
 from latticeai.api.ui_redirects import app_redirect
+from lattice_brain.runtime.contracts import contract_views
 
 
 class PresenceRequest(BaseModel):
@@ -63,7 +64,8 @@ def create_realtime_router(
     async def realtime_feed(request: Request, limit: int = 50):
         user = require_user(request)
         scope = allowed_scopes(user or None)
-        return {"events": bus.recent(limit=limit, workspace_scope=scope), "stats": bus.stats()}
+        events = bus.recent(limit=limit, workspace_scope=scope)
+        return {"events": events, "contracts": contract_views(events), "stats": bus.stats()}
 
     @router.get("/realtime/presence")
     async def realtime_presence(request: Request):

package/latticeai/core/marketplace.py

@@ -11,7 +11,7 @@ from copy import deepcopy
 from typing import Any, Dict, List, Optional
 
 
-MARKETPLACE_VERSION = "7.4.0"
+MARKETPLACE_VERSION = "7.5.0"
 TEMPLATE_KINDS = ("plugin", "workflow", "agent")
 
 

package/latticeai/core/workspace_os.py

@@ -21,7 +21,7 @@ from typing import Any, Callable, Dict, Iterable, List, Optional
 from lattice_brain.runtime.contracts import realtime_event_contract, run_record_contract, workflow_run_contract
 
 
-WORKSPACE_OS_VERSION = "7.4.0"
+WORKSPACE_OS_VERSION = "7.5.0"
 
 # Workspace types separate single-user Personal workspaces from shared
 # Organization workspaces. Both keep the same local-first JSON store; the type

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ltcai",
-  "version": "7.4.0",
+  "version": "7.5.0",
   "description": "Lattice AI — local-first Digital Brain that keeps your knowledge durable across any AI model.",
   "homepage": "https://github.com/TaeSooPark-PTS/LatticeAI#readme",
   "repository": {
@@ -115,8 +115,8 @@
     "@playwright/test": "^1.60.0",
     "@tailwindcss/postcss": "^4.3.0",
     "@tanstack/react-query": "^5.101.0",
-    "@tauri-apps/api": "^2.0.0",
-    "@tauri-apps/cli": "^2.0.0",
+    "@tauri-apps/api": "^2.11.1",
+    "@tauri-apps/cli": "^2.11.3",
     "@types/cytoscape": "^3.21.9",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
@@ -138,5 +138,8 @@
     "typescript": "^5.9.3",
     "vite": "^8.0.16",
     "zustand": "^5.0.14"
+  },
+  "overrides": {
+    "js-yaml": "^4.2.0"
   }
 }

package/scripts/brain_quality_eval.py

@@ -16,11 +16,11 @@ REPO_ROOT = Path(__file__).resolve().parents[1]
 if str(REPO_ROOT) not in sys.path:
     sys.path.insert(0, str(REPO_ROOT))
 
-from knowledge_graph import KnowledgeGraphStore
-from lattice_brain.quality import RetrievalBenchmarkRunner
-from latticeai.services.search_service import SearchService
-from latticeai.services.memory_service import MemoryService
-from lattice_brain.retrieval_benchmark_fixtures import DOCUMENTS, FIXTURE_NAME, QUERIES, TOP_K
+from knowledge_graph import KnowledgeGraphStore  # noqa: E402
+from lattice_brain.quality import RetrievalBenchmarkRunner  # noqa: E402
+from latticeai.services.search_service import SearchService  # noqa: E402
+from latticeai.services.memory_service import MemoryService  # noqa: E402
+from lattice_brain.retrieval_benchmark_fixtures import DOCUMENTS, FIXTURE_NAME, QUERIES, TOP_K  # noqa: E402
 
 
 class _EvalStore:
@@ -173,11 +173,14 @@ def main() -> int:
 
     with tempfile.TemporaryDirectory() as tmp:
         corpus_metrics = _corpus_scale_retrieval_metrics(Path(tmp))
-    if corpus_metrics.get("recall@5", 0.0) < 0.80:
+    recall_key = f"recall@{TOP_K}"
+    precision_key = f"precision@{TOP_K}"
+    ndcg_key = f"ndcg@{TOP_K}"
+    if corpus_metrics.get(recall_key, 0.0) < 0.80:
         return _fail(f"corpus hybrid recall below threshold: {corpus_metrics}")
-    if corpus_metrics.get("precision@5", 0.0) < 0.25:
+    if corpus_metrics.get(precision_key, 0.0) < 0.25:
         return _fail(f"corpus hybrid precision below threshold: {corpus_metrics}")
-    if corpus_metrics.get("ndcg@5", 0.0) < 0.70:
+    if corpus_metrics.get(ndcg_key, 0.0) < 0.70:
         return _fail(f"corpus hybrid ndcg below threshold: {corpus_metrics}")
     if corpus_metrics.get("must_include_hit_rate", 0.0) < 0.90:
         return _fail(f"corpus must-include hit rate below threshold: {corpus_metrics}")