ltcai 1.5.0 → 1.7.0

package/README.md

@@ -155,42 +155,62 @@ See [docs/architecture.md](docs/architecture.md) for request and data-flow detai
 </tr>
 </table>
 
-> Screenshots above are the live web UI. The diagrams below map the product
-> experience to the current v1.5.0 structure.
+> Every image in this section is a **real screenshot** of the running app
+> (Lattice AI v1.7.0), captured with a headless browser.
 
 ---
 
 ## Product Experience
 
-### Local model recommendation
+### Onboard in minutes
 
-Lattice AI detects your OS, CPU, GPU, RAM, and disk, then rates every local model
-**Recommended**, **Compatible**, or **Not Recommended** for your machine — grouped
-by family (Gemma, Qwen, Llama, Phi, DeepSeek, and more).
+A first run detects your OS, CPU, GPU, RAM, and disk, then recommends a local
+model and rates every option **Recommended**, **Compatible**, or **Not
+Recommended** for your machine — grouped by family (Gemma, Qwen, Llama, Phi,
+DeepSeek, and more), with estimated RAM and a clear next step.
 
 <div align="center">
-  <img src="docs/images/model-recommendation.png" alt="Tri-state local model recommendation grouped by family" width="100%"/>
+  <img src="docs/images/onboarding.png" alt="Onboarding hardware scan: OS, CPU, GPU, RAM, disk, runtime" width="49%"/>
+  <img src="docs/images/model-recommendation.png" alt="Local model recommendation with best-pick callout and per-family status" width="49%"/>
 </div>
 
 ### Workspaces & organization
 
-Switch instantly between a **Personal** workspace and shared **Organization**
-workspaces. Org data is scoped by `workspace_id`, and `owner / admin / member /
-viewer` roles map to a transparent permission matrix.
+A **Current Workspace** card shows exactly where you are; switch instantly
+between a **Personal** workspace and shared **Organization** workspaces. Org data
+is scoped by `workspace_id`, and `owner / admin / member / viewer` roles map to a
+transparent permission matrix with member management. A Workspace Health panel
+summarizes indexed files, graph size, installed skills, memories, agent runs,
+current model, last sync time, and status at a glance.
 
 <div align="center">
-  <img src="docs/images/workspace.png" alt="Personal and Organization workspace model" width="49%"/>
-  <img src="docs/images/organization.png" alt="Organization roles and permission matrix" width="49%"/>
+  <img src="docs/images/workspace.png" alt="Current Workspace summary card with scoped counts" width="100%"/>
+  <img src="docs/images/organization.png" alt="Organization workspace with members and roles" width="100%"/>
 </div>
 
-### Knowledge graph & skills
+### Knowledge graph explorer
 
-Your work becomes a typed knowledge graph (built automatically), and skills extend
-the workspace through an in-product marketplace.
+Your work becomes a typed knowledge graph automatically. The Entity Explorer
+surfaces the most important entities and, on selection, their inbound/outbound
+relationships, related entities, and a path back to you.
 
 <div align="center">
-  <img src="docs/images/graph.png" alt="Knowledge graph node and edge taxonomy" width="49%"/>
-  <img src="docs/images/skills.png" alt="Skill marketplace: recommended, popular, installed, updates" width="49%"/>
+  <img src="docs/images/graph.png" alt="Knowledge graph entity explorer with relationship detail" width="100%"/>
+</div>
+
+The Graph Canvas also supports node expand/collapse, focused subgraphs,
+relationship highlighting, shortest-path visualization, and direct navigation
+back into source conversations or files.
+
+### Skills & editions
+
+Browse and install skills from an in-product marketplace; an honest editions
+panel shows that every Enterprise capability is an opt-in extension point,
+disabled in the open-source Community build.
+
+<div align="center">
+  <img src="docs/images/skills.png" alt="Skill marketplace tabs: recommended, popular, installed, updates" width="49%"/>
+  <img src="docs/images/enterprise.png" alt="Enterprise capability status panel — all disabled in Community" width="49%"/>
 </div>
 
 ---
@@ -333,22 +353,32 @@ Supported routes include OpenAI-compatible APIs, OpenRouter, Groq, Together, xAI
 
 ## Current release
 
