project-kit-cli 0.5.1__tar.gz → 0.5.2__tar.gz

{project_kit_cli-0.5.1 → project_kit_cli-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: project-kit-cli
-Version: 0.5.1
+Version: 0.5.2
 Summary: Project definition and dev-workflow kit that hands off to Spec Kit
 Keywords: project-management,spec-kit,claude-code,workflow,github
 Author: Miguel Tomás
@@ -64,6 +64,12 @@ uv tool upgrade project-kit-cli      # later, to update the program
 The package is called `project-kit-cli`; the command is `pjkit`. To try it without
 installing: `uvx --from project-kit-cli pjkit help`.
 
+**`pjkit` not found, or `No pyvenv.cfg file`.** The skills and hooks call `pjkit` by name, so it
+must be on the PATH of the terminal that starts your agent. Install it with `uv tool install`
+(not inside a project's virtual environment) and run `uv tool update-shell` once. That error means
+a `python` or `pjkit` on the PATH belongs to a virtual environment that was deleted or is being
+rebuilt: recreate it, deactivate it, or take it off the PATH. `pjkit doctor` points at the cause.
+
 **Updating a project.** `init` copies the skills and templates into your repository and never
 overwrites them, so a new version of the program does not change a project that already exists.
 Run `pjkit upgrade` inside it to see what is out of date, and `pjkit upgrade --apply`

{project_kit_cli-0.5.1 → project_kit_cli-0.5.2}/README.md

@@ -46,6 +46,12 @@ uv tool upgrade project-kit-cli      # later, to update the program
 The package is called `project-kit-cli`; the command is `pjkit`. To try it without
 installing: `uvx --from project-kit-cli pjkit help`.
 
+**`pjkit` not found, or `No pyvenv.cfg file`.** The skills and hooks call `pjkit` by name, so it
+must be on the PATH of the terminal that starts your agent. Install it with `uv tool install`
+(not inside a project's virtual environment) and run `uv tool update-shell` once. That error means
+a `python` or `pjkit` on the PATH belongs to a virtual environment that was deleted or is being
+rebuilt: recreate it, deactivate it, or take it off the PATH. `pjkit doctor` points at the cause.
+
 **Updating a project.** `init` copies the skills and templates into your repository and never
 overwrites them, so a new version of the program does not change a project that already exists.
 Run `pjkit upgrade` inside it to see what is out of date, and `pjkit upgrade --apply`

{project_kit_cli-0.5.1 → project_kit_cli-0.5.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "project-kit-cli"
-version = "0.5.1"
+version = "0.5.2"
 description = "Project definition and dev-workflow kit that hands off to Spec Kit"
 readme = "README.md"
 requires-python = ">=3.12"

{project_kit_cli-0.5.1 → project_kit_cli-0.5.2}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "project-kit-cli"
-version = "0.5.1"
+version = "0.5.2"
 description = "Project definition and dev-workflow kit that hands off to Spec Kit"
 readme = "README.md"
 requires-python = ">=3.12"

{project_kit_cli-0.5.1 → project_kit_cli-0.5.2}/src/project_kit/context_files.py

@@ -95,6 +95,9 @@ def render_block(root: Path, config: Config) -> str:
         "- The user does not need to know the skills. Pick the one that fits what they ask, "
         "using the table below; when unsure, use `pk-next`. Only the user approves a phase: "
         "never run `pjkit approve` on your own.",
+        "- If `pjkit` does not start (not found, or an error such as `No pyvenv.cfg file`), stop: "
+        "do not work around it with `python` or by editing `.project-kit/` by hand. Tell the "
+        "user to run `pjkit doctor` and, if that fails too, `uv tool install project-kit-cli`.",
     ]
     lines += ["", "### Which skill for what", "", "| The user wants | Skill |", "|---|---|"]
     lines += [f"| {want} | {skill} |" for want, skill in ROUTING]

{project_kit_cli-0.5.1 → project_kit_cli-0.5.2}/src/project_kit/doctor.py

@@ -3,6 +3,7 @@
 import re
 import shutil
 import subprocess
+import sys
 from collections.abc import Callable
 from dataclasses import dataclass
 from enum import Enum
@@ -153,6 +154,59 @@ def check_glab(glab: Glab) -> list[Check]:
     return checks
 
 
+def check_pjkit(which: Which, running: str | None = None) -> Check:
+    """Skills, hooks and the status bar call ``pjkit`` by name: it has to be on PATH."""
+    found = which("pjkit")
+    if not found:
+        return Check(
+            "pjkit",
+            Status.WARN,
+            "not on PATH",
+            "Skills and hooks run `pjkit` by name. Install it with `uv tool install "
+            "project-kit-cli` and run `uv tool update-shell`, or start the agent from a "
+            "terminal where its environment is active.",
+        )
+    current = running if running is not None else sys.argv[0]
+    if Path(current).stem.lower() == "pjkit" and not _same_file(found, current):
+        return Check(
+            "pjkit",
+            Status.WARN,
+            f"PATH runs {found}, not {current}",
+            "Skills and hooks will use the one on PATH. Remove one of them or fix PATH.",
+        )
+    return Check("pjkit", Status.OK, found)
+
+
+def _same_file(a: str, b: str) -> bool:
+    try:
+        first, second = Path(a).resolve(), Path(b).resolve()  # argv[0] may lack ".exe"
+        return first.parent == second.parent and first.stem.lower() == second.stem.lower()
+    except OSError:
+        return False
+
+
+def check_python_env(which: Which) -> Check | None:
+    """A ``python`` on PATH inside a virtual environment that lost its ``pyvenv.cfg``.
+
+    Python then stops with ``No pyvenv.cfg file``, and so does every ``pjkit`` that depends on it.
+    """
+    found = which("python")
+    if not found:
+        return None
+    folder = Path(found).parent
+    env = folder.parent
+    if folder.name.lower() not in ("scripts", "bin") or (env / "pyvenv.cfg").exists():
+        return None
+    if not any((folder / a).exists() for a in ("activate", "activate.bat")):
+        return None
+    return Check(
+        "python",
+        Status.WARN,
+        f"{found} belongs to a broken virtual environment (no pyvenv.cfg)",
+        f"Recreate it (`uv sync` in its project), deactivate it, or remove {env} from PATH.",
+    )
+
+
 def check_uv(which: Which, runner: Runner) -> Check:
     if not which("uv"):
         return Check(
@@ -245,6 +299,8 @@ def run_checks(
     return [
         check_git(which, runner),
         *host_checks,
+        check_pjkit(which),
+        *filter(None, [check_python_env(which)]),
         check_uv(which, runner),
         check_speckit(which, runner, here),
         *check_agents(which, here),