firekeep-client 1.8.1__tar.gz → 1.8.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (181) hide show
  1. {firekeep_client-1.8.1/firekeep_client.egg-info → firekeep_client-1.8.2}/PKG-INFO +1 -1
  2. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/__init__.py +1 -1
  3. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/serverupdate.py +23 -0
  4. {firekeep_client-1.8.1 → firekeep_client-1.8.2/firekeep_client.egg-info}/PKG-INFO +1 -1
  5. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/pyproject.toml +1 -1
  6. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_package.py +1 -1
  7. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_serverupdate.py +38 -0
  8. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/LICENSE +0 -0
  9. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/NOTICE +0 -0
  10. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/README.md +0 -0
  11. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/adapters/__init__.py +0 -0
  12. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/adapters/base.py +0 -0
  13. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/adapters/claude.py +0 -0
  14. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/adapters/claude_desktop.py +0 -0
  15. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/adapters/codex.py +0 -0
  16. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/adapters/generic.py +0 -0
  17. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/adapters/kiro.py +0 -0
  18. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/adapters/opencode.py +0 -0
  19. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/adapters/pi.py +0 -0
  20. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/autoupdate.py +0 -0
  21. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/background.py +0 -0
  22. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/backups.py +0 -0
  23. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/childenv.py +0 -0
  24. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/cli.py +0 -0
  25. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/config_write.py +0 -0
  26. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/connect.py +0 -0
  27. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/contract/__init__.py +0 -0
  28. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/contract/matrix.py +0 -0
  29. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/decision/__init__.py +0 -0
  30. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/decision/board.py +0 -0
  31. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/decision/server.py +0 -0
  32. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/dexes.py +0 -0
  33. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/docdexsync.py +0 -0
  34. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/gateway.py +0 -0
  35. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/hooklog.py +0 -0
  36. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/hooks/__init__.py +0 -0
  37. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/hooks/__main__.py +0 -0
  38. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/hooks/_git.py +0 -0
  39. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/hooks/_mcp.py +0 -0
  40. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/hooks/destructive.py +0 -0
  41. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/hooks/post_tool.py +0 -0
  42. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/hooks/pre_tool.py +0 -0
  43. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/hooks/precompact.py +0 -0
  44. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/hooks/prompt.py +0 -0
  45. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/hooks/runbooks.py +0 -0
  46. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/hooks/session_end.py +0 -0
  47. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/hooks/session_start.py +0 -0
  48. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/hooks/stop.py +0 -0
  49. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/jobobject.py +0 -0
  50. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/join.py +0 -0
  51. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/joincode.py +0 -0
  52. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/maildexsync.py +0 -0
  53. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/migrate.py +0 -0
  54. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/nightshift.py +0 -0
  55. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/nightshiftdrain.py +0 -0
  56. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/pathenv.py +0 -0
  57. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/promptrecall.py +0 -0
  58. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/report.py +0 -0
  59. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/resolver.py +0 -0
  60. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/serverinit.py +0 -0
  61. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/shim.py +0 -0
  62. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/sidecar.py +0 -0
  63. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/signing.py +0 -0
  64. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/state.py +0 -0
  65. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/stdio.py +0 -0
  66. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/symdexindex.py +0 -0
  67. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/transport.py +0 -0
  68. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/updater.py +0 -0
  69. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/wizard.py +0 -0
  70. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client/worktree_snapshot.py +0 -0
  71. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client.egg-info/SOURCES.txt +0 -0
  72. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client.egg-info/dependency_links.txt +0 -0
  73. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client.egg-info/entry_points.txt +0 -0
  74. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client.egg-info/requires.txt +0 -0
  75. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/firekeep_client.egg-info/top_level.txt +0 -0
  76. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/setup.cfg +0 -0
  77. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_attribution_headers.py +0 -0
  78. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_autoupdate.py +0 -0
  79. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_background.py +0 -0
  80. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_bash_layer_retired.py +0 -0
  81. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_bootstrap_consent_pty.py +0 -0
  82. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_bootstrap_docdex.py +0 -0
  83. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_bootstrap_maildex.py +0 -0
  84. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_bootstrap_ps1.py +0 -0
  85. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_bootstrap_reinstall.py +0 -0
  86. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_bootstrap_sh.py +0 -0
  87. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_bootstrap_symdex.py +0 -0
  88. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_bootstrap_venv_provisioning.py +0 -0
  89. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_cli.py +0 -0
  90. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_cli_backup.py +0 -0
  91. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_cli_dex.py +0 -0
  92. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_cli_docdex.py +0 -0
  93. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_cli_doctor.py +0 -0
  94. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_cli_doctor_generic.py +0 -0
  95. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_cli_doctor_report.py +0 -0
  96. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_cli_entry.py +0 -0
  97. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_cli_generic_install.py +0 -0
  98. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_cli_hands.py +0 -0
  99. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_cli_install.py +0 -0
  100. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_cli_maildex.py +0 -0
  101. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_cli_onboarding.py +0 -0
  102. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_cli_personal.py +0 -0
  103. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_cli_uninstall.py +0 -0
  104. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_cli_uninstall_generic.py +0 -0
  105. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_cli_update.py +0 -0
  106. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_cli_whoami.py +0 -0
  107. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_config_migration.py +0 -0
  108. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_connect.py +0 -0
  109. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_decision_board_html.py +0 -0
  110. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_decision_bypass.py +0 -0
  111. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_decision_poll_ceiling.py +0 -0
  112. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_decision_registration.py +0 -0
  113. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_decision_server.py +0 -0
  114. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_dexes.py +0 -0
  115. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_docdexsync.py +0 -0
  116. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_docs_reference_client_kit.py +0 -0
  117. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_doctor_credential_expiry.py +0 -0
  118. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_doctor_embeddings.py +0 -0
  119. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_doctor_no_server.py +0 -0
  120. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_e2e_bootstrap.py +0 -0
  121. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_gateway.py +0 -0
  122. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_gateway_child_env.py +0 -0
  123. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_gateway_schema_slimming.py +0 -0
  124. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_gateway_toolset.py +0 -0
  125. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_generic_config.py +0 -0
  126. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_hooklog.py +0 -0
  127. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_import_boundary.py +0 -0
  128. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_init_self_enroll.py +0 -0
  129. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_init_stale_bundle.py +0 -0
  130. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_install_skill_contract.py +0 -0
  131. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_instruction_budget.py +0 -0
  132. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_jobobject.py +0 -0
  133. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_join.py +0 -0
  134. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_join_config_write.py +0 -0
  135. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_joincode.py +0 -0
  136. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_kit_smoke.py +0 -0
  137. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_maildexsync.py +0 -0
  138. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_make_release.py +0 -0
  139. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_memory_instructions.py +0 -0
  140. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_migration_entrypoints.py +0 -0
  141. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_nightshift.py +0 -0
  142. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_nightshiftdrain.py +0 -0
  143. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_pathenv.py +0 -0
  144. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_promptrecall.py +0 -0
  145. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_report_bootstrap_enums.py +0 -0
  146. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_report_capture.py +0 -0
  147. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_report_consent.py +0 -0
  148. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_report_consent_surfaces.py +0 -0
  149. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_report_flush_points.py +0 -0
  150. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_report_integration.py +0 -0
  151. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_report_milestones.py +0 -0
  152. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_report_schema.py +0 -0
  153. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_report_spool.py +0 -0
  154. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_resolver.py +0 -0
  155. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_resolver_bypass.py +0 -0
  156. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_resolver_single_connection.py +0 -0
  157. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_runbook_match_parity.py +0 -0
  158. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_runbook_state.py +0 -0
  159. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_scratch_ttl.py +0 -0
  160. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_serverinit.py +0 -0
  161. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_shim_bridge.py +0 -0
  162. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_shim_bypass.py +0 -0
  163. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_shim_eof_exit.py +0 -0
  164. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_shim_fail_loud.py +0 -0
  165. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_shim_identity.py +0 -0
  166. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_shim_recovery.py +0 -0
  167. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_shim_skeleton.py +0 -0
  168. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_sidecar.py +0 -0
  169. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_sidecar_robustness.py +0 -0
  170. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_signing.py +0 -0
  171. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_state.py +0 -0
  172. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_state_session_report.py +0 -0
  173. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_stdio_encoding.py +0 -0
  174. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_symdexindex.py +0 -0
  175. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_transport.py +0 -0
  176. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_transport_sse.py +0 -0
  177. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_twin_removed.py +0 -0
  178. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_updater.py +0 -0
  179. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_wizard.py +0 -0
  180. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_wizard_generic.py +0 -0
  181. {firekeep_client-1.8.1 → firekeep_client-1.8.2}/tests/test_worktree_snapshot.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: firekeep-client