-**1.5.0 — Unified Product Release.** Onboarding, model recommendation, and CI
-stabilization in one release:
-
-- **CI / VSIX recovery** — the stale `@azure/core-tracing` lockfile pin that
-  broke `npm ci` (ETARGET) is regenerated, so the VSIX build is green again
-- **Local model recommendation** — a hardware-aware engine
-  (`latticeai/services/model_recommendation.py`) classifies the model catalog as
-  Recommended / Compatible / Not Recommended, exposed at `/models/recommendations`
-- **Catalog extraction** — the static model catalog moved to
-  `latticeai/services/model_catalog.py`, simplifying `model_runtime.py`
-- **Enterprise PoC seam** — admin policy / audit-export / SIEM-stub / org-settings
-  surfaces consult the capability registry (Community keeps everything ungated)
-- **Documentation & visuals** — README rewritten as a product page with an
-  up-to-date architecture diagram and structural visuals
-- Python package, npm package, VS Code extension, FastAPI app, and `/health`
-  version metadata are aligned at `1.5.0`
+**1.7.0 — Graph & Collaboration Release.** An additive UI and validation release
+for graph exploration, workspace health, Enterprise admin visibility, skills,
+screenshots, and visual smoke coverage.
+
+- **Graph Canvas** — expand/collapse, subgraph focus, relationship/path
+  highlighting, shortest-path visualization, and click-through node navigation.
+- **Workspace Health** — indexed files, graph nodes/relationships, installed
+  skills, memories, agent runs, current model, last sync, and workspace status.
+- **Enterprise Admin UI** — admin policies, audit export, SIEM export preview,
+  organization settings, and capability status surfaced in `/admin`.
+- **Skill Marketplace completion** — install progress, validation status,
+  recommended/popular skills, updates, version, and source metadata.
+- **Screenshot automation + visual smoke tests** — `scripts/capture/*` and a
+  scheduled Playwright workflow cover Workspace, Graph, Skills, Organization,
+  and Enterprise screens.
+- **Compatibility preserved** — API schemas, `server:app`,
+  `latticeai.server_app.app`, CLI, MCP, model, workspace, chat, KG, and VS Code
+  extension surfaces remain backward compatible.
+
+| Version | Theme |
+|---|---|
+| **1.7.0** | Graph & Collaboration Release |
+| 1.6.0 | Product Experience Deepening (UX + real screenshots) |
+| 1.5.0 | Unified Product Release (CI/VSIX recovery, model recommendation, Enterprise PoC) |
+| 1.4.0 | Server App final decomposition |
+| 1.1.0–1.3.0 | Organization workspaces, modularization, route safety net |
 
 See the full [changelog](docs/CHANGELOG.md) and [RELEASE.md](RELEASE.md).
 

package/docs/CHANGELOG.md

@@ -1,5 +1,94 @@
 # Changelog
 
