ltcai 5.3.0 → 5.5.0

package/README.md

@@ -45,6 +45,8 @@ You need Lattice AI when:
   source-aware memory.
 - See recent memories, older memories, topics, relationships, and the full
   knowledge graph when you want deeper structure.
+- Create consent-first Brain automation drafts for memory digests, project
+  reviews, and follow-up suggestions before any schedule is enabled.
 - Use a recommended local model without learning model internals first.
 - Keep advanced controls, audit logs, roles, and retention in a separate Admin
   surface.
@@ -191,25 +193,23 @@ See [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) for developer workflow details.
 
 ## Current Release Preparation
 
-The current development target is **5.3.0 Product Clarity and Runtime Cleanup**:
+The current development target is **5.5.0 Release Coordination**:
 
-- README and first-run copy are organized around the local-first Digital Brain.
-- Product descriptions are aligned across package metadata, architecture docs,
-  feature status, release notes, and extension metadata.
-- Release artifacts and exact filenames are kept in the release section instead
-  of interrupting the product introduction.
-- `app_factory.py` is being thinned by moving config, security, and Brain runtime
-  assembly seams into `latticeai.runtime`.
-- Legacy root modules are documented in
-  [docs/LEGACY_COMPATIBILITY.md](docs/LEGACY_COMPATIBILITY.md).
+- Carries forward the v5.4.0 Brain Automation Scheduler as the release-ready
+  baseline for the 5.5.0 line.
+- Keeps consent-first automation, TriggerService dedup/LATTICE_TZ/degraded
+  behavior, and runtime graph cleanup intact.
+- Synchronizes Python, npm, VSIX, Tauri, runtime constants, lockfiles, and static
+  metadata to 5.5.0.
+- Updates release documentation and artifact naming to exact 5.5.0 filenames.
 
-Expected artifacts for a future 5.3.0 release must use exact filenames:
+Expected artifacts for 5.5.0 release must use exact filenames:
 
