ltcai 0.6.0 → 1.0.0

package/README.md

@@ -1,7 +1,7 @@
 <div align="center">
   <img src="https://raw.githubusercontent.com/TaeSooPark-PTS/LatticeAI/main/docs/images/logo.svg" alt="Lattice AI" width="280"/>
   <br/>
-  <strong>Local-first AI workspace for your files, chats, folders, and knowledge graph.</strong>
+  <strong>AI Workspace OS for local-first graph, memory, agents, workflows, skills, and timelines.</strong>
   <br/><br/>
 
 [![PyPI](https://img.shields.io/pypi/v/ltcai?label=PyPI&color=blue)](https://pypi.org/project/ltcai/)
@@ -24,18 +24,33 @@
 
 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 memory layer.**
+**Lattice AI turns your local workspace into an AI Workspace OS.**
 
-It reads approved local folders, indexes chats and documents, builds a searchable knowledge graph, and lets you ask questions over that graph with local or opt-in cloud models.
+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.
 
 ```text
 Local files + chats + folders
           ↓
 Automatic knowledge graph
           ↓
-Graph-aware AI chat, search, document generation, and admin audit
+Graph-aware chat, snapshots, memory, agents, workflows, skills, and timeline
 ```
 
+### New in 1.0.0: AI Workspace OS
+
+- Workspace OS command center at `/workspace`
+- First-run onboarding state API and UI
+- Graph RAG answer traces with sources, nodes, edges, confidence, and jump links
+- Local indexing dashboard with watcher state, success/failure counts, pause/resume/remove
+- Workspace snapshots, Time Machine views, export, and Knowledge Diff
+- Personal memory CRUD/search linked back to the graph
+- Multi-agent graph entities and agent run history
+- Relationship Explorer for inbound, outbound, related entities, and shortest path
+- Local Computer Memory remains OFF by default and requires explicit approval
+- Skill Marketplace registry with install, uninstall, update, enable, disable, and version state
+- Workflow Graph for upload -> summarize -> generate -> export style work histories
+- VS Code commands for Explain Selection, Refactor Selection, Generate Tests, Send To Lattice, and Ask About Current File
+
 ### Built for people who want
 
 - a private AI workspace that runs from their own machine
@@ -76,7 +91,7 @@ LTCAI
 2. Start the local server with `LTCAI`
 3. Press `Cmd+Shift+A` to open the chat panel
 
-**First run:** create an account → the first account becomes admin → choose a model → connect folders → start asking questions.
+**First run:** create an account -> the first account becomes admin -> open `/workspace` -> complete onboarding -> choose a model -> connect folders -> start asking questions.
 
 ---
 

package/docs/CHANGELOG.md

@@ -1,5 +1,56 @@
 # Changelog
 
+## [1.0.0] - 2026-05-31
+
+> AI Workspace OS integration release.
+
+### Added
+
+- **Workspace OS 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,
+  graph nodes, graph edges, confidence, retrieval metadata, graph jumps, and
+  source jumps.
+- **Local indexing dashboard** — indexed folder status, watcher state, success
+  and failure counts, last scan time, graph node/edge totals, and pause/resume/
+  remove operations.
+- **Workspace snapshots and Time Machine** — immutable snapshots capture graph,
+  chat, settings, indexed folders, and loaded model state. Snapshots can be
+  listed, viewed by area, compared, and exported as ZIP artifacts.
+- **Knowledge Diff** — Snapshot A/B comparison reports nodes added/removed/
+  changed, edges added/removed, and decisions changed.
+- **Personal Memory layer** — per-user preferences, decisions, working style,
+  frequently used tools, and long-term memory with CRUD/search and graph links.
+- **Multi-Agent Graph** — Planner, Executor, Reviewer, Researcher, and Release
+  Agent entities plus agent run history and timeline recording.
+- **Relationship Explorer** — inbound/outbound edge views, related entities, and
+  shortest-path exploration for graph nodes.
+- **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.
+- **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
+  Lattice, and Ask About Current File while preserving Explain Selection.
+
+### Changed
+
+- Release metadata aligned to `1.0.0` across Python, npm, VS Code extension,
+  FastAPI app metadata, `/health`, README, changelog, and release docs.
+- `KnowledgeGraphStore` gained non-destructive `remove_local_source()` for
+  deleting only derived index/graph data while leaving user files untouched.
+
+### Validation
+
+- Unit, integration, Python build, npm build, VSIX packaging, and package
+  verification were run for this release.
+
 ## [0.6.0] - 2026-05-31
 
 > Runtime / registry / config extraction release.

package/knowledge_graph.py

@@ -1609,6 +1609,39 @@ class KnowledgeGraphStore:
             )
         return {"source_id": source_id, "watch_enabled": bool(enabled)}
 
+    def remove_local_source(self, source_id: str) -> Dict[str, Any]:
+        """Remove one approved local source and its derived graph projection.
+
+        This is intentionally non-destructive for user files: only the LatticeAI
+        index rows, graph nodes, edges, and chunks derived from the source are
+        removed. The original folder and files are never touched.
+        """
+        source_id = str(source_id or "").strip()
+        if not source_id:
+            raise ValueError("source_id required")
+        with self._connect() as conn:
+            source = conn.execute(
+                "SELECT id, root_path FROM knowledge_sources WHERE id=?",
+                (source_id,),
+            ).fetchone()
+            if not source:
+                raise ValueError(f"knowledge source not found: {source_id}")
+            rows = conn.execute(
+                "SELECT graph_node_id FROM local_file_index WHERE source_id=? AND graph_node_id IS NOT NULL",
+                (source_id,),
+            ).fetchall()
+            graph_node_ids = [row["graph_node_id"] for row in rows if row["graph_node_id"]]
+            for graph_node_id in graph_node_ids:
+                self._delete_local_file_graph(conn, graph_node_id)
+            conn.execute("DELETE FROM local_file_index WHERE source_id=?", (source_id,))
+            conn.execute("DELETE FROM knowledge_sources WHERE id=?", (source_id,))
+            self._cleanup_local_graph_orphans(conn, source_id)
+        return {
+            "source_id": source_id,
+            "root_path": source["root_path"],
+            "removed_graph_nodes": len(graph_node_ids),
+        }
+
     def _extract_local_file_text(self, path: Path, category: str, *, include_ocr: bool) -> Tuple[str, Dict[str, Any]]:
         ext = path.suffix.lower()
         meta: Dict[str, Any] = {"parser": _parser_type_for_category(category, ext)}

package/latticeai/__init__.py

@@ -1 +1,3 @@
-"""Lattice AI — modular server package."""
+"""Lattice AI - modular server package."""
+
+__version__ = "1.0.0"