+## [1.7.0] - 2026-06-01
+
+> Graph & Collaboration Release — Graph Canvas interactions, Enterprise Admin
+> UI, Skill Marketplace completion, Workspace Health, screenshot automation, and
+> Playwright visual smoke coverage. Backward compatible: API paths/schemas,
+> `server:app`, `latticeai.server_app.app`, CLI, Workspace/Chat/Model/MCP/KG
+> APIs, and VS Code extension commands remain stable.
+
+### Added
+
+- **Graph Canvas** — node expand/collapse, focused subgraphs, relationship
+  highlighting, shortest-path visualization, URL/node click-through navigation,
+  and source/conversation actions. Uses existing graph/relationship APIs; no
+  schema change or destructive migration.
+- **Enterprise Admin UI** — `/admin#enterprise` now surfaces Admin Policies,
+  Audit Export, SIEM Export preview, Organization Settings, and Enterprise
+  Capability Status. Community remains fully functional and ungated.
+- **Skill Marketplace completion** — install progress (Download → Validate →
+  Ready), validation status, recommended/popular/update surfaces, version
+  metadata, and source metadata.
+- **Workspace Health Dashboard** — indexed files, graph nodes, graph
+  relationships, installed skills, memory entries, agent runs, current model,
+  last sync time, and workspace status.
+- **Screenshot automation** — `scripts/capture/` contains reproducible
+  Playwright capture scripts for workspace, graph, skills, enterprise, and
+  onboarding screenshots.
+- **Visual smoke tests** — `tests/visual/*` plus `.github/workflows/visual.yml`
+  run Workspace, Graph, Skills, Organization, and Enterprise screen checks on
+  PR/push and nightly schedule with failure artifacts.
+
+### Changed
+
+- Python package, npm package, VS Code extension, Workspace OS, FastAPI app, and
+  `/health` version metadata aligned at `1.7.0`.
+- CI package validation is version-scoped instead of a broad `dist/*` check.
+
+### Validation
+
+- Unit, integration, startup/import, route compatibility, MCP, model endpoint,
+  visual smoke, VSIX build, and release artifact validation are the release
+  target checks. Package-store publish remains manual only.
+
+## [1.6.0] - 2026-06-01
+
+> Product Experience Deepening — user-facing UX (Knowledge Graph explorer,
+> workspace summary, model recommendation 2.0, skill marketplace tabs, Enterprise
+> capability panel) and a refresh of `docs/images/*` to **real captured UI**
+> screenshots. Not a refactor: API paths, request/response schemas, `server:app`,
+> CLI, MCP, and the Knowledge Graph contract are unchanged. The only code changes
+> are additive frontend (`static/`) and version metadata.
+
+### Added
+
+- **Knowledge Graph Explorer (Workspace OS)** — an Entity Explorer (importance-
+  ranked entity cards + search) with a detail panel showing inbound/outbound
+  relationships, related entities, and the shortest path back to you; plus a
+  Recent Activity feed and a Workspace Memory feed. Built entirely on the existing
+  `/knowledge-graph/graph` and `/workspace/relationships/*` endpoints (additive
+  UI, no new API, no schema change).
+- **Workspace summary & quick-switch** — a "Current Workspace" card (active
+  workspace, role, members, scoped counts) and one-click switch chips, preserving
+  `workspace_id` scoping and the owner/admin/member/viewer model.
+- **Model Recommendation 2.0** — the onboarding recommendation panel now shows a
+  machine summary (OS/RAM/GPU/engine), a "best for this PC" callout with the
+  reason, estimated RAM, and next step, per-family status, and a cloud caution.
+  Estimates are labelled and conservative.
+- **Skill Marketplace tabs** — Recommended / Popular / Installed / Updates tabs
+  with version, category, and source, plus install / enable / disable actions on
+  the existing skill lifecycle API.
+- **Enterprise capability panel** — a 12-capability status matrix in Workspace OS
+  (Community reports all disabled; nothing gates a Community feature).
+
+### Changed
+
+- **Real UI visuals** — `docs/images/{hero.gif,onboarding,model-recommendation,
+  workspace,graph,organization,skills,enterprise}` are now **real screenshots**
+  captured from the running app with Playwright + headless Chrome (the v1.5.0
+  set was structural diagrams). `architecture.png` remains a structural diagram.
+  README references the new real screenshots with no broken links.
+- Python package, npm package, VS Code extension, FastAPI app, and `/health`
+  version metadata aligned at `1.6.0`.
+
+### Validation
+
+- Unit tests pass; route-compatibility, startup/import, streaming, model-endpoint,
+  MCP/KG, and workspace/org permission tests preserved; `npm run check:python`
+  green; new UI verified rendering in a real browser via Playwright; VSIX build
+  verified. Test/build/packaging artifacts only — no package-store publish.
+
 ## [1.5.0] - 2026-06-01
 
 > Unified Product Release — CI/VSIX recovery, hardware-aware local model

package/docs/EDITION_STRATEGY.md

@@ -50,6 +50,10 @@ the boundary stays predictable for contributors and users.
 
 - `GET /workspace/editions` → edition + per-capability matrix.
 - `GET /workspace/os` → `edition` block in the Workspace OS summary.
+- `/admin#enterprise` → Admin policy, audit export, SIEM preview,
+  organization settings, and capability status UI.
+- `GET /admin/enterprise` and `GET /admin/enterprise/siem-export` → descriptive
+  Community-safe Enterprise surfaces for integrations.
 - `latticeai.core.enterprise.detect_edition()` for in-process checks.
 
 In the Community build all of the above report `community` with every Enterprise

package/docs/ENTERPRISE.md

@@ -33,8 +33,14 @@ Community code consults the seam at extension points via
 `is_capability_enabled(EnterpriseCapability.X)`. In the Community build this is
 always `False`, so the Community code path is taken and nothing is gated off.
 
-The live edition + capability matrix is exposed at `GET /workspace/editions`
-and surfaced in the Workspace OS summary (`GET /workspace/os` → `edition`).
+The live edition + capability matrix is exposed at `GET /workspace/editions`,
+surfaced in the Workspace OS summary (`GET /workspace/os` → `edition`), and
+shown in the Enterprise Admin UI at `/admin#enterprise`.
+
+Community also exposes descriptive admin surfaces at `GET /admin/enterprise`
+and `GET /admin/enterprise/siem-export`: they show policy/export/envelope
+shapes while reporting Enterprise-only capabilities disabled and never
+streaming external events.
 
 ## Enterprise capability roadmap
 

package/latticeai/__init__.py

