sessionwiki 2.0.0__tar.gz → 2.0.1__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sessionwiki
-Version: 2.0.0
+Version: 2.0.1
 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
@@ -63,7 +63,7 @@ Dynamic: license-file
 
 [![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.1-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 +137,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
-pip install 'sessionwiki @ git+https://github.com/necroz/sessionwiki'          # core
-pip install 'sessionwiki[all] @ git+https://github.com/necroz/sessionwiki'     # + graph engine, dev, e2e
+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
+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).

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

@@ -4,7 +4,7 @@
 
 [![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.1-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 +78,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
-pip install 'sessionwiki @ git+https://github.com/necroz/sessionwiki'          # core
-pip install 'sessionwiki[all] @ git+https://github.com/necroz/sessionwiki'     # + graph engine, dev, e2e
+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
+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).

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

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

@@ -15,14 +15,38 @@ Public API:
     - sessionwiki.mcp.server.main()       — MCP server (stdio)
 """
 
-__version__ = "2.0.0"
+__version__ = "2.0.1"
 __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.1}/sessionwiki/cli.py

@@ -1111,7 +1111,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__}")
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sessionwiki
-Version: 2.0.0
+Version: 2.0.1
 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
@@ -63,7 +63,7 @@ Dynamic: license-file
 
 [![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.1-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 +137,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
-pip install 'sessionwiki @ git+https://github.com/necroz/sessionwiki'          # core
-pip install 'sessionwiki[all] @ git+https://github.com/necroz/sessionwiki'     # + graph engine, dev, e2e
+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
+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).

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

@@ -183,7 +183,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 +229,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.1}/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.1/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()

sessionwiki-2.0.0/tests/test_homebrew_tap.py

@@ -1,209 +0,0 @@
-"""Tests for the Homebrew tap kit (v1.1.0 · #102).
-
-The formula gets copied into a separate `homebrew-tap` repo that the
-maintainer owns — we can't reach that from CI. What we CAN test:
-
-- The formula in this repo stays syntactically + semantically sound.
-- The bump script is executable and enforces its input contract.
-- The auto-bump workflow stays aligned with the bump script + docs.
-- The setup doc documents every user-facing command it mentions.
-"""
-
-from __future__ import annotations
-
-import os
-import re
-import subprocess
-from pathlib import Path
-
-import pytest
-
-from sessionwiki import REPO_ROOT
-
-
-FORMULA = REPO_ROOT / "homebrew" / "sessionwiki.rb"
-BUMP_SCRIPT = REPO_ROOT / "scripts" / "bump-homebrew-formula.sh"
-WORKFLOW = REPO_ROOT / ".github" / "workflows" / "homebrew-bump.yml"
-DOC = REPO_ROOT / "docs" / "deploy" / "homebrew-setup.md"
-
-
-@pytest.fixture(scope="module")
-def formula() -> str:
-    return FORMULA.read_text(encoding="utf-8")
-
-
-@pytest.fixture(scope="module")
-def bump_script() -> str:
-    return BUMP_SCRIPT.read_text(encoding="utf-8")
-
-
-@pytest.fixture(scope="module")
-def workflow() -> str:
-    return WORKFLOW.read_text(encoding="utf-8")
-
-
-@pytest.fixture(scope="module")
-def doc() -> str:
-    return DOC.read_text(encoding="utf-8")
-
-
-# ─── Formula shape ────────────────────────────────────────────────────
-
-
-def test_formula_class_name_matches_filename(formula: str):
-    # Homebrew derives the Ruby class name from the formula's filename.
-    # `sessionwiki.rb` → `class Sessionwiki`.
-    assert re.search(r"^class Sessionwiki < Formula", formula, re.MULTILINE), (
-        "formula class must be `Sessionwiki` (camelcase of the filename)"
-    )
-
-
-def test_formula_has_required_fields(formula: str):
-    for field in ("desc ", "homepage ", "url ", "sha256 ", "license "):
-        assert field in formula, f"formula missing `{field.strip()}`"
-
-
-def test_formula_url_points_at_llm_wiki_release_tarball(formula: str):
-    m = re.search(r'^  url "([^"]+)"', formula, re.MULTILINE)
-    assert m, "formula has no url line"
-    url = m.group(1)
-    assert url.startswith(
-        "https://github.com/necroz/sessionwiki/archive/refs/tags/v"
-    ), f"unexpected url {url!r}; bump-homebrew-formula.sh rewrites this"
-    assert url.endswith(".tar.gz"), "formula url must be the .tar.gz archive"
-
-
-def test_formula_sha_is_64_hex_or_placeholder(formula: str):
-    m = re.search(r'^  sha256 "([^"]+)"', formula, re.MULTILINE)
-    assert m, "formula has no sha256 line"
-    sha = m.group(1)
-    # Two acceptable states: real 64-hex digest (after bump) or the
-    # documented placeholder (before a tag ships).
-    assert re.fullmatch(r"[0-9a-f]{64}", sha) or "PLACEHOLDER" in sha, (
-        f"sha256 value {sha!r} is neither a 64-hex digest nor the "
-        "documented PLACEHOLDER — check the bump script output"
-    )
-
-
-def test_formula_test_block_runs_sessionwiki_commands(formula: str):
-    # Homebrew runs the `test do ... end` block on install. We exercise
-    # the subcommands that matter to users — `--version` and `adapters`.
-    assert 'system bin/"sessionwiki", "--version"' in formula
-    assert 'system bin/"sessionwiki", "adapters"' in formula
-
-
-def test_formula_depends_on_python_312(formula: str):
-    assert 'depends_on "python@3.12"' in formula
-
-
-# ─── Bump script ──────────────────────────────────────────────────────
-
-
-def test_bump_script_is_executable():
-    assert BUMP_SCRIPT.is_file()
-    assert os.access(BUMP_SCRIPT, os.X_OK), (
-        "scripts/bump-homebrew-formula.sh must be executable; "
-        "run `chmod +x scripts/bump-homebrew-formula.sh`"
-    )
-
-
-def test_bump_script_rejects_missing_argument(tmp_path: Path):
-    result = subprocess.run(
-        [str(BUMP_SCRIPT)],
-        capture_output=True, text=True, cwd=str(REPO_ROOT),
-    )
-    assert result.returncode != 0
-    assert "usage" in result.stderr.lower()
-
-
-def test_bump_script_rejects_non_semver_tag(tmp_path: Path):
-    result = subprocess.run(
-        [str(BUMP_SCRIPT), "not-a-version"],
-        capture_output=True, text=True, cwd=str(REPO_ROOT),
-    )
-    assert result.returncode != 0
-    assert "semver" in result.stderr.lower()
-
-
-def test_bump_script_uses_right_tarball_url(bump_script: str):
-    # Must match the URL pattern the formula test guards.
-    assert (
-        "https://github.com/necroz/sessionwiki/archive/refs/tags/${tag}.tar.gz"
-        in bump_script
-    )
-
-
-def test_bump_script_handles_macos_and_linux_sed(bump_script: str):
-    # macOS/BSD sed needs `-i ''`, GNU sed needs `-i` without the arg.
-    # Both branches must exist so the script runs on devs' machines
-    # (macOS) and CI (Linux).
-    assert "Darwin" in bump_script
-    assert "sed -i ''" in bump_script
-    assert re.search(r"sed -i -E", bump_script)
-
-
-# ─── Auto-bump workflow ───────────────────────────────────────────────
-
-
-def test_workflow_triggers_on_version_tags(workflow: str):
-    assert 'tags:' in workflow
-    assert '"v*.*.*"' in workflow or "'v*.*.*'" in workflow
-
-
-def test_workflow_supports_manual_dispatch(workflow: str):
-    assert "workflow_dispatch:" in workflow
-
-
-def test_workflow_calls_bump_script(workflow: str):
-    assert "scripts/bump-homebrew-formula.sh" in workflow
-
-
-def test_workflow_gracefully_handles_missing_secret(workflow: str):
-    # When HOMEBREW_TAP_TOKEN isn't set, the job must still succeed —
-    # otherwise every release tag turns the workflow red.
-    assert "has_token" in workflow
-    assert "HOMEBREW_TAP_TOKEN" in workflow
-    # Conditional push step
-    assert "if: steps.check_token.outputs.has_token == 'true'" in workflow
-
-
-def test_workflow_targets_homebrew_tap_repo(workflow: str):
-    assert "necroz/homebrew-tap" in workflow
-
-
-# ─── Setup doc ────────────────────────────────────────────────────────
-
-
-def test_doc_covers_tap_repo_creation(doc: str):
-    # Must mention the literal repo name and the `homebrew-` prefix rule.
-    assert "homebrew-tap" in doc
-    # The prefix is load-bearing: Homebrew requires the repo name to
-    # start with `homebrew-` for `brew tap` to accept it.
-    assert re.search(
-        r"start with.*homebrew-|name.*must.*homebrew-|homebrew-.*must",
-        doc,
-        re.IGNORECASE,
-    ), "doc should flag that the tap repo name must start with `homebrew-`"
-
-
-def test_doc_covers_on_every_release_flow(doc: str):
-    assert "On every new release" in doc
-    assert "bump-homebrew-formula.sh" in doc
-
-
-def test_doc_covers_auto_bump_optional_path(doc: str):
-    assert "HOMEBREW_TAP_TOKEN" in doc
-    assert "gh secret set" in doc
-
-
-def test_doc_covers_troubleshooting(doc: str):
-    assert "Troubleshooting" in doc
-    # Three documented failure modes
-    for k in ("404", "brew test", "class name"):
-        assert k in doc, f"doc missing troubleshooting section for {k!r}"
-
-
-def test_doc_cross_links_pypi_sibling(doc: str):
-    # Both deploy docs should cross-reference each other so users
-    # discover the PyPI path from the Homebrew doc and vice versa.
-    assert "docs/deploy/pypi-publishing.md" in doc or "pypi-publishing" in doc