ltcai 2.2.0 → 2.2.2

package/README.md

@@ -1,102 +1,61 @@
-# Lattice AI
+<div align="center">
+  <img src="docs/images/logo.svg" alt="Lattice AI" width="120" />
 
-Lattice AI is an **AI Knowledge OS** for personal and organization workspaces.
-It is not a simple chat app, local LLM launcher, or model manager.
+  # Lattice AI
 
-Lattice AI turns files, documents, images, screenshots, conversations,
-decisions, notes, work history, and generated artifacts into knowledge. That
-knowledge is linked into a Knowledge Graph, and AI works on top of the graph to
-advise, analyze, generate documents, and automate work.
+  **Local-first AI workspace for knowledge graphs, AI pipelines, and multi-agent coding workflows.**
 
-The product rule for v2.2.0 is direct:
+  Plan, execute, review, and remember work across local models, cloud models,
+  files, and team workflows.
+</div>
 
-> Do not control the user in the name of protection. Explain clearly, disclose
-> sources and risks, then let the user decide.
+<div align="center">
 
-## Current release
+[![PyPI version](https://img.shields.io/pypi/v/ltcai?label=PyPI)](https://pypi.org/project/ltcai/)
+[![npm version](https://img.shields.io/npm/v/ltcai?label=npm)](https://www.npmjs.com/package/ltcai)
+[![VS Code Marketplace](https://vsmarketplacebadges.dev/version-short/parktaesoo.ltcai.svg)](https://marketplace.visualstudio.com/items?itemName=parktaesoo.ltcai)
+[![Open VSX](https://img.shields.io/open-vsx/v/parktaesoo/ltcai?label=Open%20VSX)](https://open-vsx.org/extension/parktaesoo/ltcai)
+[![GitHub release](https://img.shields.io/github/v/release/TaeSooPark-PTS/LatticeAI?label=GitHub%20release)](https://github.com/TaeSooPark-PTS/LatticeAI/releases/tag/v2.2.2)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org/)
+[![VS Code extension](https://img.shields.io/badge/VS%20Code-extension-blue?logo=visualstudiocode)](https://marketplace.visualstudio.com/items?itemName=parktaesoo.ltcai)
 
-**2.2.0 — Multimodal-First Knowledge OS Release.** Lattice AI now centers the
-product on a multimodal Knowledge Graph, Gemma-4-first recommendations, source
-disclosure, and equal feature access across basic and advanced modes. Admin mode
-is the only mode with additional authority.
+</div>
 
----
+![Lattice AI demo](docs/images/lattice-ai-demo.gif)
 
-## What Lattice AI Does
+## Install
 
-- Accepts PDFs, Word files, spreadsheets, slide decks, images, screenshots,
-  notes, code, web content, conversations, and work logs without asking the user
-  to pre-convert them.
-- Extracts entities, relationships, evidence, decisions, and artifacts into the
-  Knowledge Graph.
-- Uses AI models as replaceable workers on top of the graph.
-- Recommends current-generation multimodal models based on CPU, GPU, RAM,
-  storage, OS, and observed usage.
-- Shows every model's source facts before use:
-  1. 제작 국가
-  2. 제작 회사
-  3. 실행 방식
-  4. 인터넷 사용 여부
-  5. 모델명
-- Keeps text-only local model recommendations out of the product path.
+Install the local workspace:
 
-## Core Principles
-
-- Users should not work for AI. AI should work for users.
-- Do not hide features, sources, limitations, or risks.
-- Basic and advanced modes expose the same capabilities.
-- Basic mode explains in plain language.
-- Advanced mode shows deeper technical reasoning.
-- Admin mode is reserved for user management, permissions, audit logs,
-  organization policy, security policy, model approval, and Private VPC.
-- Knowledge Graph durability matters more than any single model.
-- Old model generations are removed when a newer generation in the same family
-  is available.
-
-## Multimodal Model Policy
-
-Lattice AI v2.2.0 removes the old text-only recommendation path.
-
-Current local recommendations focus on:
-
-| Family | Default role | Example current recommendation |
-| --- | --- | --- |
-| Gemma 4 | Default Google multimodal family | `mlx-community/gemma-4-12b-it-4bit` |
-| Gemma 4 large | Higher-quality local multimodal work | `mlx-community/gemma-4-31b-it-4bit` |
-| Qwen3-VL | Smaller and balanced multimodal options | `mlx-community/Qwen3-VL-4B-Instruct-4bit` |
-| Llama 4 | Meta multimodal option | `mlx-community/Llama-4-Scout-17B-16E-Instruct-4bit` |
+```bash
+pip install ltcai
+```
 
-Removed from current recommendation catalogs:
+Add Apple Silicon local model support:
 
-- `mlx-lm` as a local text-only execution path
-- Gemma 2 and Gemma 3 recommendations
-- Qwen2.5-VL recommendations
-- SmolLM, Phi, Mistral, DeepSeek, GPT-OSS, and Llama 3.x local recommendation
-  entries
-- text-only fallback logic for low-spec machines
+```bash
+pip install "ltcai[local]"
+```
 
-Low-spec machines are handled with smaller or quantized multimodal models,
-not older text-only models.
+Install the npm CLI:
 
-## Knowledge Graph Flow
-
-```text
-files / documents / images / conversations / work history
-  -> multimodal understanding
-  -> entity extraction
-  -> relationship extraction
-  -> evidence storage
-  -> Knowledge Graph update
-  -> advice / analysis / document generation / automation
+```bash
+npm install -g ltcai
 ```
 
-The graph preserves the user's work memory even when the model changes.
+Install the coding extension:
+
+- [VS Code Marketplace: parktaesoo.ltcai](https://marketplace.visualstudio.com/items?itemName=parktaesoo.ltcai)
+- [Open VSX: parktaesoo.ltcai](https://open-vsx.org/extension/parktaesoo/ltcai)
+- [GitHub Release v2.2.2](https://github.com/TaeSooPark-PTS/LatticeAI/releases/tag/v2.2.2)
 
 ## Quick Start
 
+Start the workspace:
+
 ```bash
-npm install
-npm run dev
+LTCAI
 ```
 
 Then open:
@@ -105,107 +64,177 @@ Then open:
 http://127.0.0.1:4825
 ```
 
-Useful commands:
+Development checkout:
 
 ```bash
-npm test
-npm run check:python
-npm run build
+npm install
+npm run dev
 ```
 
-VS Code extension:
+Useful validation commands:
 
 ```bash
-cd vscode-extension
-npm install
+npm run check:python
+npm run test:unit
 npm run build
-npm run package:vsix
 ```
 
-## Python Package
+## What Is Lattice AI?
 
-```bash
-python3 -m build
-```
+Lattice AI is a local-first AI workspace for people and teams who want their
+files, models, graph context, and agent workflows in one place.
 
-Expected v2.2.0 Python artifacts:
+- **Local-first AI Workspace**: work starts on your machine, with local data and
+  workspace state by default.
+- **AI Pipeline Platform**: plan, execute, review, retry, and replay work across
+  local models, cloud models, tools, files, and generated artifacts.
+- **Knowledge Graph Platform**: documents, images, screenshots, notes,
+  conversations, and decisions become linked entities, relationships, evidence,
+  and reusable context.
+- **Multi-Agent Workflow Platform**: agents hand off structured context, review
+  work, retry with reasons, and keep timelines inspectable.
+- **Personal / Organization Workspace**: move between personal work and team
+  workspaces with role-aware views.
+- **Local Model Management**: choose current multimodal local models with source
+  disclosure, hardware-aware recommendations, and cloud fallback options.
+- **SSO for teams**: organization workspaces can be paired with Okta or
+  Microsoft Entra ID patterns for team access.
 
-```text
-dist/ltcai-2.2.0-py3-none-any.whl
-dist/ltcai-2.2.0.tar.gz
-```
+## Why Lattice AI?
 
-## VS Code Package
+Most AI tools split your work across a chat window, a model picker, loose files,
+and disconnected automations. Lattice AI keeps those parts together:
 
-```bash
-cd vscode-extension
-npm run build
-npm run package:vsix
-```
+- files and conversations become graph context;
+- graph context feeds pipelines and coding actions;
+- model cards disclose country, company, run mode, internet usage, and model
+  identity;
+- personal and organization workspaces keep team workflows separate from local
+  work;
+- multi-agent workflows leave behind replayable plans, reviews, retries, and
+  outcomes.
 
-Expected v2.2.0 VSIX artifact:
+## v2.2.2 QA & Stability Highlights
 
-```text
-dist/ltcai-2.2.0.vsix
-```
+A no-features stabilization release that hardens the v2.2.x UI. Every fix keeps
+the existing design-token structure and adds no `!important`.
 
-## npm Package
+- Mobile hamburger navigation on the Knowledge Graph and Admin pages is
+  reachable again (a CSS source-order bug had kept the toggles hidden).
+- Admin top-bar actions (Refresh, Logout) are clickable again — a graph-only
+  toolbar rule that floated over the header was scoped back off the graph page.
+- Removed latent horizontal overflow on the Workspace page.
+- Verified across the full viewport matrix (375px phone → 3440px ultrawide):
+  light/dark theme parity, button hit-testing, no horizontal scroll, mobile
+  drawer open/close, and Escape-to-close — all covered by an expanded
+  Playwright suite.
 
-```bash
-npm pack
-```
+Carried forward from v2.2.1: mobile-first responsive layout, design-token
+light/dark themes, keyboard-safe chat composer, Knowledge Graph responsive UX,
+Admin mobile card layout, drag-and-drop file attachment, and model-card source
+disclosure.
 
-Expected v2.2.0 npm artifact:
+## Screenshots
 
-```text
-ltcai-2.2.0.tgz
-```
+### Workspace
 
-## Manual Publishing
+![Workspace light theme](docs/images/workspace-light.png)
 
-Publishing is intentionally manual. Do not publish with globs.
+![Workspace dark theme](docs/images/workspace-dark.png)
 
-PyPI:
+### Knowledge Graph
 
-```bash
-python3 -m twine upload dist/ltcai-2.2.0-py3-none-any.whl dist/ltcai-2.2.0.tar.gz
-```
+![Knowledge Graph](docs/images/knowledge-graph.png)
 
-VS Code Marketplace:
+### AI Pipeline
 
-```bash
-npx vsce publish --packagePath dist/ltcai-2.2.0.vsix
-```
+![AI Pipeline designer](docs/images/pipeline.png)
 
-Open VSX:
+### Admin Dashboard
 
-```bash
-npx ovsx publish dist/ltcai-2.2.0.vsix
+![Admin dashboard](docs/images/admin-dashboard.png)
+
+### Mobile Responsive
+
+![Mobile responsive layout](docs/images/mobile-responsive.png)
+
+## Knowledge Graph Flow
+
+```text
+files / documents / images / screenshots / conversations / decisions
+  -> multimodal understanding
+  -> entity and relationship extraction
+  -> evidence and artifact storage
+  -> Knowledge Graph update
+  -> AI pipeline context
+  -> coding actions / analysis / documents / team workflows
 ```
 
-npm:
+The graph keeps useful workspace context available even when you change models.
 
-```bash
-npm publish --access public
+## Local Model Policy
+
+Lattice AI recommends current-generation multimodal models for local use and
+keeps local model choices explicit.
+
+| Family | Default role | Example recommendation |
+| --- | --- | --- |
+| Gemma 4 | Default Google multimodal family | `mlx-community/gemma-4-12b-it-4bit` |
+| Gemma 4 large | Higher-quality local multimodal work | `mlx-community/gemma-4-31b-it-4bit` |
+| Qwen3-VL | Smaller, balanced multimodal options | `mlx-community/Qwen3-VL-4B-Instruct-4bit` |
+| Llama 4 | Meta multimodal option | `mlx-community/Llama-4-Scout-17B-16E-Instruct-4bit` |
+
+Every recommended model card shows maker country, maker company, run mode,
+internet requirement, and model name. See [MODEL_POLICY.md](MODEL_POLICY.md).
+
+## Architecture
+
+```text
+Personal / Organization Workspace
+  -> files, chats, screenshots, model choices, workflow events
+  -> Knowledge Graph
+  -> AI Pipeline
+  -> Multi-Agent Workflow
+  -> coding actions, documents, analysis, team handoffs
 ```
 
-## Documentation
+Core areas:
 
-- [ARCHITECTURE.md](ARCHITECTURE.md)
-- [PROJECT_PRINCIPLES.md](PROJECT_PRINCIPLES.md)
-- [AI_PHILOSOPHY.md](AI_PHILOSOPHY.md)
-- [MODEL_POLICY.md](MODEL_POLICY.md)
-- [KNOWLEDGE_GRAPH.md](KNOWLEDGE_GRAPH.md)
-- [RELEASE_NOTES.md](RELEASE_NOTES.md)
-- [docs/CHANGELOG.md](docs/CHANGELOG.md)
+- FastAPI local workspace app
+- Knowledge Graph storage and graph APIs
+- AI pipeline and workflow designer
+- Multi-agent handoff, review, retry, and replay records
+- Local model management and model recommendation catalog
+- VS Code / Cursor / VSCodium extension surface
+- Personal and organization workspace boundaries
 
-## Release History
+## Documentation
+
+- [ARCHITECTURE.md](ARCHITECTURE.md) — workspace, graph, pipeline, and model-management overview
+- [docs/architecture.md](docs/architecture.md) — full architecture reference
+- [PROJECT_PRINCIPLES.md](PROJECT_PRINCIPLES.md) — product principles
+- [AI_PHILOSOPHY.md](AI_PHILOSOPHY.md) — how AI is used in the workspace
+- [MODEL_POLICY.md](MODEL_POLICY.md) — local model recommendation policy
+- [KNOWLEDGE_GRAPH.md](KNOWLEDGE_GRAPH.md) — graph model and behavior
+- [docs/MULTI_AGENT_RUNTIME.md](docs/MULTI_AGENT_RUNTIME.md) — multi-agent workflow runtime
+- [docs/WORKFLOW_DESIGNER.md](docs/WORKFLOW_DESIGNER.md) — AI pipeline designer
+- [docs/REALTIME_COLLABORATION.md](docs/REALTIME_COLLABORATION.md) — realtime workspace events
+- [docs/ENTERPRISE.md](docs/ENTERPRISE.md) — organization workspaces and SSO
+- [docs/PLUGIN_SDK.md](docs/PLUGIN_SDK.md) — plugin SDK
+- [RELEASE_NOTES.md](RELEASE_NOTES.md) and [docs/CHANGELOG.md](docs/CHANGELOG.md)
+
+## Release history
 
 | Version | Theme |
 | --- | --- |
-| **2.2.0** | Multimodal-first Knowledge OS, source disclosure, Gemma-4 recommendation policy |
-| 2.1.0 | Agent Platform Maturity |
-| 2.0.0 | Agentic Workspace Platform |
+| **2.2.2** | Frontend QA stabilization — mobile nav, admin actions, overflow fixes, and expanded visual tests |
+| 2.2.1 | Frontend and UX overhaul for responsive workspace, themes, graph UX, admin reflow, and file attachment |
+| 2.2.0 | Multimodal-first Knowledge Graph and local model source disclosure |
+| 2.1.0 | Multi-agent workflow maturity |
+| 2.0.0 | AI pipeline, workflow, and plugin platform foundation |
 | 1.7.0 | Graph and collaboration |
 | 1.6.0 | Product experience deepening |
-| 1.5.0 | Unified product release |
+
+## License
+
+MIT

package/docs/CHANGELOG.md

@@ -1,5 +1,48 @@
 # Changelog
 
+## [2.2.1] - 2026-06-04
+
+> Frontend / UX Overhaul Release — Lattice AI keeps feature behavior stable
+> while improving responsive layout, theme handling, accessibility, graph UX,
+> admin tables, file attachment, and release packaging readiness.
+
+### Added
+
+- **Light/dark mode** — OS detection, manual theme toggle, and persisted theme
+  state.
+- **File attachment UX** — drag-and-drop and screenshot paste support for
+  attachments.
+- **Knowledge Graph controls** — zoom buttons, fullscreen, minimap,
+  relationship filter, mobile graph/card view, and theme-aware palette.
+
+### Changed
+
+- **Responsive UI** — phone/tablet/laptop/desktop/ultrawide/4K layouts now use
+  mobile-first reflow. Content is not hidden on smaller screens.
+- **Design tokens** — `static/css/tokens.css` is the single source of truth for
+  UI tokens, and theme styling no longer depends on `!important`.
+- **Accessibility** — 44px touch targets, `:focus-visible` focus rings,
+  keyboard-safe chat composer behavior, iOS no-zoom inputs, and reduced-motion
+  support.
+- **Admin UX** — wide admin tables reflow to mobile cards with larger touch
+  targets and light/dark support.
+- **Model cards** — country, company, run mode, and internet usage are shown in
+  plain language.
+- **Manual release scripts** — local publish scripts now build exact-version
+  artifacts before upload and validate the same artifact set used by CI.
+- **Marketplace positioning** — README, VS Code Marketplace/Open VSX README,
+  npm metadata, VSIX metadata, and release copy now use the local-first AI
+  workspace / AI pipeline / Knowledge Graph / multi-agent workflow positioning.
+- **Release media refresh** — v2.2.1 screenshots and demo GIF regenerated from
+  the live local app under `docs/images/`.
+
+### Validation
+
+- Unit/integration suites, Python build, npm pack, VSIX package, and
+  exact-version release artifact validation are the release targets.
+- Package-store publishing remains manual and must use the exact 2.2.1
+  filenames.
+
 ## [2.2.0] - 2026-06-04
 
 > Multimodal-First Knowledge OS Release — Lattice AI is aligned around the
@@ -20,7 +63,7 @@
 ### Changed
 
 - **README / architecture rewrite** — current docs now describe Lattice AI as an
-  AI Knowledge OS rather than a chat app or model launcher.
+  AI Knowledge Graph workspace rather than a chat app or model launcher.
 - **Multimodal recommendation logic** — local recommendation catalogs and setup
   flows use current multimodal model families only: Gemma 4, Qwen3-VL, and
   Llama 4.
@@ -84,7 +127,7 @@
 
 ### Changed
 
-- Python package, npm package, VS Code extension, Workspace OS, FastAPI app, and
+- Python package, npm package, VS Code extension, workspace, 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`.
@@ -101,13 +144,13 @@
 
 ## [2.0.0] - 2026-06-01
 
-> Agentic Workspace Platform — Lattice AI becomes a local-first **Agentic
+> Multi-Agent Workflow 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`,
+> commands remain stable. New workspace state keys (`plugin_registry`,
 > `workflow_runs`) are backfilled on load via deep-merge — no destructive
 > migration.
 
@@ -135,7 +178,7 @@
   `/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
+  activity feed over SSE. Wired as the workspace `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`.
@@ -153,7 +196,7 @@
 
 ### Changed
 
-- Python package, npm package, VS Code extension, Workspace OS, FastAPI app, and
+- Python package, npm package, VS Code extension, workspace, 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.
@@ -196,7 +239,7 @@
 
 ### Changed
 
-- Python package, npm package, VS Code extension, Workspace OS, FastAPI app, and
+- Python package, npm package, VS Code extension, workspace, FastAPI app, and
   `/health` version metadata aligned at `1.7.0`.
 - CI package validation is version-scoped instead of a broad `dist/*` check.
 
@@ -217,7 +260,7 @@
 
 ### Added
 
-- **Knowledge Graph Explorer (Workspace OS)** — an Entity Explorer (importance-
+- **Knowledge Graph Explorer (workspace)** — 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
@@ -233,7 +276,7 @@
 - **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
+- **Enterprise capability panel** — a 12-capability status matrix in the workspace
   (Community reports all disabled; nothing gates a Community feature).
 
 ### Changed
@@ -335,7 +378,7 @@
   lines. The file now owns FastAPI construction, lifespan, middleware, static
   mount, router wiring, and compatibility globals only.
 - **Chat/history/agent extracted** — `/chat`, `/history*`, `/agent*`, streaming
-  generator, document-generation session handling, Graph RAG trace recording,
+  generator, document-generation session handling, Knowledge Graph context trace recording,
   and AgentRuntime wiring moved to `latticeai/api/chat.py` with behavior and
   SSE chunk format preserved.
 - **Model runtime/provider extracted** — provider catalogs, engine aliases,
@@ -411,7 +454,7 @@
 
 - **server_app.py modularization (phase 2)** — reduced
   `latticeai/server_app.py` from ~6,585 to ~5,948 lines by extracting the
-  Workspace OS / Organization API and the health/engine-summary endpoints into
+  workspace / Organization API and the health/engine-summary endpoints into
   dedicated routers backed by a new service layer. `server_app` now focuses on
   app assembly, lifespan, middleware, and router include. The historical
   `server:app` import path, all API paths, and request/response shapes are
@@ -458,7 +501,7 @@
 
 ### Added
 
-- **Organization Workspace foundation** — Workspace OS now distinguishes
+- **Organization Workspace foundation** — workspace now distinguishes
   `personal` and `organization` workspace types. A full workspace model
   (`workspace_id`, `name`, `type`, `owner_user_id`, `members`, `roles`,
   `settings`, `created_at`, `updated_at`, `status`) is stored in the existing
@@ -486,9 +529,9 @@
   verifies that exactly the expected `whl`/`tar.gz`/`vsix`/`tgz` exist for a
   single version, that internal versions match, that the VSIX contains
   `extension/out/extension.js`, and warns when `dist/` mixes other versions.
-- **Workspace OS UI** — Personal/Organization workspace switcher, current
+- **workspace UI** — Personal/Organization workspace switcher, current
   workspace indicator, and a minimal organization create / member / role panel
-  wired into the existing Workspace OS command center.
+  wired into the existing workspace command center.
 
 ### Changed
 
@@ -497,7 +540,7 @@
   `actions/setup-node@v5`, `actions/setup-python@v6`. Artifact upload and
   `twine check` are now scoped to the tagged version only — never a `dist/*`
   glob — and the build runs the release artifact validator before upload.
-- Existing 1.0.x Workspace OS state is migrated non-destructively to the v1.1
+- Existing 1.0.x workspace state is migrated non-destructively to the v1.1
   workspace model on load; legacy records map to the Personal workspace.
 - Release metadata aligned to `1.1.0` across Python, npm, VS Code extension,
   FastAPI app metadata, and `/health`.
@@ -525,18 +568,18 @@
 
 ## [1.0.0] - 2026-05-31
 
-> AI Workspace OS integration release.
+> AI workspace integration release.
 
 ### Added
 
-- **Workspace OS foundation** — new `/workspace` UI and `/workspace/*` API surface
+- **workspace foundation** — new `/workspace` UI and `/workspace/*` API surface
   organize LatticeAI around Graph, Snapshot, Memory, Agent, Workflow, Skills,
   and Timeline areas while preserving existing chat, graph, admin, CLI, and MCP
   compatibility.
 - **First-run onboarding wizard** — reentrant step state, completion API,
   hardware scan, model recommendations, folder connection state, and recovery
   from failed/skipped steps.
-- **Graph RAG answer trace** — each generated answer records source files,
+- **Knowledge Graph context answer trace** — each generated answer records source files,
   graph nodes, graph edges, confidence, retrieval metadata, graph jumps, and
   source jumps.
 - **Local indexing dashboard** — indexed folder status, watcher state, success
@@ -556,7 +599,7 @@
 - **Local Computer Memory** — defaults OFF, requires explicit approval, tracks
   activity summaries only after consent, and links approved records to graph.
 - **Skill Marketplace registry** — install, uninstall, update, enable, disable,
-  version tracking, and metadata state surfaced in Workspace OS.
+  version tracking, and metadata state surfaced in the workspace.
 - **Workflow Graph** — stores workflow timelines and searchable workflow graphs
   for repeatable actions such as Upload -> Summarize -> Generate -> Export.
 - **VS Code workflow** — added Refactor Selection, Generate Tests, Send To
@@ -1104,7 +1147,7 @@ latticeai/
 `언급함` · `포함함` · `해결함` · `의존함` · `설명함` · `비교함` · `사용함` · `연결함` · `확장함` · `생성함` · `대체함` · `지원함` · `발생함` · `관련됨` · `작성함` · `업로드함`
 
 **핵심 개선**
-- `_extract_concepts()` — 고유명사·복합어·기술 용어 추출 (Lattice AI, Graph RAG, VS Code 등)
+- `_extract_concepts()` — 고유명사·복합어·기술 용어 추출 (Lattice AI, Knowledge Graph context, VS Code 등)
 - `_classify_node_type()` — 개념별 노드 타입 자동 분류 (윈도우 컨텍스트 기반)
 - `_infer_edge()` — 문장 내 동사·조사 패턴으로 엣지 레이블 자동 결정
 - `_extract_triples()` — 문장 단위 개념 쌍 → (주어, 동사, 목적어) 트리플 추출
@@ -1192,7 +1235,7 @@ latticeai/
 #### VS Code 익스텐션 메타데이터 개선
 - **카테고리** `Other` → `AI, Machine Learning, Chat, Other` (Marketplace 검색 노출 증가)
 - **키워드** 8개 → 16개 추가 (`copilot`, `apple-silicon`, `groq`, `graph-rag` 등)
-- **설명 문구** 구체화 — 핵심 차별점(MLX, MCP, Graph RAG, zero telemetry) 명시
+- **설명 문구** 구체화 — 핵심 차별점(MLX, MCP, Knowledge Graph context, local-first data handling) 명시
 - **익스텐션 README 전면 재작성** — 기능표 · 빠른 시작 · 단축키 · 지원 모델 · 설정 · 비교표 포함
 
 #### 리포지터리 정리
@@ -1252,7 +1295,7 @@ latticeai/
   - clear 동작을 `ClearEvent` 노드로 그래프에 기록 (언제 누가 clear 했는지 감사 추적)
 - **민감정보 검사** — 문서 업로드 텍스트를 감사 로그에 기록
 
-### Graph RAG / Data Graph
+### Knowledge Graph context / Data Graph
 
 - **한국어 단어 검색 개선** — 2글자 키워드(`문서`, `모델` 등) RAG 검색 누락 문제 수정
 - **`graph.html` 독립 페이지 유지** — 채팅 사이드바 `Data Graph` 버튼으로 연결, New Chat 버튼은 대화 검색 아래로 이동
@@ -1549,7 +1592,7 @@ latticeai/
 
 ### Added
 - **Data Graph** — 채팅·AI 답변·업로드 문서를 SQLite 지식 그래프로 자동 구조화, `/graph`에서 Canvas 기반 Force-directed 시각화
-- **Graph RAG** — 그래프 검색 결과를 채팅 컨텍스트에 자동 주입하여 이전 대화·문서 참조 능력 강화
+- **Knowledge Graph context** — 그래프 검색 결과를 채팅 컨텍스트에 자동 주입하여 이전 대화·문서 참조 능력 강화
 - **Telegram 원격 제어** — 인라인 키보드 메뉴로 상태 조회, 모델 관리, 스크린샷, 그래프 통계, 문서 업로드 등 원격 제어
 - `knowledge_graph.py` — KnowledgeGraphStore (node/edge/chunk/event), `ingest_message()`, `ingest_document()`, `context_for_query()`, `search()`, `neighbors()`
 - `static/graph.html` — 타입별 색상, 줌/패닝, 핀치 줌, 이웃 하이라이트, 노드 상세 정보, 채팅 연결 링크

package/docs/EDITION_STRATEGY.md

@@ -5,12 +5,12 @@ the boundary stays predictable for contributors and users.
 
 ## Editions
 
-- **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.
+- **Community** — this repository, MIT licensed. Local-first **AI workspace
+  platform**: local models, knowledge graph, Personal **and** Organization
+  workspaces, role-based membership, snapshots, durable context, AI pipelines,
+  multi-agent workflows, skills, the auditable timeline, and the full v2
+  platform — **Plugin SDK**, **Workflow Designer**, **Multi-Agent Runtime**, 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).
@@ -40,7 +40,7 @@ the boundary stays predictable for contributors and users.
 |--------|------------------------|------------------------|
 | Personal & Organization workspaces | ✅ | — |
 | Base roles (owner/admin/member/viewer) | ✅ | — |
-| Snapshots / memory / agents / workflows / skills | ✅ | — |
+| Snapshots / durable context / AI pipelines / multi-agent 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 |
@@ -55,7 +55,7 @@ the boundary stays predictable for contributors and users.
 ## Detecting edition at runtime
 
 - `GET /workspace/editions` → edition + per-capability matrix.
-- `GET /workspace/os` → `edition` block in the Workspace OS summary.
+- `GET /workspace/os` → `edition` block in the workspace 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