pipulate 2.57__tar.gz → 2.58__tar.gz

{pipulate-2.57/pipulate.egg-info → pipulate-2.58}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pipulate
-Version: 2.57
+Version: 2.58
 Summary: The context compiler that helps you prompt well — local-first, Nix-reproducible, replayable. The successor to AI SEO software.
 Author-email: Mike Levin <pipulate@gmail.com>
 License-Expression: AGPL-3.0-or-later

{pipulate-2.57 → pipulate-2.58}/__init__.py

@@ -12,7 +12,7 @@ Usage:
     pipulate
 """
 
-__version__ = "2.57"
+__version__ = "2.58"
 # APOSTROPHES RESTORED (2026-08-04). They were stripped as a workaround for
 # flake.nix's descMatch regex, whose character class excluded ' from the
 # CAPTURE and truncated the banner to "(So)". That regex was fixed in the same
@@ -23,7 +23,7 @@ __version__ = "2.57"
 # is not a property of the system; the regex is. Blast radius is one banner:
 # nothing but flake.nix reads this name -- version_sync.py syncs __version__
 # and __description__, never this. So'wI' chu' -- "engage the cloaking device."
-__version_description__ = "NPvg.org Walk Walking"
+__version_description__ = "NPvg.org 1st 10 Minutes"
 # SPDX expression, single source of truth, synced into pyproject.toml by
 # scripts/release/version_sync.py. "-or-later" (not bare AGPL-3.0, which is
 # deprecated SPDX) because the header below grants "any later version".

{pipulate-2.57 → pipulate-2.58}/apps/010_introduction.py

@@ -155,10 +155,18 @@ class IntroductionPlugin:
 
         
         from imports.voice_synthesis import chip_voice_system
-        if chip_voice_system and chip_voice_system.voice_ready:
-             chip_voice_system.stop_speaking()  # 🛑 INTERRUPT: Prevent voice overlapping on Back button
-             logger.info(f"🎤 Speaking: {step_id}")
-             asyncio.create_task(asyncio.to_thread(chip_voice_system.speak_text, text))
+        if chip_voice_system:
+            chip_voice_system.stop_speaking()  # 🛑 INTERRUPT: Prevent voice overlapping on Back button
+            def _speak():
+                # THE FLAG WENT COLD (2026-09-18): the gate moved off the event
+                # loop. can_speak() reads the consent card and loads the model
+                # on first use, seconds long, so it runs here, in the thread; a
+                # declined or unanswered card returns False with no download,
+                # and speak_text keeps its own barrier behind this one.
+                if chip_voice_system.can_speak():
+                    logger.info(f"🎤 Speaking: {step_id}")
+                    chip_voice_system.speak_text(text)
+            asyncio.create_task(asyncio.to_thread(_speak))
              
         return ""
 

{pipulate-2.57 → pipulate-2.58}/imports/voice_synthesis.py

@@ -12,6 +12,7 @@ import wave
 import subprocess
 import tempfile
 import signal
+import sys
 from pathlib import Path
 from typing import Optional, Dict, Any
 import logging
@@ -34,6 +35,92 @@ except ImportError:
 
 logger = logging.getLogger(__name__)
 
+# ---------------------------------------------------------------------------
+# THE VOICE ASKS BEFORE IT SPEAKS (2026-09-17). Two functions, one file.
+# voice_consent() is the BARRIER: every path to sound reads it, fresh, on every
+# call. The answer comes from PIPULATE_VOICE (an unattended shell declaring
+# intent, the way PIPULATE_BOOT_MENU=0 does) or from ~/.config/pipulate/voice,
+# outside the worktree, so it survives rm -rf on the folder and is asked once
+# per machine rather than once per install.
+# ask_voice_consent() is the CEREMONY: it prints the card and reads one line
+# from /dev/tty. The two are SEPARATE on purpose. flake.nix's door-1 greeting
+# runs as a backgrounded python with stdout on /dev/null while the server holds
+# the foreground on the same terminal; a speaker that ASKED would print the
+# card into /dev/null and take the keystrokes meant for a prompt nobody can
+# see. So the speaker never asks. The rider asks at the start of a walk, and
+# the `voice` word asks again later; both own a terminal.
+# NOTHING IS DOWNLOADED BEFORE A YES: the model loads in ensure_voice(), on
+# the first speak after consent, never at import. Importing this module used
+# to fetch the voice and spend seconds before anyone had asked to speak or
+# been asked whether it may; that was also the import tax the tool roster
+# measured at ~3.8 s.
+# ---------------------------------------------------------------------------
+VOICE_CONSENT_FILE = Path.home() / ".config" / "pipulate" / "voice"
+VOICE_CARD = (
+    "\nThe steps can be read aloud.\n\n"
+    "The voice is Piper, a small text-to-speech program that runs on this\n"
+    "computer; it was made for a Raspberry Pi. It reads sentences a person\n"
+    "typed in advance. No AI writes them, and nothing you say or type is\n"
+    "sent anywhere. Answering yes downloads the voice once, about 60 MB.\n\n"
+    "Read the steps aloud? [y/N] "
+)
+
+
+def voice_consent() -> str:
+    """'yes', 'no' or 'unset': the environment first, then the recorded answer."""
+    env = os.environ.get("PIPULATE_VOICE", "").strip().lower()
+    if env in ("0", "no", "off", "false"):
+        return "no"
+    if env in ("1", "yes", "on", "true"):
+        return "yes"
+    try:
+        recorded = VOICE_CONSENT_FILE.read_text(encoding="utf-8").strip().lower()
+    except OSError:
+        return "unset"
+    if recorded in ("yes", "no"):
+        return recorded
+    return "unset"
+
+
+def ask_voice_consent(later_hint: str = "voice", force: bool = False) -> str:
+    """Ask on /dev/tty and record the answer. Returns 'yes', 'no' or 'unavailable'.
+
+    Asks only when nothing is recorded, unless force is set (the `voice` word),
+    and never when PIPULATE_VOICE decides. Without a terminal to ask on -- a
+    pipe, a compile-lane probe, a backgrounded job -- it prints nothing and
+    returns 'unavailable', so no prompt can ever block an unattended caller.
+    Enter alone means no. A Ctrl+C is not recorded, so the question returns.
+    """
+    env = os.environ.get("PIPULATE_VOICE", "").strip().lower()
+    if env in ("0", "no", "off", "false", "1", "yes", "on", "true"):
+        return voice_consent()
+    recorded = voice_consent()
+    if recorded != "unset" and not force:
+        return recorded
+    if not sys.stdout.isatty():
+        return "unavailable"
+    try:
+        tty = open("/dev/tty", "r", encoding="utf-8")
+    except OSError:
+        return "unavailable"
+    try:
+        print(VOICE_CARD, end="", flush=True)
+        answer = tty.readline()
+    except (OSError, KeyboardInterrupt):
+        print()
+        return "no"
+    finally:
+        tty.close()
+    decision = "yes" if answer.strip().lower() in ("y", "yes") else "no"
+    try:
+        VOICE_CONSENT_FILE.parent.mkdir(parents=True, exist_ok=True)
+        VOICE_CONSENT_FILE.write_text(decision + "\n", encoding="utf-8")
+    except OSError as exc:
+        print(f"(could not record the answer, so it will be asked again: {exc})")
+    if decision == "no":
+        print(f"Staying quiet. To turn the voice on later, type: {later_hint}")
+    return decision
+
 class ChipVoiceSystem:
     """
     Voice synthesis system for Chip O'Theseus
