ltcai 1.6.0 → 2.0.0

package/README.md

@@ -1,7 +1,7 @@
 <div align="center">
   <img src="https://raw.githubusercontent.com/TaeSooPark-PTS/LatticeAI/main/docs/images/logo.svg" alt="Lattice AI" width="280"/>
   <br/>
-  <strong>AI Workspace OS for local-first graph, memory, agents, workflows, skills, and timelines.</strong>
+  <strong>Lattice AI — Local-first Agentic Workspace Platform: plugins, visual workflows, multi-agent runs, and realtime activity over your graph, memory, skills, and timeline.</strong>
   <br/><br/>
 
 [![PyPI](https://img.shields.io/pypi/v/ltcai?label=PyPI&color=blue)](https://pypi.org/project/ltcai/)
@@ -24,7 +24,7 @@
 
 Most AI tools answer one chat at a time. They do not remember your folders, your project history, your previous decisions, or how your files relate to each other.
 
-**Lattice AI turns your local workspace into an AI Workspace OS.**
+**Lattice AI turns your local workspace into a Local-first Agentic Workspace Platform.**
 
 It reads approved local folders, indexes chats and documents, builds a searchable knowledge graph, and connects the graph to snapshots, personal memory, agent runs, workflow history, skills, and an auditable timeline.
 
@@ -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 v2.0.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,39 @@ 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
+**2.0.0 — Agentic Workspace Platform.** Lattice AI graduates from a local-first
+AI *workspace* to a local-first **Agentic Workspace Platform**: four new
+subsystems land as one cohesive, fully integrated platform — all additive, with
+every v1.x surface preserved.
+
+- **Plugin SDK** — versioned, permissioned plugins (`plugin.json` manifest,
+  allow-listed permissions, lifecycle, validation, and a safe execution
+  boundary) that **extend** existing skills/tools/workflows rather than replace
+  them. Ships two example plugins. See [docs/PLUGIN_SDK.md](docs/PLUGIN_SDK.md).
+- **Workflow Designer** — node-based workflows (trigger · tool · skill · plugin ·
+  agent · condition · output) with validation, execution, run history, and
+  export/import. Pre-2.0 workflow history keeps working.
+  See [docs/WORKFLOW_DESIGNER.md](docs/WORKFLOW_DESIGNER.md).
+- **Multi-Agent Runtime 2.0** — Planner · Executor · Reviewer · Researcher ·
+  Release roles with handoff, retry, and an observable timeline, connected to
+  workspace, memory, graph, and workflow runs.
+  See [docs/MULTI_AGENT_RUNTIME.md](docs/MULTI_AGENT_RUNTIME.md).
+- **Realtime Collaboration** — presence + an activity feed over SSE, fed
+  automatically from every workspace timeline event; single-user local mode and
+  workspace isolation preserved. See [docs/REALTIME_COLLABORATION.md](docs/REALTIME_COLLABORATION.md).
+- **Cross-system integration** — workflows run plugins/skills/agents, agent runs
+  run plugins/workflows, and all activity surfaces in the realtime feed, the
+  knowledge graph, and the workspace timeline. See [docs/V2_ARCHITECTURE.md](docs/V2_ARCHITECTURE.md).
+- **Compatibility preserved** — API schemas, `server:app`,
+  `latticeai.server_app.app`, CLI, MCP, model, workspace, chat, KG, existing
+  skills/snapshots/memories/agent history, and the VS Code extension remain
+  backward compatible. Changes are additive; no destructive migrations.
 
 | Version | Theme |
 |---|---|
-| **1.6.0** | Product Experience Deepening (UX + real screenshots) |
+| **2.0.0** | Agentic Workspace Platform (Plugin SDK, Workflow Designer, Multi-Agent Runtime, Realtime) |
+| 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,112 @@
 # Changelog
 
+## [2.0.0] - 2026-06-01
+
+> Agentic Workspace Platform — Lattice AI becomes a local-first **Agentic
+> Workspace Platform** with four integrated subsystems: Plugin SDK, Workflow
+> Designer, Multi-Agent Runtime 2.0, and Realtime Collaboration. Backward
+> compatible and additive: API paths/schemas, `server:app`,
+> `latticeai.server_app.app`, CLI, Workspace/Chat/Model/MCP/KG APIs, existing
+> skills/snapshots/memories/agent & workflow history, and VS Code extension
+> commands remain stable. New Workspace OS state keys (`plugin_registry`,
+> `workflow_runs`) are backfilled on load via deep-merge — no destructive
+> migration.
+
+### Added
+
+- **Plugin SDK** (`latticeai/core/plugins.py`, `latticeai/api/plugins.py`) —
+  `plugin.json` manifest, an allow-listed permission model, discovery,
+  validation, lifecycle (install/enable/disable/uninstall), and a permissioned
+  execution boundary. Plugins **extend** the existing skill registry (installing
+  a plugin registers its bundled skills) rather than replacing skills. Ships two
+  example plugins (`plugins/hello-world`, `plugins/git-insights`). Routes under
+  `/plugins/registry`, `/plugins/validate`, `/plugins/install`, `/plugins/enable`,
+  `/plugins/disable`, `/plugins/uninstall`, `/plugins/execute`, page `/plugins/sdk`.
+- **Workflow Designer** (`latticeai/core/workflow_engine.py`,
+  `latticeai/api/workflow_designer.py`) — node-based workflows
+  (trigger/tool/skill/plugin/agent/condition/output), validation, a bounded
+  deterministic execution engine, run history, and JSON export/import. Legacy
+  `steps`-list workflows are auto-normalized so pre-2.0 history still runs.
+  Routes under `/workflows/api/*`, page `/workflows`.
+- **Multi-Agent Runtime 2.0** (`latticeai/core/multi_agent.py`,
+  `latticeai/api/agents.py`) — Planner/Executor/Reviewer/Researcher/Release role
+  orchestration with handoff, bounded retry, and an observable timeline; runs
+  persist to agent history + knowledge graph + timeline. Deterministic by
+  default (no LLM required) with an injectable role runner. Routes under
+  `/agents/api/*`, page `/agents`.
+- **Realtime Collaboration** (`latticeai/core/realtime.py`,
+  `latticeai/api/realtime.py`) — in-process pub/sub bus, presence, and an
+  activity feed over SSE. Wired as the Workspace OS `event_sink`, so every
+  timeline event flows to the feed automatically. Workspace isolation enforced;
+  single-user local mode preserved. Routes `/realtime/stream` (SSE),
+  `/realtime/feed`, `/realtime/presence*`, page `/activity`.
+- **Cross-system integration** (`latticeai/services/platform_runtime.py`) —
+  workflows can run tools/skills/plugins/agents; agent runs can run
+  plugins/workflows; graph entities link to workflow runs and agent runs; all
+  activity surfaces in the unified timeline + realtime feed. Recursion is bounded
+  by construction.
+- **Platform UI** — `static/plugins.html`, `workflows.html`, `agents.html`,
+  `activity.html` (+ shared `static/platform.css`, `static/scripts/platform.js`),
+  linked from the Workspace dashboard.
+- **Docs** — `docs/V2_ARCHITECTURE.md`, `docs/PLUGIN_SDK.md`,
+  `docs/WORKFLOW_DESIGNER.md`, `docs/MULTI_AGENT_RUNTIME.md`,
+  `docs/REALTIME_COLLABORATION.md`.
+
+### Changed
+
+- Python package, npm package, VS Code extension, Workspace OS, FastAPI app, and
+  `/health` version metadata aligned at `2.0.0`.
+- `server_app` cross-system wiring extracted into
+  `latticeai/services/platform_runtime.py` to keep the assembly file lean.
+
+### Validation
+
+- Unit (incl. new plugin/workflow/multi-agent/realtime suites), integration
+  smoke, startup/import, route-compatibility (full v1.x baseline preserved),
+  and release-artifact checks. Package-store publishing remains manual.
+
+## [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

@@ -5,10 +5,12 @@ the boundary stays predictable for contributors and users.
 
 ## Editions
 
-- **Community** — this repository, MIT licensed. Local-first AI Workspace OS:
-  local LLMs, knowledge graph, Personal **and** Organization workspaces,
-  role-based membership, snapshots, memory, agents, workflows, skills, and the
-  auditable timeline. Community is a complete product.
+- **Community** — this repository, MIT licensed. Local-first **Agentic Workspace
+  Platform**: local LLMs, knowledge graph, Personal **and** Organization
+  workspaces, role-based membership, snapshots, memory, agents, workflows,
+  skills, the auditable timeline, and the full v2.0 platform — **Plugin SDK**,
+  **Workflow Designer**, **Multi-Agent Runtime 2.0**, and **Realtime
+  Collaboration**. Community is a complete product.
 - **Enterprise** — a separately-distributed plugin adding organization-scale
   governance, identity, compliance, and deployment capabilities. Distributed and
   licensed separately. See [ENTERPRISE.md](ENTERPRISE.md).
@@ -39,6 +41,10 @@ the boundary stays predictable for contributors and users.
 | Personal & Organization workspaces | ✅ | — |
 | Base roles (owner/admin/member/viewer) | ✅ | — |
 | Snapshots / memory / agents / workflows / skills | ✅ | — |
+| Plugin SDK (manifest, lifecycle, permission boundary) | ✅ | RBAC/ABAC over plugin permissions |
+| Workflow Designer (build/run/run-history) | ✅ | Org approval gates, scheduled triggers |
+| Multi-Agent Runtime 2.0 (roles/handoff/retry) | ✅ | Policy-bounded autonomous runs |
+| Realtime Collaboration (presence + activity feed) | ✅ | Cross-tenant fan-out, retention |
 | Audit timeline (local) | ✅ | — |
 | Capability seam & enum | ✅ (declares) | ✅ (implements) |
 | SSO/SCIM/IdP provisioning | seam only | ✅ |
@@ -50,6 +56,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

@@ -9,7 +9,9 @@ Lattice AI follows an **open-core** model:
 
 - **Community** (this repository, MIT) is fully functional on its own: local
   LLMs, knowledge graph, Personal and Organization workspaces, roles, snapshots,
-  memory, agents, workflows, skills, and the auditable timeline.
+  memory, agents, workflows, skills, the auditable timeline, and the full v2.0
+  Agentic Workspace Platform (Plugin SDK, Workflow Designer, Multi-Agent Runtime
+  2.0, Realtime Collaboration).
 - **Enterprise** is a separately-distributed plugin that attaches advanced,
   organization-scale governance and deployment capabilities through a stable
   runtime seam. It is never bundled into the Community build.
@@ -33,8 +35,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