specsmith 0.3.0.dev132__tar.gz → 0.3.0.dev136__tar.gz

{specsmith-0.3.0.dev132/src/specsmith.egg-info → specsmith-0.3.0.dev136}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.3.0.dev132
+Version: 0.3.0.dev136
 Summary: Applied Epistemic Engineering toolkit — forge epistemically-governed scaffolds, stress-test belief systems, and run AEE pipelines.
 Author: BitConcepts
 License-Expression: MIT
@@ -141,10 +141,30 @@ Every governed project follows: **propose → check → execute → verify → r
 
 ## Install
 
+**Recommended — global install via [pipx](https://pipx.pypa.io) (isolated, no dependency conflicts):**
+
+```bash
+pipx install specsmith                    # core CLI + epistemic library
+pipx inject specsmith anthropic           # + Claude support
+pipx inject specsmith openai             # + GPT / O-series support
+pipx inject specsmith google-generativeai # + Gemini support
+pipx inject specsmith PySide6            # + GUI (specsmith gui)
+```
+
+**Or with pip (into your active environment):**
+
+```bash
+pip install specsmith                # core
+pip install "specsmith[anthropic]"  # + Claude
+pip install "specsmith[openai]"     # + GPT/O-series
+pip install "specsmith[gui]"        # + GUI
+```
+
+**Update:**
+
 ```bash
-pip install specsmith             # core + epistemic library
-pip install specsmith[anthropic]  # + Claude support (specsmith run)
-pip install specsmith[openai]     # + GPT/O-series support
+pipx upgrade specsmith     # pipx install
+specsmith self-update      # pip install
 ```
 
 ## Quick Start

{specsmith-0.3.0.dev132 → specsmith-0.3.0.dev136}/README.md

@@ -76,10 +76,30 @@ Every governed project follows: **propose → check → execute → verify → r
 
 ## Install
 
+**Recommended — global install via [pipx](https://pipx.pypa.io) (isolated, no dependency conflicts):**
+
+```bash
+pipx install specsmith                    # core CLI + epistemic library
+pipx inject specsmith anthropic           # + Claude support
+pipx inject specsmith openai             # + GPT / O-series support
+pipx inject specsmith google-generativeai # + Gemini support
+pipx inject specsmith PySide6            # + GUI (specsmith gui)
+```
+
+**Or with pip (into your active environment):**
+
+```bash
+pip install specsmith                # core
+pip install "specsmith[anthropic]"  # + Claude
+pip install "specsmith[openai]"     # + GPT/O-series
+pip install "specsmith[gui]"        # + GUI
+```
+
+**Update:**
+
 ```bash
-pip install specsmith             # core + epistemic library
-pip install specsmith[anthropic]  # + Claude support (specsmith run)
-pip install specsmith[openai]     # + GPT/O-series support
+pipx upgrade specsmith     # pipx install
+specsmith self-update      # pip install
 ```
 
 ## Quick Start

{specsmith-0.3.0.dev132 → specsmith-0.3.0.dev136}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specsmith"
-version = "0.3.0.dev132"
+version = "0.3.0.dev136"
 description = "Applied Epistemic Engineering toolkit — forge epistemically-governed scaffolds, stress-test belief systems, and run AEE pipelines."
 readme = "README.md"
 license = "MIT"
@@ -105,5 +105,20 @@ warn_unused_configs = true
 # environment. Exclude it from type-checking to avoid false positives.
 exclude = ["src/specsmith/gui"]
 
+# Optional extras — installed by the user, not in the dev environment.
+# Ignore missing stubs rather than failing type-check for absent packages.
+[[tool.mypy.overrides]]
+module = [
+    "anthropic",
+    "anthropic.*",
+    "openai",
+    "openai.*",
+    "google.generativeai",
+    "google.generativeai.*",
+    "keyring",
+    "keyring.*",
+]
+ignore_missing_imports = true
+
 [tool.pytest.ini_options]
 testpaths = ["tests"]

{specsmith-0.3.0.dev132 → specsmith-0.3.0.dev136}/src/specsmith/templates/agents.md.j2

@@ -215,3 +215,16 @@ Stop condition (H13): P1 requirement with confidence below MEDIUM = work stops.
 | `pr`           | `specsmith pr` (create PR with governance)     |
 | `update`       | `specsmith update` (check + install + migrate) |
 | `session-end`  | `specsmith session-end` (end checklist)        |
+
+**specsmith install / update:**
+
+```bash
+# Recommended — global isolated install
+pipx install specsmith
+pipx inject specsmith anthropic openai  # add LLM providers
+pipx upgrade specsmith                  # update
+
+# Or with pip
+pip install specsmith
+specsmith self-update
+```

{specsmith-0.3.0.dev132 → specsmith-0.3.0.dev136}/src/specsmith/updater.py

@@ -60,24 +60,50 @@ def is_outdated() -> bool:
     return current != latest
 
 
+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.
+    """
+    import os
+    import sys
+
+    exe = sys.executable.replace("\\", "/").lower()
+    return (
+        "pipx" in exe
+        or bool(os.environ.get("PIPX_HOME"))
+        or bool(os.environ.get("PIPX_LOCAL_VENVS"))
+    )
+
+
 def run_self_update(
     *,
     channel: str = "",
     target_version: str = "",
 ) -> tuple[bool, str]:
-    """Update specsmith via pip.
+    """Update specsmith.
+
+    Detects whether running under pipx and uses the appropriate command:
+      - pipx: ``pipx upgrade specsmith`` (or ``pipx install specsmith==X.Y.Z``)
+      - pip: ``pip install --upgrade specsmith``
 
     If target_version is set, installs that exact version.
     Otherwise uses --pre flag for dev channel, plain upgrade for stable.
     """
-    if target_version:
-        cmd = ["pip", "install", f"specsmith=={target_version}"]
+    if is_pipx_install():
+        if target_version:
+            cmd = ["pipx", "install", f"specsmith=={target_version}", "--force"]
+        else:
+            cmd = ["pipx", "upgrade", "specsmith"]
     else:
-        if not channel:
-            channel = get_update_channel()
-        cmd = ["pip", "install", "--upgrade", "specsmith"]
-        if channel == "dev":
-            cmd.insert(2, "--pre")
+        if target_version:
+            cmd = ["pip", "install", f"specsmith=={target_version}"]
+        else:
+            if not channel:
+                channel = get_update_channel()
+            cmd = ["pip", "install", "--upgrade", "specsmith"]
+            if channel == "dev":
+                cmd.insert(2, "--pre")
 
     try:
         result = subprocess.run(

{specsmith-0.3.0.dev132 → specsmith-0.3.0.dev136/src/specsmith.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.3.0.dev132
+Version: 0.3.0.dev136
 Summary: Applied Epistemic Engineering toolkit — forge epistemically-governed scaffolds, stress-test belief systems, and run AEE pipelines.
 Author: BitConcepts
 License-Expression: MIT
@@ -141,10 +141,30 @@ Every governed project follows: **propose → check → execute → verify → r
 
 ## Install
 
+**Recommended — global install via [pipx](https://pipx.pypa.io) (isolated, no dependency conflicts):**
+
+```bash
+pipx install specsmith                    # core CLI + epistemic library
+pipx inject specsmith anthropic           # + Claude support
+pipx inject specsmith openai             # + GPT / O-series support
+pipx inject specsmith google-generativeai # + Gemini support
+pipx inject specsmith PySide6            # + GUI (specsmith gui)
+```
+
+**Or with pip (into your active environment):**
+
+```bash
+pip install specsmith                # core
+pip install "specsmith[anthropic]"  # + Claude
+pip install "specsmith[openai]"     # + GPT/O-series
+pip install "specsmith[gui]"        # + GUI
+```
+
+**Update:**
+
 ```bash
-pip install specsmith             # core + epistemic library
-pip install specsmith[anthropic]  # + Claude support (specsmith run)
-pip install specsmith[openai]     # + GPT/O-series support
+pipx upgrade specsmith     # pipx install
+specsmith self-update      # pip install
 ```
 
 ## Quick Start