@@ -49,9 +136,9 @@ class ChipVoiceSystem:
         self.current_process = None  # Track the running audio process
         self.last_error = None       # Populated by synthesize_and_play on failure
         
-        if VOICE_SYNTHESIS_AVAILABLE:
-            self.setup_voice_model()
-        else:
+        # No download and no model load here: see ensure_voice(). Importing
+        # this module must cost nothing and ask nothing.
+        if not VOICE_SYNTHESIS_AVAILABLE:
             logger.warning(f"🎤 Voice synthesis not available: {IMPORT_ERROR}")
     
     def setup_voice_model(self):
@@ -96,8 +183,38 @@ class ChipVoiceSystem:
             
         except Exception as e:
             logger.error(f"🎤 Failed to setup voice model: {e}")
+            self.last_error = f"voice model setup failed: {e}"
             self.voice_ready = False
 
+    def ensure_voice(self) -> bool:
+        """Load the voice on first use, never at import. Returns readiness.
+
+        Reached only after voice_consent() read yes, so the download the card
+        announces happens after the answer and not before it.
+        """
+        if self.voice_ready:
+            return True
+        if not VOICE_SYNTHESIS_AVAILABLE:
+            self.last_error = f"voice synthesis not installed: {IMPORT_ERROR}"
+            return False
+        self.setup_voice_model()
+        return self.voice_ready
+
+    def can_speak(self) -> bool:
+        """True only once a human has said yes AND the voice is loaded.
+
+        THE FLAG WENT COLD (2026-09-17, the census after the lazy load).
+        voice_ready read True at import on any machine with the model on disk,
+        and four files gate on it BEFORE they ever call speak_text:
+        apps/010_introduction.py, pipulate/core.py, server.py and
+        tools/mcp_tools.py. With the load deferred to first use the flag reads
+        False in every fresh process until something speaks, so none of those
+        gates opens. This is the question they meant to ask: consent first,
+        then the load, which downloads only after a yes. A status read that
+        must never download keeps reading voice_ready, which now means loaded.
+        """
+        return voice_consent() == "yes" and self.ensure_voice()
+
     def stop_speaking(self):
         """
         Silence! Kill the current audio process if it exists.
@@ -129,7 +246,13 @@ class ChipVoiceSystem:
         Returns:
             bool: True if successful, False otherwise
         """
