ltcai 7.6.0 → 7.7.0

package/latticeai/services/architecture_readiness.py

@@ -1,13 +1,15 @@
 """Machine-checkable architecture readiness gates for release work.
 
-The 7.6 line closes the two local review notes by turning their architectural
-claims into a small contract: AgentRuntime, ToolRegistry, central Config,
+The 7.7 complete-product line preserves the 7.6 closure of the two local review
+notes by keeping their architectural claims in a small contract: AgentRuntime,
+ToolRegistry, central Config,
 decomposed API routers, and Knowledge Graph portability must all be discoverable
 and testable before the release can be called complete.
 """
 
 from __future__ import annotations
 
+import importlib
 from dataclasses import dataclass
 from pathlib import Path
 from typing import Any, Dict, List
@@ -21,6 +23,22 @@ class ArchitectureGate:
     evidence: List[str]
 
 
+def _symbol_exists(dotted: str) -> bool:
+    """Verify a dotted path like 'pkg.mod.Class' actually imports and has the attr.
+    Non-symbol evidence (with space/* or docs) treated as non-blocking here.
+    """
+    if not dotted or " " in dotted or "*" in dotted or "::" in dotted:
+        return True
+    try:
+        if "." not in dotted:
+            return False
+        mod_name, name = dotted.rsplit(".", 1)
+        mod = importlib.import_module(mod_name)
+        return hasattr(mod, name)
+    except Exception:
+        return False
+
+
 def architecture_readiness(root: Path | None = None) -> Dict[str, Any]:
     if root is None:
         root = Path(__file__).resolve().parents[2]
