specsmith 0.3.0.dev132__py3-none-any.whl → 0.3.0.dev136__py3-none-any.whl

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/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.dist-info → specsmith-0.3.0.dev136.dist-info}/METADATA

@@ -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.dist-info → specsmith-0.3.0.dev136.dist-info}/RECORD

@@ -32,7 +32,7 @@ specsmith/scaffolder.py,sha256=brtVoRXI41i5ttgAdsPtFy74FyD0iPnHdMVt8f85MYc,16909
 specsmith/session.py,sha256=Q3yN6ldDfcEOWUiMntvgpMdc9dB6yxUe52Vbb2Fd50Y,4481
 specsmith/tools.py,sha256=IZ8gVGGgDvbrU5ErG4QoUF3eI_Z3K5A4Qhlp58nGPwU,14010
 specsmith/trace.py,sha256=XuS-miv4WHt6yCniyytjZcIvgnjZj-DRxDQMHy6eNTc,10397
-specsmith/updater.py,sha256=egv6QmYswjb8bvlYTNG71SKCHf507_9haHR1VJXCtjc,5235
+specsmith/updater.py,sha256=BWtXK47tIhmpw4zvy0UtlAoL314fZIZWbZ50FFOkBPo,6063
 specsmith/upgrader.py,sha256=Hvjowhg2leGHRQMdF0enHwvJhh8I45UFAX64YkL3jLM,12790
 specsmith/validator.py,sha256=nJDzD0a6JmShuZi0mADxNVhjN_n93Kpjj4WySbYlGco,10627
 specsmith/vcs_commands.py,sha256=xDJb6FsREPQ8waF1rq5_KMxc8P1Gh9YrIUSjCitMnAU,10245
@@ -82,7 +82,7 @@ specsmith/integrations/cursor.py,sha256=xEbdq2a8zHvbvmQmkvOWmAPFGxuTrn0V4Dkvoq3w
 specsmith/integrations/gemini.py,sha256=vmyOIJX8IYYEk7EWfBUmd8O7uo4DlPPKyqu8-ZlQpW4,1839
 specsmith/integrations/warp.py,sha256=szzCGP4RyqLGuBSHIAVuPjBrSvYmIrhA37xnqY5JhOA,3501
 specsmith/integrations/windsurf.py,sha256=dwSiYT_OrSo_SEzfXS2LvHeb5TEkSVzQ_XO15VN1SlU,1682
-specsmith/templates/agents.md.j2,sha256=oE9a7aM-7EKCjFNMXRIhdar7kvM3vK-k8_ICpasezkA,10312
+specsmith/templates/agents.md.j2,sha256=z_tDaF-WtkAdnMRvyZURj_hAdg5lxIthwPlwRprh1FE,10591
 specsmith/templates/editorconfig.j2,sha256=nFpLLwwxfwg2AIJK029bvHHE4srhzen-Wn-oORF-iyo,1651
 specsmith/templates/gitattributes.j2,sha256=WlO0yV2aBrPiVWilH7L_EcfUiD0mMfn99AevjRRwWOM,2869
 specsmith/templates/gitignore.j2,sha256=ApiF5LwezoTqm20247rnGKMu1oRKp9Tf0z8PsQcZBF8,2501
@@ -132,9 +132,9 @@ specsmith/vcs/base.py,sha256=IzyC3xtO8npaNbGZoAzgQyc9iSKleJFnp4GA0otTJfU,4098
 specsmith/vcs/bitbucket.py,sha256=U5cGqpybuPngjpu5GDM8aTZPm9bvZf1099OSBwU_Lro,5014
 specsmith/vcs/github.py,sha256=OVTLs9egmM_Smrxm4-Lo525Pi59x0PDMOOwqNNiM7lA,11995
 specsmith/vcs/gitlab.py,sha256=fDYYoDBic0KBnD_QWYf_K3GmdZOEartLXhzNXf4D4-0,5136
-specsmith-0.3.0.dev132.dist-info/licenses/LICENSE,sha256=jCLkf20ZMVU47ykbfIxw-5eukhnaeIsxSflw07hVNlY,1074
-specsmith-0.3.0.dev132.dist-info/METADATA,sha256=CSGul2Uj3rMUg8F8BtYaPPs0MyDnOF1vAxkfz_TmYNo,13512
-specsmith-0.3.0.dev132.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-specsmith-0.3.0.dev132.dist-info/entry_points.txt,sha256=X_zb8_KvBONFGgkQYKIbW1UtWd3Ck7E11l3SyHO7omA,49
-specsmith-0.3.0.dev132.dist-info/top_level.txt,sha256=wu2UpLt3wnh0TwSBmoox7kOMoGfzD6mUs22ihAcEx4E,20
-specsmith-0.3.0.dev132.dist-info/RECORD,,
+specsmith-0.3.0.dev136.dist-info/licenses/LICENSE,sha256=jCLkf20ZMVU47ykbfIxw-5eukhnaeIsxSflw07hVNlY,1074
+specsmith-0.3.0.dev136.dist-info/METADATA,sha256=1WL4iZ-FPyqziTQw-NiJTscbohO0ELhyAQm1exFY8T4,14116
+specsmith-0.3.0.dev136.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+specsmith-0.3.0.dev136.dist-info/entry_points.txt,sha256=X_zb8_KvBONFGgkQYKIbW1UtWd3Ck7E11l3SyHO7omA,49
+specsmith-0.3.0.dev136.dist-info/top_level.txt,sha256=wu2UpLt3wnh0TwSBmoox7kOMoGfzD6mUs22ihAcEx4E,20
+specsmith-0.3.0.dev136.dist-info/RECORD,,