-        if not self.voice_ready:
+        if voice_consent() != "yes":
+            # THE BARRIER. Every path to sound passes here, and the answer is
+            # read fresh each time, so a no recorded mid-session holds at once.
+            self.last_error = "voice not allowed"
+            logger.info("🎤 Voice not allowed; nothing spoken")
+            return False
+        if not self.ensure_voice():
             logger.warning("🎤 Voice synthesis not ready")
             return False
         
@@ -318,10 +441,22 @@ class ChipVoiceSystem:
         Returns:
             Dict with success status and details
         """
-        if not self.voice_ready:
+        consent = voice_consent()
+        if consent != "yes":
+            # DECLINED IS NOT FAILED. Callers read success=False either way;
+            # this key is how they tell a human's answer from a broken player.
+            return {
+                "success": False,
+                "declined": True,
+                "consent": consent,
+                "text": text,
+                "error": "voice declined" if consent == "no"
+                         else "voice not yet allowed: the voice card has not been answered",
+            }
+        if not self.ensure_voice():
             return {
                 "success": False,
-                "error": "Voice synthesis not available",
+                "error": self.last_error or "Voice synthesis not available",
                 "details": "Piper TTS model not loaded"
             }
         
@@ -467,7 +602,7 @@ def test_voice_synthesis():
     # Test basic voice synthesis
     test_text = "Hello Mike, this is Chip O'Theseus speaking. I can now remember what happened before the server restart!"
     
-    if chip_voice_system and chip_voice_system.voice_ready:
+    if chip_voice_system and chip_voice_system.can_speak():
         result = chip_voice_system.speak_text(test_text)
         if result["success"]:
             print("✅ Voice synthesis test successful")
@@ -510,6 +645,23 @@ def test_memory_voice_integration():
         print("❌ No memories found to test")
         return False
 
+if __name__ == "__main__" and sys.argv[1:2] == ["ask"]:
+    # `voice`, the word the card names: re-ask and record, then speak one
+    # sentence on yes so the audio path is heard rather than assumed.
+    _env = os.environ.get("PIPULATE_VOICE", "").strip()
+    if _env:
+        print(f"voice: PIPULATE_VOICE={_env!r} decides; unset it to be asked.")
+        raise SystemExit(0)
+    _decision = ask_voice_consent(later_hint="voice", force=True)
+    if _decision == "unavailable":
+        print("voice: no terminal to ask on; run this from a terminal.")
+        raise SystemExit(1)
+    print(f"voice: {_decision}  (recorded in {VOICE_CONSENT_FILE})")
+    if _decision == "yes" and chip_voice_system is not None:
+        _result = chip_voice_system.speak_text("This is Piper, reading a script. The voice is on.")
+        if not _result.get("success"):
+            print(f"voice: nothing was heard: {_result.get('error')}")
+    raise SystemExit(0)
 if __name__ == "__main__":
     # Run tests if script is executed directly
     print("🎤🧠 Chip O'Theseus Voice System Tests")

{pipulate-2.57 → pipulate-2.58}/pipulate/core.py

@@ -555,7 +555,7 @@ class Pipulate:
             try:
                 # Import here to avoid circular dependencies
                 from imports.voice_synthesis import chip_voice_system
-                if chip_voice_system and chip_voice_system.voice_ready:
+                if chip_voice_system and chip_voice_system.can_speak():
                      # Acoustic Sanitization (Using the voice_text so it doesn't read URLs!)
                      safe_text = voice_text.replace('\u0329', '')
                      safe_text = safe_text.replace('—', ', ').replace('–', ', ')

{pipulate-2.57 → pipulate-2.58/pipulate.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pipulate
-Version: 2.57
+Version: 2.58
 Summary: The context compiler that helps you prompt well — local-first, Nix-reproducible, replayable. The successor to AI SEO software.
 Author-email: Mike Levin <pipulate@gmail.com>
 License-Expression: AGPL-3.0-or-later

{pipulate-2.57 → pipulate-2.58}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "pipulate"
 # VERSION NOTE: Synced from pipulate/__init__.py.__version__ via python version_sync.py
-version = "2.57"
+version = "2.58"
 authors = [
   { name="Mike Levin", email="pipulate@gmail.com" },
 ]

{pipulate-2.57 → pipulate-2.58}/server.py

@@ -3156,7 +3156,7 @@ async def test_voice_synthesis_endpoint(request):
             return JSONResponse({"success": False, "error": "Voice synthesis not available"})
 
         # Check if voice system is ready
-        if not chip_voice_system.voice_ready:
+        if not chip_voice_system.can_speak():
             logger.error("🎤 Voice system not ready")
             return JSONResponse({"success": False, "error": "Voice system not ready"})
 

{pipulate-2.57 → pipulate-2.58}/tools/connector_tools.py

@@ -1,5 +1,5 @@
 """