@@ -29,7 +47,7 @@ def architecture_readiness(root: Path | None = None) -> Dict[str, Any]:
         ArchitectureGate(
             id="agent-runtime",
             title="AgentRuntime boundary",
-            status="complete",
+            status="complete" if _symbol_exists("lattice_brain.runtime.agent_runtime.AgentRuntime") else "incomplete",
             evidence=[
                 "lattice_brain.runtime.agent_runtime.AgentRuntime",
                 "latticeai.api.agents.create_agents_router(agent_runtime=...)",
@@ -39,7 +57,7 @@ def architecture_readiness(root: Path | None = None) -> Dict[str, Any]:
         ArchitectureGate(
             id="tool-registry",
             title="ToolRegistry separation",
-            status="complete",
+            status="complete" if all(_symbol_exists(s) for s in ["latticeai.core.tool_registry.ToolRegistry", "latticeai.services.tool_dispatch.ToolDispatchService"]) else "incomplete",
             evidence=[
                 "latticeai.core.tool_registry.ToolRegistry",
                 "latticeai.services.tool_dispatch.ToolDispatchService",
@@ -49,7 +67,7 @@ def architecture_readiness(root: Path | None = None) -> Dict[str, Any]:
         ArchitectureGate(
             id="config-centralization",
             title="Central app Config",
-            status="complete",
+            status="complete" if _symbol_exists("latticeai.core.config.Config") else "incomplete",
             evidence=[
                 "latticeai.core.config.Config.from_env",
                 "latticeai.runtime.config_runtime.ConfigRuntime",
@@ -69,7 +87,7 @@ def architecture_readiness(root: Path | None = None) -> Dict[str, Any]:
         ArchitectureGate(
             id="kg-hardening",
             title="Knowledge Graph stabilization",
-            status="complete",
+            status="complete" if _symbol_exists("lattice_brain.graph.store.KnowledgeGraphStore") else "incomplete",
             evidence=[
                 "lattice_brain.graph.store.KnowledgeGraphStore",
                 "lattice_brain.portability.KGPortabilityService",
@@ -92,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.6.0",
+        "version_target": "7.7.0",
         "gates": [gate.__dict__ for gate in gates],
         "metrics": {
             "api_router_modules": api_router_count,

package/latticeai/services/product_readiness.py

@@ -0,0 +1,159 @@
+"""Machine-checkable *product* readiness gates for the 7.7 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
+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
+point: completeness is something we keep measuring, not a one-time claim.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Any, Dict, List
+
+from latticeai.services.architecture_readiness import architecture_readiness
+
+PRODUCT_VERSION_TARGET = "7.7.0"
+
+
+@dataclass(frozen=True)
+class ProductGate:
+    id: str
+    title: str
+    # Evidence is either a repo-relative path that must exist, or
+    # "path::needle" meaning the file must exist and contain ``needle``.
+    evidence: List[str]
+
+
+PRODUCT_GATES: List[ProductGate] = [
+    ProductGate(
+        id="first-run",
+        title="First five minutes lands without a manual",
+        evidence=[
+            "frontend/src/components/ProductFlow.tsx::WakeBrainScreen",
+            "frontend/src/features/brain/BrainConversation.tsx::ProductCommandCenter",
+            "frontend/src/features/brain/BrainHome.tsx",
+            "auto_setup.py",
+            "setup_wizard.py",
+        ],
+    ),
+    ProductGate(
+        id="answer-proof",
+        title="Answers carry memory proof and citations",
+        evidence=[
+            "latticeai/api/memory.py::brain-proof",
+            "scripts/brain_quality_eval.py",
+        ],
+    ),
+    ProductGate(
+        id="local-first-trust",
+        title="Local-first privacy is stated and bounded",
+        evidence=[
+            "PRIVACY.md",
+            "PUBLIC_MODE.md",
+            "SECURITY.md",
+        ],
+    ),
+    ProductGate(
+        id="packaging",
+        title="One command produces shippable artifacts",
+        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",
+            "scripts/validate_release_artifacts.py",
+            "scripts/release_smoke.py",
+            "Dockerfile",
+        ],
+    ),
+    ProductGate(
+        id="architecture-closed",
+        title="Architecture readiness is complete",
+        evidence=["latticeai/services/architecture_readiness.py"],
+    ),
+    ProductGate(
+        id="trust-docs",
+        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]",
+            "FEATURE_STATUS.md",
+            "RELEASE_NOTES_v7.7.0.md",
+        ],
+    ),
+    ProductGate(
+        id="quality-gates",
+        title="Quality is guarded by repeatable gates",
+        evidence=[
+            "scripts/brain_quality_eval.py",
+            "scripts/product_readiness.py",
+            "tests/unit/test_v77_product_readiness.py",
+            "tests/visual/v3.spec.js::제품 상태판",
+            ".github/workflows/ci.yml::scripts/product_readiness.py",
+            ".github/workflows/release.yml::npm run lint",
+        ],
+    ),
+]
+
+
+def _evidence_resolves(root: Path, evidence: str) -> bool:
+    if "::" in evidence:
+        rel, needle = evidence.split("::", 1)
+        target = root / rel
+        if not target.is_file():
+            return False
+        try:
+            return needle in target.read_text(encoding="utf-8", errors="ignore")
+        except OSError:
+            return False
+    return (root / evidence).exists()
+
+
+def product_readiness(root: Path | None = None) -> Dict[str, Any]:
+    if root is None:
+        root = Path(__file__).resolve().parents[2]
+
+    arch = architecture_readiness(root)
+
+    gate_reports: List[Dict[str, Any]] = []
+    for gate in PRODUCT_GATES:
+        missing = [e for e in gate.evidence if not _evidence_resolves(root, e)]
+        # The architecture gate is satisfied by the composed report, not just
+        # the file existing — fold its status in so this score can never claim
+        # product completeness while the structure underneath is incomplete.
+        if gate.id == "architecture-closed" and arch.get("status") != "complete":
+            missing = missing or ["architecture_readiness().status != complete"]
+        gate_reports.append(
+            {
+                "id": gate.id,
+                "title": gate.title,
+                "status": "complete" if not missing else "incomplete",
+                "evidence": gate.evidence,
+                "missing": missing,
+            }
+        )
+
+    complete = sum(1 for g in gate_reports if g["status"] == "complete")
+    total = len(gate_reports)
+    return {
+        "status": "complete" if complete == total else "incomplete",
+        "version_target": PRODUCT_VERSION_TARGET,
+        "score": f"{complete}/{total}",
+        "gates": gate_reports,
+        "architecture": arch["status"],
+        "metrics": {
+            "product_gates": total,
+            "product_gates_complete": complete,
+            **arch.get("metrics", {}),
+        },
+    }

package/package.json

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

@@ -0,0 +1,37 @@
+#!/usr/bin/env python3
+"""Print the 7.7 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
+only when every product gate resolves its evidence on disk.
+"""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+REPO_ROOT = Path(__file__).resolve().parents[1]
+if str(REPO_ROOT) not in sys.path:
+    sys.path.insert(0, str(REPO_ROOT))
+
+from latticeai.services.product_readiness import product_readiness  # noqa: E402
+
+
+def main() -> int:
+    report = product_readiness(REPO_ROOT)
+    print(f"Lattice AI product readiness — target {report['version_target']}")
+    print(f"Score: {report['score']}  (architecture: {report['architecture']})")
+    print("-" * 60)
+    for gate in report["gates"]:
+        mark = "✓" if gate["status"] == "complete" else "✗"
+        print(f"{mark} {gate['id']:<22} {gate['title']}")
+        for miss in gate["missing"]:
+            print(f"    missing: {miss}")
+    print("-" * 60)
+    print(f"STATUS: {report['status'].upper()}")
+    return 0 if report["status"] == "complete" else 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/src-tauri/Cargo.lock

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

package/src-tauri/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "lattice-ai-desktop"
-version = "7.6.0"
+version = "7.7.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.6.0",
+  "version": "7.7.0",
   "identifier": "ai.lattice.desktop",
   "build": {
     "beforeDevCommand": "npm run frontend:dev",

package/static/app/asset-manifest.json

@@ -1,20 +1,20 @@
 {
-  "version": "7.6.0",
+  "version": "7.7.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-CSsF_Ymb.js": "/static/app/assets/primitives-CSsF_Ymb.js",
-    "_textarea-CJMFSyfQ.js": "/static/app/assets/textarea-CJMFSyfQ.js",
-    "index.html": "/static/app/assets/index-D1hsexMt.js",
-    "assets/index-BwmCpRoW.css": "/static/app/assets/index-BwmCpRoW.css",
-    "src/pages/Act.tsx": "/static/app/assets/Act-CSeeIWB4.js",
-    "src/pages/Brain.tsx": "/static/app/assets/Brain-D_Ne4YoR.js",
-    "src/pages/Capture.tsx": "/static/app/assets/Capture-YFRAO4bJ.js",
-    "src/pages/Library.tsx": "/static/app/assets/Library-C4zmA8O2.js",
-    "src/pages/System.tsx": "/static/app/assets/System-Da-Kxwiz.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"
   },
   "vite": {
     "../node_modules/@tauri-apps/api/core.js": {
@@ -23,22 +23,22 @@
       "src": "../node_modules/@tauri-apps/api/core.js",
       "isDynamicEntry": true
     },
-    "_primitives-CSsF_Ymb.js": {
-      "file": "assets/primitives-CSsF_Ymb.js",
+    "_primitives-CFhU5Rka.js": {
+      "file": "assets/primitives-CFhU5Rka.js",
       "name": "primitives",
       "imports": [
         "index.html"
       ]
     },
-    "_textarea-CJMFSyfQ.js": {
-      "file": "assets/textarea-CJMFSyfQ.js",
+    "_textarea-uBpGDOJM.js": {
+      "file": "assets/textarea-uBpGDOJM.js",
       "name": "textarea",
       "imports": [
         "index.html"
       ]
     },
     "index.html": {
-      "file": "assets/index-D1hsexMt.js",
+      "file": "assets/index-B4_drWel.js",
       "name": "index",
       "src": "index.html",
       "isEntry": true,
@@ -51,59 +51,59 @@
         "src/pages/System.tsx"
       ],
       "css": [
-        "assets/index-BwmCpRoW.css"
+        "assets/index-DjpDeE0c.css"
       ]
     },
     "src/pages/Act.tsx": {
-      "file": "assets/Act-CSeeIWB4.js",
+      "file": "assets/Act-CX5hL0Z3.js",
       "name": "Act",
       "src": "src/pages/Act.tsx",
       "isDynamicEntry": true,
       "imports": [
         "index.html",
-        "_primitives-CSsF_Ymb.js",
-        "_textarea-CJMFSyfQ.js"
+        "_primitives-CFhU5Rka.js",
+        "_textarea-uBpGDOJM.js"
       ]
     },
     "src/pages/Brain.tsx": {
-      "file": "assets/Brain-D_Ne4YoR.js",
+      "file": "assets/Brain-m19en5wz.js",
       "name": "Brain",
       "src": "src/pages/Brain.tsx",
       "isDynamicEntry": true,
       "imports": [
         "index.html",
-        "_primitives-CSsF_Ymb.js",
-        "_textarea-CJMFSyfQ.js"
+        "_primitives-CFhU5Rka.js",
+        "_textarea-uBpGDOJM.js"
       ]
     },
     "src/pages/Capture.tsx": {
-      "file": "assets/Capture-YFRAO4bJ.js",
+      "file": "assets/Capture-CdFSrZnA.js",
       "name": "Capture",
       "src": "src/pages/Capture.tsx",
       "isDynamicEntry": true,
       "imports": [
         "index.html",
-        "_primitives-CSsF_Ymb.js"
+        "_primitives-CFhU5Rka.js"
       ]
     },
     "src/pages/Library.tsx": {
-      "file": "assets/Library-C4zmA8O2.js",
+      "file": "assets/Library-CZFVGSmG.js",
       "name": "Library",
       "src": "src/pages/Library.tsx",
       "isDynamicEntry": true,
       "imports": [
         "index.html",
-        "_primitives-CSsF_Ymb.js"
+        "_primitives-CFhU5Rka.js"
       ]
     },
     "src/pages/System.tsx": {
-      "file": "assets/System-Da-Kxwiz.js",
+      "file": "assets/System-CMoOoUrZ.js",
       "name": "System",
       "src": "src/pages/System.tsx",
       "isDynamicEntry": true,
       "imports": [
         "index.html",
-        "_primitives-CSsF_Ymb.js"
+        "_primitives-CFhU5Rka.js"
       ]
     }
   }