@@ -1,3 +1,3 @@
 """Lattice AI - modular server package."""
 
-__version__ = "1.5.0"
+__version__ = "1.7.0"

package/latticeai/core/workspace_os.py

@@ -18,7 +18,7 @@ from pathlib import Path
 from typing import Any, Callable, Dict, Iterable, List, Optional
 
 
-WORKSPACE_OS_VERSION = "1.5.0"
+WORKSPACE_OS_VERSION = "1.7.0"
 
 # Workspace types separate single-user Personal workspaces from shared
 # Organization workspaces. Both keep the same local-first JSON store; the type
@@ -353,6 +353,7 @@ class WorkspaceOSStore:
             "workspaces": state.get("workspaces"),
             "navigation": list(WORKSPACE_AREAS),
             "feature_flags": state.get("feature_flags"),
+            "updated_at": state.get("updated_at"),
             "counts": {
                 "snapshots": len(_listify(state.get("snapshots"))),
                 "traces": len(_listify(state.get("traces"))),
@@ -1424,6 +1425,9 @@ class WorkspaceOSStore:
                     "description": desc,
                     "version": version,
                     "installed": True,
+                    "install_status": entry.get("install_status") or "ready",
+                    "validation_status": "ready" if skill_md.exists() else "missing_manifest",
+                    "source": entry.get("source") or "local",
                     "path": str(skill_dir),
                     "updated_at": entry.get("updated_at") or _now(),
                 })
@@ -1438,6 +1442,9 @@ class WorkspaceOSStore:
                 **item,
                 "enabled": bool(state_entry.get("enabled", True)),
                 "installed": bool(state_entry.get("installed")),
+                "install_status": state_entry.get("install_status") or ("ready" if state_entry.get("installed") else "available"),
+                "validation_status": state_entry.get("validation_status") or item.get("validation_status") or ("ready" if state_entry.get("installed") else "not_installed"),
+                "source": state_entry.get("source") or item.get("source") or item.get("plugin") or "marketplace",
                 "version": state_entry.get("version") or item.get("version") or "remote",
             })
         self.save_state(state)
@@ -1465,6 +1472,9 @@ class WorkspaceOSStore:
             "installed": True,
             "enabled": entry.get("enabled", True),
             "version": version,
+            "install_status": "ready",
+            "validation_status": "ready",
+            "source": (metadata or {}).get("source") or entry.get("source") or "marketplace",
             "metadata": metadata or entry.get("metadata") or {},
             "updated_at": _now(),
         })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ltcai",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "Lattice AI Workspace OS for local-first graph, memory, agent, workflow, and skill operations",
   "homepage": "https://github.com/TaeSooPark-PTS/LatticeAI#readme",
   "repository": {
@@ -23,6 +23,12 @@
     "test": "python3 -m pytest tests/ -v",
     "test:unit": "python3 -m pytest tests/unit/ -v",
     "test:integration": "python3 -m pytest tests/integration/ -v",
+    "test:visual": "playwright test",
+    "capture:workspace": "node scripts/capture/capture_workspace.js",
+    "capture:graph": "node scripts/capture/capture_graph.js",
+    "capture:skills": "node scripts/capture/capture_skills.js",
+    "capture:enterprise": "node scripts/capture/capture_enterprise.js",
+    "capture:onboarding": "node scripts/capture/capture_onboarding.js",
     "publish:npm": "npm publish --access public",
     "publish:pypi": "python3 -m twine upload --skip-existing dist/ltcai-$npm_package_version.tar.gz dist/ltcai-$npm_package_version-py3-none-any.whl"
   },
@@ -75,5 +81,8 @@
   ],
   "publishConfig": {
     "access": "public"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.60.0"
   }
 }

package/static/admin.html

@@ -26,6 +26,7 @@
             <a href="#users" data-admin-nav="users"><i class="ti ti-users"></i> <span data-i18n="nav_users">사용자 관리</span></a>
             <a href="#permissions" data-admin-nav="permissions"><i class="ti ti-key"></i> <span data-i18n="nav_permissions">권한 관리</span></a>
             <a href="#sso" data-admin-nav="sso"><i class="ti ti-lock-access"></i> <span data-i18n="nav_sso">SSO 관리</span></a>
+            <a href="#enterprise" data-admin-nav="enterprise"><i class="ti ti-building-skyscraper"></i> <span data-i18n="nav_enterprise">Enterprise</span></a>
             <a href="#security" data-admin-nav="security"><i class="ti ti-shield-check"></i> <span data-i18n="nav_security">보안 모니터링</span></a>
             <a href="#audit" data-admin-nav="audit"><i class="ti ti-report-search"></i> <span data-i18n="nav_audit">감사 로그</span></a>
             <a href="/workspace"><i class="ti ti-layout-dashboard"></i> <span>Workspace OS</span></a>
