specsmith 0.3.6.dev183__tar.gz → 0.3.6.dev186__tar.gz

{specsmith-0.3.6.dev183/src/specsmith.egg-info → specsmith-0.3.6.dev186}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.3.6.dev183
+Version: 0.3.6.dev186
 Summary: Applied Epistemic Engineering toolkit — AEE agent sessions, execution profiles, FPGA/HDL governance, tool installer, 50+ CLI commands.
 Author: BitConcepts
 License-Expression: MIT
@@ -224,12 +224,15 @@ The **specsmith AEE Workbench** VS Code extension is the flagship client:
 
 ## Supporting specsmith
 
-If specsmith is saving you time or helping your team ship better software, please consider:
+specsmith is open source and built by a small team. Every bit of support helps:
 
-- **[Sponsoring BitConcepts](https://github.com/sponsors/BitConcepts)** — directly funds development
-- **Starring** [specsmith](https://github.com/BitConcepts/specsmith) and [specsmith-vscode](https://github.com/BitConcepts/specsmith-vscode) on GitHub
-- **Reporting bugs** and **requesting features** via [GitHub Issues](https://github.com/BitConcepts/specsmith/issues)
-- **Contributing** — see [CONTRIBUTING.md](CONTRIBUTING.md)
+- ⭐ **Star** [specsmith](https://github.com/BitConcepts/specsmith) and [specsmith-vscode](https://github.com/BitConcepts/specsmith-vscode) on GitHub
+- 📣 **Tell your friends and colleagues** — word of mouth is our best marketing
+- 🐛 **Report bugs** via [GitHub Issues](https://github.com/BitConcepts/specsmith/issues) — even small ones help
+- 💡 **Suggest features** via [GitHub Discussions](https://github.com/BitConcepts/specsmith/discussions) — we read every suggestion
+- 🔧 **Fix bugs and contribute** — see [CONTRIBUTING.md](CONTRIBUTING.md); PRs welcome
+- 📝 **Write about specsmith** — blog posts, tutorials, and talks help the community grow
+- ❤️ **[Sponsor BitConcepts](https://github.com/sponsors/BitConcepts)** — directly funds development
 
 ---
 
@@ -344,6 +347,13 @@ Use cases: linguistics research, compliance pipelines, AI alignment, patent pros
 
 ---
 
+## The specsmith Bootstrap
+
+specsmith governs itself — the specsmith repo is a specsmith-managed project. Run `specsmith audit`
+in this repo to check its governance health. This means every feature we add to specsmith is
+immediately dogfooded on specsmith itself. The [VS Code extension](https://github.com/BitConcepts/specsmith-vscode)
+is developed alongside it as the flagship client.
+
 ## Documentation
 
 **[specsmith.readthedocs.io](https://specsmith.readthedocs.io)** — Full manual: AEE primer,

{specsmith-0.3.6.dev183 → specsmith-0.3.6.dev186}/README.md

@@ -159,12 +159,15 @@ The **specsmith AEE Workbench** VS Code extension is the flagship client:
 
 ## Supporting specsmith
 
-If specsmith is saving you time or helping your team ship better software, please consider:
+specsmith is open source and built by a small team. Every bit of support helps:
 
-- **[Sponsoring BitConcepts](https://github.com/sponsors/BitConcepts)** — directly funds development
-- **Starring** [specsmith](https://github.com/BitConcepts/specsmith) and [specsmith-vscode](https://github.com/BitConcepts/specsmith-vscode) on GitHub
-- **Reporting bugs** and **requesting features** via [GitHub Issues](https://github.com/BitConcepts/specsmith/issues)
-- **Contributing** — see [CONTRIBUTING.md](CONTRIBUTING.md)
+- ⭐ **Star** [specsmith](https://github.com/BitConcepts/specsmith) and [specsmith-vscode](https://github.com/BitConcepts/specsmith-vscode) on GitHub
+- 📣 **Tell your friends and colleagues** — word of mouth is our best marketing
+- 🐛 **Report bugs** via [GitHub Issues](https://github.com/BitConcepts/specsmith/issues) — even small ones help
+- 💡 **Suggest features** via [GitHub Discussions](https://github.com/BitConcepts/specsmith/discussions) — we read every suggestion
+- 🔧 **Fix bugs and contribute** — see [CONTRIBUTING.md](CONTRIBUTING.md); PRs welcome
+- 📝 **Write about specsmith** — blog posts, tutorials, and talks help the community grow
+- ❤️ **[Sponsor BitConcepts](https://github.com/sponsors/BitConcepts)** — directly funds development
 
 ---
 
@@ -279,6 +282,13 @@ Use cases: linguistics research, compliance pipelines, AI alignment, patent pros
 
 ---
 
+## The specsmith Bootstrap
+
+specsmith governs itself — the specsmith repo is a specsmith-managed project. Run `specsmith audit`
+in this repo to check its governance health. This means every feature we add to specsmith is
+immediately dogfooded on specsmith itself. The [VS Code extension](https://github.com/BitConcepts/specsmith-vscode)
+is developed alongside it as the flagship client.
+
 ## Documentation
 
 **[specsmith.readthedocs.io](https://specsmith.readthedocs.io)** — Full manual: AEE primer,

{specsmith-0.3.6.dev183 → specsmith-0.3.6.dev186}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specsmith"
-version = "0.3.6.dev183"
+version = "0.3.6.dev186"
 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.3.6.dev183 → specsmith-0.3.6.dev186}/src/specsmith/cli.py

@@ -64,6 +64,7 @@ class _AutoUpdateGroup(click.Group):
 
         if not skip:
             _maybe_prompt_project_update()
+            _maybe_notify_pypi_update()
 
         return super().invoke(ctx)
 
@@ -125,6 +126,47 @@ def _maybe_prompt_project_update() -> None:
         pass  # Never break the actual command on version check errors
 
 
+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.
+    """
+    import os
+
+    session_key = "SPECSMITH_PYPI_CHECKED"
+    if os.environ.get(session_key):
+        return
+    os.environ[session_key] = "1"
+
+    try:
+        import json as _json  # noqa: PLC0415
+        from urllib.request import urlopen  # noqa: PLC0415
+
+        resp = urlopen("https://pypi.org/pypi/specsmith/json", timeout=3)  # noqa: S310
+        data = _json.loads(resp.read())
+        latest = data.get("info", {}).get("version", "")
+        if not latest:
+            return
+
+        # Simple version comparison: split into tuples of ints
+        def _ver(v: str) -> tuple[int, ...]:
+            import re
+
+            clean = re.match(r"(\d+\.\d+\.\d+)", v)
+            return tuple(int(x) for x in clean.group(1).split(".")) if clean else (0,)
+
+        if _ver(latest) > _ver(__version__):
+            console.print(
+                f"  [dim]specsmith [bold]{latest}[/bold] available "
+                f"(you have {__version__}). "
+                f"Run [bold]specsmith self-update[/bold] or "
+                f"[bold]pipx upgrade specsmith[/bold].[/dim]"
+            )
+    except Exception:  # noqa: BLE001
+        pass  # Never block the CLI on network errors
+
+
 @click.group(cls=_AutoUpdateGroup)
 @click.version_option(version=__version__, prog_name="specsmith")
 def main() -> None:

{specsmith-0.3.6.dev183 → specsmith-0.3.6.dev186}/src/specsmith/upgrader.py

@@ -235,17 +235,27 @@ def _sync_full(
         except ValueError:
             pass
 
-    # 3. VCS CI configs — regenerate
+    # 3. VCS CI configs — create only if missing (never overwrite user CI)
     if config.vcs_platform:
-        try:
-            from specsmith.vcs import get_platform
-
-            platform = get_platform(config.vcs_platform)
-            files = platform.generate_all(config, root)
-            for f in files:
-                synced.append(str(f.relative_to(root)))
-        except ValueError:
-            pass
+        ci_exists = (
+            (
+                list((root / ".github" / "workflows").glob("*.yml"))
+                if (root / ".github" / "workflows").is_dir()
+                else []
+            )
+            or (root / ".gitlab-ci.yml").exists()
+            or (root / "bitbucket-pipelines.yml").exists()
+        )
+        if not ci_exists:
+            try:
+                from specsmith.vcs import get_platform
+
+                platform = get_platform(config.vcs_platform)
+                files = platform.generate_all(config, root)
+                for f in files:
+                    synced.append(str(f.relative_to(root)) + " (created)")
+            except ValueError:
+                pass
 
     # 4. Community files — create only if missing
     for tmpl_name, output_rel in _build_community_files(config):

{specsmith-0.3.6.dev183 → specsmith-0.3.6.dev186/src/specsmith.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specsmith
-Version: 0.3.6.dev183
+Version: 0.3.6.dev186
 Summary: Applied Epistemic Engineering toolkit — AEE agent sessions, execution profiles, FPGA/HDL governance, tool installer, 50+ CLI commands.
 Author: BitConcepts
 License-Expression: MIT
@@ -224,12 +224,15 @@ The **specsmith AEE Workbench** VS Code extension is the flagship client:
 
 ## Supporting specsmith
 
-If specsmith is saving you time or helping your team ship better software, please consider:
+specsmith is open source and built by a small team. Every bit of support helps:
 
-- **[Sponsoring BitConcepts](https://github.com/sponsors/BitConcepts)** — directly funds development
-- **Starring** [specsmith](https://github.com/BitConcepts/specsmith) and [specsmith-vscode](https://github.com/BitConcepts/specsmith-vscode) on GitHub
-- **Reporting bugs** and **requesting features** via [GitHub Issues](https://github.com/BitConcepts/specsmith/issues)
-- **Contributing** — see [CONTRIBUTING.md](CONTRIBUTING.md)
+- ⭐ **Star** [specsmith](https://github.com/BitConcepts/specsmith) and [specsmith-vscode](https://github.com/BitConcepts/specsmith-vscode) on GitHub
+- 📣 **Tell your friends and colleagues** — word of mouth is our best marketing
+- 🐛 **Report bugs** via [GitHub Issues](https://github.com/BitConcepts/specsmith/issues) — even small ones help
+- 💡 **Suggest features** via [GitHub Discussions](https://github.com/BitConcepts/specsmith/discussions) — we read every suggestion
+- 🔧 **Fix bugs and contribute** — see [CONTRIBUTING.md](CONTRIBUTING.md); PRs welcome
+- 📝 **Write about specsmith** — blog posts, tutorials, and talks help the community grow
+- ❤️ **[Sponsor BitConcepts](https://github.com/sponsors/BitConcepts)** — directly funds development
 
 ---
 
@@ -344,6 +347,13 @@ Use cases: linguistics research, compliance pipelines, AI alignment, patent pros
 
 ---
 
+## The specsmith Bootstrap
+
+specsmith governs itself — the specsmith repo is a specsmith-managed project. Run `specsmith audit`
+in this repo to check its governance health. This means every feature we add to specsmith is
+immediately dogfooded on specsmith itself. The [VS Code extension](https://github.com/BitConcepts/specsmith-vscode)
+is developed alongside it as the flagship client.
+
 ## Documentation
 
 **[specsmith.readthedocs.io](https://specsmith.readthedocs.io)** — Full manual: AEE primer,