-- `dist/ltcai-5.3.0-py3-none-any.whl`
-- `dist/ltcai-5.3.0.tar.gz`
-- `ltcai-5.3.0.tgz`
-- `dist/ltcai-5.3.0.vsix`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_5.3.0_aarch64.dmg`
+- `dist/ltcai-5.5.0-py3-none-any.whl`
+- `dist/ltcai-5.5.0.tar.gz`
+- `ltcai-5.5.0.tgz`
+- `dist/ltcai-5.5.0.vsix`
+- `src-tauri/target/release/bundle/dmg/Lattice AI_5.5.0_aarch64.dmg`
 
 Do not upload `dist/*`. Package registry publishing remains owner-run.
 
@@ -228,6 +228,8 @@ Do not upload `dist/*`. Package registry publishing remains owner-run.
 
 | Version | Theme |
 | --- | --- |
+| 5.5.0 | Release Coordination: synchronized package/runtime/static versions and release docs for the 5.5.0 line while preserving v5.4.0 Brain Automation Scheduler behavior |
+| 5.4.0 | Brain Automation Scheduler: consent-first recipe drafts (Daily/Weekly/Follow-up), TriggerService with dedup/LATTICE_TZ/degraded, runtime graph cleanup, E2E scenarios |
 | 5.3.0 | Product Clarity and Runtime Cleanup: user-first README/onboarding, unified Digital Brain identity, legacy compatibility map, and app factory runtime seams |
 | 5.2.0 | User-Focused Model Transformation: structured model capability registry, HF verification transparency, model recommendation UX, and workspace-scoped marketplace state |
 | 5.1.0 | Product Trust & Clarity Release: clarifies the private AI memory-layer promise, hardens CSP/secret/auto-read/download gates, adds trust/privacy docs, and refreshes evidence |

package/docs/CHANGELOG.md

@@ -3,6 +3,52 @@
 The top entry is the current release-preparation target. Older entries are
 historical and may describe behavior as it existed at that release.
 
+## [5.5.0] - 2026-06-15
+
+> Release Coordination. Synchronized package/runtime/static metadata and release
+> documentation for the 5.5.0 line while preserving v5.4.0 Brain Automation
+> Scheduler behavior.
+
+### Changed
+- Bumped synchronized Python, npm, VSIX, Tauri, runtime constants, lockfiles, and
+  static asset manifest metadata to `5.5.0`.
+- Updated README, RELEASE.md, RELEASE_NOTES.md, FEATURE_STATUS.md,
+  vscode-extension/README.md, and this changelog so current-release references
+  and expected artifact names point at exact 5.5.0 filenames.
+
+### Preserved
+- v5.4.0 consent-first Brain automation recipes, TriggerService dedup,
+  LATTICE_TZ, degraded status, enabled:false disarming, runtime graph cleanup,
+  and E2E scenario coverage remain the functional baseline.
+- Package registry publishing and deployment remain owner-run only.
+
+## [5.4.0] - 2026-06-15
+
+> Brain Automation Scheduler. Consent-first recipe drafts (Daily Memory Digest,
+> Weekly Project Review, Follow-up Radar) install as disabled workflows.
+> Scheduler triggers (TriggerService) with dedup, LATTICE_TZ, degraded status,
+> and runtime graph cleanup.
+
+### Added
+- Consent-first Brain automation recipe drafts for Daily Memory Digest, Weekly
+  Project Review, and Follow-up Radar. Recipes install as disabled workflows so
+  users can inspect them before any scheduler or Brain-event trigger fires.
+
+### Changed
+- Workflow trigger scanning now treats explicit `enabled: false` trigger config
+  as disarmed while preserving legacy behavior for existing workflows that do
+  not include an `enabled` field.
+- The Automate page now surfaces Brain automation recipe cards with local-only,
+  review-before-run consent copy.
+- Recipe install UX: success feedback on "Create reviewable draft", install-time
+  button disabled to block duplicates clicks, and if same recipe draft already
+  exists (by metadata), button state changes + guide text instead of re-creating.
+- lattice_brain/runtime dependency/responsibility graph 정리 + 실제 진입점 매핑 문서화 (runtime/* 모듈 헤더 + app_factory 주석). AgentRuntime (lattice_brain facade) vs latticeai/core/agent (single-agent state/plan/transcript) 분리 명확화.
+- TriggerService 스케줄러 엣지케이스 보강: LATTICE_TZ env 지원 (describe() 노출), last_attempt_at + cooldown dedup 가드로 중복 실행 방지 (interval/brain_event), consecutive_failures + "degraded" status per-trigger 서페이싱.
+- A방향 E2E 시나리오 초안 brain_automation.py 에 작성 (draft install, dedup, consent-first, trigger fire with provenance, LATTICE_TZ, degraded, review flow, RunExecutor 경로).
+
+## Unreleased
+
 ## [5.3.0] - 2026-06-14
 
 > Product Clarity and Runtime Cleanup. Lattice AI is now presented consistently

package/frontend/src/App.tsx

@@ -24,6 +24,8 @@ import { ProductFlow, readProductFlowComplete } from "@/components/ProductFlow";
 import { useAppStore } from "@/store/appStore";
 import { asArray } from "@/lib/utils";
 import { LANGUAGE_LABELS, t, type Language } from "@/i18n";
+import { parseHash } from "@/routes";
+import { ActPage } from "@/pages/Act";
 
 type ApiRecord = Record<string, unknown>;
 type BrainDepth = 1 | 2 | 3 | 4 | 5;
@@ -73,7 +75,8 @@ export default function App() {
   const theme = useAppStore((state) => state.theme);
   const language = useAppStore((state) => state.language);
   const [flowComplete, setFlowComplete] = React.useState(readProductFlowComplete);
-  const route = useHashRoute();
+  const rawRoute = useHashRoute();
+  const parsed = React.useMemo(() => parseHash(), [rawRoute]);
   const { state: brainState, intensity, setBrain } = useBrainState();
 
   React.useEffect(() => {
@@ -99,8 +102,10 @@ export default function App() {
   return (
     <div className="brain-space">
       <div className="brain-field" />
-      {route.startsWith("/admin") ? (
+      {rawRoute.startsWith("/admin") ? (
         <AdminConsole onBack={() => navigateHash("/brain")} />
+      ) : parsed.primary === "act" ? (
+        <ActPage initialTab={parsed.tab} />
       ) : (
         <BrainHome brainState={brainState} intensity={intensity} onBrainChange={setBrain} />
       )}
@@ -576,6 +581,7 @@ function AdminConsole({ onBack }: { onBack: () => void }) {
             <span>{stringValue(retention.retained_events, "0")} retained · {stringValue(retention.prune_candidates, "0")} ready for export/prune review</span>
           </div>
         </AdminPanel>
+
       </section>
     </main>
   );

package/frontend/src/api/client.ts

@@ -368,6 +368,8 @@ export const latticeApi = {
   workflowDefinitions: () => get("/workflows/api/definitions", { workflows: [] }),
   workflowRuns: () => get("/workflows/api/runs", { runs: [] }),
   workflowTriggers: () => get("/workflows/api/triggers", { armed: [] }),
+  automationRecipes: () => get("/workflows/api/automation/recipes", { recipes: [], principles: {} }),
+  installAutomationRecipe: (recipeId: string, enabled = false) => post(`/workflows/api/automation/recipes/${encodeURIComponent(recipeId)}`, { enabled }, {}),
   createWorkflow: (body: { name: string; nodes: Array<Record<string, unknown>>; metadata?: Record<string, unknown> }) => post("/workflows/api/definitions", body, {}),
   importWorkflow: (data: Record<string, unknown>) => post("/workflows/api/import", { data }, {}),
   exportWorkflow: (id: string) => get(`/workflows/api/export/${encodeURIComponent(id)}`, {}),

package/frontend/src/pages/Act.tsx

@@ -1,7 +1,7 @@
 import * as React from "react";
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 import ReactFlow, { Background, Controls, Edge, Node } from "reactflow";
-import { Bot, GitBranch, PauseCircle, Play, Workflow } from "lucide-react";
+import { Bot, CalendarClock, GitBranch, PauseCircle, Play, ShieldCheck, Workflow } from "lucide-react";
 import { latticeApi } from "@/api/client";
 import { ActionButton, DataPanel, EntityList, KeyValueList, ModeGate, OperationResult, StructuredView, Tabs } from "@/components/primitives";
 import { Badge } from "@/components/ui/badge";
@@ -199,6 +199,7 @@ function WorkflowsPanel() {
   const qc = useQueryClient();
   const defs = useQuery({ queryKey: ["workflowDefinitions"], queryFn: latticeApi.workflowDefinitions });
   const triggers = useQuery({ queryKey: ["workflowTriggers"], queryFn: latticeApi.workflowTriggers });
+  const recipes = useQuery({ queryKey: ["automationRecipes"], queryFn: latticeApi.automationRecipes });
   const [name, setName] = React.useState("Manual workflow");
   const [importText, setImportText] = React.useState("");
   const create = useMutation({
@@ -216,7 +217,19 @@ function WorkflowsPanel() {
       qc.invalidateQueries({ queryKey: ["workflowDefinitions"] });
     },
   });
+  const installRecipe = useMutation({
+    mutationFn: (recipeId: string) => latticeApi.installAutomationRecipe(recipeId, false),
+    onSuccess: () => {
+      qc.invalidateQueries({ queryKey: ["workflowDefinitions"] });
+      qc.invalidateQueries({ queryKey: ["workflowTriggers"] });
+    },
+  });
   const workflows = asArray<Record<string, unknown>>((defs.data?.data as Record<string, unknown>)?.workflows);
+  const installedRecipeIds = new Set(
+    workflows
+      .filter((w: any) => w && w.metadata && w.metadata.created_from === "brain_automation_recipe" && w.metadata.recipe_id)
+      .map((w: any) => String(w.metadata.recipe_id))
+  );
   const nodes: Node[] = workflows.slice(0, 12).map((workflow, index) => ({
     id: String(workflow.id || workflow.workflow_id || index),
     position: { x: (index % 4) * 190, y: Math.floor(index / 4) * 120 },
@@ -225,6 +238,74 @@ function WorkflowsPanel() {
   const edges: Edge[] = nodes.slice(1).map((node, index) => ({ id: `e-${index}`, source: nodes[index].id, target: node.id }));
   return (
     <div className="grid gap-4 xl:grid-cols-[1.2fr_0.8fr]">
+      <DataPanel title="Brain automations" result={recipes.data} className="xl:col-span-2">
+        {(data) => {
+          const items = asArray<Record<string, unknown>>((data as Record<string, unknown>).recipes);
+          return (
+            <div className="grid gap-3 lg:grid-cols-3">
+              {items.map((recipe) => {
+                const id = String(recipe.id || "");
+                const consent = (recipe.consent || {}) as Record<string, unknown>;
+                const creates = asArray<string>(recipe.creates);
+                return (
+                  <div key={id} className="rounded-lg border border-border bg-background/70 p-4">
+                    <div className="flex items-start justify-between gap-2">
+                      <div>
+                        <div className="flex items-center gap-2 font-medium">
+                          <CalendarClock className="h-4 w-4" /> {String(recipe.name || id)}
+                        </div>
+                        <p className="mt-2 text-sm text-muted-foreground">{String(recipe.summary || "")}</p>
+                      </div>
+                      <Badge variant="muted">{String(recipe.cadence || "draft")}</Badge>
+                    </div>
+                    <p className="mt-3 text-sm">{String(recipe.user_value || "")}</p>
+                    <div className="mt-3 flex flex-wrap gap-2">
+                      <Badge variant="success"><ShieldCheck className="h-3 w-3" /> local only</Badge>
+                      {consent.requires_user_enable ? <Badge variant="warning">draft first</Badge> : null}
+                      {creates.slice(0, 2).map((item) => <Badge key={item} variant="muted">{item}</Badge>)}
+                    </div>
+                    {(() => {
+                      const isInstalling = installRecipe.isPending && installRecipe.variables === id;
+                      const last = installRecipe.data as any;
+                      const lastRid = last && last.recipe && last.recipe.recipe_id ? String(last.recipe.recipe_id) : "";
+                      const justSucceeded = !installRecipe.isPending && lastRid === id;
+                      const installed = installedRecipeIds.has(id);
+                      const btnLabel = isInstalling
+                        ? "Creating..."
+                        : justSucceeded
+                        ? "✓ Draft created"
+                        : installed
+                        ? "Draft already created"
+                        : "Create reviewable draft";
+                      return (
+                        <>
+                          <Button
+                            className="mt-4 w-full"
+                            variant={installed || justSucceeded ? "secondary" : "outline"}
+                            disabled={!id || isInstalling || installed}
+                            onClick={() => {
+                              if (installed || isInstalling) return;
+                              installRecipe.mutate(id);
+                            }}
+                          >
+                            {btnLabel}
+                          </Button>
+                          {justSucceeded ? (
+                            <p className="mt-1 text-[10px] text-green-600">Reviewable draft ready. Check Definitions below.</p>
+                          ) : null}
+                          {installed && !justSucceeded ? (
+                            <p className="mt-1 text-[10px] text-muted-foreground">Reviewable draft exists — see Definitions.</p>
+                          ) : null}
+                        </>
+                      );
+                    })()}
+                  </div>
+                );
+              })}
+            </div>
+          );
+        }}
+      </DataPanel>
       <Card>
         <CardHeader>
           <CardTitle className="flex items-center gap-2"><GitBranch className="h-4 w-4" /> Workflow graph</CardTitle>

package/lattice_brain/__init__.py

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

package/lattice_brain/runtime/__init__.py

@@ -3,6 +3,59 @@
 Physically hosts the hooks registry/dispatch lifecycle, the multi-agent
 orchestrator, and the agent runtime service. Lazy-loaded so importing
 ``lattice_brain.runtime`` stays cheap.
+
+=== lattice_brain/runtime 책임 + 의존성 그래프 (A방향 + Act/automation 기준) ===
+- multi_agent.py (핵심 실행체)
+  책임: OrchestrationContext, AgentContextPacket, AgentHandoff, AgentRunResult,
+        MultiAgentOrchestrator, default_role_runner, llm_role_runner,
+        CORE_PIPELINE/AGENT_ROLES, handoff/review/retry 타임라인 생성.
+  의존: 없음 (순수, deterministic/LLM runner 주입).
+  진입: orchestrator_factory 로 AgentRuntime에 주입됨.
+
+- hooks.py (라이프사이클 확장)
+  책임: HookContext/HookResult, HooksRegistry (builtin+user, order/enabled persist),
+        dispatch_tool (pre_tool/post_tool 통합), fire_hook/run_hooks,
+        BUILTIN_HOOKS (redact, memory-snapshot, tool-permission-gate 등).
+  의존: subprocess (user command hooks).
+  진입: AgentRuntime, tool_dispatch, api/tools, core/agent 등에 주입/등록.
+
+- agent_runtime.py (공개 퍼사드 / 바운더리)
+  책임: AgentRuntime (store+orchestrator_factory+workspace_graph+audit+hooks 주입),
+        start/reserve_run/complete_reserved_run, stop, status/health/config,
+        list_runs/get_run/events/replay, _fire_pre_run / _post_run_hooks.
+  의존: .multi_agent, .hooks (간접), store (WORKSPACE_OS).
+  진입점: **여기가 제품 경계**. app_factory에서 AGENT_RUNTIME으로 생성,
+         api/agents.py (런타임 라우터), RunExecutor (async agent/workflow),
+         workflow_designer에 주입. frontend BrainAutomationPanel / Act 가
+         /agents/* 를 통해 이 바운더리만 의존.
+
+- __init__.py : lazy re-export (import 비용 최소화).
+
+실제 진입점 매핑 (app_factory + 호출 스택):
+  app_factory.py:1508
+    AGENT_RUNTIME = AgentRuntime(store=WORKSPACE_OS, orchestrator_factory=PLATFORM.build_orchestrator, hooks=HOOKS_REGISTRY, ...)
+    RUN_EXECUTOR = RunExecutor(..., agent_runtime=AGENT_RUNTIME)
+    AGENT_RUNTIME.attach_executor(RUN_EXECUTOR)
+    create_agents_router(..., agent_runtime=AGENT_RUNTIME)
+    create_workflow_designer_router(..., run_executor=RUN_EXECUTOR, trigger_service=TRIGGER_SERVICE)
+  api/agents.py:49
+    from lattice_brain.runtime.agent_runtime import AgentRuntime
+    runtime = agent_runtime or AgentRuntime(...)  # fallback
+    /agents/api/runtime/* , POST /agents (start via runtime.start or executor)
+  api/chat.py
+    from latticeai.services.tool_dispatch import build_agent_runtime
+    -> latticeai/core/agent.py:AgentRuntime (별도 state/plan/transcript 머신, single-agent /agent 경로. dispatch_tool 만 공유)
+  latticeai/services/tool_dispatch.py:14
+    from latticeai.core.agent import AgentRuntime as CoreAgentRuntime
+    (tool governance + core single-agent용)
+  latticeai/services/platform_runtime.py
+    from lattice_brain.runtime.{hooks, multi_agent}
+  tests: test_hooks_dispatch.py, test_t7_triggers.py 등에서 직접 import lattice_brain.runtime.* 
+
+core/tool_registry.py (신규) + services/tool_dispatch.py 가 tool build 주도.
+lattice_brain/runtime 는 multi-agent + hooks + facade 에 집중. core/agent 는 chat/agent 단일 루프.
+
+이 매핑으로 중복 제거 및 wiring 명확화 완료 (feat(Act, automation) 방향).
 """
 
 from __future__ import annotations

package/lattice_brain/runtime/agent_runtime.py

@@ -1,5 +1,12 @@
 """AgentRuntime — the single boundary for agent execution and observability.
 
+(lattice_brain/runtime/agent_runtime.py)
+책임: 퍼사드. store/orchestrator/hooks/audit 주입 받아 start/reserve/complete,
+      status/health/config/events/replay/stop, pre/post_run hook firing.
+      RunExecutor와 /agents 라우터의 유일한 의존 대상.
+의존: .multi_agent (orchestrator), .hooks, store (WORKSPACE_OS).
+진입점: app_factory.py:AGENT_RUNTIME (wiring root), api/agents.py, RunExecutor.
+
 Before this module the agent concern was spread across three places: the
 :class:`~latticeai.core.multi_agent.MultiAgentOrchestrator` (role pipeline),
 the :class:`~latticeai.services.platform_runtime.PlatformRuntime` (cross-system

package/lattice_brain/runtime/hooks.py

@@ -1,5 +1,11 @@
 """Hooks platform — a persisted registry of lifecycle extension points.
 
+(lattice_brain/runtime/hooks.py)
+책임: HookContext/Result, HooksRegistry (persist+order+enable+builtin), dispatch_tool,
+      fire_hook (pre/post_run/tool/workflow), BUILTIN_HOOKS 등록.
+의존성: threading, subprocess (user hooks). dispatch_tool은 tool path 단일화.
+상위: agent_runtime.py (pre/post_run), tool_dispatch.py, api/tools, core/agent (shared).
+
 Lattice AI runs several behaviours at well-defined points in the agent / tool /
 workflow lifecycle (audit logging, secret redaction, sensitive-data
 classification, tool-permission gating, memory snapshots, workflow replay

package/lattice_brain/runtime/multi_agent.py

@@ -1,4 +1,9 @@
-"""Multi-Agent Runtime 2.1.
+"""Multi-Agent Runtime 2.1. (lattice_brain/runtime/multi_agent.py)
+
+책임: 역할 파이프라인 실행, handoff/context_packet/timeline/review/retry 기록 생성,
+      OrchestrationContext, default/llm_role_runner, MultiAgentOrchestrator.
+의존성: 없음 (순수). runner 주입으로 simulation vs llm 분리.
+상위 호출자: agent_runtime.py (orchestrator_factory), platform_runtime.
 
 The runtime remains a small, dependency-injected orchestrator, but v2.1 makes
 the operational objects first-class: handoffs, context packets, review/retry
@@ -14,7 +19,7 @@ from datetime import datetime
 from typing import Any, Callable, Dict, List, Optional
 
 
-MULTI_AGENT_VERSION = "5.3.0"
+MULTI_AGENT_VERSION = "5.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__ = "5.3.0"
+__version__ = "5.5.0"

package/latticeai/api/workflow_designer.py

@@ -51,6 +51,10 @@ class WorkflowImportRequest(BaseModel):
     data: Dict[str, Any] = {}
 
 
+class WorkflowRecipeInstallRequest(BaseModel):
+    enabled: bool = False
+
+
 def create_workflow_designer_router(
     *,
     store,
@@ -254,6 +258,62 @@ def create_workflow_designer_router(
             return {"running": False, "tick_seconds": None, "armed": []}
         return trigger_service.describe()
 
+    @router.get("/workflows/api/automation/recipes")
+    async def automation_recipes(request: Request):
+        require_user(request)
+        from latticeai.services.brain_automation import list_brain_automation_recipes
+
+        return list_brain_automation_recipes()
+
+    @router.post("/workflows/api/automation/recipes/{recipe_id}")
+    async def install_automation_recipe(recipe_id: str, req: WorkflowRecipeInstallRequest, request: Request):
+        current_user = require_user(request)
+        scope = gate_write(request)
+        from latticeai.services.brain_automation import (
+            build_brain_automation_workflow,
+            find_installed_recipe_workflow,
+        )
+
+        try:
+            definition = build_brain_automation_workflow(recipe_id, enabled=req.enabled)
+        except KeyError as exc:
+            raise HTTPException(status_code=404, detail=f"Automation recipe not found: {recipe_id}") from exc
+        existing = find_installed_recipe_workflow(
+            store.list_workflows(workspace_id=scope).get("workflows"), recipe_id
+        )
+        if existing is not None:
+            return {
+                "workflow": existing,
+                "recipe": existing.get("metadata") or definition["metadata"],
+                "enabled": bool((existing.get("metadata") or {}).get("automation_state") == "enabled"),
+                "already_installed": True,
+            }
+        errors = validate_definition({"name": definition["name"], "nodes": definition["nodes"]})
+        if errors:
+            raise HTTPException(status_code=400, detail={"validation_errors": errors})
+        workflow = store.create_workflow(
+            name=definition["name"],
+            steps=[{"action": n.get("type"), "node": n.get("id")} for n in definition["nodes"]],
+            nodes=definition["nodes"],
+            metadata=definition["metadata"],
+            user_email=current_user or None,
+            graph=workspace_graph(),
+            workspace_id=scope,
+        )
+        append_audit_event(
+            "brain_automation_recipe_installed",
+            user_email=current_user,
+            workflow_id=workflow["id"],
+            recipe_id=recipe_id,
+            enabled=bool(req.enabled),
+        )
+        return {
+            "workflow": workflow,
+            "recipe": definition["metadata"],
+            "enabled": bool(req.enabled),
+            "already_installed": False,
+        }
+
     @router.get("/workflows/api/runs/{run_id}/replay")
     async def workflow_run_replay(run_id: str, request: Request):
         require_user(request)

package/latticeai/app_factory.py

@@ -1505,6 +1505,7 @@ def _build(config: "Optional[Config]" = None) -> Dict[str, Any]:
     HOOKS_REGISTRY.register_hook(_trigger_hook_id, TRIGGER_SERVICE.hook_runner())
 
     # Single AgentRuntime boundary over the orchestrator + run store.
+    # (lattice_brain/runtime.agent_runtime.AgentRuntime — see runtime/__init__.py for full dep graph + entry mapping)
     AGENT_RUNTIME = AgentRuntime(
         store=WORKSPACE_OS,
         orchestrator_factory=PLATFORM.build_orchestrator,

package/latticeai/core/marketplace.py

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

package/latticeai/core/workspace_os.py

@@ -19,7 +19,7 @@ from pathlib import Path
 from typing import Any, Callable, Dict, Iterable, List, Optional
 
 
-WORKSPACE_OS_VERSION = "5.3.0"
+WORKSPACE_OS_VERSION = "5.5.0"
 
 # Workspace types separate single-user Personal workspaces from shared
 # Organization workspaces. Both keep the same local-first JSON store; the type