linear-mcp-fast 0.2.6__tar.gz → 0.3.1__tar.gz

{linear_mcp_fast-0.2.6 → linear_mcp_fast-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: linear-mcp-fast
-Version: 0.2.6
+Version: 0.3.1
 Summary: Fast MCP server for Linear - reads from Linear.app's local cache on macOS
 Author: everything-chalna
 License-Expression: MIT
@@ -32,18 +32,22 @@ While using the official Linear MCP with Claude Code, I noticed that **read oper
 
 The problem:
 - Official Linear MCP makes API calls for every read
+- Issue descriptions require separate API calls
 - Responses include excessive metadata (full user objects, workflow states, etc.)
 - Context window fills up quickly when exploring issues
 - Slower response times due to network latency
 
 My solution: **Read directly from Linear.app's local cache.**
 
+Linear.app stores issue descriptions in Y.js CRDT format. This package decodes them locally, so you get descriptions without API calls.
+
 Linear.app (Electron) syncs all your data to a local IndexedDB. This MCP server reads from that cache, giving you:
 
 - **Zero API calls** - Instant reads from disk
 - **Smaller responses** - Only the fields you need
 - **Offline access** - Works without internet
 - **Faster iteration** - No rate limits, no latency
+- **Issue descriptions** - Extracts text from Y.js encoded content (v0.3.0+)
 
 ## Requirements
 
@@ -146,10 +150,16 @@ IndexedDB (LevelDB)
 ~/Library/Application Support/Linear/IndexedDB/...
     ↓ read by
 linear-mcp-fast
-    ↓
+    ↓ decodes Y.js CRDT content
 Fast, offline access to issues, teams, users, projects
 ```
 
+### Issue Descriptions
+
+Linear stores issue descriptions in a separate `contentState` field using Y.js CRDT encoding. This package decodes the binary format to extract readable text, so `get_issue` returns the description without an API call.
+
+Note: The extraction is text-based (not full Y.js parsing), so some formatting may be lost. For rich markdown content, use the official Linear MCP.
+
 ## Troubleshooting
 
 **"Linear database not found"**

{linear_mcp_fast-0.2.6 → linear_mcp_fast-0.3.1}/README.md

@@ -8,18 +8,22 @@ While using the official Linear MCP with Claude Code, I noticed that **read oper
 
 The problem:
 - Official Linear MCP makes API calls for every read
+- Issue descriptions require separate API calls
 - Responses include excessive metadata (full user objects, workflow states, etc.)
 - Context window fills up quickly when exploring issues
 - Slower response times due to network latency
 
 My solution: **Read directly from Linear.app's local cache.**
 
+Linear.app stores issue descriptions in Y.js CRDT format. This package decodes them locally, so you get descriptions without API calls.
+
 Linear.app (Electron) syncs all your data to a local IndexedDB. This MCP server reads from that cache, giving you:
 
 - **Zero API calls** - Instant reads from disk
 - **Smaller responses** - Only the fields you need
 - **Offline access** - Works without internet
 - **Faster iteration** - No rate limits, no latency
+- **Issue descriptions** - Extracts text from Y.js encoded content (v0.3.0+)
 
 ## Requirements
 
@@ -122,10 +126,16 @@ IndexedDB (LevelDB)
 ~/Library/Application Support/Linear/IndexedDB/...
     ↓ read by
 linear-mcp-fast
-    ↓
+    ↓ decodes Y.js CRDT content
 Fast, offline access to issues, teams, users, projects
 ```
 
+### Issue Descriptions
+
+Linear stores issue descriptions in a separate `contentState` field using Y.js CRDT encoding. This package decodes the binary format to extract readable text, so `get_issue` returns the description without an API call.
+
+Note: The extraction is text-based (not full Y.js parsing), so some formatting may be lost. For rich markdown content, use the official Linear MCP.
+
 ## Troubleshooting
 
 **"Linear database not found"**

{linear_mcp_fast-0.2.6 → linear_mcp_fast-0.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "linear-mcp-fast"
-version = "0.2.6"
+version = "0.3.1"
 description = "Fast MCP server for Linear - reads from Linear.app's local cache on macOS"
 readme = "README.md"
 license = "MIT"

{linear_mcp_fast-0.2.6 → linear_mcp_fast-0.3.1}/src/linear_mcp_fast/reader.py

@@ -5,8 +5,10 @@ Reads Linear's local IndexedDB cache to provide fast access to issues, users,
 teams, workflow states, and comments without API calls.
 """
 
+import base64
 import json
 import os
+import re
 import time
 from dataclasses import dataclass, field
 from typing import Any
@@ -36,6 +38,7 @@ class CachedData:
     comments: dict[str, dict[str, Any]] = field(default_factory=dict)
     comments_by_issue: dict[str, list[str]] = field(default_factory=dict)
     projects: dict[str, dict[str, Any]] = field(default_factory=dict)
+    issue_content: dict[str, str] = field(default_factory=dict)  # issueId -> description
     loaded_at: float = 0.0
 
     def is_expired(self) -> bool:
@@ -92,6 +95,77 @@ class LinearLocalReader:
             return val.decode("utf-8", errors="replace")
         return str(val)
 
+    def _extract_yjs_text(self, content_state: str | None) -> str:
+        """Extract readable text from Y.js encoded contentState."""
+        if not content_state:
+            return ""
+
+        try:
+            decoded = base64.b64decode(content_state)
+            text = decoded.decode("utf-8", errors="replace")
+
+            # Extract readable text (Korean + ASCII printable)
+            readable = re.findall(r"[\uac00-\ud7af\u0020-\u007e]+", text)
+
+            # Structural markers to skip (ProseMirror/Y.js)
+            skip_exact = {
+                "prosemirror", "paragraph", "heading", "bullet_list", "list_item",
+                "ordered_list", "level", "link", "null", "strong", "em", "code",
+                "table", "table_row", "table_cell", "table_header", "colspan",
+                "rowspan", "colwidth", "issuemention", "label", "href", "title",
+                "order", "attrs", "content", "marks", "type", "text", "doc",
+                "blockquote", "code_block", "hard_break", "horizontal_rule",
+                "image", "suggestion_usermentions", "todo_item", "done", "language",
+            }
+
+            result = []
+            for r in readable:
+                r = r.strip()
+                if len(r) < 2:
+                    continue
+
+                # Skip exact structural markers
+                if r.lower() in skip_exact:
+                    continue
+
+                # Skip Y.js IDs and encoded strings
+                if re.match(r"^w[\$\)\(A-Z]", r):
+                    continue
+
+                # Skip JSON objects and JSON-like patterns
+                if r.startswith("{") or '{"' in r:
+                    continue
+
+                # Skip link markers with JSON
+                if r.startswith("link") and "{" in r:
+                    continue
+
+                # Skip UUIDs
+                if re.match(r"^[a-f0-9-]{36}$", r):
+                    continue
+
+                # Skip single characters or pure numbers
+                if len(r) <= 2 and not re.search(r"[\uac00-\ud7af]", r):
+                    continue
+
+                # Skip strings that are mostly special characters
+                if len(r) > 0:
+                    special_ratio = sum(1 for c in r if c in "()[]{}$#@*&^%") / len(r)
+                    if special_ratio > 0.3:
+                        continue
+
+                result.append(r)
+
+            # Join and clean up
+            text = " ".join(result)
+            # Remove excessive whitespace and parentheses artifacts
+            text = re.sub(r"\s*\(\s*$", "", text)
+            text = re.sub(r"^\s*\)\s*", "", text)
+            text = re.sub(r"\s+", " ", text)
+            return text.strip()
+        except Exception:
+            return ""
+
     def _extract_comment_text(self, body_data: Any) -> str:
         """Extract plain text from ProseMirror bodyData format."""
         if body_data is None:
@@ -185,11 +259,16 @@ class LinearLocalReader:
                 team_key = team.get("key", "???")
                 identifier = f"{team_key}-{val.get('number')}"
 
+                # Try descriptionData (ProseMirror format) first, fall back to description
+                description = val.get("description")
+                if not description and val.get("descriptionData"):
+                    description = self._extract_comment_text(val.get("descriptionData"))
+
                 cache.issues[val["id"]] = {
                     "id": val["id"],
                     "identifier": identifier,
                     "title": val.get("title"),
-                    "description": val.get("description"),
+                    "description": description,
                     "number": val.get("number"),
                     "priority": val.get("priority"),
                     "estimate": val.get("estimate"),
@@ -246,6 +325,21 @@ class LinearLocalReader:
                     "updatedAt": val.get("updatedAt"),
                 }
 
+        # Load issue content (Y.js encoded descriptions)
+        if self._stores.issue_content:
+            for val in self._load_from_store(db, self._stores.issue_content):
+                issue_id = val.get("issueId")
+                content_state = val.get("contentState")
+                if issue_id and content_state:
+                    extracted = self._extract_yjs_text(content_state)
+                    if extracted:
+                        cache.issue_content[issue_id] = extracted
+
+        # Update issues with descriptions from issue_content
+        for issue_id, desc in cache.issue_content.items():
+            if issue_id in cache.issues and not cache.issues[issue_id].get("description"):
+                cache.issues[issue_id]["description"] = desc
+
         self._cache = cache
 
     def _ensure_cache(self) -> CachedData:

{linear_mcp_fast-0.2.6 → linear_mcp_fast-0.3.1}/src/linear_mcp_fast/store_detector.py

@@ -21,6 +21,7 @@ class DetectedStores:
     workflow_states: list[str] | None = None
     comments: str | None = None
     projects: str | None = None
+    issue_content: str | None = None  # Y.js encoded issue descriptions
 
 
 def _is_issue_record(record: dict[str, Any]) -> bool:
@@ -68,6 +69,12 @@ def _is_project_record(record: dict[str, Any]) -> bool:
     return required.issubset(record.keys())
 
 
+def _is_issue_content_record(record: dict[str, Any]) -> bool:
+    """Check if a record looks like issue content (Y.js encoded description)."""
+    required = {"issueId", "contentState"}
+    return required.issubset(record.keys())
+
+
 def detect_stores(db: ccl_chromium_indexeddb.WrappedDatabase) -> DetectedStores:
     """
     Detect object stores by sampling their first record.
@@ -109,6 +116,8 @@ def detect_stores(db: ccl_chromium_indexeddb.WrappedDatabase) -> DetectedStores:
                     result.comments = store_name
                 elif _is_project_record(val) and result.projects is None:
                     result.projects = store_name
+                elif _is_issue_content_record(val) and result.issue_content is None:
+                    result.issue_content = store_name
 
                 break  # Only check first record
         except Exception:

{linear_mcp_fast-0.2.6 → linear_mcp_fast-0.3.1}/src/linear_mcp_fast.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: linear-mcp-fast
-Version: 0.2.6
+Version: 0.3.1
 Summary: Fast MCP server for Linear - reads from Linear.app's local cache on macOS
 Author: everything-chalna
 License-Expression: MIT
@@ -32,18 +32,22 @@ While using the official Linear MCP with Claude Code, I noticed that **read oper
 
 The problem:
 - Official Linear MCP makes API calls for every read
+- Issue descriptions require separate API calls
 - Responses include excessive metadata (full user objects, workflow states, etc.)
 - Context window fills up quickly when exploring issues
 - Slower response times due to network latency
 
 My solution: **Read directly from Linear.app's local cache.**
 
+Linear.app stores issue descriptions in Y.js CRDT format. This package decodes them locally, so you get descriptions without API calls.
+
 Linear.app (Electron) syncs all your data to a local IndexedDB. This MCP server reads from that cache, giving you:
 
 - **Zero API calls** - Instant reads from disk
 - **Smaller responses** - Only the fields you need
 - **Offline access** - Works without internet
 - **Faster iteration** - No rate limits, no latency
+- **Issue descriptions** - Extracts text from Y.js encoded content (v0.3.0+)
 
 ## Requirements
 
@@ -146,10 +150,16 @@ IndexedDB (LevelDB)
 ~/Library/Application Support/Linear/IndexedDB/...
     ↓ read by
 linear-mcp-fast
-    ↓
+    ↓ decodes Y.js CRDT content
 Fast, offline access to issues, teams, users, projects
 ```
 
+### Issue Descriptions
+
+Linear stores issue descriptions in a separate `contentState` field using Y.js CRDT encoding. This package decodes the binary format to extract readable text, so `get_issue` returns the description without an API call.
+
+Note: The extraction is text-based (not full Y.js parsing), so some formatting may be lost. For rich markdown content, use the official Linear MCP.
+
 ## Troubleshooting
 
 **"Linear database not found"**