3
- Version: 1.8.1
3
+ Version: 1.8.2
4
4
  Summary: Client for Firekeep, the self-hosted operating layer for connected AI agents.
5
5
  License-Expression: LicenseRef-Firekeep-BUSL-1.1
6
6
  Project-URL: Homepage, https://firekeep.ai
@@ -9,4 +9,4 @@ versions without a verdict (`_check_versions`) and judges staleness against the
9
9
  release manifest instead (`_check_client_version`).
10
10
  """
11
11
 
12
- __version__ = "1.8.1"
12
+ __version__ = "1.8.2"
@@ -19,6 +19,7 @@ from firekeep_client.transport import get_json
19
19
 
20
20
  _TIMEOUT = 3.0
21
21
  _CACHE_KEY = "server_update_check"
22
+ _RECHECK_KEY = "server_update_recheck"
22
23
 
23
24
 
24
25
  @dataclass
@@ -93,6 +94,26 @@ def _fetch_latest(cfg) -> str | None:
93
94
  return None
94
95
 
95
96
 
97
+ def _recheck_ahead(cfg, running: str, cached: str | None) -> str | None:
98
+ """A server ahead of the day-cached latest usually means the cache predates
99
+ a release deployed since (a published server cannot outrun the published
100
+ series). Re-fetch once, at most once a day per running version so a
101
+ checkout parked on an unpublished tag pays the 3s once, not per call."""
102
+ try:
103
+ today = datetime.date.today().isoformat()
104
+ marker = f"{today}|{running}"
105
+ if state.read_scratch(_RECHECK_KEY) == marker:
106
+ return cached
107
+ state.write_scratch(_RECHECK_KEY, marker)
108
+ fresh = _fetch_latest_uncached(cfg)
109
+ if fresh:
110
+ state.write_scratch(_CACHE_KEY, f"{today}|{fresh}")
111
+ return fresh
112
+ except Exception: # noqa: BLE001 — keep the cached verdict
113
+ pass
114
+ return cached
115
+
116
+
96
117
  def _relation(running: str, latest: str | None) -> str:
97
118
  # Checked BEFORE the manifest: provenance is a property of the server, not
98
119
  # of dist-host reachability, so this verdict must never degrade to
@@ -129,6 +150,8 @@ def check(cfg) -> ServerUpdateStatus | None:
129
150
  if running is None:
130
151
  return None
131
152
  latest = _fetch_latest(cfg)
153
+ if _relation(running, latest) == "ahead":
154
+ latest = _recheck_ahead(cfg, running, latest)
132
155
  return ServerUpdateStatus(
133
156
  running=running, latest=latest,
134
157
  relation=_relation(running, latest),
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: firekeep-client
3
- Version: 1.8.1
3
+ Version: 1.8.2
4
4
  Summary: Client for Firekeep, the self-hosted operating layer for connected AI agents.
5
5
  License-Expression: LicenseRef-Firekeep-BUSL-1.1
6
6
  Project-URL: Homepage, https://firekeep.ai
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "firekeep-client"
7
- version = "1.8.1"
7
+ version = "1.8.2"
8
8
  description = "Client for Firekeep, the self-hosted operating layer for connected AI agents."
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10"
@@ -7,7 +7,7 @@ from pathlib import Path
7
7
  def test_package_imports_and_exposes_frozen_version():
8
8
  import firekeep_client
9
9
 
10
- assert firekeep_client.__version__ == "1.8.1"
10
+ assert firekeep_client.__version__ == "1.8.2"
11
11
 
12
12
 
13
13
  def test_the_version_pins_agree():
@@ -186,3 +186,41 @@ def test_real_releases_still_judge_normally(monkeypatch):
186
186
  _wire(monkeypatch, running=running, latest="v1.3.1")
187
187
  state.delete_scratch(serverupdate._CACHE_KEY)
188
188
  assert serverupdate.check(_cfg()).relation == relation
189
+
190
+
191
+ def _seed_cache(latest):
192
+ import datetime
193
+ state.write_scratch(serverupdate._CACHE_KEY,
194
+ f"{datetime.date.today().isoformat()}|{latest}")
195
+
196
+
197
+ def test_ahead_of_a_cached_latest_rechecks_once_and_heals(monkeypatch):
198
+ # The morning's fetch saw v1.6.2; v1.6.4 was published and deployed later
199
+ # the same day. A published server cannot outrun the published series, so
200
+ # "ahead" of a CACHED latest is evidence the cache is stale.
201
+ _seed_cache("v1.6.2")
202
+ calls = _wire(monkeypatch, running="v1.6.4", latest="v1.6.4")
203
+ status = serverupdate.check(_cfg())
204
+ assert (status.relation, status.latest) == ("current", "v1.6.4")
205
+ assert calls["manifest"] == 1
206
+ assert serverupdate.check(_cfg()).latest == "v1.6.4" # cache healed
207
+ assert calls["manifest"] == 1
208
+
209
+
210
+ def test_genuinely_ahead_rechecks_at_most_once_per_day(monkeypatch):
211
+ # A checkout parked on a tag that was never published really is ahead:
212
+ # one recheck confirms it, and no later call pays the 3s again.
213
+ calls = _wire(monkeypatch, running="v1.7.0", latest="v1.6.4")
214
+ for _ in range(3):
215
+ assert serverupdate.check(_cfg()).relation == "ahead"
216
+ assert calls["manifest"] == 2 # the day's fetch + one recheck
217
+
218
+
219
+ def test_failed_recheck_keeps_the_cached_verdict(monkeypatch):
220
+ _seed_cache("v1.6.2")
221
+ monkeypatch.setattr(serverupdate, "_fetch_running", lambda cfg: "v1.6.4")
222
+ def fail(cfg):
223
+ raise updater.UpdateError("down")
224
+ monkeypatch.setattr(serverupdate, "_fetch_latest_uncached", fail)
225
+ status = serverupdate.check(_cfg())
226
+ assert (status.relation, status.latest) == ("ahead", "v1.6.2")
File without changes
File without changes