specsmith 0.11.6.dev457__tar.gz → 0.11.7.dev461__tar.gz

{specsmith-0.11.6.dev457/src/specsmith.egg-info → specsmith-0.11.7.dev461}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.11.6.dev457
+Version: 0.11.7.dev461
 Summary: Applied Epistemic Engineering toolkit — AEE agent sessions, execution profiles, FPGA/HDL governance, tool installer, 50+ CLI commands.
 Author: BitConcepts
 License-Expression: MIT

{specsmith-0.11.6.dev457 → specsmith-0.11.7.dev461}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specsmith"
-version = "0.11.6.dev457"
+version = "0.11.7.dev461"
 description = "Applied Epistemic Engineering toolkit — AEE agent sessions, execution profiles, FPGA/HDL governance, tool installer, 50+ CLI commands."
 readme = "README.md"
 license = "MIT"

{specsmith-0.11.6.dev457 → specsmith-0.11.7.dev461}/src/specsmith/__init__.py

@@ -8,4 +8,4 @@ from importlib.metadata import version as _pkg_version
 try:
     __version__: str = _pkg_version("specsmith")
 except PackageNotFoundError:  # running from source without install
-    __version__ = "0.11.6"  # fallback: keep in sync with pyproject.toml
+    __version__ = "0.11.7"  # fallback: keep in sync with pyproject.toml

{specsmith-0.11.6.dev457 → specsmith-0.11.7.dev461}/src/specsmith/cli.py

@@ -97,12 +97,32 @@ class _AutoUpdateGroup(click.Group):
 
     def invoke(self, ctx: click.Context) -> object:
         import os
-
-        # Skip if explicitly disabled or if this is a meta-command
-        # ctx.protected_args is deprecated in Click 9.0; suppress the warning
-        # on access (it still works in 8.x). In 9.0 the subcommand moves to args.
         import warnings
 
+        # ── Pipx-only enforcement ─────────────────────────────────────────────
+        # specsmith MUST be installed and invoked through pipx.
+        # Any invocation from a non-pipx Python environment is rejected unless
+        # the escape hatch SPECSMITH_ALLOW_NON_PIPX=1 is set (CI / dev only).
+        if not os.environ.get("SPECSMITH_ALLOW_NON_PIPX"):
+            from specsmith.updater import is_pipx_install
+
+            if not is_pipx_install():
+                click.echo(
+                    "ERROR: specsmith must be installed and run via pipx only.\n"
+                    "  Any pip install, venv install, or editable dev install\n"
+                    "  is rejected to prevent version conflicts.\n"
+                    "\n"
+                    "  Install:      pipx install specsmith\n"
+                    "  Upgrade:      pipx upgrade specsmith\n"
+                    "  Remove other: pip uninstall specsmith\n"
+                    "\n"
+                    "  CI/testing override: set SPECSMITH_ALLOW_NON_PIPX=1",
+                    err=True,
+                )
+                raise SystemExit(1)
+
+        # ── Version checks (skip for meta-commands) ───────────────────────────
+        # ctx.protected_args is deprecated in Click 9.0; suppress the warning.
         with warnings.catch_warnings():
             warnings.simplefilter("ignore", DeprecationWarning)
             protected = list(ctx.protected_args)  # [subcommand] in 8.x, [] in 9.0
@@ -182,17 +202,53 @@ def _maybe_prompt_project_update() -> None:
 def _maybe_notify_pypi_update() -> None:
     """Check PyPI for a newer specsmith version. Prints one-liner if outdated.
 
-    Runs at most once per shell session (tracked via env var). Uses a 3-second
-    timeout to avoid blocking the CLI. Only checks stable versions.
+    Persists the last-check timestamp to ``~/.specsmith/last-update-check``
+    so the network call is only made when it has been more than
+    ``SPECSMITH_UPDATE_INTERVAL_HOURS`` hours since the previous check
+    (default: 24h).  Within that window the function returns immediately
+    without any I/O — adding zero latency to every CLI invocation.
+
+    Override the interval::
+
+        SPECSMITH_UPDATE_INTERVAL_HOURS=4 specsmith audit
+
+    Disable entirely::
+
+        SPECSMITH_NO_UPDATE_CHECK=1 specsmith audit
+
+    Uses a 3-second network timeout so a slow/offline connection never
+    blocks the user.
     """
     import os
+    import time
+    from pathlib import Path
 
+    if os.environ.get("SPECSMITH_NO_UPDATE_CHECK"):
+        return
+
+    # One check per shell session — never fire twice in the same process tree.
     session_key = "SPECSMITH_PYPI_CHECKED"
     if os.environ.get(session_key):
         return
     os.environ[session_key] = "1"
 
     try:
+        interval_h = float(os.environ.get("SPECSMITH_UPDATE_INTERVAL_HOURS", "24"))
+        interval_s = interval_h * 3600
+
+        stamp_file = Path.home() / ".specsmith" / "last-update-check"
+        now = time.time()
+
+        # Read persisted last-check time (best-effort).
+        last_check = 0.0
+        if stamp_file.is_file():
+            with contextlib.suppress(ValueError, OSError):
+                last_check = float(stamp_file.read_text(encoding="utf-8").strip())
+
+        # Not due yet — skip entirely (no network call).
+        if now - last_check < interval_s:
+            return
+
         import json as _json  # noqa: PLC0415
         from urllib.request import urlopen  # noqa: PLC0415
 
@@ -202,9 +258,16 @@ def _maybe_notify_pypi_update() -> None:
         if not latest:
             return
 
-        # Simple version comparison: split into tuples of ints
+        # Persist the timestamp now that we have a successful response.
+        try:
+            stamp_file.parent.mkdir(parents=True, exist_ok=True)
+            stamp_file.write_text(str(now), encoding="utf-8")
+        except OSError:
+            pass  # Never fail the CLI over a timestamp write error
+
+        # Simple version comparison — no packaging dep needed.
         def _ver(v: str) -> tuple[int, ...]:
-            import re
+            import re  # noqa: PLC0415
 
             clean = re.match(r"(\d+\.\d+\.\d+)", v)
             return tuple(int(x) for x in clean.group(1).split(".")) if clean else (0,)

{specsmith-0.11.6.dev457 → specsmith-0.11.7.dev461}/src/specsmith/config.py

@@ -115,7 +115,7 @@ class ProjectConfig(BaseModel):
         ),
     )
     language: str = Field(default="python", description="Primary language/runtime")
-    spec_version: str = Field(default="0.11.6", description="Spec version to scaffold from")
+    spec_version: str = Field(default="0.11.7", description="Spec version to scaffold from")
     description: str = Field(default="", description="Short project description")
 
     # Options

{specsmith-0.11.6.dev457 → specsmith-0.11.7.dev461}/src/specsmith/updater.py

@@ -66,17 +66,32 @@ def is_outdated() -> bool:
 def is_pipx_install() -> bool:
     """Return True if specsmith was installed via pipx.
 
-    Checks sys.executable path and PIPX_HOME / PIPX_LOCAL_VENVS env vars.
+    Checks sys.executable path against known pipx venv locations and the
+    PIPX_HOME / PIPX_LOCAL_VENVS env vars.  Robust on Windows where pipx
+    stores venvs in ``~/pipx/venvs/`` without setting PIPX_HOME.
     """
     import os
     import sys
+    from pathlib import Path
 
     exe = sys.executable.replace("\\", "/").lower()
-    return (
-        "pipx" in exe
-        or bool(os.environ.get("PIPX_HOME"))
-        or bool(os.environ.get("PIPX_LOCAL_VENVS"))
-    )
+
+    # 1. Executable path contains 'pipx' (catches most OS defaults)
+    if "pipx" in exe:
+        return True
+
+    # 2. Explicit pipx env vars (set by some CI / pipx versions)
+    if os.environ.get("PIPX_HOME") or os.environ.get("PIPX_LOCAL_VENVS"):
+        return True
+
+    # 3. Windows default: ~/pipx/venvs/<pkg>/Scripts/python.exe
+    win_pipx = (Path.home() / "pipx" / "venvs").as_posix().lower()
+    if exe.startswith(win_pipx):
+        return True
+
+    # 4. Linux/macOS default: ~/.local/pipx/venvs/<pkg>/bin/python
+    unix_pipx = (Path.home() / ".local" / "pipx" / "venvs").as_posix().lower()
+    return bool(exe.startswith(unix_pipx))
 
 
 def run_self_update(
@@ -123,14 +138,17 @@ def run_self_update(
 
 
 def check_project_version(root: Path) -> tuple[str, str]:
-    """Compare scaffold.yml spec_version to installed version.
+    """Compare scaffold config spec_version to installed version.
 
+    Checks ``docs/SPECSMITH.yml`` (canonical) then ``scaffold.yml`` (legacy).
     Returns (project_version, installed_version).
     """
     import yaml
 
-    scaffold_path = root / "scaffold.yml"
-    if not scaffold_path.exists():
+    from specsmith.paths import find_scaffold
+
+    scaffold_path = find_scaffold(root)
+    if scaffold_path is None:
         return "", __version__
 
     with open(scaffold_path) as f:
@@ -150,15 +168,19 @@ def needs_migration(root: Path) -> bool:
 def run_migration(root: Path, *, dry_run: bool = False) -> list[str]:
     """Migrate a project to the current specsmith version.
 
+    Checks ``docs/SPECSMITH.yml`` (canonical) then ``scaffold.yml`` (legacy).
     Returns list of actions taken (or that would be taken for dry_run).
     """
     import yaml
 
     from specsmith.ledger import add_entry
+    from specsmith.paths import find_scaffold
 
-    scaffold_path = root / "scaffold.yml"
-    if not scaffold_path.exists():
-        return ["No scaffold.yml found — nothing to migrate"]
+    scaffold_path = find_scaffold(root)
+    if scaffold_path is None:
+        return [
+            "No scaffold config found (docs/SPECSMITH.yml or scaffold.yml) — nothing to migrate"
+        ]
 
     with open(scaffold_path) as f:
         raw = yaml.safe_load(f) or {}

{specsmith-0.11.6.dev457 → specsmith-0.11.7.dev461/src/specsmith.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.11.6.dev457
+Version: 0.11.7.dev461
 Summary: Applied Epistemic Engineering toolkit — AEE agent sessions, execution profiles, FPGA/HDL governance, tool installer, 50+ CLI commands.
 Author: BitConcepts
 License-Expression: MIT

{specsmith-0.11.6.dev457 → specsmith-0.11.7.dev461}/tests/test_cli.py

@@ -113,6 +113,15 @@ class TestCLIUpgrade:
 
     def test_upgrade_to_new_version(self, tmp_path: Path) -> None:
         target = _scaffold_governed(tmp_path)
+        # Backdate spec_version so there is an actual upgrade to perform.
+        # Without this the scaffold is already at __version__ and the
+        # command would return "Already at spec version" instead.
+        scaffold_yml = target / "scaffold.yml"
+        with open(scaffold_yml) as fh:
+            data = yaml.safe_load(fh)
+        data["spec_version"] = "0.11.6"
+        with open(scaffold_yml, "w") as fh:
+            yaml.dump(data, fh, default_flow_style=False)
         runner = CliRunner()
         result = runner.invoke(
             main, ["upgrade", "--project-dir", str(target), "--spec-version", "0.11.7"]