ltcai 7.7.0 → 7.9.0

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, Iterable, List, Optional
+from typing import Any, Dict, Iterable, List, Optional, Protocol, runtime_checkable
 
 
 def runtime_timestamp() -> str:
@@ -69,6 +69,8 @@ CONTRACT_VIEW_KEYS = (
     "blocking_reasons",
 )
 
+RUNTIME_BOUNDARY_SCHEMA = "runtime-boundary/v1"
+
 _SCHEMA_FOR_KIND = {
     "agent_run": AGENT_RUN_SCHEMA,
     "workflow_run": WORKFLOW_RUN_SCHEMA,
@@ -223,6 +225,67 @@ def multi_agent_contract(
     ).as_dict()
 
 
+@dataclass(frozen=True)
+class RuntimeBoundaryContract:
+    """Machine-readable descriptor for an execution runtime boundary.
+
+    This is intentionally separate from run records: it lets tests, routers, and
+    docs assert which class owns which execution surface without importing the
+    wrong runtime by name.
+    """
+
+    name: str
+    runtime: str
+    entrypoint: str
+    surface: str
+    owns: str
+    compatibility_aliases: List[str] = field(default_factory=list)
+
+    def as_dict(self) -> Dict[str, Any]:
+        return {
+            "schema_version": RUNTIME_BOUNDARY_SCHEMA,
+            "name": self.name,
+            "runtime": self.runtime,
+            "entrypoint": self.entrypoint,
+            "surface": self.surface,
+            "owns": self.owns,
+            "compatibility_aliases": list(self.compatibility_aliases),
+        }
+
+
+def runtime_boundary_contract(
+    *,
+    name: str,
+    runtime: str,
+    entrypoint: str,
+    surface: str,
+    owns: str,
+    compatibility_aliases: Optional[List[str]] = None,
+) -> Dict[str, Any]:
+    return RuntimeBoundaryContract(
+        name=name,
+        runtime=runtime,
+        entrypoint=entrypoint,
+        surface=surface,
+        owns=owns,
+        compatibility_aliases=list(compatibility_aliases or []),
+    ).as_dict()
+
+
+@runtime_checkable
+class RuntimeBoundaryProtocol(Protocol):
+    """Minimal shared surface for runtime boundary discovery.
+
+    Product ``AgentRuntime`` and core ``SingleAgentRuntime`` intentionally keep
+    different execution methods. This protocol only fixes the common inspection
+    surface that DI, readiness gates, and tests can depend on safely.
+    """
+
+    def boundary(self) -> Dict[str, Any]: ...
+
+    def config(self) -> Dict[str, Any]: ...
+
+
 def run_record_contract(run: Dict[str, Any], *, runtime: str = "multi_agent") -> Dict[str, Any]:
     """Build the family contract from a persisted agent run row."""
     run = dict(run or {})

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.7.0"
+MULTI_AGENT_VERSION = "7.9.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.7.0"
+__version__ = "7.9.0"

package/latticeai/core/agent.py

@@ -1,7 +1,7 @@
-"""Agent Runtime — the Discover→Plan→Implement→Verify state machine.
+"""Single-agent runtime — the Discover→Plan→Implement→Verify state machine.
 
-This module is the deep one: a small interface (``AgentDeps`` ports +
-``AgentRuntime.run_to_completion``) over the whole multi-role agent loop
+This module is the deep single-agent loop: a small interface (``AgentDeps`` ports +
+``SingleAgentRuntime.run_to_completion``) over the whole role-phased state machine
 (planner → executor → critic → rollback → memory). It carries no FastAPI,
 no globals, and no I/O of its own — every collaborator is injected through
 ``AgentDeps``.
@@ -23,14 +23,13 @@ from __future__ import annotations
 import json
 import logging
 import re
-import subprocess
 from dataclasses import dataclass
 from enum import Enum
 from pathlib import Path
 from typing import Any, Awaitable, Callable, Dict, FrozenSet, List, Optional
 
 from lattice_brain.runtime.hooks import dispatch_tool
-from lattice_brain.runtime.contracts import single_agent_contract
+from lattice_brain.runtime.contracts import runtime_boundary_contract, single_agent_contract
 from tools import ToolError
 
 
@@ -92,7 +91,7 @@ def extract_action(raw: str) -> Dict:
 
 @dataclass
 class AgentDeps:
-    """The ports an :class:`AgentRuntime` needs from the outside world.
+    """The ports a :class:`SingleAgentRuntime` needs from the outside world.
 
     Everything the state machine touches is here, so the loop can be exercised
     against fakes. See module docstring for the two-adapter rationale.
@@ -125,6 +124,11 @@ class AgentDeps:
     memory_updater_prompt: str
     agent_root: Path
 
+    # ── rollback port (optional) ─────────────────────────────────────
+    # Production injects this from the tool dispatch service so this pure
+    # state machine does not shell out directly. Tests can pass a recorder.
+    rollback_file: Optional[Callable[[str], Dict[str, Any]]] = None
+
     # ── lifecycle hooks port (optional) ──────────────────────────────
     # When present, every tool execution fires the shared pre_tool/post_tool
     # lifecycle, so the agent tool path no longer bypasses hooks.
@@ -137,12 +141,30 @@ class AgentDeps:
     brain_memory: Any = None
 
 
-class AgentRuntime:
+class SingleAgentRuntime:
     """Drives the agent state machine over injected :class:`AgentDeps`."""
 
     def __init__(self, deps: AgentDeps) -> None:
         self.deps = deps
 
+    def boundary(self) -> Dict[str, Any]:
+        return runtime_boundary_contract(
+            name="SingleAgentRuntime",
+            runtime="single_agent",
+            entrypoint="latticeai.core.agent.SingleAgentRuntime",
+            surface="/agent",
+            owns="single-agent PLAN / EXECUTE / VERIFY state machine over injected ports",
+            compatibility_aliases=["latticeai.core.agent.AgentRuntime"],
+        )
+
+    def config(self) -> Dict[str, Any]:
+        return {
+            "boundary": self.boundary(),
+            "states": [state.value for state in AgentState],
+            "terminal_states": sorted(state.value for state in AGENT_TERMINAL_STATES),
+            "execution_mode": "injected_ports",
+        }
+
     def contract(self, ctx: AgentRunContext, req: Any, *, run_id: Optional[str] = None) -> Dict[str, Any]:
         """Expose the shared agent-run contract for the single-agent loop."""
         return single_agent_contract(ctx=ctx, goal=getattr(req, "message", ""), run_id=run_id)
@@ -405,12 +427,11 @@ class AgentRuntime:
             path = result.get("path") or (step.get("args") or {}).get("path", "")
             if not path:
                 continue
+            if d.rollback_file is None:
+                rolled.append({"path": path, "ok": False, "error": "rollback_file port is not configured"})
+                continue
             try:
-                r = subprocess.run(
-                    ["git", "checkout", "--", path], cwd=str(d.agent_root),
-                    capture_output=True, text=True, timeout=10,
-                )
-                rolled.append({"path": path, "ok": r.returncode == 0, "stderr": r.stderr[:200]})
+                rolled.append(d.rollback_file(str(path)))
             except Exception as exc:
                 rolled.append({"path": path, "ok": False, "error": str(exc)})
 
@@ -491,3 +512,9 @@ class AgentRuntime:
                 ctx.state = AgentState.FAILED
 
         ctx.state_history.append(ctx.state.value)
+
+
+# Backward compatibility: external callers historically imported
+# ``latticeai.core.agent.AgentRuntime`` for the single-agent state machine.
+# The product/runtime facade lives at ``lattice_brain.runtime.agent_runtime``.
+AgentRuntime = SingleAgentRuntime

package/latticeai/core/marketplace.py

@@ -11,7 +11,7 @@ from copy import deepcopy
 from typing import Any, Dict, List, Optional
 
 
-MARKETPLACE_VERSION = "7.7.0"
+MARKETPLACE_VERSION = "7.9.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.7.0"
+WORKSPACE_OS_VERSION = "7.9.0"
 
 # Workspace types separate single-user Personal workspaces from shared
 # Organization workspaces. Both keep the same local-first JSON store; the type

package/latticeai/services/architecture_readiness.py

@@ -110,7 +110,7 @@ def architecture_readiness(root: Path | None = None) -> Dict[str, Any]:
     runtime_module_count = len(list((root / "latticeai" / "runtime").glob("*.py")))
     return {
         "status": "complete" if all(gate.status == "complete" for gate in gates) else "incomplete",
-        "version_target": "7.7.0",
+        "version_target": "7.9.0",
         "gates": [gate.__dict__ for gate in gates],
         "metrics": {
             "api_router_modules": api_router_count,

package/latticeai/services/product_readiness.py

@@ -1,8 +1,8 @@
-"""Machine-checkable *product* readiness gates for the 7.7 line.
+"""Machine-checkable *product* readiness gates for the 7.9 line.
 
 Where ``architecture_readiness`` proves the internal structure is sound, this
-module answers the product question the 7.7 release exists to settle: *would
-anyone looking at this call it a finished product?* It does so honestly — every
+module answers the product question the 7.9 release exists to settle: *are the
+runtime boundaries still clear and release-ready after hardening?* It does so honestly — every
 gate is backed by evidence that is probed on disk, so a gate only reports
 ``complete`` when its evidence actually resolves. The same report can be printed
 by ``scripts/product_readiness.py`` and re-run after every change, which is the
@@ -17,7 +17,7 @@ from typing import Any, Dict, List
 
 from latticeai.services.architecture_readiness import architecture_readiness
 
-PRODUCT_VERSION_TARGET = "7.7.0"
+PRODUCT_VERSION_TARGET = "7.9.0"
 
 
 @dataclass(frozen=True)
@@ -64,10 +64,10 @@ PRODUCT_GATES: List[ProductGate] = [
         evidence=[
             "package.json::release:artifacts",
             "package.json::release:validate",
-            "README.md::dist/ltcai-7.7.0-py3-none-any.whl",
-            "README.md::dist/ltcai-7.7.0.tar.gz",
-            "README.md::dist/ltcai-7.7.0.vsix",
-            "README.md::ltcai-7.7.0.tgz",
+            "README.md::dist/ltcai-7.9.0-py3-none-any.whl",
+            "README.md::dist/ltcai-7.9.0.tar.gz",
+            "README.md::dist/ltcai-7.9.0.vsix",
+            "README.md::ltcai-7.9.0.tgz",
             "scripts/validate_release_artifacts.py",
             "scripts/release_smoke.py",
             "Dockerfile",
@@ -83,12 +83,19 @@ PRODUCT_GATES: List[ProductGate] = [
         title="Release story is documented and honest",
         evidence=[
             "README.md",
-            "README.md::The current release is **7.7.0",
-            "SECURITY.md::7.7.x (latest)",
-            "vscode-extension/README.md::**7.7.0",
-            "docs/CHANGELOG.md::## [7.7.0]",
+            "README.md::The current release is **7.9.0",
+            "SECURITY.md::7.9.x (latest)",
+            "vscode-extension/README.md::**7.9.0",
+            "docs/CHANGELOG.md::## [7.9.0]",
             "FEATURE_STATUS.md",
-            "RELEASE_NOTES_v7.7.0.md",
+            "RELEASE_NOTES_v7.9.0.md",
+            "latticeai/core/agent.py::SingleAgentRuntime",
+            "latticeai/core/agent.py::AgentRuntime = SingleAgentRuntime",
+            "lattice_brain/runtime/contracts.py::runtime-boundary/v1",
+            "lattice_brain/runtime/contracts.py::RuntimeBoundaryProtocol",
+            "lattice_brain/runtime/agent_runtime.py::def boundary",
+            "latticeai/core/agent.py::def boundary",
+            "latticeai/services/tool_dispatch.py::rollback_file",
         ],
     ),
     ProductGate(
@@ -97,8 +104,8 @@ PRODUCT_GATES: List[ProductGate] = [
         evidence=[
             "scripts/brain_quality_eval.py",
             "scripts/product_readiness.py",
-            "tests/unit/test_v77_product_readiness.py",
-            "tests/visual/v3.spec.js::제품 상태판",
+            "tests/unit/test_v78_product_readiness.py",
+            "tests/visual/v3.spec.js::Brain Chat Home",
             ".github/workflows/ci.yml::scripts/product_readiness.py",
             ".github/workflows/release.yml::npm run lint",
         ],

package/latticeai/services/tool_dispatch.py

@@ -8,11 +8,12 @@ from __future__ import annotations
 
 from dataclasses import dataclass, field
 from pathlib import Path
+import subprocess
 from typing import Any, Callable, Dict, Mapping, Optional
 
 from fastapi import HTTPException
 
-from latticeai.core.agent import AgentDeps, AgentRuntime
+from latticeai.core.agent import AgentDeps, SingleAgentRuntime
 from latticeai.core.agent_prompts import (
     CRITIC_PROMPT,
     EXECUTOR_PROMPT,
@@ -106,6 +107,16 @@ class ToolDispatchService:
                 detail=f"'{tool_name}' 툴은 관리자 전용입니다.",
             )
 
+    def rollback_file(self, path: str) -> Dict[str, Any]:
+        r = subprocess.run(
+            ["git", "checkout", "--", path],
+            cwd=str(AGENT_ROOT),
+            capture_output=True,
+            text=True,
+            timeout=10,
+        )
+        return {"path": path, "ok": r.returncode == 0, "stderr": r.stderr[:200]}
+
 
 DEFAULT_TOOL_DISPATCH_SERVICE = ToolDispatchService()
 
@@ -185,7 +196,7 @@ def build_agent_runtime(
     hooks: Any = None,
     brain_memory: Any = None,
     dispatch_service: ToolDispatchService = DEFAULT_TOOL_DISPATCH_SERVICE,
-) -> AgentRuntime:
+) -> SingleAgentRuntime:
     ensure_agent_root()
     deps = AgentDeps(
         generate_as=model_router.generate_as,
@@ -205,10 +216,11 @@ def build_agent_runtime(
         critic_prompt=CRITIC_PROMPT,
         memory_updater_prompt=MEMORY_UPDATER_PROMPT,
         agent_root=AGENT_ROOT,
+        rollback_file=dispatch_service.rollback_file,
         hooks=hooks,
         brain_memory=brain_memory,
     )
-    return AgentRuntime(deps)
+    return SingleAgentRuntime(deps)
 
 
 def tool_response(fn, *args):

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ltcai",
-  "version": "7.7.0",
+  "version": "7.9.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": {

package/scripts/product_readiness.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Print the 7.7 product-readiness scorecard and fail CI when incomplete.
+"""Print the 7.8 product-readiness scorecard and fail CI when incomplete.
 
 Run it as often as you like — it re-probes the repo every time, so it is the
 single objective answer to "is this a finished product yet?". Exit code is 0

package/src-tauri/Cargo.lock

@@ -1584,7 +1584,7 @@ dependencies = [
 
 [[package]]
 name = "lattice-ai-desktop"
-version = "7.7.0"
+version = "7.9.0"
 dependencies = [
  "plist",
  "serde",

package/src-tauri/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "lattice-ai-desktop"
-version = "7.7.0"
+version = "7.9.0"
 description = "Lattice AI Digital Brain desktop shell"
 authors = ["TaeSoo Park"]
 edition = "2021"

package/src-tauri/tauri.conf.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://schema.tauri.app/config/2",
   "productName": "Lattice AI",
-  "version": "7.7.0",
+  "version": "7.9.0",
   "identifier": "ai.lattice.desktop",
   "build": {
     "beforeDevCommand": "npm run frontend:dev",

package/static/app/asset-manifest.json

@@ -1,20 +1,20 @@
 {
-  "version": "7.7.0",
+  "version": "7.9.0",
   "generated_at": "vite",
   "entrypoints": {
     "app": "/static/app/index.html"
   },
   "assets": {
     "../node_modules/@tauri-apps/api/core.js": "/static/app/assets/core-CwxXejkd.js",
-    "_primitives-CFhU5Rka.js": "/static/app/assets/primitives-CFhU5Rka.js",
-    "_textarea-uBpGDOJM.js": "/static/app/assets/textarea-uBpGDOJM.js",
-    "index.html": "/static/app/assets/index-B4_drWel.js",
-    "assets/index-DjpDeE0c.css": "/static/app/assets/index-DjpDeE0c.css",
-    "src/pages/Act.tsx": "/static/app/assets/Act-CX5hL0Z3.js",
-    "src/pages/Brain.tsx": "/static/app/assets/Brain-m19en5wz.js",
-    "src/pages/Capture.tsx": "/static/app/assets/Capture-CdFSrZnA.js",
-    "src/pages/Library.tsx": "/static/app/assets/Library-CZFVGSmG.js",
-    "src/pages/System.tsx": "/static/app/assets/System-CMoOoUrZ.js"
+    "_primitives-CD38lt4n.js": "/static/app/assets/primitives-CD38lt4n.js",
+    "_textarea-BZk6ybp5.js": "/static/app/assets/textarea-BZk6ybp5.js",
+    "index.html": "/static/app/assets/index-DbcEYJQ2.js",
+    "assets/index-C7g26IF6.css": "/static/app/assets/index-C7g26IF6.css",
+    "src/pages/Act.tsx": "/static/app/assets/Act-DOvf59ru.js",
+    "src/pages/Brain.tsx": "/static/app/assets/Brain-C7_0mEiI.js",
+    "src/pages/Capture.tsx": "/static/app/assets/Capture-B9Tlhzqr.js",
+    "src/pages/Library.tsx": "/static/app/assets/Library-BJPEEm5O.js",
+    "src/pages/System.tsx": "/static/app/assets/System-D6t9jo9V.js"
   },
   "vite": {
     "../node_modules/@tauri-apps/api/core.js": {
@@ -23,22 +23,22 @@
       "src": "../node_modules/@tauri-apps/api/core.js",
       "isDynamicEntry": true
     },
-    "_primitives-CFhU5Rka.js": {
-      "file": "assets/primitives-CFhU5Rka.js",
+    "_primitives-CD38lt4n.js": {
+      "file": "assets/primitives-CD38lt4n.js",
       "name": "primitives",
       "imports": [
         "index.html"
       ]
     },
-    "_textarea-uBpGDOJM.js": {
-      "file": "assets/textarea-uBpGDOJM.js",
+    "_textarea-BZk6ybp5.js": {
+      "file": "assets/textarea-BZk6ybp5.js",
       "name": "textarea",
       "imports": [
         "index.html"
       ]
     },
     "index.html": {
-      "file": "assets/index-B4_drWel.js",
+      "file": "assets/index-DbcEYJQ2.js",
       "name": "index",
       "src": "index.html",
       "isEntry": true,
@@ -51,59 +51,59 @@
         "src/pages/System.tsx"
       ],
       "css": [
-        "assets/index-DjpDeE0c.css"
+        "assets/index-C7g26IF6.css"
       ]
     },
     "src/pages/Act.tsx": {
-      "file": "assets/Act-CX5hL0Z3.js",
+      "file": "assets/Act-DOvf59ru.js",
       "name": "Act",
       "src": "src/pages/Act.tsx",
       "isDynamicEntry": true,
       "imports": [
         "index.html",
-        "_primitives-CFhU5Rka.js",
-        "_textarea-uBpGDOJM.js"
+        "_primitives-CD38lt4n.js",
+        "_textarea-BZk6ybp5.js"
       ]
     },
     "src/pages/Brain.tsx": {
-      "file": "assets/Brain-m19en5wz.js",
+      "file": "assets/Brain-C7_0mEiI.js",
       "name": "Brain",
       "src": "src/pages/Brain.tsx",
       "isDynamicEntry": true,
       "imports": [
         "index.html",
-        "_primitives-CFhU5Rka.js",
-        "_textarea-uBpGDOJM.js"
+        "_primitives-CD38lt4n.js",
+        "_textarea-BZk6ybp5.js"
       ]
     },
     "src/pages/Capture.tsx": {
-      "file": "assets/Capture-CdFSrZnA.js",
+      "file": "assets/Capture-B9Tlhzqr.js",
       "name": "Capture",
       "src": "src/pages/Capture.tsx",
       "isDynamicEntry": true,
       "imports": [
         "index.html",
-        "_primitives-CFhU5Rka.js"
+        "_primitives-CD38lt4n.js"
       ]
     },
     "src/pages/Library.tsx": {
-      "file": "assets/Library-CZFVGSmG.js",
+      "file": "assets/Library-BJPEEm5O.js",
       "name": "Library",
       "src": "src/pages/Library.tsx",
       "isDynamicEntry": true,
       "imports": [
         "index.html",
-        "_primitives-CFhU5Rka.js"
+        "_primitives-CD38lt4n.js"
       ]
     },
     "src/pages/System.tsx": {
-      "file": "assets/System-CMoOoUrZ.js",
+      "file": "assets/System-D6t9jo9V.js",
       "name": "System",
       "src": "src/pages/System.tsx",
       "isDynamicEntry": true,
       "imports": [
         "index.html",
-        "_primitives-CFhU5Rka.js"
+        "_primitives-CD38lt4n.js"
       ]
     }
   }