wxcc-toolkit 0.3.2__tar.gz → 0.3.4__tar.gz

{wxcc_toolkit-0.3.2/src/wxcc_toolkit.egg-info → wxcc_toolkit-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wxcc-toolkit
-Version: 0.3.2
+Version: 0.3.4
 Summary: WxCC AI Agent Builder Toolkit — a Claude Code playbook (agent, skills, rules, docs) plus the wxcc-flow Flow Designer CLI, delivered via pip
 License-Expression: Apache-2.0
 Requires-Python: >=3.9
@@ -34,17 +34,26 @@ This installs two console commands (aliases of the same CLI): `wxcc-toolkit` and
 wxcc-toolkit init my-wxcc-project
 ```
 
-This materializes the playbook into `my-wxcc-project/`:
+This materializes **both** the Claude Code and Codex CLI profiles into
+`my-wxcc-project/` by default (pass `--claude-only` or `--codex-only` to
+install just one — see "Using with OpenAI Codex CLI" below):
 
 ```
 my-wxcc-project/
 ├── CLAUDE.md                  # project instructions Claude Code loads at session start
-├── .mcp.json                  # MCP server config (optional — see "Configure MCP servers" below)
+├── AGENTS.md                  # project instructions Codex CLI loads
+├── .mcp.json                  # Claude MCP server config (optional — see "Configure MCP servers" below)
 ├── .claude/
 │   ├── settings.json          # pre-approved Skills, MCP tools, and wxcc-flow CLI
 │   ├── agents/                # the wxcc-agent-builder agent
 │   ├── skills/                # 14 build/design skills
 │   └── rules/                 # platform-accuracy doc-lookup rules
+├── .codex/
+│   ├── config.toml            # approval policy, sandbox mode, MCP servers
+│   ├── agents/                # per-agent Codex config
+│   └── docs/                  # CLI command reference, doc-lookup rules
+├── .agents/
+│   └── skills/                # the same 14 skills, in Codex's skill format
 └── docs/
     ├── reference/             # platform knowledge (Flow Designer, Connect, AI Agent Studio, …)
     ├── playbooks/             # step-by-step platform guides
@@ -52,10 +61,11 @@ my-wxcc-project/
     └── examples/              # working FlowIR / config examples
 ```
 
-`init` writes a manifest (`.claude/.wxcc-manifest.json`) recording every file it
-owns. It never overwrites files you create. If the target folder already contains
-files the playbook would overwrite, `init` stops and lists them — re-run with
-`--force` to overwrite, or pick an empty folder.
+`init` writes a manifest per installed profile (`.claude/.wxcc-manifest.json`
+and/or `.codex/.wxcc-manifest.json`) recording every file it owns. It never
+overwrites files you create. If the target folder already contains files the
+playbook would overwrite, `init` stops and lists them — re-run with `--force`
+to overwrite, or pick an empty folder.
 
 ## Configure the `wxcc-flow` CLI (recommended)
 
@@ -146,6 +156,20 @@ The Codex profile is generated from the Claude profile at build time — the
 two never drift. Codex has no per-command allowlist, so expect an approval
 prompt when a command needs to run outside the workspace sandbox.
 
+## Staying up to date
+
+`pip` never upgrades on its own, so `wxcc-flow` checks PyPI once a day (a
+best-effort call with a 1-second timeout, cached in `~/.wxcc-flow/`) and, when a
+newer release exists, prints one line to stderr before the command runs:
+
+> wxcc-flow 0.3.4 available (you have 0.3.3). Upgrade: pip install -U wxcc-toolkit && wxcc-flow init
+
+Both steps matter: `pip install -U wxcc-toolkit` updates the CLI, and
+`wxcc-flow init` (see below) refreshes the playbook files in your project folder.
+The check never blocks a command and stays silent on any network error. Silence
+it with the `--no-update-check` flag, by setting `WXCC_FLOW_NO_UPDATE_CHECK=1`,
+or in CI (it is skipped automatically when `CI` is set).
+
 ## Update an existing project folder
 
 After upgrading the package (`pip install --upgrade wxcc-toolkit`), refresh a

{wxcc_toolkit-0.3.2 → wxcc_toolkit-0.3.4}/README.md

@@ -21,17 +21,26 @@ This installs two console commands (aliases of the same CLI): `wxcc-toolkit` and
 wxcc-toolkit init my-wxcc-project
 ```
 
-This materializes the playbook into `my-wxcc-project/`:
+This materializes **both** the Claude Code and Codex CLI profiles into
+`my-wxcc-project/` by default (pass `--claude-only` or `--codex-only` to
+install just one — see "Using with OpenAI Codex CLI" below):
 
 ```
 my-wxcc-project/
 ├── CLAUDE.md                  # project instructions Claude Code loads at session start
-├── .mcp.json                  # MCP server config (optional — see "Configure MCP servers" below)
+├── AGENTS.md                  # project instructions Codex CLI loads
+├── .mcp.json                  # Claude MCP server config (optional — see "Configure MCP servers" below)
 ├── .claude/
 │   ├── settings.json          # pre-approved Skills, MCP tools, and wxcc-flow CLI
 │   ├── agents/                # the wxcc-agent-builder agent
 │   ├── skills/                # 14 build/design skills
 │   └── rules/                 # platform-accuracy doc-lookup rules
+├── .codex/
+│   ├── config.toml            # approval policy, sandbox mode, MCP servers
+│   ├── agents/                # per-agent Codex config
+│   └── docs/                  # CLI command reference, doc-lookup rules
+├── .agents/
+│   └── skills/                # the same 14 skills, in Codex's skill format
 └── docs/
     ├── reference/             # platform knowledge (Flow Designer, Connect, AI Agent Studio, …)
     ├── playbooks/             # step-by-step platform guides
@@ -39,10 +48,11 @@ my-wxcc-project/
     └── examples/              # working FlowIR / config examples
 ```
 
-`init` writes a manifest (`.claude/.wxcc-manifest.json`) recording every file it
-owns. It never overwrites files you create. If the target folder already contains
-files the playbook would overwrite, `init` stops and lists them — re-run with
-`--force` to overwrite, or pick an empty folder.
+`init` writes a manifest per installed profile (`.claude/.wxcc-manifest.json`
+and/or `.codex/.wxcc-manifest.json`) recording every file it owns. It never
+overwrites files you create. If the target folder already contains files the
+playbook would overwrite, `init` stops and lists them — re-run with `--force`
+to overwrite, or pick an empty folder.
 
 ## Configure the `wxcc-flow` CLI (recommended)
 
@@ -133,6 +143,20 @@ The Codex profile is generated from the Claude profile at build time — the
 two never drift. Codex has no per-command allowlist, so expect an approval
 prompt when a command needs to run outside the workspace sandbox.
 
+## Staying up to date
+
+`pip` never upgrades on its own, so `wxcc-flow` checks PyPI once a day (a
+best-effort call with a 1-second timeout, cached in `~/.wxcc-flow/`) and, when a
+newer release exists, prints one line to stderr before the command runs:
+
+> wxcc-flow 0.3.4 available (you have 0.3.3). Upgrade: pip install -U wxcc-toolkit && wxcc-flow init
+
+Both steps matter: `pip install -U wxcc-toolkit` updates the CLI, and
+`wxcc-flow init` (see below) refreshes the playbook files in your project folder.
+The check never blocks a command and stays silent on any network error. Silence
+it with the `--no-update-check` flag, by setting `WXCC_FLOW_NO_UPDATE_CHECK=1`,
+or in CI (it is skipped automatically when `CI` is set).
+
 ## Update an existing project folder
 
 After upgrading the package (`pip install --upgrade wxcc-toolkit`), refresh a

{wxcc_toolkit-0.3.2 → wxcc_toolkit-0.3.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "wxcc-toolkit"
-version = "0.3.2"
+version = "0.3.4"
 description = "WxCC AI Agent Builder Toolkit — a Claude Code playbook (agent, skills, rules, docs) plus the wxcc-flow Flow Designer CLI, delivered via pip"
 readme = "README.md"
 license = "Apache-2.0"

wxcc_toolkit-0.3.4/src/wxcc_flow/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.3.4"

{wxcc_toolkit-0.3.2 → wxcc_toolkit-0.3.4}/src/wxcc_flow/main.py

@@ -41,8 +41,17 @@ def version_callback(value: bool):
 @app.callback()
 def main(
     version: bool = typer.Option(False, "--version", callback=version_callback, is_eager=True),
+    no_update_check: bool = typer.Option(
+        False, "--no-update-check",
+        help="Skip the once-a-day PyPI update check for this run.",
+    ),
 ):
-    pass
+    # Best-effort upgrade nudge; never let it break a real command.
+    try:
+        from wxcc_flow.update_check import maybe_notify_update
+        maybe_notify_update(__version__, disabled=no_update_check)
+    except Exception:
+        pass
 
 
 # ── Configure ────────────────────────────────────────────────────────

wxcc_toolkit-0.3.4/src/wxcc_flow/update_check.py

@@ -0,0 +1,135 @@
+"""Best-effort PyPI update check for the wxcc-flow CLI.
+
+Runs once per invocation from the top-level Typer callback. It must NEVER
+block or break a real command, so every path here is defensive:
+
+* a short (1s) network timeout,
+* a 24h on-disk cache next to the config (``~/.wxcc-flow/update-check.json``),
+* every exception (no network, PyPI outage, bad JSON, unwritable cache)
+  swallowed — a failure prints nothing and returns ``None``.
+
+The notice is printed to stderr so it never corrupts ``-o json`` output on
+stdout. It is silenced by ``--no-update-check``, by ``WXCC_FLOW_NO_UPDATE_CHECK``,
+and under ``CI`` (so pipelines and the test suite stay hermetic).
+"""
+import json
+import os
+import re
+import sys
+import time
+from pathlib import Path
+
+import httpx
+
+PACKAGE_NAME = "wxcc-toolkit"
+PYPI_JSON_URL = f"https://pypi.org/pypi/{PACKAGE_NAME}/json"
+CACHE_PATH = Path.home() / ".wxcc-flow" / "update-check.json"
+CACHE_TTL_SECONDS = 24 * 60 * 60  # re-check PyPI at most once a day
+REQUEST_TIMEOUT_SECONDS = 1.0
+ENV_DISABLE = "WXCC_FLOW_NO_UPDATE_CHECK"
+
+_LEADING_NUMERIC = re.compile(r"(\d+(?:\.\d+)*)")
+
+
+def _parse_version(text):
+    """Leading numeric components of a version as an int tuple.
+
+    ``'0.3.10'`` -> ``(0, 3, 10)``; ``'0.4.0rc1'`` -> ``(0, 4, 0)``;
+    ``''`` / unparseable -> ``()``. Dependency-free so we don't pull in
+    ``packaging`` (not a declared runtime dep).
+    """
+    if not text:
+        return ()
+    m = _LEADING_NUMERIC.match(text.strip())
+    if not m:
+        return ()
+    return tuple(int(p) for p in m.group(1).split("."))
+
+
+def _is_newer(latest, current):
+    """True iff ``latest`` is a strictly newer release than ``current``."""
+    lt, ct = _parse_version(latest), _parse_version(current)
+    if not lt:
+        return False
+    width = max(len(lt), len(ct))
+    lt = lt + (0,) * (width - len(lt))
+    ct = ct + (0,) * (width - len(ct))
+    return lt > ct
+
+
+def _env_truthy(name):
+    val = os.environ.get(name, "").strip().lower()
+    return bool(val) and val not in ("0", "false", "no", "off")
+
+
+def _read_cache(path):
+    try:
+        with open(path, encoding="utf-8") as f:
+            return json.load(f)
+    except Exception:
+        return None
+
+
+def _write_cache(path, latest, now):
+    try:
+        path.parent.mkdir(parents=True, exist_ok=True)
+        with open(path, "w", encoding="utf-8") as f:
+            json.dump({"pkg": PACKAGE_NAME, "latest": latest, "last_check": now}, f)
+    except Exception:
+        pass
+
+
+def _fetch_latest(timeout):
+    resp = httpx.get(PYPI_JSON_URL, timeout=timeout)
+    resp.raise_for_status()
+    return resp.json()["info"]["version"]
+
+
+def check_for_update(current_version, *, now=None, cache_path=CACHE_PATH,
+                     ttl=CACHE_TTL_SECONDS, timeout=REQUEST_TIMEOUT_SECONDS,
+                     force=False):
+    """Return the latest PyPI version string if newer than ``current_version``.
+
+    Returns ``None`` when already up to date OR on any failure. Only hits PyPI
+    when the cache is missing/stale or ``force=True``; a fresh cache answers
+    offline.
+    """
+    try:
+        if now is None:
+            now = time.time()
+        latest = None
+        cache = _read_cache(cache_path)
+        if (not force and cache
+                and isinstance(cache.get("last_check"), (int, float))
+                and now - cache["last_check"] < ttl):
+            latest = cache.get("latest")
+        if latest is None:
+            latest = _fetch_latest(timeout)
+            _write_cache(cache_path, latest, now)
+        if latest and _is_newer(latest, current_version):
+            return latest
+        return None
+    except Exception:
+        return None
+
+
+def maybe_notify_update(current_version, *, disabled=False, stream=None, **kwargs):
+    """Print a one-line upgrade notice to stderr if a newer release exists.
+
+    Silent when disabled (flag, ``WXCC_FLOW_NO_UPDATE_CHECK``, or ``CI``) and
+    silent on any failure. Returns the latest version if a notice was printed,
+    else ``None``. Extra kwargs pass through to :func:`check_for_update`.
+    """
+    if disabled or _env_truthy(ENV_DISABLE) or _env_truthy("CI"):
+        return None
+    latest = check_for_update(current_version, **kwargs)
+    if not latest:
+        return None
+    try:
+        (stream or sys.stderr).write(
+            f"wxcc-flow {latest} available (you have {current_version}). "
+            f"Upgrade: pip install -U {PACKAGE_NAME} && wxcc-flow init\n"
+        )
+    except Exception:
+        return None
+    return latest

{wxcc_toolkit-0.3.2 → wxcc_toolkit-0.3.4/src/wxcc_toolkit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wxcc-toolkit
-Version: 0.3.2
+Version: 0.3.4
 Summary: WxCC AI Agent Builder Toolkit — a Claude Code playbook (agent, skills, rules, docs) plus the wxcc-flow Flow Designer CLI, delivered via pip
 License-Expression: Apache-2.0
 Requires-Python: >=3.9
@@ -34,17 +34,26 @@ This installs two console commands (aliases of the same CLI): `wxcc-toolkit` and
 wxcc-toolkit init my-wxcc-project
 ```
 
-This materializes the playbook into `my-wxcc-project/`:
+This materializes **both** the Claude Code and Codex CLI profiles into
+`my-wxcc-project/` by default (pass `--claude-only` or `--codex-only` to
+install just one — see "Using with OpenAI Codex CLI" below):
 
 ```
 my-wxcc-project/
 ├── CLAUDE.md                  # project instructions Claude Code loads at session start
-├── .mcp.json                  # MCP server config (optional — see "Configure MCP servers" below)
+├── AGENTS.md                  # project instructions Codex CLI loads
+├── .mcp.json                  # Claude MCP server config (optional — see "Configure MCP servers" below)
 ├── .claude/
 │   ├── settings.json          # pre-approved Skills, MCP tools, and wxcc-flow CLI
 │   ├── agents/                # the wxcc-agent-builder agent
 │   ├── skills/                # 14 build/design skills
 │   └── rules/                 # platform-accuracy doc-lookup rules
+├── .codex/
+│   ├── config.toml            # approval policy, sandbox mode, MCP servers
+│   ├── agents/                # per-agent Codex config
+│   └── docs/                  # CLI command reference, doc-lookup rules
+├── .agents/
+│   └── skills/                # the same 14 skills, in Codex's skill format
 └── docs/
     ├── reference/             # platform knowledge (Flow Designer, Connect, AI Agent Studio, …)
     ├── playbooks/             # step-by-step platform guides
@@ -52,10 +61,11 @@ my-wxcc-project/
     └── examples/              # working FlowIR / config examples
 ```
 
-`init` writes a manifest (`.claude/.wxcc-manifest.json`) recording every file it
-owns. It never overwrites files you create. If the target folder already contains
-files the playbook would overwrite, `init` stops and lists them — re-run with
-`--force` to overwrite, or pick an empty folder.
+`init` writes a manifest per installed profile (`.claude/.wxcc-manifest.json`
+and/or `.codex/.wxcc-manifest.json`) recording every file it owns. It never
+overwrites files you create. If the target folder already contains files the
+playbook would overwrite, `init` stops and lists them — re-run with `--force`
+to overwrite, or pick an empty folder.
 
 ## Configure the `wxcc-flow` CLI (recommended)
 
@@ -146,6 +156,20 @@ The Codex profile is generated from the Claude profile at build time — the
 two never drift. Codex has no per-command allowlist, so expect an approval
 prompt when a command needs to run outside the workspace sandbox.
 
+## Staying up to date
+
+`pip` never upgrades on its own, so `wxcc-flow` checks PyPI once a day (a
+best-effort call with a 1-second timeout, cached in `~/.wxcc-flow/`) and, when a
+newer release exists, prints one line to stderr before the command runs:
+
+> wxcc-flow 0.3.4 available (you have 0.3.3). Upgrade: pip install -U wxcc-toolkit && wxcc-flow init
+
+Both steps matter: `pip install -U wxcc-toolkit` updates the CLI, and
+`wxcc-flow init` (see below) refreshes the playbook files in your project folder.
+The check never blocks a command and stays silent on any network error. Silence
+it with the `--no-update-check` flag, by setting `WXCC_FLOW_NO_UPDATE_CHECK=1`,
+or in CI (it is skipped automatically when `CI` is set).
+
 ## Update an existing project folder
 
 After upgrading the package (`pip install --upgrade wxcc-toolkit`), refresh a

{wxcc_toolkit-0.3.2 → wxcc_toolkit-0.3.4}/src/wxcc_toolkit.egg-info/SOURCES.txt

@@ -8,6 +8,7 @@ src/wxcc_flow/config.py
 src/wxcc_flow/init_playbook.py
 src/wxcc_flow/main.py
 src/wxcc_flow/output.py
+src/wxcc_flow/update_check.py
 src/wxcc_flow/_playbook/.mcp.json
 src/wxcc_flow/_playbook/AGENTS.md
 src/wxcc_flow/_playbook/CLAUDE.md
@@ -237,4 +238,5 @@ tests/test_init_playbook.py
 tests/test_live_mutation.py
 tests/test_live_readonly.py
 tests/test_release_integrity.py
-tests/test_spec_diff.py
+tests/test_spec_diff.py
+tests/test_update_check.py

wxcc_toolkit-0.3.4/tests/test_update_check.py

@@ -0,0 +1,178 @@
+"""Tests for the best-effort PyPI update check (wxcc_flow.update_check).
+
+Fully hermetic: every test mocks httpx and points the cache at tmp_path, so
+nothing here reaches the network. The conftest disables the check session-wide;
+the autouse fixture below re-enables it for this module's tests.
+"""
+import json
+
+import httpx
+import pytest
+from typer.testing import CliRunner
+
+import wxcc_flow.update_check as uc
+from wxcc_flow import __version__
+from wxcc_flow.main import app
+
+runner = CliRunner()
+
+
+class _FakeResp:
+    def __init__(self, payload):
+        self._payload = payload
+
+    def raise_for_status(self):
+        return None
+
+    def json(self):
+        return self._payload
+
+
+def _fake_get(version):
+    def _get(url, timeout=None):
+        assert "wxcc-toolkit" in url
+        return _FakeResp({"info": {"version": version}})
+    return _get
+
+
+@pytest.fixture(autouse=True)
+def _enable_checks(monkeypatch):
+    """Undo the conftest session-wide disable so these tests hit the enabled
+    path; the gate tests re-set the env in their own body."""
+    monkeypatch.delenv(uc.ENV_DISABLE, raising=False)
+    monkeypatch.delenv("CI", raising=False)
+
+
+# ------------------------------------------------------------ version compare
+@pytest.mark.parametrize("latest,current,expected", [
+    ("0.3.4", "0.3.3", True),
+    ("0.3.10", "0.3.3", True),      # numeric, not string, comparison
+    ("0.10.0", "0.9.9", True),
+    ("1.0.0", "0.99.99", True),
+    ("0.3.3", "0.3.3", False),
+    ("0.3.2", "0.3.3", False),
+    ("0.4.0rc1", "0.4.0", False),   # don't nag toward a prerelease
+    ("", "0.3.3", False),
+    ("garbage", "0.3.3", False),
+])
+def test_is_newer(latest, current, expected):
+    assert uc._is_newer(latest, current) is expected
+
+
+def test_parse_version_strips_suffix():
+    assert uc._parse_version("0.4.0rc1") == (0, 4, 0)
+    assert uc._parse_version("1.2.3.post1") == (1, 2, 3)
+    assert uc._parse_version("") == ()
+
+
+# ------------------------------------------------------------ check_for_update
+def test_returns_latest_when_newer(monkeypatch, tmp_path):
+    monkeypatch.setattr(uc.httpx, "get", _fake_get("9.9.9"))
+    cache = tmp_path / "u.json"
+    assert uc.check_for_update("0.3.3", cache_path=cache, now=1000.0) == "9.9.9"
+    saved = json.loads(cache.read_text())
+    assert saved["latest"] == "9.9.9" and saved["last_check"] == 1000.0
+
+
+def test_returns_none_when_current(monkeypatch, tmp_path):
+    monkeypatch.setattr(uc.httpx, "get", _fake_get(__version__))
+    assert uc.check_for_update(__version__, cache_path=tmp_path / "u.json", now=1.0) is None
+
+
+def test_fresh_cache_skips_network(monkeypatch, tmp_path):
+    cache = tmp_path / "u.json"
+    cache.write_text(json.dumps({"latest": "9.9.9", "last_check": 1000.0}))
+
+    def _boom(*a, **k):
+        raise AssertionError("network must not be hit on a fresh cache")
+    monkeypatch.setattr(uc.httpx, "get", _boom)
+    assert uc.check_for_update("0.3.3", cache_path=cache, now=1000.0 + 60) == "9.9.9"
+
+
+def test_stale_cache_refetches(monkeypatch, tmp_path):
+    cache = tmp_path / "u.json"
+    cache.write_text(json.dumps({"latest": "0.0.1", "last_check": 1000.0}))
+    monkeypatch.setattr(uc.httpx, "get", _fake_get("9.9.9"))
+    now = 1000.0 + uc.CACHE_TTL_SECONDS + 1
+    assert uc.check_for_update("0.3.3", cache_path=cache, now=now) == "9.9.9"
+    assert json.loads(cache.read_text())["latest"] == "9.9.9"
+
+
+def test_network_error_is_swallowed(monkeypatch, tmp_path):
+    def _raise(*a, **k):
+        raise httpx.ConnectError("no network")
+    monkeypatch.setattr(uc.httpx, "get", _raise)
+    assert uc.check_for_update("0.3.3", cache_path=tmp_path / "u.json", now=1.0) is None
+
+
+def test_force_ignores_fresh_cache(monkeypatch, tmp_path):
+    cache = tmp_path / "u.json"
+    cache.write_text(json.dumps({"latest": "0.0.1", "last_check": 1000.0}))
+    monkeypatch.setattr(uc.httpx, "get", _fake_get("9.9.9"))
+    assert uc.check_for_update("0.3.3", cache_path=cache, now=1000.0 + 1, force=True) == "9.9.9"
+
+
+# ------------------------------------------------------------ maybe_notify
+class _Sink:
+    def __init__(self):
+        self.text = ""
+
+    def write(self, s):
+        self.text += s
+
+
+def test_notify_prints_when_newer(monkeypatch, tmp_path):
+    monkeypatch.setattr(uc.httpx, "get", _fake_get("9.9.9"))
+    sink = _Sink()
+    out = uc.maybe_notify_update("0.3.3", stream=sink, cache_path=tmp_path / "u.json", now=1.0)
+    assert out == "9.9.9"
+    assert "9.9.9 available" in sink.text
+    assert "pip install -U wxcc-toolkit" in sink.text
+    assert "wxcc-flow init" in sink.text
+
+
+def test_notify_silent_when_current(monkeypatch, tmp_path):
+    monkeypatch.setattr(uc.httpx, "get", _fake_get(__version__))
+    sink = _Sink()
+    assert uc.maybe_notify_update(__version__, stream=sink,
+                                  cache_path=tmp_path / "u.json", now=1.0) is None
+    assert sink.text == ""
+
+
+def test_notify_silent_when_flag_disabled(monkeypatch, tmp_path):
+    monkeypatch.setattr(uc.httpx, "get", _fake_get("9.9.9"))
+    sink = _Sink()
+    assert uc.maybe_notify_update("0.3.3", disabled=True, stream=sink,
+                                  cache_path=tmp_path / "u.json", now=1.0) is None
+    assert sink.text == ""
+
+
+@pytest.mark.parametrize("env", ["WXCC_FLOW_NO_UPDATE_CHECK", "CI"])
+def test_notify_silent_when_env_set(monkeypatch, tmp_path, env):
+    monkeypatch.setenv(env, "1")
+    monkeypatch.setattr(uc.httpx, "get", _fake_get("9.9.9"))
+    sink = _Sink()
+    assert uc.maybe_notify_update("0.3.3", stream=sink,
+                                  cache_path=tmp_path / "u.json", now=1.0) is None
+    assert sink.text == ""
+
+
+def test_notify_env_falsey_stays_enabled(monkeypatch, tmp_path):
+    monkeypatch.setenv("WXCC_FLOW_NO_UPDATE_CHECK", "0")  # explicit "don't disable"
+    monkeypatch.setattr(uc.httpx, "get", _fake_get("9.9.9"))
+    sink = _Sink()
+    assert uc.maybe_notify_update("0.3.3", stream=sink,
+                                  cache_path=tmp_path / "u.json", now=1.0) == "9.9.9"
+
+
+# ------------------------------------------------------------ CLI wiring
+def test_version_flag_still_works():
+    result = runner.invoke(app, ["--version"])
+    assert result.exit_code == 0
+    assert __version__ in result.output
+
+
+def test_no_update_check_option_registered():
+    import typer
+    cmd = typer.main.get_command(app)
+    assert "no_update_check" in {p.name for p in cmd.params}

wxcc_toolkit-0.3.2/src/wxcc_flow/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.3.2"