tycho-cli 0.0.3__tar.gz → 0.0.4__tar.gz

{tycho_cli-0.0.3 → tycho_cli-0.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tycho-cli
-Version: 0.0.3
+Version: 0.0.4
 Summary: Tycho — a free, offline, open-source local verifier that proves an AI agent actually did what it claims, from git, the filesystem, process exit codes, and the harness event stream. No account, no LLM in the trust path.
 Project-URL: Homepage, https://swail.dev/tycho
 Project-URL: Repository, https://github.com/swail-labs/tycho

{tycho_cli-0.0.3 → tycho_cli-0.0.4}/tests/test_update.py

@@ -94,6 +94,15 @@ def test_stale_cache_triggers_a_refetch(_online, monkeypatch):
     assert version_mod.refresh() == "2.0.0"
 
 
+def test_force_bypasses_a_fresh_cache(_online, monkeypatch):
+    # The bug: a same-day release is invisible because the ≤24h cache short-circuits refresh().
+    # `tycho update`/`doctor` pass force=True to re-hit the index now (TYCHO-53).
+    state.write_update_cache(latest="0.0.2", checked_at=time.time())  # fresh, but stale content
+    _fetches(monkeypatch, "0.0.3")
+    assert version_mod.refresh() == "0.0.2"            # cached path still honors the day
+    assert version_mod.refresh(force=True) == "0.0.3"  # forced path sees the new release
+
+
 def test_status_bar_path_reads_cache_only_never_network(_online, monkeypatch):
     # refresh_first=False must not fetch — the status bar renders constantly.
     monkeypatch.setattr(version_mod, "_fetch", lambda: pytest.fail("must not hit the network"))

{tycho_cli-0.0.3 → tycho_cli-0.0.4}/tycho/__init__.py

@@ -6,4 +6,4 @@ trust path. Free, open source (Apache 2.0), offline, no account needed.
 """
 
 # Alpha. Bumped to 0.1.0 for the first public release (TYCHO-10).
-__version__ = "0.0.3"
+__version__ = "0.0.4"

{tycho_cli-0.0.3 → tycho_cli-0.0.4}/tycho/cli.py

@@ -389,7 +389,7 @@ def _update(skip: bool) -> int:
     from . import state
     from . import version as version_mod
 
-    newest = version_mod.refresh()
+    newest = version_mod.refresh(force=True)  # explicit command — never trust the daily cache
     behind = bool(newest) and version_mod.is_newer(newest, __version__)
     if skip:
         if behind:

{tycho_cli-0.0.3 → tycho_cli-0.0.4}/tycho/doctor.py

@@ -96,7 +96,7 @@ def diagnose(repo: Path) -> list[Finding]:
     findings: list[Finding] = []
     # A new version is worth surfacing where someone is already looking; doctor is manual,
     # so the (once-a-day, fail-open) network check is fine here (TYCHO-53).
-    note = version_mod.notice(refresh_first=True)
+    note = version_mod.notice(refresh_first=True, force=True)  # explicit command — bypass the daily cache
     if note:
         findings.append(Finding(INFO, note, "run `tycho update`"))
     wired = _wired_harnesses(repo, findings)
@@ -293,7 +293,15 @@ def healthy(findings: list[Finding]) -> bool:
 
 
 def render(findings: list[Finding]) -> str:
-    lines = [f"tycho doctor (v{__version__})"]
+    # `diagnose` already ran the forced check, so the cache now holds the true latest (TYCHO-53).
+    latest = version_mod.cached_latest()
+    if latest and version_mod.is_newer(latest, __version__):
+        head = f"tycho doctor (v{__version__} · latest {latest} — run `tycho update`)"
+    elif latest:
+        head = f"tycho doctor (v{__version__} · latest {latest})"
+    else:
+        head = f"tycho doctor (v{__version__})"  # index unreachable / opted out
+    lines = [head]
     for f in findings:
         mark = {OK: "✓", INFO: "•", DRIFT: "⚠"}.get(f.level, "✗")
         label = "" if f.level in (OK, INFO, DRIFT) else f"{f.level}: "

{tycho_cli-0.0.3 → tycho_cli-0.0.4}/tycho/version.py

@@ -54,13 +54,18 @@ def _fetch() -> str | None:
         return None  # offline, slow, blocked, unparseable — say nothing
 
 
-def refresh() -> str | None:
+def refresh(force: bool = False) -> str | None:
     """Newest published version, hitting the network only if the cache is stale (≤ once/day)
-    and the user hasn't opted out. Cached machine-wide; never raises."""
+    and the user hasn't opted out. Cached machine-wide; never raises.
+
+    `force=True` ignores the daily cache and re-hits the index now — for the explicit,
+    interactive paths (`tycho update`, `tycho doctor`), where a same-day release must be
+    seen immediately. The passive paths (status bar, per-session bootup) leave it False so
+    they never add a network round-trip (TYCHO-53)."""
     if _env_opted_out():
         return None
     cache = state.read_update_cache()
-    if cache.get("latest") and (time.time() - cache.get("checked_at", 0)) < _CHECK_TTL:
+    if not force and cache.get("latest") and (time.time() - cache.get("checked_at", 0)) < _CHECK_TTL:
         return cache["latest"]
     got = _fetch()
     if got:
@@ -69,6 +74,16 @@ def refresh() -> str | None:
     return cache.get("latest")
 
 
+def cached_latest() -> str | None:
+    """The newest version already known from the cache — no network. For display after a
+    caller has (or hasn't) refreshed; the status header reads this."""
+    try:
+        got = state.read_update_cache().get("latest")
+        return got if isinstance(got, str) and got else None
+    except Exception:
+        return None
+
+
 def _tuple(v: str) -> tuple[int, ...]:
     """Numeric release tuple: "0.1.0" -> (0, 1, 0). Non-numeric suffixes are dropped — fine
     for the 0.0.x-alpha → 0.1.0 scheme (no pre-release tags in play)."""
@@ -79,14 +94,15 @@ def is_newer(candidate: str, than: str) -> bool:
     return _tuple(candidate) > _tuple(than)
 
 
-def notice(refresh_first: bool = False) -> str | None:
+def notice(refresh_first: bool = False, force: bool = False) -> str | None:
     """One line if a newer version exists and the user hasn't opted out or dismissed it — else
     None. `refresh_first=True` permits the network check (doctor/init/bootup); the default reads
-    only the cache, which is what the status bar must use. Never raises."""
+    only the cache, which is what the status bar must use. `force=True` additionally bypasses the
+    daily cache (explicit `tycho update`/`doctor`). Never raises."""
     if _env_opted_out():
         return None
     try:
-        newest = refresh() if refresh_first else state.read_update_cache().get("latest")
+        newest = refresh(force=force) if refresh_first else state.read_update_cache().get("latest")
         if not isinstance(newest, str) or not is_newer(newest, __version__):
             return None
         if state.read_update_cache().get("dismissed_version") == newest: