ltcai 2.2.1 → 2.2.2

package/README.md

@@ -3,122 +3,59 @@
 
   # Lattice AI
 
-  **A local-first AI workspace** — Plan → Execute → Review with multiple LLMs,
-  on top of a durable Knowledge Graph.
+  **Local-first AI workspace for knowledge graphs, AI pipelines, and multi-agent coding workflows.**
 
-  Apple Silicon (MLX) local model management · Personal & Organization workspaces ·
-  Multi-agent workflows · SSO for teams
+  Plan, execute, review, and remember work across local models, cloud models,
+  files, and team workflows.
 </div>
 
----
-
-Lattice AI turns your files, documents, images, screenshots, conversations,
-decisions, notes, and work history into linked knowledge. AI then works on top of
-that Knowledge Graph to advise, analyze, generate documents, and automate work.
-
-It is built around a simple product rule:
-
-> Do not control the user in the name of protection. Explain clearly, disclose
-> sources and risks, then let the user decide.
-
-## What Lattice AI is
-
-Lattice AI is four things working together, not an operating system and not a
-simple chat front-end:
-
-- **Local-first AI Workspace** — runs on your machine first; your data and graph
-  stay local by default.
-- **AI Pipeline Platform** — a Plan → Execute → Review loop that can route across
-  multiple LLMs for each stage.
-- **Knowledge Graph Platform** — multimodal inputs become entities,
-  relationships, evidence, and artifacts that outlive any single model.
-- **Workspace Platform** — Personal and Organization workspaces, role-based
-  access, and SSO for teams.
-
-## Highlights
-
-- **Multimodal ingestion** — accepts PDFs, Word, spreadsheets, slide decks,
-  images, screenshots, notes, code, web content, conversations, and work logs
-  without asking you to pre-convert them.
-- **Knowledge Graph core** — extracts entities, relationships, evidence,
-  decisions, and artifacts so your work memory survives model changes.
-- **Multi-agent workflow** — agents hand off work with structured context
-  packets, review/retry loops, and replayable timelines.
-- **Local model management** — MLX-VLM on Apple Silicon, with current-generation
-  multimodal model recommendations based on your CPU, GPU, RAM, storage, and OS.
-- **Source disclosure** — every recommended model shows its facts in plain
-  language before use: maker country, maker company, run mode (local/cloud),
-  internet requirement, and model name.
-- **Basic / Advanced / Admin modes** — the same features everywhere; the modes
-  differ only in how much is explained. Admin mode adds authority
-  (user management, permissions, audit logs, org/security policy, model approval).
-
-## v2.2.1 — Frontend & UX overhaul
-
-v2.2.1 is a UX-focused release. No features were removed; the interface was
-re-laid out and re-themed.
-
-- **Responsive, mobile-first UI** — phone, tablet, laptop, desktop, ultrawide,
-  and 4K. Content is re-laid out for each size, never hidden.
-- **Light / Dark themes via design tokens** — a single source of truth in
-  [`static/css/tokens.css`](static/css/tokens.css). `:root` holds light values,
-  `[data-lt-theme="dark"]` holds dark values. The theme toggle, OS preference
-  detection, and persistence live in
-  [`static/scripts/ux.js`](static/scripts/ux.js).
-- **Accessibility** — 44px touch targets, `:focus-visible` rings, a
-  keyboard-safe chat composer (uses `visualViewport` insets), iOS no-zoom inputs,
-  and reduced-motion support.
-- **Knowledge Graph UX** — responsive canvas that re-fits on resize, zoom
-  buttons, fullscreen, minimap, relationship filtering, a mobile graph↔card
-  view, and a theme-aware palette.
-- **Admin UX** — wide tables reflow to cards on mobile, with larger touch targets
-  and full dark/light support.
-- **File UX** — drag & drop and screenshot paste to attach. Model cards explain
-  country, company, run mode, and internet use in plain language.
-
-## Knowledge Graph flow
+<div align="center">
 
