sessionwiki 2.0.1__tar.gz → 2.0.2__tar.gz

{sessionwiki-2.0.1/sessionwiki.egg-info → sessionwiki-2.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sessionwiki
-Version: 2.0.1
+Version: 2.0.2
 Summary: Searchable, interlinked wiki of your AI coding sessions (Claude Code, Codex CLI, Cursor, Gemini CLI, ZCode, OpenCode, Obsidian), with LLM synthesis and MCP access. Based on llmwiki by Pratiyush.
 Author-email: Igor Lashkevich <3133574+necroz@users.noreply.github.com>
 License: MIT
@@ -59,11 +59,13 @@ Dynamic: license-file
 
 # sessionwiki
 
+<!-- mcp-name: io.github.necroz/sessionwiki -->
+
 > **Your AI coding sessions, compiled into a searchable, interlinked wiki** — from Claude Code, Codex CLI, Cursor, Gemini CLI, Copilot, ZCode and OpenCode. Local-first, with LLM synthesis, a session graph, and an MCP server so your agents can look up what you already solved.
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/necroz/sessionwiki/blob/master/LICENSE)
 [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/)
-[![Version](https://img.shields.io/badge/version-v2.0.1-10B981.svg)](https://github.com/necroz/sessionwiki/blob/master/CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-v2.0.2-10B981.svg)](https://github.com/necroz/sessionwiki/blob/master/CHANGELOG.md)
 [![Tests](https://img.shields.io/badge/tests-2886%20passing-10B981.svg)](https://github.com/necroz/sessionwiki/tree/master/tests)
 [![CI](https://github.com/necroz/sessionwiki/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/necroz/sessionwiki/actions/workflows/ci.yml)
 [![Link check](https://github.com/necroz/sessionwiki/actions/workflows/link-check.yml/badge.svg?branch=master)](https://github.com/necroz/sessionwiki/actions/workflows/link-check.yml)
@@ -211,18 +213,29 @@ Backends: `ollama` (local), `openai` (any OpenAI-compatible `/v1`: vLLM, SGLang,
 
 ## Ask your wiki from your agents (MCP)
 
+**Claude Code plugin** — the MCP server plus a skill that tells the agent when to search the wiki. It asks for your sessionwiki folder on install:
+
+```
+/plugin marketplace add necroz/sessionwiki
+/plugin install sessionwiki@sessionwiki
+```
+
+**Any MCP client** — run the published package with `uvx`, and point `SESSIONWIKI_HOME` at the folder that holds `raw/` and `wiki/` (run `sessionwiki sync` there first):
+
 ```json
 {
   "mcpServers": {
     "sessionwiki": {
-      "command": "/path/to/sessionwiki/.venv/bin/python",
-      "args": ["-m", "sessionwiki.mcp"],
-      "cwd": "/path/to/sessionwiki"
+      "command": "uvx",
+      "args": ["sessionwiki", "mcp"],
+      "env": { "SESSIONWIKI_HOME": "/path/to/your/sessionwiki" }
     }
   }
 }
 ```
 
+From a source checkout, use `"command": "/path/to/sessionwiki/.venv/bin/sessionwiki"` with `"args": ["mcp"]`; the checkout is the data root, so no `env` is needed.
+
 Add it to Claude Code, Claude Desktop, ZCode or any MCP client. Tools include `wiki_query`, `wiki_search` (optionally over raw transcripts), `wiki_read_page`, `wiki_list_sources`, `wiki_lint`, `wiki_sync`, `wiki_export`, `wiki_dashboard` and more — 12 in total, stdio transport, no SDK dependency, path-traversal guarded.
 
 ## CLI reference
@@ -244,6 +257,7 @@ sessionwiki doctor                  # check Python, deps, config, agent paths
 sessionwiki audit                   # scan raw/ wiki/ site/ for usernames and secrets
 sessionwiki zcode                   # export · autosync · install
 sessionwiki opencode                # export · autosync · install
+sessionwiki mcp                     # MCP server on stdio
 sessionwiki version
 ```
 

{sessionwiki-2.0.1 → sessionwiki-2.0.2}/README.md

@@ -1,10 +1,12 @@
 # sessionwiki
 
+<!-- mcp-name: io.github.necroz/sessionwiki -->
+
 > **Your AI coding sessions, compiled into a searchable, interlinked wiki** — from Claude Code, Codex CLI, Cursor, Gemini CLI, Copilot, ZCode and OpenCode. Local-first, with LLM synthesis, a session graph, and an MCP server so your agents can look up what you already solved.
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/necroz/sessionwiki/blob/master/LICENSE)
 [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/)
-[![Version](https://img.shields.io/badge/version-v2.0.1-10B981.svg)](https://github.com/necroz/sessionwiki/blob/master/CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-v2.0.2-10B981.svg)](https://github.com/necroz/sessionwiki/blob/master/CHANGELOG.md)
 [![Tests](https://img.shields.io/badge/tests-2886%20passing-10B981.svg)](https://github.com/necroz/sessionwiki/tree/master/tests)
 [![CI](https://github.com/necroz/sessionwiki/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/necroz/sessionwiki/actions/workflows/ci.yml)
 [![Link check](https://github.com/necroz/sessionwiki/actions/workflows/link-check.yml/badge.svg?branch=master)](https://github.com/necroz/sessionwiki/actions/workflows/link-check.yml)
@@ -152,18 +154,29 @@ Backends: `ollama` (local), `openai` (any OpenAI-compatible `/v1`: vLLM, SGLang,
 
 ## Ask your wiki from your agents (MCP)
 
+**Claude Code plugin** — the MCP server plus a skill that tells the agent when to search the wiki. It asks for your sessionwiki folder on install:
+
+```
+/plugin marketplace add necroz/sessionwiki
+/plugin install sessionwiki@sessionwiki
+```
+
+**Any MCP client** — run the published package with `uvx`, and point `SESSIONWIKI_HOME` at the folder that holds `raw/` and `wiki/` (run `sessionwiki sync` there first):
+
 ```json
 {
   "mcpServers": {
     "sessionwiki": {
-      "command": "/path/to/sessionwiki/.venv/bin/python",
-      "args": ["-m", "sessionwiki.mcp"],
-      "cwd": "/path/to/sessionwiki"
+      "command": "uvx",
+      "args": ["sessionwiki", "mcp"],
+      "env": { "SESSIONWIKI_HOME": "/path/to/your/sessionwiki" }
     }
   }
 }
 ```
 
+From a source checkout, use `"command": "/path/to/sessionwiki/.venv/bin/sessionwiki"` with `"args": ["mcp"]`; the checkout is the data root, so no `env` is needed.
+
 Add it to Claude Code, Claude Desktop, ZCode or any MCP client. Tools include `wiki_query`, `wiki_search` (optionally over raw transcripts), `wiki_read_page`, `wiki_list_sources`, `wiki_lint`, `wiki_sync`, `wiki_export`, `wiki_dashboard` and more — 12 in total, stdio transport, no SDK dependency, path-traversal guarded.
 
 ## CLI reference
@@ -185,6 +198,7 @@ sessionwiki doctor                  # check Python, deps, config, agent paths
 sessionwiki audit                   # scan raw/ wiki/ site/ for usernames and secrets
 sessionwiki zcode                   # export · autosync · install
 sessionwiki opencode                # export · autosync · install
+sessionwiki mcp                     # MCP server on stdio
 sessionwiki version
 ```
 

{sessionwiki-2.0.1 → sessionwiki-2.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sessionwiki"
-version = "2.0.1"
+version = "2.0.2"
 description = "Searchable, interlinked wiki of your AI coding sessions (Claude Code, Codex CLI, Cursor, Gemini CLI, ZCode, OpenCode, Obsidian), with LLM synthesis and MCP access. Based on llmwiki by Pratiyush."
 readme = "README.md"
 requires-python = ">=3.9"

{sessionwiki-2.0.1 → sessionwiki-2.0.2}/sessionwiki/__init__.py

@@ -15,7 +15,7 @@ Public API:
     - sessionwiki.mcp.server.main()       — MCP server (stdio)
 """
 
-__version__ = "2.0.1"
+__version__ = "2.0.2"
 __author__ = "Igor Lashkevich"  # based on llmwiki by Pratiyush (MIT)
 __license__ = "MIT"
 

{sessionwiki-2.0.1 → sessionwiki-2.0.2}/sessionwiki/cli.py

@@ -57,6 +57,13 @@ def cmd_version(args: argparse.Namespace) -> int:
     return 0
 
 
+def cmd_mcp(args: argparse.Namespace) -> int:
+    """Run the MCP server on stdin/stdout (same as `python3 -m sessionwiki.mcp`)."""
+    from sessionwiki.mcp.server import main as mcp_main
+
+    return mcp_main()
+
+
 def cmd_all(args: argparse.Namespace) -> int:
     """Run the full wiki pipeline end-to-end: build → graph → export all → lint.
 
@@ -1629,6 +1636,13 @@ def build_parser() -> argparse.ArgumentParser:
     ver = sub.add_parser("version", help="Print version")
     ver.set_defaults(func=cmd_version)
 
+    # mcp — stdio MCP server (the entry point MCP clients and registries use)
+    mcp = sub.add_parser(
+        "mcp",
+        help="Run the MCP server on stdio (data root: $SESSIONWIKI_HOME or the current directory)",
+    )
+    mcp.set_defaults(func=cmd_mcp)
+
     # all — run build + graph + export all + lint in sequence
     all_p = sub.add_parser(
         "all",

{sessionwiki-2.0.1 → sessionwiki-2.0.2/sessionwiki.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sessionwiki
-Version: 2.0.1
+Version: 2.0.2
 Summary: Searchable, interlinked wiki of your AI coding sessions (Claude Code, Codex CLI, Cursor, Gemini CLI, ZCode, OpenCode, Obsidian), with LLM synthesis and MCP access. Based on llmwiki by Pratiyush.
 Author-email: Igor Lashkevich <3133574+necroz@users.noreply.github.com>
 License: MIT
@@ -59,11 +59,13 @@ Dynamic: license-file
 
 # sessionwiki
 
+<!-- mcp-name: io.github.necroz/sessionwiki -->
+
 > **Your AI coding sessions, compiled into a searchable, interlinked wiki** — from Claude Code, Codex CLI, Cursor, Gemini CLI, Copilot, ZCode and OpenCode. Local-first, with LLM synthesis, a session graph, and an MCP server so your agents can look up what you already solved.
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/necroz/sessionwiki/blob/master/LICENSE)
 [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/)
-[![Version](https://img.shields.io/badge/version-v2.0.1-10B981.svg)](https://github.com/necroz/sessionwiki/blob/master/CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-v2.0.2-10B981.svg)](https://github.com/necroz/sessionwiki/blob/master/CHANGELOG.md)
 [![Tests](https://img.shields.io/badge/tests-2886%20passing-10B981.svg)](https://github.com/necroz/sessionwiki/tree/master/tests)
 [![CI](https://github.com/necroz/sessionwiki/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/necroz/sessionwiki/actions/workflows/ci.yml)
 [![Link check](https://github.com/necroz/sessionwiki/actions/workflows/link-check.yml/badge.svg?branch=master)](https://github.com/necroz/sessionwiki/actions/workflows/link-check.yml)
@@ -211,18 +213,29 @@ Backends: `ollama` (local), `openai` (any OpenAI-compatible `/v1`: vLLM, SGLang,
 
 ## Ask your wiki from your agents (MCP)
 
+**Claude Code plugin** — the MCP server plus a skill that tells the agent when to search the wiki. It asks for your sessionwiki folder on install:
+
+```
+/plugin marketplace add necroz/sessionwiki
+/plugin install sessionwiki@sessionwiki
+```
+
+**Any MCP client** — run the published package with `uvx`, and point `SESSIONWIKI_HOME` at the folder that holds `raw/` and `wiki/` (run `sessionwiki sync` there first):
+
 ```json
 {
   "mcpServers": {
     "sessionwiki": {
-      "command": "/path/to/sessionwiki/.venv/bin/python",
-      "args": ["-m", "sessionwiki.mcp"],
-      "cwd": "/path/to/sessionwiki"
+      "command": "uvx",
+      "args": ["sessionwiki", "mcp"],
+      "env": { "SESSIONWIKI_HOME": "/path/to/your/sessionwiki" }
     }
   }
 }
 ```
 
+From a source checkout, use `"command": "/path/to/sessionwiki/.venv/bin/sessionwiki"` with `"args": ["mcp"]`; the checkout is the data root, so no `env` is needed.
+
 Add it to Claude Code, Claude Desktop, ZCode or any MCP client. Tools include `wiki_query`, `wiki_search` (optionally over raw transcripts), `wiki_read_page`, `wiki_list_sources`, `wiki_lint`, `wiki_sync`, `wiki_export`, `wiki_dashboard` and more — 12 in total, stdio transport, no SDK dependency, path-traversal guarded.
 
 ## CLI reference
@@ -244,6 +257,7 @@ sessionwiki doctor                  # check Python, deps, config, agent paths
 sessionwiki audit                   # scan raw/ wiki/ site/ for usernames and secrets
 sessionwiki zcode                   # export · autosync · install
 sessionwiki opencode                # export · autosync · install
+sessionwiki mcp                     # MCP server on stdio
 sessionwiki version
 ```
 

{sessionwiki-2.0.1 → sessionwiki-2.0.2}/sessionwiki.egg-info/SOURCES.txt

@@ -159,6 +159,7 @@ tests/test_cross_platform_paths.py
 tests/test_css_dark_code_and_sticky_header.py
 tests/test_dashboard.py
 tests/test_default_redaction.py
+tests/test_distribution_manifests.py
 tests/test_docker.py
 tests/test_docs_structure.py
 tests/test_doctor.py

{sessionwiki-2.0.1 → sessionwiki-2.0.2}/tests/test_cli.py

@@ -26,6 +26,25 @@ def test_version_subcommand():
     assert __version__ in r.stdout
 
 
+def test_mcp_subcommand_serves_stdio(tmp_path):
+    """`sessionwiki mcp` must start the stdio MCP server, so registry
+    clients can launch the PyPI package as `uvx sessionwiki mcp`."""
+    import json
+    import os
+
+    request = {"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}
+    r = subprocess.run(
+        [sys.executable, "-m", "sessionwiki", "mcp"],
+        input=json.dumps(request) + "\n",
+        capture_output=True, text=True, timeout=30,
+        env={**os.environ, "SESSIONWIKI_HOME": str(tmp_path)},
+    )
+    assert r.returncode == 0, r.stderr
+    response = json.loads(r.stdout.splitlines()[0])
+    names = {tool["name"] for tool in response["result"]["tools"]}
+    assert {"wiki_query", "wiki_search", "wiki_read_page"} <= names
+
+
 def test_adapters_lists_claude_code():
     r = subprocess.run(
         [sys.executable, "-m", "sessionwiki", "adapters"],

sessionwiki-2.0.2/tests/test_distribution_manifests.py

@@ -0,0 +1,99 @@
+"""Guardrails for the catalog manifests: the Claude Code plugin, its
+marketplace, the MCP Registry `server.json` and the Glama claim file.
+
+The catalogs read these files as published, and a published MCP Registry
+version cannot be changed, so drift between them and the package is caught
+here instead of after a release.
+"""
+
+from __future__ import annotations
+
+import json
+import re
+from pathlib import Path
+
+from sessionwiki import __version__
+from sessionwiki.cli import build_parser
+
+REPO_ROOT = Path(__file__).resolve().parents[1]
+SERVER_JSON = REPO_ROOT / "server.json"
+MARKETPLACE_JSON = REPO_ROOT / ".claude-plugin" / "marketplace.json"
+PLUGIN_DIR = REPO_ROOT / "plugin"
+PLUGIN_JSON = PLUGIN_DIR / ".claude-plugin" / "plugin.json"
+GLAMA_JSON = REPO_ROOT / "glama.json"
+
+
+def _load(path: Path) -> dict:
+    return json.loads(path.read_text(encoding="utf-8"))
+
+
+def _subcommands() -> set[str]:
+    for action in build_parser()._actions:
+        if isinstance(getattr(action, "choices", None), dict):
+            return set(action.choices)
+    raise AssertionError("no subparsers on build_parser()")
+
+
+def test_server_json_versions_match_package():
+    server = _load(SERVER_JSON)
+    assert server["version"] == __version__
+    for package in server["packages"]:
+        assert package["version"] == __version__
+
+
+def test_server_json_pypi_package_runs_the_mcp_subcommand():
+    (package,) = [p for p in _load(SERVER_JSON)["packages"] if p["registryType"] == "pypi"]
+    assert package["identifier"] == "sessionwiki"
+    assert package["transport"] == {"type": "stdio"}
+    args = [a["value"] for a in package.get("packageArguments", [])]
+    assert args == ["mcp"]
+    assert "mcp" in _subcommands()
+    env = {e["name"] for e in package.get("environmentVariables", [])}
+    assert "SESSIONWIKI_HOME" in env
+
+
+def test_server_json_description_fits_registry_limit():
+    assert len(_load(SERVER_JSON)["description"]) <= 100
+
+
+def test_readme_carries_the_registry_ownership_line():
+    """The MCP Registry checks the PyPI description (our README) for
+    `mcp-name: <server name>`, followed by whitespace or `-->`."""
+    name = _load(SERVER_JSON)["name"]
+    readme = (REPO_ROOT / "README.md").read_text(encoding="utf-8")
+    assert re.search(rf"mcp-name: {re.escape(name)}(\s|-->)", readme)
+
+
+def test_plugin_version_matches_package():
+    assert _load(PLUGIN_JSON)["version"] == __version__
+
+
+def test_plugin_mcp_server_uses_the_mcp_subcommand_and_user_folder():
+    plugin = _load(PLUGIN_JSON)
+    server = plugin["mcpServers"]["sessionwiki"]
+    assert server["args"][-1] == "mcp"
+    home = server["env"]["SESSIONWIKI_HOME"]
+    key = re.fullmatch(r"\$\{user_config\.(\w+)\}", home).group(1)
+    assert plugin["userConfig"][key]["required"] is True
+
+
+def test_marketplace_points_to_the_plugin_folder():
+    market = _load(MARKETPLACE_JSON)
+    assert market["owner"]["name"]
+    (entry,) = market["plugins"]
+    assert entry["name"] == _load(PLUGIN_JSON)["name"]
+    assert (REPO_ROOT / entry["source"]).resolve() == PLUGIN_DIR.resolve()
+
+
+def test_plugin_skills_have_frontmatter():
+    skills = sorted((PLUGIN_DIR / "skills").glob("*/SKILL.md"))
+    assert skills
+    for skill in skills:
+        text = skill.read_text(encoding="utf-8")
+        assert text.startswith("---\n")
+        assert re.search(rf"^name: {skill.parent.name}$", text, re.MULTILINE)
+        assert re.search(r"^description: \S", text, re.MULTILINE)
+
+
+def test_glama_claim_names_a_maintainer():
+    assert _load(GLAMA_JSON)["maintainers"]

{sessionwiki-2.0.1 → sessionwiki-2.0.2}/tests/test_release_pipeline.py

@@ -155,3 +155,13 @@ def test_check_release_artifacts_script_runs_twine_check():
     # metadata issues that trip up PyPI.
     assert "python -m build" in text or "python3 -m build" in text
     assert "twine check" in text
+
+
+def test_release_job_publishes_a_release_drafter_draft():
+    """Release Drafter pre-creates a draft for the next tag; the release
+    job must publish it, not just upload assets to it (v2.0.1 stayed a
+    draft until published by hand)."""
+    text = (REPO_ROOT / ".github" / "workflows" / "release.yml").read_text(encoding="utf-8")
+    assert "--json isDraft" in text
+    assert "--draft=false" in text
+    assert "--latest=false" in text  # pre-releases must not become Latest