code-puppy-core-plugins 0.0.99__tar.gz → 0.0.100__tar.gz

{code_puppy_core_plugins-0.0.99 → code_puppy_core_plugins-0.0.100}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: code-puppy-core-plugins
-Version: 0.0.99
+Version: 0.0.100
 Summary: Official plugin bundle for Code Puppy
 Project-URL: Repository, https://github.com/mpfaffenberger/code_puppy_core_plugins
 Project-URL: Homepage, https://github.com/mpfaffenberger/code_puppy_core_plugins

code_puppy_core_plugins-0.0.100/code_puppy_core_plugins/resume_hint/__init__.py

@@ -0,0 +1 @@
+"""Print a copy-pasteable ``--resume`` command when the interactive CLI exits."""

code_puppy_core_plugins-0.0.100/code_puppy_core_plugins/resume_hint/locales/en-US.json

@@ -0,0 +1,3 @@
+{
+  "plugin.resume-hint.header": "Resume this session with:"
+}

code_puppy_core_plugins-0.0.100/code_puppy_core_plugins/resume_hint/locales/es.json

@@ -0,0 +1,3 @@
+{
+  "plugin.resume-hint.header": "Reanuda esta sesión con:"
+}

code_puppy_core_plugins-0.0.100/code_puppy_core_plugins/resume_hint/locales/fr-CA.json

@@ -0,0 +1,3 @@
+{
+  "plugin.resume-hint.header": "Reprenez cette session avec :"
+}

code_puppy_core_plugins-0.0.100/code_puppy_core_plugins/resume_hint/register_callbacks.py

@@ -0,0 +1,72 @@
+"""Leave a breadcrumb on exit: ``Resume this session with: uvx code-puppy --resume <name>``.
+
+Hooks ``shutdown``, which ``cli_runner.main`` fires *after* the persistent UI
+and message renderers are torn down. That makes it the last thing on screen,
+but it also means the message bus is gone, so we write straight to stdout.
+
+The hint only appears when autosave is on and the session file exists on
+disk, so we never advertise a name with nothing saved behind it (nothing
+said yet, or a fresh ``/clear``) or a stale snapshot (autosave disabled).
+"""
+
+from __future__ import annotations
+
+import logging
+from importlib.resources import files
+from pathlib import Path
+
+from code_puppy.callbacks import register_callback
+from code_puppy.config import (
+    AUTOSAVE_DIR,
+    get_auto_save_session,
+    get_current_session_name,
+    get_headless_mode,
+)
+from code_puppy.i18n import register_plugin_catalog, t
+from code_puppy.session_storage import build_session_paths
+
+register_plugin_catalog(files(__package__).joinpath("locales"))
+
+logger = logging.getLogger(__name__)
+
+# The README's launch method; works whether or not code-puppy is installed.
+_LAUNCH_COMMAND = "uvx code-puppy"
+
+
+def _saved_session_name() -> str | None:
+    """Return the current session name if it has been persisted, else None."""
+    name = get_current_session_name()
+    paths = build_session_paths(Path(AUTOSAVE_DIR), name)
+    if paths.json_path.is_file() or paths.pickle_path.is_file():
+        return name
+    return None
+
+
+def _resume_arg(session_name: str) -> str:
+    # argparse reads a leading "-" as an option; the "=" form keeps it a value.
+    separator = "=" if session_name.startswith("-") else " "
+    return f"--resume{separator}{session_name}"
+
+
+def _format_resume_hint(session_name: str) -> str:
+    return (
+        f"\n{t('plugin.resume-hint.header')}\n"
+        f"  {_LAUNCH_COMMAND} {_resume_arg(session_name)}\n"
+    )
+
+
+def _on_shutdown() -> None:
+    try:
+        # Headless ``-p`` stdout is often machine-parsed; with autosave off,
+        # the file on disk is a stale snapshot rather than "this session".
+        if get_headless_mode() or not get_auto_save_session():
+            return
+        session_name = _saved_session_name()
+        if session_name:
+            print(_format_resume_hint(session_name), flush=True)
+    except Exception:
+        # A goodbye nicety must never turn a clean exit into a traceback.
+        logger.debug("resume_hint: unable to print resume hint", exc_info=True)
+
+
+register_callback("shutdown", _on_shutdown)

{code_puppy_core_plugins-0.0.99 → code_puppy_core_plugins-0.0.100}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "code-puppy-core-plugins"
-version = "0.0.99"
+version = "0.0.100"
 description = "Official plugin bundle for Code Puppy"
 readme = "README.md"
 requires-python = ">=3.11,<3.15"
@@ -114,6 +114,7 @@ pstack = "code_puppy_core_plugins.pstack.register_callbacks"
 puppy_spinner = "code_puppy_core_plugins.puppy_spinner.register_callbacks"
 qa_kitten_skill = "code_puppy_core_plugins.qa_kitten_skill.register_callbacks"
 quick_resume = "code_puppy_core_plugins.quick_resume.register_callbacks"
+resume_hint = "code_puppy_core_plugins.resume_hint.register_callbacks"
 review_pr = "code_puppy_core_plugins.review_pr.register_callbacks"
 session_namer = "code_puppy_core_plugins.session_namer.register_callbacks"
 setup_cli = "code_puppy_core_plugins.setup_cli.register_callbacks"