-```text
-files / documents / images / conversations / work history
-  -> multimodal understanding
-  -> entity extraction
-  -> relationship extraction
-  -> evidence storage
-  -> Knowledge Graph update
-  -> advice / analysis / document generation / automation
-```
+[![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)
 
-The graph preserves your work memory even when the model changes.
+</div>
 
-## Local model policy
+![Lattice AI demo](docs/images/lattice-ai-demo.gif)
 
-Lattice AI recommends current-generation **multimodal** models for local use and
-keeps text-only recommendation paths out of the product:
+## Install
 
-| 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, balanced multimodal options | `mlx-community/Qwen3-VL-4B-Instruct-4bit` |
-| Llama 4 | Meta multimodal option | `mlx-community/Llama-4-Scout-17B-16E-Instruct-4bit` |
+Install the local workspace:
 
-Low-spec machines use smaller or quantized multimodal models rather than older
-text-only models. See [MODEL_POLICY.md](MODEL_POLICY.md) for the full policy.
+```bash
+pip install ltcai
+```
 
-## Requirements
+Add Apple Silicon local model support:
 
-- Python **3.11+**
-- macOS, Windows, or Linux for the workspace server
-- Apple Silicon for local MLX-VLM model execution (optional; cloud models work
-  without it)
+```bash
+pip install "ltcai[local]"
+```
 
-## Quick start
+Install the npm CLI:
 
-Lattice AI is a Python + FastAPI app. The CLI entry point is `ltcai_cli.py`.
+```bash
+npm install -g ltcai
+```
+
+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        # installs the npm package and dev tooling
-npm run dev        # runs: python3 ltcai_cli.py --reload
+LTCAI
 ```
 
 Then open:
@@ -127,76 +64,174 @@ Then open:
 http://127.0.0.1:4825
 ```
 
-Prefer Python directly?
+Development checkout:
 
 ```bash
-python3 ltcai_cli.py
-# host/port: --host 127.0.0.1 --port 4825
+npm install
+npm run dev
 ```
 
-For local model execution on Apple Silicon, install the optional extra:
+Useful validation commands:
 
 ```bash
-pip install "ltcai[local]"   # adds mlx-vlm
+npm run check:python
+npm run test:unit
+npm run build
 ```
 
-Useful commands:
+## What Is Lattice AI?
 
-```bash
-npm test                # python3 -m pytest tests/ -v
-npm run check:python    # py_compile across core modules
-npm run build           # 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.
 
-## VS Code extension
+- **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.
 
-A companion VS Code extension lives in [`vscode-extension/`](vscode-extension).
+## Why Lattice AI?
 
-```bash
-cd vscode-extension
-npm install
-npm run build
-npm run package:vsix
+Most AI tools split your work across a chat window, a model picker, loose files,
+and disconnected automations. Lattice AI keeps those parts together:
+
+- 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.
+
+## v2.2.2 QA & Stability Highlights
+
+A no-features stabilization release that hardens the v2.2.x UI. Every fix keeps
+the existing design-token structure and adds no `!important`.
+
+- 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.
+
+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.
+
+## Screenshots
+
+### Workspace
+
+![Workspace light theme](docs/images/workspace-light.png)
+
+![Workspace dark theme](docs/images/workspace-dark.png)
+
+### Knowledge Graph
+
+![Knowledge Graph](docs/images/knowledge-graph.png)
+
+### AI Pipeline
+
+![AI Pipeline designer](docs/images/pipeline.png)
+
+### Admin Dashboard
+
+![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
 ```
 
-## Build & packaging
+The graph keeps useful workspace context available even when you change models.
 
-Lattice AI ships as a Python package (`ltcai`), an npm package (`ltcai`), and a
-VS Code extension.
+## Local Model Policy
 
-```bash
-python3 -m build        # Python wheel + sdist
-npm pack                # npm tarball
+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
 ```
 
-Publishing is intentionally manual — no glob uploads. See [RELEASE.md](RELEASE.md)
-for the exact, version-scoped publish steps for PyPI, npm, the VS Code
-Marketplace, and Open VSX.
+Core areas:
+
+- 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
 
 ## Documentation
 
-- [ARCHITECTURE.md](ARCHITECTURE.md) — system shape and runtime policy
+- [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 here
+- [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 runtime
-- [docs/WORKFLOW_DESIGNER.md](docs/WORKFLOW_DESIGNER.md) — workflow designer
-- [docs/REALTIME_COLLABORATION.md](docs/REALTIME_COLLABORATION.md) — realtime collaboration
-- [docs/ENTERPRISE.md](docs/ENTERPRISE.md) — Organization workspaces & SSO (Okta / Microsoft Entra ID)
-- [docs/security-model.md](docs/security-model.md) — security model
+- [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) · [docs/CHANGELOG.md](docs/CHANGELOG.md)
+- [RELEASE_NOTES.md](RELEASE_NOTES.md) and [docs/CHANGELOG.md](docs/CHANGELOG.md)
 
 ## Release history
 
 | Version | Theme |
 | --- | --- |
-| **2.2.1** | Frontend & UX overhaul — responsive, design-token theming, accessibility, graph/admin UX |
-| 2.2.0 | Multimodal-first Knowledge Graph, 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 |
 

package/docs/CHANGELOG.md

@@ -30,6 +30,11 @@
   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
 
@@ -58,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.
@@ -122,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`.
@@ -139,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.
 
@@ -173,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`.
@@ -191,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.
@@ -234,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.
 
@@ -255,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
@@ -271,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
@@ -373,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,
@@ -449,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
@@ -496,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
@@ -524,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
 
@@ -535,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`.
@@ -563,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
@@ -594,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
@@ -1142,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()` — 문장 단위 개념 쌍 → (주어, 동사, 목적어) 트리플 추출
@@ -1230,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 전면 재작성** — 기능표 · 빠른 시작 · 단축키 · 지원 모델 · 설정 · 비교표 포함
 
 #### 리포지터리 정리
@@ -1290,7 +1295,7 @@ latticeai/
   - clear 동작을 `ClearEvent` 노드로 그래프에 기록 (언제 누가 clear 했는지 감사 추적)
 - **민감정보 검사** — 문서 업로드 텍스트를 감사 로그에 기록
 
-### Graph RAG / Data Graph
+### Knowledge Graph context / Data Graph
 
 - **한국어 단어 검색 개선** — 2글자 키워드(`문서`, `모델` 등) RAG 검색 누락 문제 수정
 - **`graph.html` 독립 페이지 유지** — 채팅 사이드바 `Data Graph` 버튼으로 연결, New Chat 버튼은 대화 검색 아래로 이동
@@ -1587,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

package/docs/ENTERPRISE.md

@@ -8,10 +8,10 @@
 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, the auditable timeline, and the full v2.0
-  Agentic Workspace Platform (Plugin SDK, Workflow Designer, Multi-Agent Runtime
-  2.0, Realtime Collaboration).
+  models, knowledge graph, Personal and Organization workspaces, roles,
+  snapshots, durable context, AI pipelines, multi-agent workflows, skills, the
+  auditable timeline, and the full v2 workspace platform (Plugin SDK, Workflow
+  Designer, Multi-Agent Runtime, 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.
@@ -36,7 +36,7 @@ Community code consults the seam at extension points via
 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`,
-surfaced in the Workspace OS summary (`GET /workspace/os` → `edition`), and
+surfaced in the workspace 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`

package/docs/PLUGIN_SDK.md

@@ -14,7 +14,7 @@ through the existing skill registry rather than owning a parallel one.
 
 > **Compatibility.** v1.x data and APIs are preserved. The Plugin SDK adds new
 > code (`latticeai/core/plugins.py`, `latticeai/api/plugins.py`) and new
-> persisted state (`plugin_registry` inside the Workspace OS store). Nothing in
+> persisted state (`plugin_registry` inside the workspace store). Nothing in
 > the v1.x contract changes. The new HTTP routes live under `/plugins/registry`
 > and friends, which do **not** collide with the pre-existing
 > `/plugins/directory` marketplace routes.
@@ -28,7 +28,7 @@ PLUGIN_SDK_VERSION = "2.2.0"
 ## v2.2 additions
 
 - `execute_action(...)` emits `plugin_started`, `plugin_completed`, and
-  `execution_failed` through the existing Workspace OS timeline/realtime feed.
+  `execution_failed` through the existing workspace timeline/realtime feed.
 - Plugin outputs can be carried inside agent context packets and replayed from
   agent/workflow run history.
 - The local template catalog (`latticeai.core.marketplace`) adds Plugin,
@@ -228,7 +228,7 @@ discover  ->  validate  ->  install  ->  enable / disable  ->  uninstall
 ```
 
 Lifecycle *state* (installed / enabled / version / status) is delegated to the
-Workspace OS store via a small `store` port, so plugins reuse the same
+workspace store via a small `store` port, so plugins reuse the same
 local-first JSON persistence, workspace scoping, and timeline events as skills.
 The registry itself owns only manifest parsing and the execution boundary.
 
@@ -355,7 +355,7 @@ A persisted entry looks like:
 }
 ```
 
-Each lifecycle mutation also records a Workspace OS timeline event
+Each lifecycle mutation also records a workspace timeline event
 (`plugin_installed`, `plugin_uninstalled`, `plugin_enabled`, `plugin_disabled`)
 under the `plugins` channel.
 

package/docs/V2_ARCHITECTURE.md

@@ -1,11 +1,11 @@
-# Lattice AI v2 Architecture — Agentic Workspace Platform
+# Lattice AI v2 Architecture — AI Workspace, Pipeline, and Workflow Platform
 
-Lattice AI v2.0.0 turned the local-first Workspace OS into a full **Agentic
-Workspace Platform**. v2.2.0 keeps that architecture and matures the operational
-layer: explicit handoffs, context packets, review/retry loops, memory snapshots,
-planning records, replay, marketplace templates, and realtime execution
-observability all compose over the same local-first JSON store and Knowledge
-Graph.
+Lattice AI v2.0.0 introduced the local-first AI workspace, AI pipeline,
+Knowledge Graph, and multi-agent workflow foundation. v2.2.1 keeps that
+architecture and matures the operational layer: explicit handoffs, context
+packets, review/retry loops, durable context snapshots, planning records,
+replay, marketplace templates, and realtime workflow observability all compose
+over the same local-first JSON store and Knowledge Graph.
 
 This document describes how the v2 platform pillars fit together, the small set of
 **additive integration seams** that wire them, the cross-integration matrix that
@@ -47,7 +47,7 @@ templates / actions under one versioned, permissioned unit.
 
 Design rules enforced by the module: no import-time I/O (the filesystem is only
 touched on `discover()`), no FastAPI and no globals (lifecycle state lives in the
-Workspace OS store), and permissions are an allow-list — the execution boundary
+workspace store), and permissions are an allow-list — the execution boundary
 refuses any capability a plugin did not declare *and* was not granted.
 
 A validated `plugin.json` manifest:
@@ -213,7 +213,7 @@ class RealtimeBus:
 v2.2.0 adds a local marketplace foundation rather than a cloud marketplace
 service. `TemplateCatalog` manages Plugin, Workflow, and Agent templates with
 metadata, export/import, install hooks, and a template registry stored through
-Workspace OS. Marketplace templates are local extension points for the existing
+workspace. Marketplace templates are local extension points for the existing
 Plugin SDK, Workflow Engine, and Multi-Agent Runtime; they do not bypass plugin
 permissions, workflow execution guards, or workspace scoping.
 

package/docs/architecture.md

@@ -1,9 +1,10 @@
 # Lattice AI Architecture
 
-Lattice AI is a local-first **AI Workspace and Knowledge Graph platform**. The
-architecture is organized around one durable center: the Knowledge Graph.
-Models, tools, agents, workflows, and UI modes are replaceable layers that
-operate on top of the graph.
+Lattice AI is a local-first **AI workspace, AI pipeline platform, Knowledge
+Graph platform, and multi-agent workflow platform**. The architecture is
+organized around one durable center: the Knowledge Graph. Models, tools,
+agents, workflows, and UI modes are replaceable layers that operate on top of
+workspace and graph context.
 
 ## Architecture Goals
 
@@ -15,7 +16,7 @@ operate on top of the graph.
 - Keep basic and advanced modes feature-equivalent.
 - Keep admin-only capabilities explicit and auditable.
 
-## System View
+## Workspace View
 
 ```mermaid
 flowchart TD
@@ -24,9 +25,9 @@ flowchart TD
     Extract["Entity, relation, evidence extraction"]
     Graph["Knowledge Graph"]
     Context["Graph context builder"]
-    Models["Multimodal model runtime"]
-    Agents["Agent runtime and workflows"]
-    Outputs["Advice, analysis, documents, automation"]
+    Models["Local or cloud model workflow"]
+    Agents["Multi-agent workflow"]
+    Outputs["Coding actions, analysis, documents, team workflows"]
     Admin["Admin policy and audit"]
 
     User --> Ingestion
@@ -42,7 +43,7 @@ flowchart TD
 
 ## Durable Core
 
-The Knowledge Graph stores the durable user and organization memory:
+The Knowledge Graph stores durable personal and organization workspace context:
 
 - files and document evidence
 - images and screenshots
@@ -52,8 +53,8 @@ The Knowledge Graph stores the durable user and organization memory:
 - generated artifacts
 - agent and workflow events
 
-The LLM is not the product core. It is an execution worker that can be replaced
-when hardware, policy, or user preference changes.
+The model is not the product core. It is a replaceable participant in the
+workspace pipeline.
 
 ## Multimodal Ingestion
 
@@ -75,9 +76,9 @@ input set includes:
 The architecture must not ask users to convert these to plain text before AI can
 work on them.
 
-## Model Runtime Policy
+## Local Model Management Policy
 
-Local recommended models must be multimodal. The v2.2 local runtime policy is:
+Local recommended models must be multimodal. The v2.2 local model workflow policy is:
 
 - macOS Apple Silicon: MLX-VLM first
 - Windows: llama.cpp multimodal path, with LM Studio as a user-friendly option
@@ -130,11 +131,11 @@ Basic mode and advanced mode have the same feature access.
 | --- | --- |
 | `latticeai/services/model_catalog.py` | Multimodal model catalog, source metadata, aliases |
 | `latticeai/services/model_recommendation.py` | Hardware-aware multimodal recommendation |
-| `latticeai/services/model_runtime.py` | Download, load, server, and runtime orchestration |
+| `latticeai/services/model_runtime.py` | Download, load, server, and model workflow orchestration |
 | `llm_router.py` | MLX-VLM and OpenAI-compatible model routing |
-| `knowledge_graph.py` | Graph storage, extraction, local folder graph RAG |
+| `knowledge_graph.py` | Graph storage, extraction, local folder knowledge graph context |
 | `latticeai/core/context_builder.py` | Graph context for generation |
-| `latticeai/core/workspace_os.py` | Workspace state, timeline, snapshots, memory |
+| `latticeai/core/workspace_os.py` | Workspace state, timeline, snapshots, durable context |
 | `latticeai/core/multi_agent.py` | Planner/executor/reviewer/researcher orchestration |
 | `latticeai/core/workflow_engine.py` | Workflow definitions and run history |
 | `latticeai/core/plugins.py` | Plugin manifest, registry, permission boundary |
@@ -142,7 +143,7 @@ Basic mode and advanced mode have the same feature access.
 
 ## Compatibility
 
-v2.2.0 preserves the additive Workspace OS and API compatibility posture from
+v2.2.1 preserves the additive workspace and API compatibility posture from
 v2.x. Existing graph/workspace data is migrated non-destructively. The release
 does remove current recommendation entries for old or text-only model paths, but
 it does not destructively mutate existing user graph data.

package/latticeai/__init__.py

@@ -1,3 +1,3 @@
 """Lattice AI - modular server package."""
 
-__version__ = "2.2.1"
+__version__ = "2.2.2"

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 = "2.2.1"
+WORKSPACE_OS_VERSION = "2.2.2"
 
 # Workspace types separate single-user Personal workspaces from shared
 # Organization workspaces. Both keep the same local-first JSON store; the type

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ltcai",
-  "version": "2.2.1",
-  "description": "Lattice AI Workspace OS for local-first graph, memory, agent, workflow, and skill operations",
+  "version": "2.2.2",
+  "description": "Local-first AI workspace for knowledge graphs, AI pipelines, and multi-agent coding workflows.",
   "homepage": "https://github.com/TaeSooPark-PTS/LatticeAI#readme",
   "repository": {
     "type": "git",
@@ -39,11 +39,14 @@
   },
   "keywords": [
     "ltcai",
-    "ai-assistant",
+    "ai-workspace",
+    "ai-pipeline",
+    "knowledge-graph",
     "llm",
     "mlx",
     "local-ai",
-    "agent",
+    "multi-agent",
+    "workflow",
     "mcp",
     "rag",
     "vscode"

package/static/account.html

@@ -4,7 +4,7 @@
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover, interactive-widget=resizes-content">
     <title>Lattice AI</title>
-    <script src="/static/scripts/ux.js?v=2.2.1"></script>
+    <script src="/static/scripts/ux.js?v=2.2.2"></script>
     <link rel="manifest" href="/manifest.json">
     <meta name="theme-color" content="#f3ecff">
     <meta name="apple-mobile-web-app-capable" content="yes">
@@ -15,7 +15,7 @@
     <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700;800&display=swap">
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@tabler/icons-webfont@latest/tabler-icons.min.css">
     <link rel="stylesheet" href="/static/lattice-reference.css?v=0.3.3">
-    <link rel="stylesheet" href="/static/css/responsive.css?v=2.2.1">
+    <link rel="stylesheet" href="/static/css/responsive.css?v=2.2.2">
 </head>
 <body class="lattice-ref-auth">
     <div class="orb orb-1"></div>

package/static/activity.html

@@ -4,10 +4,10 @@
   <meta charset="UTF-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover, interactive-widget=resizes-content" />
   <title>Realtime Activity — Lattice AI</title>
-  <script src="/static/scripts/ux.js?v=2.2.1"></script>
-  <link rel="stylesheet" href="/static/css/tokens.css?v=2.2.1" />
-  <link rel="stylesheet" href="/static/platform.css?v=2.2.1" />
-  <link rel="stylesheet" href="/static/css/responsive.css?v=2.2.1" />
+  <script src="/static/scripts/ux.js?v=2.2.2"></script>
+  <link rel="stylesheet" href="/static/css/tokens.css?v=2.2.2" />
+  <link rel="stylesheet" href="/static/platform.css?v=2.2.2" />
+  <link rel="stylesheet" href="/static/css/responsive.css?v=2.2.2" />
 </head>
 <body>
   <main>

package/static/admin.html

@@ -5,7 +5,7 @@
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover, interactive-widget=resizes-content">
     <title>Lattice AI Admin</title>
-    <script src="/static/scripts/ux.js?v=2.2.1"></script>
+    <script src="/static/scripts/ux.js?v=2.2.2"></script>
     <link rel="manifest" href="/manifest.json">
     <meta name="theme-color" content="#f3ecff">
     <meta name="apple-mobile-web-app-capable" content="yes">
@@ -16,7 +16,7 @@
     <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700;800&display=swap">
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@tabler/icons-webfont@latest/tabler-icons.min.css">
     <link rel="stylesheet" href="/static/lattice-reference.css?v=0.3.3">
-    <link rel="stylesheet" href="/static/css/responsive.css?v=2.2.1">
+    <link rel="stylesheet" href="/static/css/responsive.css?v=2.2.2">
     <script src="https://cdn.jsdelivr.net/npm/chart.js@4.4.0/dist/chart.umd.min.js"></script>
 </head>
 

package/static/agents.html

@@ -4,10 +4,10 @@
   <meta charset="UTF-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover, interactive-widget=resizes-content" />
   <title>Multi-Agent Runtime — Lattice AI</title>
-  <script src="/static/scripts/ux.js?v=2.2.1"></script>
-  <link rel="stylesheet" href="/static/css/tokens.css?v=2.2.1" />
-  <link rel="stylesheet" href="/static/platform.css?v=2.2.1" />
-  <link rel="stylesheet" href="/static/css/responsive.css?v=2.2.1" />
+  <script src="/static/scripts/ux.js?v=2.2.2"></script>
+  <link rel="stylesheet" href="/static/css/tokens.css?v=2.2.2" />
+  <link rel="stylesheet" href="/static/platform.css?v=2.2.2" />
+  <link rel="stylesheet" href="/static/css/responsive.css?v=2.2.2" />
 </head>
 <body>
   <main>

package/static/chat.html

@@ -5,7 +5,7 @@
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover, interactive-widget=resizes-content">
     <title>Lattice AI — All-in-One Multimodal Workspace</title>
-    <script src="/static/scripts/ux.js?v=2.2.1"></script>
+    <script src="/static/scripts/ux.js?v=2.2.2"></script>
 
     <!-- PWA -->
     <link rel="manifest" href="/manifest.json">
@@ -25,7 +25,7 @@
 
     <!-- ── Setup Wizard Styles ──────────────────────────────────────────── -->
     <link rel="stylesheet" href="/static/lattice-reference.css?v=0.3.3">
-    <link rel="stylesheet" href="/static/css/responsive.css?v=2.2.1">
+    <link rel="stylesheet" href="/static/css/responsive.css?v=2.2.2">
 </head>
 
 <body class="lattice-ref-chat">

package/static/css/responsive.css

@@ -1,5 +1,5 @@
 /* ============================================================================
- * Lattice AI — Responsive / Accessibility / Theme Foundation  (v2.2.1)
+ * Lattice AI — Responsive / Accessibility / Theme Foundation  (v2.2.2)
  *
  * 이 파일은 모든 페이지에서 가장 마지막에 로드된다 (lattice-reference.css /
  * workspace.css / platform.css 다음). 따라서 기존 규칙을 "덮어쓰는" 레이어로
@@ -63,6 +63,12 @@ code,
 .admin-main,
 .stage { min-width: 0; }
 
+/* 모바일 햄버거 토글은 기본 숨김 — 모바일/태블릿 미디어쿼리(섹션 7·8)에서 노출.
+ * 이 기본값은 노출 규칙보다 *먼저* 선언돼야 소스 순서상 노출이 이긴다.
+ * (graph-view-toggle 은 섹션 8 에서 동일 패턴으로 처리) */
+.graph-nav-toggle,
+.admin-rail-toggle { display: none; }
+
 /* ============================================================================
  * 1. 앱 셸 — dvh 기반, 100vw 스크롤바 버그 제거
  * ========================================================================== */
@@ -349,6 +355,19 @@ body.lattice-ref-admin {
   min-width: 0;
 }
 
+/* `.toolbar` 의 position:absolute / z-index:20 은 graph 캔버스 전용인데
+ * 선택자가 과넓어(`.toolbar`) admin·chat 의 폼 액션 행(.toolbar)까지 새어
+ * 페이지 우상단으로 떠올라 헤더 버튼(새로고침/로그아웃)을 덮었다.
+ * graph 가 아닌 페이지에서는 정상 흐름(static)으로 되돌린다. !important 불필요
+ * — `body.lattice-ref-*  .toolbar` 가 `.toolbar` 보다 명시도가 높다. */
+body.lattice-ref-admin .toolbar,
+body.lattice-ref-chat .toolbar {
+  position: static;
+  z-index: auto;
+  -webkit-backdrop-filter: none;
+  backdrop-filter: none;
+}
+
 @media (max-width: 1024px) {
   .lattice-ref-admin { grid-template-columns: 1fr; }
   .lattice-ref-admin .content { width: 100%; max-width: 100%; }
@@ -472,9 +491,7 @@ body.lattice-ref-admin {
   }
 }
 
-/* 새 햄버거 토글은 데스크톱에서 숨김 (모바일/태블릿 미디어쿼리에서 노출) */
-.graph-nav-toggle,
-.admin-rail-toggle { display: none; }
+/* (햄버거 토글 기본 숨김은 섹션 0 으로 이동 — 노출 규칙보다 먼저 선언) */
 
 /* 그래프/카드 뷰 토글 (graph.js 가 .graph-card-view 클래스 토글) */
 .graph-view-toggle { display: none; }

package/static/css/tokens.css

@@ -1,5 +1,5 @@
 /* ============================================================================
- * Lattice AI — Design Tokens (Single Source of Truth)  v2.2.1
+ * Lattice AI — Design Tokens (Single Source of Truth)  v2.2.2
  *
  * 이 파일이 색·면·테두리·그림자·포커스의 단일 출처다.
  *   :root                      → 라이트 테마 값

package/static/graph.html

@@ -4,13 +4,13 @@
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover, interactive-widget=resizes-content">
   <title>Lattice AI - 지식 그래프</title>
-  <script src="/static/scripts/ux.js?v=2.2.1"></script>
+  <script src="/static/scripts/ux.js?v=2.2.2"></script>
       <link rel="preconnect" href="https://fonts.googleapis.com">
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
     <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700;800&display=swap">
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@tabler/icons-webfont@latest/tabler-icons.min.css">
   <link rel="stylesheet" href="/static/lattice-reference.css?v=0.3.3">
-  <link rel="stylesheet" href="/static/css/responsive.css?v=2.2.1">
+  <link rel="stylesheet" href="/static/css/responsive.css?v=2.2.2">
 </head>
 <body class="lattice-ref-graph">
   <div class="sidebar-overlay" onclick="closeGraphNav&&closeGraphNav()"></div>

package/static/plugins.html

@@ -4,10 +4,10 @@
   <meta charset="UTF-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover, interactive-widget=resizes-content" />
   <title>Plugin SDK — Lattice AI</title>
-  <script src="/static/scripts/ux.js?v=2.2.1"></script>
-  <link rel="stylesheet" href="/static/css/tokens.css?v=2.2.1" />
-  <link rel="stylesheet" href="/static/platform.css?v=2.2.1" />
-  <link rel="stylesheet" href="/static/css/responsive.css?v=2.2.1" />
+  <script src="/static/scripts/ux.js?v=2.2.2"></script>
+  <link rel="stylesheet" href="/static/css/tokens.css?v=2.2.2" />
+  <link rel="stylesheet" href="/static/platform.css?v=2.2.2" />
+  <link rel="stylesheet" href="/static/css/responsive.css?v=2.2.2" />
 </head>
 <body>
   <main>

package/static/scripts/ux.js

@@ -1,5 +1,5 @@
 /* ============================================================================
- * Lattice AI — Shared UX runtime (v2.2.1)
+ * Lattice AI — Shared UX runtime (v2.2.2)
  *
  * 모든 페이지에서 로드된다. 페이지마다 일부 요소가 없을 수 있으므로 전부
  * 방어적으로(존재 확인 후) 동작한다. 기존 chat.js / graph.js / admin.js 의

package/static/workflows.html

@@ -4,10 +4,10 @@
   <meta charset="UTF-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover, interactive-widget=resizes-content" />
   <title>Workflow Designer — Lattice AI</title>
-  <script src="/static/scripts/ux.js?v=2.2.1"></script>
-  <link rel="stylesheet" href="/static/css/tokens.css?v=2.2.1" />
-  <link rel="stylesheet" href="/static/platform.css?v=2.2.1" />
-  <link rel="stylesheet" href="/static/css/responsive.css?v=2.2.1" />
+  <script src="/static/scripts/ux.js?v=2.2.2"></script>
+  <link rel="stylesheet" href="/static/css/tokens.css?v=2.2.2" />
+  <link rel="stylesheet" href="/static/platform.css?v=2.2.2" />
+  <link rel="stylesheet" href="/static/css/responsive.css?v=2.2.2" />
 </head>
 <body>
   <main>

package/static/workspace.css

@@ -445,6 +445,11 @@ textarea {
   position: absolute;
   opacity: 0;
   pointer-events: none;
+  /* 절대배치 + width:auto 인 체크박스는 컨테이닝 블록(뷰포트) 폭만큼 늘어나
+   * 가로 오버플로우를 만든다. 1px 박스로 가둬 레이아웃에 영향 없게 한다. */
+  width: 1px;
+  height: 1px;
+  margin: 0;
 }
 
 .toggle-row span {

package/static/workspace.html

@@ -4,14 +4,14 @@
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover, interactive-widget=resizes-content">
   <title>Lattice AI Workspace OS</title>
-  <script src="/static/scripts/ux.js?v=2.2.1"></script>
+  <script src="/static/scripts/ux.js?v=2.2.2"></script>
   <link rel="manifest" href="/manifest.json">
   <link rel="icon" type="image/png" sizes="32x32" href="/icons/favicon-32.png">
   <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&display=swap">
   <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@tabler/icons-webfont@latest/tabler-icons.min.css">
-  <link rel="stylesheet" href="/static/css/tokens.css?v=2.2.1">
-  <link rel="stylesheet" href="/static/workspace.css?v=2.2.1">
-  <link rel="stylesheet" href="/static/css/responsive.css?v=2.2.1">
+  <link rel="stylesheet" href="/static/css/tokens.css?v=2.2.2">
+  <link rel="stylesheet" href="/static/workspace.css?v=2.2.2">
+  <link rel="stylesheet" href="/static/css/responsive.css?v=2.2.2">
 </head>
 <body>
   <div class="workspace-shell">