-connector_tools.py -- the registry face of scripts/connectors/*.py: one tool
+connector_tools.py -- the registry face of connectors/*.py: one tool
 per connector, SAME argument shape, SAME backend, SAME docstring.
 
 This file exists for the two-arm experiment (shell verb vs registry tool) and
@@ -33,7 +33,7 @@ from pathlib import Path
 from tools import auto_tool
 
 REPO_ROOT = Path(__file__).resolve().parent.parent
-CONNECTORS = REPO_ROOT / "scripts" / "connectors"
+CONNECTORS = REPO_ROOT / "connectors"
 TIMEOUT = 120
 KEY_TRAILER = (
     "\n\nRegistry form: --json-args keys mirror the connector's argument names --"
@@ -52,7 +52,7 @@ def _connector_doc(name):
 
 
 async def _run_connector(name, params):
-    """Run scripts/connectors/<name>.py as a subprocess; return its three channels."""
+    """Run connectors/<name>.py as a subprocess; return its three channels."""
     if not isinstance(params, dict):
         return {"success": False, "error": "params must be a JSON object"}
     argv = [sys.executable, str(CONNECTORS / f"{name}.py")]
@@ -90,7 +90,7 @@ async def _run_connector(name, params):
 
 @auto_tool
 async def botify(params: dict) -> dict:
-    """Registry face of scripts/connectors/botify.py; __doc__ is replaced at
+    """Registry face of connectors/botify.py; __doc__ is replaced at
     import with that file's own docstring so both arms read one description."""
     return await _run_connector("botify", params)
 

{pipulate-2.57 → pipulate-2.58}/tools/mcp_tools.py

@@ -1464,7 +1464,7 @@ async def voice_synthesis(params: dict) -> dict:
                 "error": "Voice synthesis not available - missing dependencies"
             }
 
-        if not chip_voice_system or not chip_voice_system.voice_ready:
+        if not chip_voice_system:
             return {
                 "success": False,
                 "error": "Voice system not ready - check model initialization"