ltcai 1.7.0 → 2.1.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.7.0), captured with a headless browser.
+> (Lattice AI v2.0.0), captured with a headless browser.
 
 ---
 
@@ -353,28 +353,39 @@ Supported routes include OpenAI-compatible APIs, OpenRouter, Groq, Together, xAI
 
 ## Current release
 
-**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.
+**2.1.0 — Agent Platform Maturity Release.** Lattice AI operationalizes the
+v2.0 platform without replacing it: agent handoff, context packets, review/retry,
+planning, memory, replay, marketplace templates, and realtime execution
+observability are now first-class and still additive.
+
+- **Agent handoff + context packets** — handoffs now carry `handoff_id`,
+  source/target agent ids, reason, status, timestamps, and safe structured
+  context packets for replayable role transfer.
+- **Review / retry loops** — Planner -> Executor -> Reviewer records plan
+  review, reviewer notes, retry history, retry limits, and failure propagation.
+- **Timeline / replay** — agent and workflow runs expose replay frames showing
+  who acted, when, why, input, output, and decisions.
+- **Agent memory + planning** — short-term, workspace, and long-term memory
+  kinds are supported with workspace-scoped snapshots; plans are persisted with
+  run history and plan-review metadata.
+- **Workflow / agent / plugin hardening** — plugin outputs enter agent context,
+  agent outputs enter workflow outputs, and plugin/workflow/agent failures emit
+  observable execution events.
+- **Marketplace foundation** — local Plugin, Workflow, and Agent templates have
+  metadata, export/import, install hooks, and a registry. No cloud marketplace
+  service is introduced.
+- **Realtime execution observability** — existing SSE feed now emits agent,
+  handoff, review, retry, workflow, plugin, and execution failure events.
 - **Compatibility preserved** — API schemas, `server:app`,
-  `latticeai.server_app.app`, CLI, MCP, model, workspace, chat, KG, and VS Code
-  extension surfaces remain backward compatible.
+  `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.7.0** | Graph & Collaboration Release |
+| **2.1.0** | Agent Platform Maturity Release (handoff, context packets, review/retry, replay, memory, planning, marketplace foundation) |
+| 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 |

package/docs/CHANGELOG.md

@@ -1,5 +1,124 @@
 # Changelog
 
+## [2.1.0] - 2026-06-01
+
+> Agent Platform Maturity Release — v2.1 operationalizes the v2.0 platform
+> without redesigning it. Agent handoff, context packets, review/retry loops,
+> timeline replay, memory snapshots, planning records, marketplace templates,
+> and realtime execution observability are now first-class and additive.
+
+### Added
+
+- **Explicit agent handoff** — handoff records now include `handoff_id`,
+  source/target agent ids, reason, task summary, context packet, status, and
+  timestamps. Handoffs are workspace-scoped, persisted, inspectable, and replayable.
+- **Agent context packets** — structured transfer packets include objective,
+  task summary, workspace/graph/memory/workflow context, plugin outputs,
+  constraints, reviewer notes, and retry metadata with obvious secret fields
+  redacted before persistence.
+- **Review / retry loops** — Planner -> Executor -> Reviewer records plan review,
+  reviewer outcomes (`approve`, `reject`, `retry`), retry history, retry limits,
+  reviewer notes, and failure propagation.
+- **Timeline / replay** — agent and workflow runs expose replay support through
+  persisted frames that show actor, time, reason, input, output, and decision.
+  UI pages add replay viewers for agent and workflow runs.
+- **Agent memory and planning** — `short_term`, `workspace`, and `long_term`
+  memory scopes are supported, memory snapshots are workspace-scoped and
+  replayable, and agent plans persist with plan-review metadata.
+- **Workflow / agent / plugin hardening** — plugin output enters agent context,
+  agent output enters workflow output, retry paths are bounded, and failures
+  propagate into run status and realtime events.
+- **Marketplace foundation** — local Plugin, Workflow, and Agent templates with
+  metadata, export/import, install hooks, and a template registry. No cloud
+  marketplace service is introduced.
+- **Realtime execution observability** — existing SSE feed emits
+  `agent_started`, `handoff_created`, `handoff_accepted`, `handoff_completed`,
+  `review_requested`, `review_approved`, `retry_requested`,
+  `workflow_started`, `plugin_started`, `plugin_completed`, `execution_failed`,
+  and related workspace-scoped events.
+
+### Changed
+
+- Python package, npm package, VS Code extension, Workspace OS, FastAPI app, and
+  `/health` version metadata aligned at `2.1.0`.
+- Multi-Agent Runtime, Plugin SDK, Workflow Engine, and Realtime surface
+  versions now report `2.1.0`.
+- Platform UI pages for agents, workflows, plugins, and activity now expose
+  handoff chains, review panels, retry history, replay, templates, and plugin
+  execution visibility.
+
+### Validation
+
+- Unit coverage added for handoff/context persistence, review/retry history,
+  memory snapshots, replay, workflow-agent-plugin output propagation,
+  marketplace template install, and realtime execution events.
+- Package-store publishing remains manual; release artifacts are version-scoped.
+
+## [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

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 | ✅ |

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.