@@ -256,6 +257,67 @@
                 </section>
             </section>
 
+            <section class="admin-view" id="admin-view-enterprise" data-admin-view="enterprise">
+                <section class="panel">
+                    <div class="panel-header">
+                        <div>
+                            <h3 data-i18n="enterprise_title">Enterprise Admin</h3>
+                            <p data-i18n="enterprise_desc">Admin policies, audit export, SIEM export, organization settings, and capability status.</p>
+                        </div>
+                        <div class="tag-row" id="enterprise-status-tags"></div>
+                    </div>
+                    <div class="panel-body">
+                        <div class="enterprise-grid" id="enterprise-capability-status"></div>
+                    </div>
+                </section>
+
+                <section class="panel-grid">
+                    <article class="panel">
+                        <div class="panel-header">
+                            <div>
+                                <h3 data-i18n="enterprise_policies">Admin Policies</h3>
+                                <p data-i18n="enterprise_policies_desc">Effective Community policy and Enterprise policy-pack status.</p>
+                            </div>
+                        </div>
+                        <div class="panel-body" id="enterprise-admin-policies"></div>
+                    </article>
+                    <article class="panel">
+                        <div class="panel-header">
+                            <div>
+                                <h3 data-i18n="enterprise_org">Organization Settings</h3>
+                                <p data-i18n="enterprise_org_desc">Workspace governance and organization capability status.</p>
+                            </div>
+                        </div>
+                        <div class="panel-body" id="enterprise-org-settings"></div>
+                    </article>
+                </section>
+
+                <section class="panel-grid">
+                    <article class="panel">
+                        <div class="panel-header">
+                            <div>
+                                <h3 data-i18n="enterprise_audit_export">Audit Export</h3>
+                                <p data-i18n="enterprise_audit_export_desc">Local export remains available in Community; retention is an Enterprise extension point.</p>
+                            </div>
+                        </div>
+                        <div class="panel-body" id="enterprise-audit-export"></div>
+                    </article>
+                    <article class="panel">
+                        <div class="panel-header">
+                            <div>
+                                <h3 data-i18n="enterprise_siem">SIEM Export</h3>
+                                <p data-i18n="enterprise_siem_desc">Preview the SIEM envelope without streaming external events in Community.</p>
+                            </div>
+                            <button class="btn" id="refresh-siem-btn" type="button"><i class="ti ti-refresh"></i> <span>SIEM</span></button>
+                        </div>
+                        <div class="panel-body">
+                            <div id="enterprise-siem-export"></div>
+                            <pre class="enterprise-json" id="enterprise-siem-preview"></pre>
+                        </div>
+                    </article>
+                </section>
+            </section>
+
             <section class="admin-view" id="admin-view-security" data-admin-view="security">
                 <!-- Security & Audit Command Center (피드백 #5) -->
                 <section class="panel" id="security-overview-panel">

package/static/graph.html

@@ -51,7 +51,12 @@
       </section>
 
       <div class="toolbar">
-        <button class="tb-btn" id="refresh-btn">↺ Refresh</button>
+        <button class="tb-btn" id="refresh-btn"><i class="ti ti-refresh"></i> Refresh</button>
+        <button class="tb-btn" id="fit-btn" title="Fit graph"><i class="ti ti-arrows-maximize"></i> Fit</button>
+        <button class="tb-btn" id="expand-btn" title="Expand selected node"><i class="ti ti-circle-plus"></i> Expand</button>
+        <button class="tb-btn" id="collapse-btn" title="Collapse selected neighbors"><i class="ti ti-circle-minus"></i> Collapse</button>
+        <button class="tb-btn" id="focus-btn" title="Focus selected subgraph"><i class="ti ti-focus-2"></i> Focus</button>
+        <button class="tb-btn" id="path-btn" title="Shortest path from saved start"><i class="ti ti-route"></i> Path</button>
         <div class="lang-picker" id="graph-lang-picker">
           <button class="tb-btn" id="graph-lang-btn" type="button" onclick="toggleLangMenu('graph-lang-picker')">Language</button>
           <div class="lang-picker-menu" id="graph-lang-picker-menu">
@@ -60,6 +65,7 @@
           </div>
         </div>
       </div>
+      <div id="graph-focus-chip" class="focus-chip" hidden></div>
     </main>
 
     <aside>