ltcai 1.6.0 → 1.7.0

package/README.md

@@ -156,7 +156,7 @@ See [docs/architecture.md](docs/architecture.md) for request and data-flow detai
 </table>
 
 > Every image in this section is a **real screenshot** of the running app
-> (Lattice AI v1.6.0), captured with a headless browser.
+> (Lattice AI v1.7.0), captured with a headless browser.
 
 ---
 
@@ -179,7 +179,9 @@ DeepSeek, and more), with estimated RAM and a clear next step.
 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.
+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="Current Workspace summary card with scoped counts" width="100%"/>
@@ -196,6 +198,10 @@ relationships, related entities, and a path back to you.
   <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
@@ -347,24 +353,29 @@ Supported routes include OpenAI-compatible APIs, OpenRouter, Groq, Together, xAI
 
 ## Current release
 
-**1.6.0 — Product Experience Deepening.** A UX release: the screens in this README
-are now real captured UI.
-
-- **Knowledge Graph explorer** — entity cards, a relationship/related-entities/
-  shortest-path detail panel, recent activity, and a memory feed (additive UI on
-  existing endpoints)
-- **Workspace UX** — a "Current Workspace" summary card with quick-switch chips
-- **Model Recommendation 2.0** — machine summary, a best-pick callout with
-  estimated RAM and next step, per-family status, and a cloud caution
-- **Skill Marketplace** — Recommended / Popular / Installed / Updates tabs
-- **Enterprise capability panel** — an honest 12-capability matrix (Community: all
-  disabled, nothing gated)
-- **Real screenshots** — `docs/images/*` refreshed from the running app; API,
-  schemas, `server:app`, CLI, MCP, and the Knowledge Graph contract unchanged
+**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.6.0** | Product Experience Deepening (UX + real screenshots) |
+| **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 |

package/docs/CHANGELOG.md

@@ -1,5 +1,47 @@
 # 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,

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.6.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.6.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.6.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>

package/static/lattice-reference.css

@@ -1555,6 +1555,91 @@
   line-height: 1.5;
 }
 
+.lattice-ref-admin .enterprise-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(220px, 1fr));
+  gap: 10px;
+}
+
+.lattice-ref-admin .enterprise-cap-card {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  min-width: 0;
+  border: 1px solid rgba(111,66,232,0.12);
+  border-radius: 8px;
+  background: rgba(255,255,255,0.70);
+  padding: 11px 12px;
+}
+
+.lattice-ref-admin .enterprise-cap-card i {
+  color: #7a74a0;
+  font-size: 18px;
+}
+
+.lattice-ref-admin .enterprise-cap-card.on i {
+  color: #0d8f72;
+}
+
+.lattice-ref-admin .enterprise-cap-card span {
+  flex: 1;
+  min-width: 0;
+  color: #14162c;
+  font-size: 13px;
+  font-weight: 800;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  text-transform: capitalize;
+}
+
+.lattice-ref-admin .enterprise-cap-card strong {
+  color: #4a4668;
+  font-size: 11px;
+}
+
+.lattice-ref-admin .enterprise-kv {
+  display: grid;
+  gap: 8px;
+}
+
+.lattice-ref-admin .enterprise-kv div {
+  display: grid;
+  grid-template-columns: 150px minmax(0, 1fr);
+  gap: 10px;
+  align-items: start;
+  border: 1px solid rgba(111,66,232,0.10);
+  border-radius: 8px;
+  background: rgba(255,255,255,0.62);
+  padding: 9px 10px;
+}
+
+.lattice-ref-admin .enterprise-kv span {
+  color: #4a4668;
+  font-size: 12px;
+  font-weight: 800;
+}
+
+.lattice-ref-admin .enterprise-kv strong {
+  color: #14162c;
+  font-size: 12px;
+  line-height: 1.45;
+  overflow-wrap: anywhere;
+}
+
+.lattice-ref-admin .enterprise-json {
+  max-height: 280px;
+  overflow: auto;
+  margin: 12px 0 0;
+  border: 1px solid rgba(111,66,232,0.10);
+  border-radius: 8px;
+  background: rgba(20,22,44,0.05);
+  color: #14162c;
+  padding: 12px;
+  font-size: 12px;
+  white-space: pre-wrap;
+}
+
 @media (max-width: 980px) {
   .lattice-ref-chat .reference-card-grid,
   .reference-lists {
@@ -2784,9 +2869,11 @@ body.lattice-ref-graph {
       top: 16px;
       right: 16px;
       display: flex;
+      flex-wrap: wrap;
       gap: 8px;
       padding: 8px;
       border-radius: 10px;
+      max-width: min(760px, calc(100% - 32px));
     }
 
     .tb-btn {
@@ -3301,6 +3388,103 @@ body.lattice-ref-graph {
 
     .jump-btn:hover { filter: brightness(1.04); }
 
+    .jump-btn.secondary {
+      border: 1px solid rgba(111,66,232,0.20);
+      color: var(--text);
+      background: rgba(255,255,255,0.82);
+      box-shadow: none;
+      cursor: pointer;
+      font: inherit;
+      font-size: 12px;
+      font-weight: 700;
+    }
+
+    .detail-actions {
+      display: flex;
+      flex-wrap: wrap;
+      gap: 8px;
+      margin-bottom: 14px;
+    }
+
+    .related-node-list {
+      display: grid;
+      gap: 7px;
+      margin-bottom: 14px;
+    }
+
+    .related-node-btn {
+      width: 100%;
+      min-width: 0;
+      display: grid;
+      grid-template-columns: 18px minmax(0, 1fr) auto;
+      align-items: center;
+      gap: 8px;
+      border: 1px solid rgba(111,66,232,0.13);
+      border-radius: 8px;
+      background: rgba(255,255,255,0.76);
+      color: var(--text);
+      padding: 8px 10px;
+      text-align: left;
+      cursor: pointer;
+    }
+
+    .related-node-btn:hover {
+      border-color: rgba(111,66,232,0.34);
+      background: rgba(111,66,232,0.07);
+    }
+
+    .related-node-btn strong {
+      min-width: 0;
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+      font-size: 12px;
+    }
+
+    .related-node-btn em {
+      color: var(--faint);
+      font-size: 11px;
+      font-style: normal;
+      white-space: nowrap;
+    }
+
+    .focus-chip {
+      position: absolute;
+      z-index: 21;
+      left: 16px;
+      bottom: 16px;
+      max-width: min(560px, calc(100% - 32px));
+      display: flex;
+      flex-wrap: wrap;
+      gap: 8px;
+      padding: 8px;
+      border: 1px solid var(--line);
+      border-radius: 10px;
+      background: rgba(255,255,255,0.90);
+      box-shadow: var(--shadow);
+      backdrop-filter: blur(18px);
+    }
+
+    .focus-chip span {
+      display: inline-flex;
+      align-items: center;
+      gap: 6px;
+      border-radius: 999px;
+      background: rgba(111,66,232,0.08);
+      color: var(--text);
+      padding: 5px 10px;
+      font-size: 11px;
+      font-weight: 800;
+      max-width: 260px;
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+    }
+
+    .search-shell.search-open .search-results {
+      display: block;
+    }
+
     .empty-hint {
       margin: 0;
       color: var(--muted);