sessionwiki 2.0.0__tar.gz → 2.0.2__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sessionwiki
-Version: 2.0.0
+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.0-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)
@@ -137,11 +139,19 @@ cd sessionwiki
 
 `setup` creates a checkout-local `.venv`, installs the package, scaffolds `raw/`, `wiki/`, `site/`, enables the adapters for the agents it finds and runs `sessionwiki doctor`. The wrapper scripts use the venv automatically; for the CLI, activate it (`source .venv/bin/activate`) or call `.venv/bin/sessionwiki`.
 
-Prefer pip? Install straight from GitHub (PyPI release coming with v2.0.0):
+Or install the published package — pick one:
+
+```bash
+uv tool install sessionwiki          # uv: CLI in its own isolated environment
+uvx sessionwiki --help               # uv: run without installing
+pip install sessionwiki              # pip, inside a virtualenv
+pip install 'sessionwiki[graph]'     # + graphify graph engine (also works with uv tool install)
+```
+
+Docker — serve a site you have built (image `ghcr.io/necroz/sessionwiki`, see [Docker deployment](https://github.com/necroz/sessionwiki/blob/master/docs/deploy/docker.md) for `docker compose` and running CLI commands in the container):
 
 ```bash
-pip install 'sessionwiki @ git+https://github.com/necroz/sessionwiki'          # core
-pip install 'sessionwiki[all] @ git+https://github.com/necroz/sessionwiki'     # + graph engine, dev, e2e
+docker run --rm -p 8765:8765 -v "$PWD/site:/wiki/site:ro" ghcr.io/necroz/sessionwiki
 ```
 
 A step-by-step walkthrough with screenshots lives in the [setup guide](https://github.com/necroz/sessionwiki/blob/master/docs/tutorials/setup-guide.md).
@@ -203,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
@@ -236,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.0 → 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.0-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)
@@ -78,11 +80,19 @@ cd sessionwiki
 
 `setup` creates a checkout-local `.venv`, installs the package, scaffolds `raw/`, `wiki/`, `site/`, enables the adapters for the agents it finds and runs `sessionwiki doctor`. The wrapper scripts use the venv automatically; for the CLI, activate it (`source .venv/bin/activate`) or call `.venv/bin/sessionwiki`.
 
-Prefer pip? Install straight from GitHub (PyPI release coming with v2.0.0):
+Or install the published package — pick one:
+
+```bash
+uv tool install sessionwiki          # uv: CLI in its own isolated environment
+uvx sessionwiki --help               # uv: run without installing
+pip install sessionwiki              # pip, inside a virtualenv
+pip install 'sessionwiki[graph]'     # + graphify graph engine (also works with uv tool install)
+```
+
+Docker — serve a site you have built (image `ghcr.io/necroz/sessionwiki`, see [Docker deployment](https://github.com/necroz/sessionwiki/blob/master/docs/deploy/docker.md) for `docker compose` and running CLI commands in the container):
 
 ```bash
-pip install 'sessionwiki @ git+https://github.com/necroz/sessionwiki'          # core
-pip install 'sessionwiki[all] @ git+https://github.com/necroz/sessionwiki'     # + graph engine, dev, e2e
+docker run --rm -p 8765:8765 -v "$PWD/site:/wiki/site:ro" ghcr.io/necroz/sessionwiki
 ```
 
 A step-by-step walkthrough with screenshots lives in the [setup guide](https://github.com/necroz/sessionwiki/blob/master/docs/tutorials/setup-guide.md).
@@ -144,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
@@ -177,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.0 → sessionwiki-2.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sessionwiki"
-version = "2.0.0"
+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.0 → sessionwiki-2.0.2}/sessionwiki/__init__.py

@@ -15,14 +15,38 @@ Public API:
     - sessionwiki.mcp.server.main()       — MCP server (stdio)
 """
 
-__version__ = "2.0.0"
+__version__ = "2.0.2"
 __author__ = "Igor Lashkevich"  # based on llmwiki by Pratiyush (MIT)
 __license__ = "MIT"
 
+import os
 from pathlib import Path
 
-# Repo root (sessionwiki/ clone), resolved from this file's location.
-REPO_ROOT = Path(__file__).resolve().parent.parent
+
+def _resolve_root(package_file: "str | Path" = __file__) -> Path:
+    """Directory that holds raw/, wiki/, site/ and the state files.
+
+    1. ``$SESSIONWIKI_HOME`` (or the legacy ``$LLMWIKI_HOME``) when set.
+    2. The source checkout, when the package runs from a clone (``./setup.sh``
+       or ``pip install -e``): the parent of ``sessionwiki/`` has
+       ``pyproject.toml``.
+    3. Otherwise — ``pip install`` / ``uv tool install`` / ``uvx`` / Docker,
+       where the parent is ``site-packages`` — the current directory.
+    """
+    for var in ("SESSIONWIKI_HOME", "LLMWIKI_HOME"):
+        value = os.environ.get(var, "").strip()
+        if value:
+            return Path(value).expanduser().resolve()
+    checkout = Path(package_file).resolve().parent.parent
+    if (checkout / "pyproject.toml").is_file():
+        return checkout
+    return Path.cwd().resolve()
+
+
+# Data root (raw/, wiki/, site/, state files). See _resolve_root().
+REPO_ROOT = _resolve_root()
+# The installed package itself — use this, not REPO_ROOT, for files that
+# ship inside the package (templates, prompts, bundled assets).
 PACKAGE_ROOT = Path(__file__).resolve().parent
 
 # #arch-m4 (#617): the docstring above promised a "public API" but

{sessionwiki-2.0.0 → 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.
 
@@ -1111,7 +1118,7 @@ def _add_vault_arg(parser: argparse.ArgumentParser, *, role: str) -> None:
 def build_parser() -> argparse.ArgumentParser:
     p = argparse.ArgumentParser(
         prog="sessionwiki",
-        description="LLM-powered knowledge base from Claude Code and Codex CLI sessions.",
+        description="Searchable, interlinked wiki of your AI coding sessions (Claude Code, Codex CLI, Cursor, Gemini CLI, Copilot, ZCode, OpenCode).",
     )
     p.add_argument("--version", action="version", version=f"sessionwiki {__version__}")
 
@@ -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.0 → sessionwiki-2.0.2/sessionwiki.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sessionwiki
-Version: 2.0.0
+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.0-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)
@@ -137,11 +139,19 @@ cd sessionwiki
 
 `setup` creates a checkout-local `.venv`, installs the package, scaffolds `raw/`, `wiki/`, `site/`, enables the adapters for the agents it finds and runs `sessionwiki doctor`. The wrapper scripts use the venv automatically; for the CLI, activate it (`source .venv/bin/activate`) or call `.venv/bin/sessionwiki`.
 
-Prefer pip? Install straight from GitHub (PyPI release coming with v2.0.0):
+Or install the published package — pick one:
+
+```bash
+uv tool install sessionwiki          # uv: CLI in its own isolated environment
+uvx sessionwiki --help               # uv: run without installing
+pip install sessionwiki              # pip, inside a virtualenv
+pip install 'sessionwiki[graph]'     # + graphify graph engine (also works with uv tool install)
+```
+
+Docker — serve a site you have built (image `ghcr.io/necroz/sessionwiki`, see [Docker deployment](https://github.com/necroz/sessionwiki/blob/master/docs/deploy/docker.md) for `docker compose` and running CLI commands in the container):
 
 ```bash
-pip install 'sessionwiki @ git+https://github.com/necroz/sessionwiki'          # core
-pip install 'sessionwiki[all] @ git+https://github.com/necroz/sessionwiki'     # + graph engine, dev, e2e
+docker run --rm -p 8765:8765 -v "$PWD/site:/wiki/site:ro" ghcr.io/necroz/sessionwiki
 ```
 
 A step-by-step walkthrough with screenshots lives in the [setup guide](https://github.com/necroz/sessionwiki/blob/master/docs/tutorials/setup-guide.md).
@@ -203,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
@@ -236,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.0 → 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
@@ -183,7 +184,6 @@ tests/test_graphify_bridge.py
 tests/test_healer_comment.py
 tests/test_highlightjs.py
 tests/test_home_card_date_range.py
-tests/test_homebrew_tap.py
 tests/test_ignore.py
 tests/test_ingest_queue_shim.py
 tests/test_is_subagent.py
@@ -230,6 +230,7 @@ tests/test_references.py
 tests/test_release_pipeline.py
 tests/test_render_is_subagent.py
 tests/test_render_split.py
+tests/test_repo_root_resolution.py
 tests/test_schedule_config.py
 tests/test_schema.py
 tests/test_schema_entity_types.py

{sessionwiki-2.0.0 → 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.0 → sessionwiki-2.0.2}/tests/test_editorconfig_lychee.py

@@ -97,10 +97,9 @@ def test_lychee_skips_known_future_urls():
     assert "v1\\\\.1" in text or "v1.1" in text
 
 
-def test_lychee_skips_pypi_and_homebrew_placeholders():
+def test_lychee_skips_pypi_placeholder():
     text = LYCHEE.read_text(encoding="utf-8")
     assert "pypi" in text
-    assert "homebrew-sessionwiki" in text
 
 
 # ─── workflow ─────────────────────────────────────────────────────────

{sessionwiki-2.0.0 → 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

sessionwiki-2.0.2/tests/test_repo_root_resolution.py

@@ -0,0 +1,90 @@
+"""Where sessionwiki keeps raw/, wiki/ and site/.
+
+Before 2.0.1 the root was always the parent of the package directory.
+That is right for a git clone, but for `pip install` / `uv tool install`
+/ Docker it is `site-packages`, so `sessionwiki init` scaffolded raw/,
+wiki/ and site/ inside the virtualenv (or failed on a read-only image).
+"""
+
+from __future__ import annotations
+
+import os
+import subprocess
+import sys
+from pathlib import Path
+
+import pytest
+
+from sessionwiki import _resolve_root
+
+CHECKOUT = Path(__file__).resolve().parent.parent
+
+
+def _clear(monkeypatch):
+    monkeypatch.delenv("SESSIONWIKI_HOME", raising=False)
+    monkeypatch.delenv("LLMWIKI_HOME", raising=False)
+
+
+def test_source_checkout_is_the_root(monkeypatch, tmp_path):
+    _clear(monkeypatch)
+    monkeypatch.chdir(tmp_path)
+    pkg = CHECKOUT / "sessionwiki" / "__init__.py"
+    assert _resolve_root(pkg) == CHECKOUT
+
+
+def test_installed_package_uses_the_current_directory(monkeypatch, tmp_path):
+    _clear(monkeypatch)
+    site_packages = tmp_path / "venv" / "lib" / "site-packages"
+    pkg = site_packages / "sessionwiki" / "__init__.py"
+    pkg.parent.mkdir(parents=True)
+    pkg.write_text("", encoding="utf-8")
+    work = tmp_path / "work"
+    work.mkdir()
+    monkeypatch.chdir(work)
+    assert _resolve_root(pkg) == work.resolve()
+
+
+@pytest.mark.parametrize("var", ["SESSIONWIKI_HOME", "LLMWIKI_HOME"])
+def test_environment_variable_wins(monkeypatch, tmp_path, var):
+    _clear(monkeypatch)
+    home = tmp_path / "my-wiki"
+    monkeypatch.setenv(var, str(home))
+    assert _resolve_root(CHECKOUT / "sessionwiki" / "__init__.py") == home.resolve()
+
+
+def test_sessionwiki_home_beats_legacy_name(monkeypatch, tmp_path):
+    monkeypatch.setenv("SESSIONWIKI_HOME", str(tmp_path / "new"))
+    monkeypatch.setenv("LLMWIKI_HOME", str(tmp_path / "old"))
+    assert _resolve_root(CHECKOUT / "sessionwiki" / "__init__.py") == (tmp_path / "new").resolve()
+
+
+def test_blank_environment_variable_is_ignored(monkeypatch, tmp_path):
+    _clear(monkeypatch)
+    monkeypatch.setenv("SESSIONWIKI_HOME", "   ")
+    assert _resolve_root(CHECKOUT / "sessionwiki" / "__init__.py") == CHECKOUT
+
+
+def test_init_from_an_installed_copy_writes_into_the_working_directory(tmp_path):
+    """End-to-end: a copy of the package outside any checkout (like
+    site-packages) must scaffold into the current directory."""
+    site_packages = tmp_path / "site-packages"
+    subprocess.run(
+        [sys.executable, "-c",
+         "import shutil, sys; shutil.copytree(sys.argv[1], sys.argv[2], "
+         "ignore=shutil.ignore_patterns('__pycache__'))",
+         str(CHECKOUT / "sessionwiki"), str(site_packages / "sessionwiki")],
+        check=True,
+    )
+    work = tmp_path / "work"
+    work.mkdir()
+    env = {k: v for k, v in os.environ.items() if k not in {"SESSIONWIKI_HOME", "LLMWIKI_HOME"}}
+    env["PYTHONPATH"] = str(site_packages)
+    env["HOME"] = str(tmp_path / "home")
+    proc = subprocess.run(
+        [sys.executable, "-m", "sessionwiki", "init"],
+        cwd=str(work), env=env, capture_output=True, text=True,
+    )
+    assert proc.returncode == 0, proc.stderr[-500:]
+    assert (work / "raw").is_dir() and (work / "wiki").is_dir()
+    assert not (site_packages / "raw").exists()
+    assert not (site_packages / "wiki").exists()