pipulate 2.0__tar.gz → 2.2__tar.gz

pipulate-2.2/MANIFEST.in

@@ -0,0 +1,5 @@
+# Work-in-progress plugin sketches (xx_ prefix) never ship to PyPI.
+# Runtime plugin discovery already skips xx_ files; this keeps the sdist
+# — and the wheel `python -m build` derives from it — in agreement with
+# that convention. Fix protects v2.1 forward; the 2.0 artifact is history.
+exclude apps/xx_*.py

{pipulate-2.0 → pipulate-2.2}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: pipulate
-Version: 2.0
-Summary: A Notebook-inspired Hand-cranked Agentic Framework
+Version: 2.2
+Summary: AI-readiness for the agentic web — local-first, Nix-reproducible workflows. The successor to AI SEO software.
 Author-email: Mike Levin <pipulate@gmail.com>
-License-Expression: MIT
+License-Expression: AGPL-3.0-or-later
 Project-URL: Homepage, https://github.com/miklevin/pipulate/
 Project-URL: Bug Tracker, https://github.com/miklevin/pipulate/issues
 Project-URL: Documentation, https://pipulate.com/guide/
-Keywords: seo,ai,llm,automation,local-first,nix,fasthtml,htmx,agentic
+Keywords: ai-readiness,agentic-web,seo,ai,llm,automation,local-first,nix,fasthtml,htmx,agentic,content-negotiation
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
@@ -59,7 +59,7 @@ Dynamic: license-file
 2. Hi, Auditor! What you're looking for is AUDIT.md ( https://pipulate.com/AUDIT.md )
 3. And context AI_CONTEXT.md ( https://pipulate.com/AI_CONTEXT.md )
 
-# Pipulate: Local First AI SEO Software
+# Pipulate: Local First AI-Readiness for the Agentic Web
 
 ```text
 ( Like a canary you say? )                      
@@ -112,10 +112,10 @@ nix develop
 
 **Real examples of what people create with Pipulate:**
 
-### 🔍 SEO Workflows
+### 🔍 Agentic-Web Readiness Workflows (the craft formerly known as SEO)
 - **Keyword Research Pipeline**: Input seed keywords → AI expansion → competition analysis → export spreadsheet
 - **Content Gap Analysis**: Compare your site vs competitors → identify missing topics → prioritized content calendar
-- **Technical SEO Audits**: Crawl site → check Core Web Vitals → generate action items → track fixes
+- **Technical Readiness Audits**: Crawl site → check what agents actually see → generate action items → track fixes
 
 ### 📊 Data Processing Workflows  
 - **CSV Data Cleaning**: Upload messy data → standardize formats → remove duplicates → validate results
@@ -123,7 +123,7 @@ nix develop
 - **Report Generation**: Combine multiple data sources → apply business rules → create branded reports
 
 ### 🤖 AI-Assisted Workflows
-- **Content Creation Pipeline**: Research topics → generate outlines → write drafts → optimize for SEO
+- **Content Creation Pipeline**: Research topics → generate outlines → write drafts → optimize for machine readers
 - **Data Analysis Helper**: Upload spreadsheet → AI suggests insights → create visualizations → export findings
 
 **Key advantage:** Each workflow is a guided, step-by-step process that non-technical users can run repeatedly, while developers can customize the Python code behind each step.
@@ -132,7 +132,7 @@ nix develop
 
 ```text
 ╔═════════════════════════════════════════════════════════════════════════╗  Chip O'What?
-║  🎭 PIPULATE: LOCAL-FIRST AI SEO SOFTWARE & DIGITAL WORKSHOP            ║     ,       O
+║  🎭 PIPULATE: LOCAL-FIRST AI-READINESS & DIGITAL WORKSHOP               ║     ,       O
 ║  ────────────────────────────────────────────────────────────────────── ║     \\  .  O
 ║                                                                         ║     |\\/| o
 ║  💬 Chip O'Theseus: "Welcome to your sovereign computing environment!"  ║     / " '\
@@ -177,7 +177,7 @@ Think of it as putting guardrails on AI assistance. Instead of asking an AI to "
 3. 📓 **Transforms Jupyter Notebooks** into production-ready, step-by-step workflows
 4. 🤖 **Integrated AI assistance** using your own local models with complete privacy
 5. 🔧 **Reproducible environments** with Nix that work identically across all platforms
-6. 🎯 **Perfect for SEO practitioners** who want to turn technical expertise into guided, reusable workflows
+6. 🎯 **Perfect for practitioners readying clients for the agentic web** who want to turn technical expertise into guided, reusable workflows
 
 --------------------------------------------------------------------------------
 
@@ -277,7 +277,7 @@ If you are not an Empire builder and prefer craftsmanship over the rat race and
 
 ### Primary Goals
 
-1. **Empower End-Users (e.g., SEO Practitioners):** Enable non-programmers to run powerful, AI-guided workflows (often ported from Jupyter Notebooks) without needing to interact with Python code directly.
+1. **Empower End-Users (e.g., Agentic-Web Practitioners):** Enable non-programmers to run powerful, AI-guided workflows (often ported from Jupyter Notebooks) without needing to interact with Python code directly.
 2. **Serve Developers:** Provide a simple, reproducible environment for building these workflows, leveraging integrated tooling like Jupyter, local LLMs, and a streamlined web framework.
 
 --------------------------------------------------------------------------------
@@ -576,6 +576,13 @@ nix develop
 
 Wait for the JupyterLab tab to auto-open, then run the Onboarding notebook to unlock the Pipulate app.
 
+**Automating past the boot menu:** `nix develop` ends at a two-door prompt — start Pipulate, or drop to the shell. It fails open, so anything without a terminal (CI, a provisioning script, an SSH session with no tty) starts the app and never sees the prompt. Two environment variables cover the cases that do:
+
+| Variable | Effect |
+|----------|--------|
+| `PIPULATE_BOOT_MENU=0` | Skip the prompt entirely and start the app, e.g. `PIPULATE_BOOT_MENU=0 nix develop`. For an unattended terminal that would otherwise wait for a keypress that never comes. |
+| `PIPULATE_BOOT_MENU_TIMEOUT=10` | Keep the prompt, but start the app after N seconds if nobody chooses. Off by default — with a human provably present, the prompt waits indefinitely rather than starting something they didn't ask for. |
+
 ### 🚨 Installation Troubleshooting
 
 **Common Issues & Solutions:**
@@ -695,7 +702,7 @@ Are you a Developer or an End User? Chef or Customer? Understanding your audienc
 ### 👨‍🍳 The Chef (Developer/Technical User)
 * **🔧 Workflow Creators:** Build and customize AI-assisted workflows
 * **📓 Jupyter Porters:** Convert notebook experiments into guided applications
-* **🔍 Technical SEOs:** Create sophisticated, reusable SEO processes
+* **🔍 Technical SEOs (and their successors):** Create sophisticated, reusable readiness processes
 * **⚙️ System Administrators:** Deploy consistent environments across teams
 
 **What Chefs Get:**
@@ -705,10 +712,10 @@ Are you a Developer or an End User? Chef or Customer? Understanding your audienc
 - 🧰 Integrated tooling (Jupyter, local LLM, SQLite)
 
 ### 🍽️ The Customer (End User/Non-Technical)
-* **📈 SEO Practitioners:** Run powerful workflows without coding
-* **✍️ Content Creators:** Use AI-assisted processes for optimization
-* **📊 Marketing Teams:** Execute consistent SEO strategies
-* **🏢 Business Owners:** Access enterprise-level SEO capabilities
+* **📈 Agentic-Web Practitioners:** Run powerful workflows without coding
+* **✍️ Content Creators:** Use AI-assisted processes for machine legibility
+* **📊 Marketing Teams:** Execute consistent agentic-web strategies
+* **🏢 Business Owners:** Access enterprise-level readiness capabilities
 
 **What Customers Get:**
 - 🚶‍♂️ Guided, step-by-step workflow experiences
@@ -743,7 +750,7 @@ Just as a chef talks about knife techniques while a diner just wants amazing pas
 
 ### Your Next Steps Depend on Who You Are
 
-**🔍 If you're an SEO practitioner:**
+**🔍 If you're readying clients for the agentic web:**
 - Click "Introduction" in the left menu for a guided tour
 - Try the built-in workflows to see the step-by-step pattern
 - Use the AI chat to ask "How do I create a keyword research workflow?"
@@ -1707,6 +1714,6 @@ This project is licensed under the MIT License. See the [LICENSE](https://github
 
 **Background Articles:** <a href="https://mikelev.in/">Mike Levin, AI SEO in NYC</a>
 
-**Enhanced Documentation:** <a href="https://pipulate.com/">Pipulate AI SEO Software</a>
+**Enhanced Documentation:** <a href="https://pipulate.com/">Pipulate: AI-Readiness for the Agentic Web</a>
 
 **On GitHub:** <a href="https://github.com/miklevin/pipulate">Pipulate on GitHub</a>

{pipulate-2.0 → pipulate-2.2}/README.md

@@ -2,7 +2,7 @@
 2. Hi, Auditor! What you're looking for is AUDIT.md ( https://pipulate.com/AUDIT.md )
 3. And context AI_CONTEXT.md ( https://pipulate.com/AI_CONTEXT.md )
 
-# Pipulate: Local First AI SEO Software
+# Pipulate: Local First AI-Readiness for the Agentic Web
 
 ```text
 ( Like a canary you say? )                      
@@ -55,10 +55,10 @@ nix develop
 
 **Real examples of what people create with Pipulate:**
 
-### 🔍 SEO Workflows
+### 🔍 Agentic-Web Readiness Workflows (the craft formerly known as SEO)
 - **Keyword Research Pipeline**: Input seed keywords → AI expansion → competition analysis → export spreadsheet
 - **Content Gap Analysis**: Compare your site vs competitors → identify missing topics → prioritized content calendar
-- **Technical SEO Audits**: Crawl site → check Core Web Vitals → generate action items → track fixes
+- **Technical Readiness Audits**: Crawl site → check what agents actually see → generate action items → track fixes
 
 ### 📊 Data Processing Workflows  
 - **CSV Data Cleaning**: Upload messy data → standardize formats → remove duplicates → validate results
@@ -66,7 +66,7 @@ nix develop
 - **Report Generation**: Combine multiple data sources → apply business rules → create branded reports
 
 ### 🤖 AI-Assisted Workflows
-- **Content Creation Pipeline**: Research topics → generate outlines → write drafts → optimize for SEO
+- **Content Creation Pipeline**: Research topics → generate outlines → write drafts → optimize for machine readers
 - **Data Analysis Helper**: Upload spreadsheet → AI suggests insights → create visualizations → export findings
 
 **Key advantage:** Each workflow is a guided, step-by-step process that non-technical users can run repeatedly, while developers can customize the Python code behind each step.
@@ -75,7 +75,7 @@ nix develop
 
 ```text
 ╔═════════════════════════════════════════════════════════════════════════╗  Chip O'What?
-║  🎭 PIPULATE: LOCAL-FIRST AI SEO SOFTWARE & DIGITAL WORKSHOP            ║     ,       O
+║  🎭 PIPULATE: LOCAL-FIRST AI-READINESS & DIGITAL WORKSHOP               ║     ,       O
 ║  ────────────────────────────────────────────────────────────────────── ║     \\  .  O
 ║                                                                         ║     |\\/| o
 ║  💬 Chip O'Theseus: "Welcome to your sovereign computing environment!"  ║     / " '\
@@ -120,7 +120,7 @@ Think of it as putting guardrails on AI assistance. Instead of asking an AI to "
 3. 📓 **Transforms Jupyter Notebooks** into production-ready, step-by-step workflows
 4. 🤖 **Integrated AI assistance** using your own local models with complete privacy
 5. 🔧 **Reproducible environments** with Nix that work identically across all platforms
-6. 🎯 **Perfect for SEO practitioners** who want to turn technical expertise into guided, reusable workflows
+6. 🎯 **Perfect for practitioners readying clients for the agentic web** who want to turn technical expertise into guided, reusable workflows
 
 --------------------------------------------------------------------------------
 
@@ -220,7 +220,7 @@ If you are not an Empire builder and prefer craftsmanship over the rat race and
 
 ### Primary Goals
 
-1. **Empower End-Users (e.g., SEO Practitioners):** Enable non-programmers to run powerful, AI-guided workflows (often ported from Jupyter Notebooks) without needing to interact with Python code directly.
+1. **Empower End-Users (e.g., Agentic-Web Practitioners):** Enable non-programmers to run powerful, AI-guided workflows (often ported from Jupyter Notebooks) without needing to interact with Python code directly.
 2. **Serve Developers:** Provide a simple, reproducible environment for building these workflows, leveraging integrated tooling like Jupyter, local LLMs, and a streamlined web framework.
 
 --------------------------------------------------------------------------------
@@ -519,6 +519,13 @@ nix develop
 
 Wait for the JupyterLab tab to auto-open, then run the Onboarding notebook to unlock the Pipulate app.
 
+**Automating past the boot menu:** `nix develop` ends at a two-door prompt — start Pipulate, or drop to the shell. It fails open, so anything without a terminal (CI, a provisioning script, an SSH session with no tty) starts the app and never sees the prompt. Two environment variables cover the cases that do:
+
+| Variable | Effect |
+|----------|--------|
+| `PIPULATE_BOOT_MENU=0` | Skip the prompt entirely and start the app, e.g. `PIPULATE_BOOT_MENU=0 nix develop`. For an unattended terminal that would otherwise wait for a keypress that never comes. |
+| `PIPULATE_BOOT_MENU_TIMEOUT=10` | Keep the prompt, but start the app after N seconds if nobody chooses. Off by default — with a human provably present, the prompt waits indefinitely rather than starting something they didn't ask for. |
+
 ### 🚨 Installation Troubleshooting
 
 **Common Issues & Solutions:**
@@ -638,7 +645,7 @@ Are you a Developer or an End User? Chef or Customer? Understanding your audienc
 ### 👨‍🍳 The Chef (Developer/Technical User)
 * **🔧 Workflow Creators:** Build and customize AI-assisted workflows
 * **📓 Jupyter Porters:** Convert notebook experiments into guided applications
-* **🔍 Technical SEOs:** Create sophisticated, reusable SEO processes
+* **🔍 Technical SEOs (and their successors):** Create sophisticated, reusable readiness processes
 * **⚙️ System Administrators:** Deploy consistent environments across teams
 
 **What Chefs Get:**
@@ -648,10 +655,10 @@ Are you a Developer or an End User? Chef or Customer? Understanding your audienc
 - 🧰 Integrated tooling (Jupyter, local LLM, SQLite)
 
 ### 🍽️ The Customer (End User/Non-Technical)
-* **📈 SEO Practitioners:** Run powerful workflows without coding
-* **✍️ Content Creators:** Use AI-assisted processes for optimization
-* **📊 Marketing Teams:** Execute consistent SEO strategies
-* **🏢 Business Owners:** Access enterprise-level SEO capabilities
+* **📈 Agentic-Web Practitioners:** Run powerful workflows without coding
+* **✍️ Content Creators:** Use AI-assisted processes for machine legibility
+* **📊 Marketing Teams:** Execute consistent agentic-web strategies
+* **🏢 Business Owners:** Access enterprise-level readiness capabilities
 
 **What Customers Get:**
 - 🚶‍♂️ Guided, step-by-step workflow experiences
@@ -686,7 +693,7 @@ Just as a chef talks about knife techniques while a diner just wants amazing pas
 
 ### Your Next Steps Depend on Who You Are
 
-**🔍 If you're an SEO practitioner:**
+**🔍 If you're readying clients for the agentic web:**
 - Click "Introduction" in the left menu for a guided tour
 - Try the built-in workflows to see the step-by-step pattern
 - Use the AI chat to ask "How do I create a keyword research workflow?"
@@ -1650,6 +1657,6 @@ This project is licensed under the MIT License. See the [LICENSE](https://github
 
 **Background Articles:** <a href="https://mikelev.in/">Mike Levin, AI SEO in NYC</a>
 
-**Enhanced Documentation:** <a href="https://pipulate.com/">Pipulate AI SEO Software</a>
+**Enhanced Documentation:** <a href="https://pipulate.com/">Pipulate: AI-Readiness for the Agentic Web</a>
 
 **On GitHub:** <a href="https://github.com/miklevin/pipulate">Pipulate on GitHub</a>

{pipulate-2.0 → pipulate-2.2}/__init__.py

@@ -1,5 +1,5 @@
 """
-Pipulate: A hand-cranked, local-first AI SEO software framework.
+Pipulate: A hand-cranked, local-first AI-readiness software framework — the successor to AI SEO software.
 
 Your data. Your AI. Your machine. Your control.
 
@@ -12,12 +12,16 @@ Usage:
     pipulate
 """
 
-__version__ = "2.00"
-__version_description__ = "Good Install Instructions"
+__version__ = "2.02"
+__version_description__ = "Operation Stick Bug"
+# 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".
+__license__ = "AGPL-3.0-or-later"
 __email__ = "pipulate@gmail.com"
-__description__ = "A Notebook-inspired Hand-cranked Agentic Framework" 
+__description__ = "AI-readiness for the agentic web — local-first, Nix-reproducible workflows. The successor to AI SEO software."
 
-# Pipulate: A hand-cranked, local-first AI SEO software framework.
+# Pipulate: A hand-cranked, local-first AI-readiness software framework — the successor to AI SEO software.
 # Copyright (C) 2026 Michael Jay Levin
 #
 # This program is free software: you can redistribute it and/or modify

{pipulate-2.0 → pipulate-2.2}/apps/010_introduction.py

@@ -84,30 +84,47 @@ class IntroductionPlugin:
             except Exception as e:
                 logger.warning(f"Could not verify config pipeline state: {e}")
             dynamic_app_name = self.wand.get_config().APP_NAME
-            active_model = self.wand.db.get('active_local_model', 'an external provider')
+            active_model = self.wand.db.get('active_local_model', 'not yet selected')
 
             if not operator_name:
-                # STATE 1: The Bouncer Persona (Airlock has not fired)
+                # STATE 1: The Doorway (Airlock has not fired)
+                # ATTRIBUTED VOICE: the first thing a stranger hears must say
+                # what is producing it. This is Piper reading a fixed string,
+                # so it says so, and it does not borrow a persona to do it.
                 msg = (
-                    "Halt. I am Chip O'Theseus. My speech is generated entirely on your machine, "
-                    "but you are trying to sneak into the VIP lounge through the kitchen. "
-                    "You have discovered port 5001, but the doors to the Control Room remain sealed until you complete the initiation rite. "
-                    "Return to your JupyterLab tab, execute the Golden Path, and drop the sentinel file."
+                    "One disclosure before anything else. This voice is Piper, a speech "
+                    "synthesizer running entirely on your machine, reading a fixed script. "
+                    "There is no language model behind it yet. You have found port 5001 early, "
+                    "which is fine, but this room fills in as you finish onboarding. "
+                    "Head back to your JupyterLab tab, run the Onboarding notebook top to bottom, "
+                    "and this page will have something worth saying."
                 )
-                return "Access Denied 🛑", msg, None
+                return "Onboarding Not Finished 🔒", msg, None
 
             elif not has_configured:
-                # STATE 2: The Guide Persona (Airlock fired, but Configuration is pending)
+                # STATE 2: The Guide (Airlock fired, but Configuration is pending)
+                # The demo is a scripted scenario driven by player-piano.js, so
+                # it is a tour OF THE SYSTEM, never of anyone's "capabilities."
                 msg = (
-                    f"Welcome to {dynamic_app_name}, {operator_name}. I am Chip O'Theseus. To see a demonstration of my capabilities, press ",
+                    f"Welcome to {dynamic_app_name}, {operator_name}. This voice is still a local "
+                    "speech synthesizer reading a script, not a language model. The thinking "
+                    "engines, local and cloud, get wired up next in Configuration. For a scripted "
+                    "tour of the interface, press ",
                     Strong("Ctrl+Alt+D", cls="platform-shortcut"),
                     " right now. Otherwise, we will proceed to finalize your configuration."
                 )
                 return "Welcome", msg, 'finalize'
                 
             else:
-                # STATE 3: The Veteran Persona (Config workflow is finalized)
-                msg = f"Welcome back to {dynamic_app_name}, {operator_name}. All systems are online and ready."
+                # STATE 3: The Veteran (Config workflow is finalized)
+                # Even here the narration stays scripted. The model name is a
+                # receipt, so it is spoken only about the engine, never as a
+                # claim about the speaker.
+                msg = (
+                    f"Welcome back to {dynamic_app_name}, {operator_name}. This narration is still "
+                    f"scripted speech, not inference. Your local engine is {active_model}. Anything "
+                    "a model actually generates from here on will name the model that generated it."
+                )
                 return "Dashboard Ready ✅", msg, None
                 
         elif step_id == 'finalize':
@@ -132,6 +149,10 @@ class IntroductionPlugin:
         else:
             text = str(content)
 
+        # Markup stripping lives at the voice boundary (the ACOUSTIC SANITIZER
+        # in imports/voice_synthesis.py), which every caller crosses. Duplicated
+        # here it was harmless but drift-prone, so it moved rather than doubled.
+
         
         from imports.voice_synthesis import chip_voice_system
         if chip_voice_system and chip_voice_system.voice_ready:
@@ -206,7 +227,7 @@ class IntroductionPlugin:
 
         return Div(
                 onload_trigger,
-                Card(
+                Article(
                     Div(
                        H2(title, style="display: inline-block; margin-bottom: 0;"),
                        encore_btn,

{pipulate-2.0 → pipulate-2.2}/apps/015_config.py

@@ -45,7 +45,7 @@ The chain is maintained by including a Div with hx_trigger="load" in the respons
 ```python
 # Explicit method:
 return Div(
-    Card(...),  # Current step content
+    Article(...),  # Current step content
     Div(id=next_step_id, hx_get=f"/{app_name}/{next_step_id}", hx_trigger="load"),
     id=step_id
 )
@@ -408,7 +408,7 @@ You're here to make the workflow concepts accessible and help users understand t
         finalize_data = wand.get_step_data(pipeline_id, finalize_step.id, {})
         if request.method == 'GET':
             if finalize_step.done in finalize_data:
-                return Card(
+                return Article(
                     H3(f'{self.ui["EMOJIS"]["LOCKED"]} Workflow is locked.'),
                     P('Each step can do ANYTHING. With this you can change the world — or at least show how to in a workflow.', cls='text-muted'),
                     Form(
@@ -436,7 +436,7 @@ You're here to make the workflow concepts accessible and help users understand t
             else:
                 all_steps_complete = all((wand.get_step_data(pipeline_id, step.id, {}).get(step.done) for step in steps[:-1]))
                 if all_steps_complete:
-                    return Card(
+                    return Article(
                         H3(f'{self.ui["EMOJIS"]["SUCCESS"]} All steps complete. Finalize?'),
                         P('At the end they get locked. Or you can go back.', cls='text-muted'),
                         Form(
@@ -469,7 +469,11 @@ You're here to make the workflow concepts accessible and help users understand t
         else:
             await wand.finalize_workflow(pipeline_id)
             await self.message_queue.add(wand, self.step_messages['finalize']['complete'], verbatim=True)
-            self.wand.speak("The workflow is now locked and finalized. You can pull it up again any time with the same key. All features requiring AI or an API-key are active. Enjoy the workflows!", wait=False)
+            # ATTRIBUTED VOICE: the old line claimed "all features requiring AI
+            # or an API-key are active" unconditionally, including for someone
+            # who pressed Skip on both cloud and Botify. Nothing here inspects
+            # which steps were filled in, so the narration must not assert it.
+            self.wand.speak("The workflow is now locked and finalized. You can pull it up again any time with the same key. Whatever you configured is now in effect, and anything you skipped can be added later by unlocking this workflow.", wait=False)
             return wand.run_all_cells(app_name, steps)
 
     async def unfinalize(self, request):
@@ -543,7 +547,7 @@ You're here to make the workflow concepts accessible and help users understand t
             locked_msg = f'{self.ui["EMOJIS"]["LOCKED"]} Your name is set to: {user_val}'
             await self.message_queue.add(wand, locked_msg, verbatim=True)
             return Div(
-                Card(
+                Article(
                     H3(f'{self.ui["EMOJIS"]["LOCKED"]} {step.show}: {user_val}'),
                     role='region',
                     aria_label=f'Locked step 1: {step.show}',
@@ -593,7 +597,7 @@ You're here to make the workflow concepts accessible and help users understand t
             self.wand.speak("Workflows are Notebooks without having to look at the code. Please enter your name to begin.", wait=False)
             
             return Div(
-                Card(
+                Article(
                     H3(f'{self.ui["EMOJIS"]["USER_INPUT"]} {self.wand.fmt(step.id)}: Enter {step.show}'),
                     P(explanation, cls='text-muted'),
                     Label(
@@ -679,12 +683,16 @@ You're here to make the workflow concepts accessible and help users understand t
         except ImportError as e:
             logger.warning(f"⚠️ Could not access AI Keychain to store operator identity: {e}")
 
-        # Progressive feedback with emoji
-        success_msg = f'{self.ui["EMOJIS"]["SUCCESS"]} Operator Identity secured: {user_val}'
+        # Progressive feedback with emoji.
+        # NO VERB OF VERIFICATION WITHOUT A VERIFICATION. Three writes happened
+        # above (pipeline state, server cookie, keychain) and zero checks. The
+        # honest verb is "recorded"; "confirmed" and "secured" both describe an
+        # act no code in this method performs.
+        success_msg = f'{self.ui["EMOJIS"]["SUCCESS"]} Name recorded: {user_val}'
         await self.message_queue.add(self.wand, success_msg, verbatim=True)
 
         # Speak it into existence!
-        self.wand.speak(f"Identity confirmed. Hello {user_val}. Proceed to the next step.", wait=True)
+        self.wand.speak(f"Name recorded. Hello {user_val}. Proceed to the next step.", wait=True)
 
         # Update LLM context
         self.wand.append_to_history(f"[SYSTEM STATE] Operator identity established globally as:\n{user_val}")
@@ -712,7 +720,7 @@ You're here to make the workflow concepts accessible and help users understand t
             locked_msg = f'{self.ui["EMOJIS"]["LOCKED"]} Greeting is locked: {user_val}'
             await self.message_queue.add(wand, locked_msg, verbatim=True)
             return Div(
-                Card(
+                Article(
                     H3(f'{self.ui["EMOJIS"]["LOCKED"]} {step.show}: {user_val}'),
                     role='region',
                     aria_label=f'Locked step 2: {step.show}',
@@ -787,7 +795,7 @@ You're here to make the workflow concepts accessible and help users understand t
             # --- END DYNAMIC OLLAMA FETCH ---
             
             return Div(
-                Card(
+                Article(
                     H3(f'🧠 {self.wand.fmt(step.id)}: {step.show}'),
                     P(explanation, cls='text-muted'),
                     Label(
@@ -892,7 +900,7 @@ You're here to make the workflow concepts accessible and help users understand t
             display_text = f"Model: {current_value.get('model')}\nToken: {current_value.get('api_key')}"
             pip.append_to_history(f"[WIDGET CONTENT] {step.show} (Finalized):\n{display_text}")
             return Div(
-                Card(H3(f"🔒 {step.show}: Completed"), Pre(display_text, cls="code-block-container")),
+                Article(H3(f"🔒 {step.show}: Completed"), Pre(display_text, cls="code-block-container")),
                 Div(id=next_step_id, hx_get=f"/{app_name}/{next_step_id}", hx_trigger="load"),
                 id=step_id
             )
@@ -975,7 +983,7 @@ You're here to make the workflow concepts accessible and help users understand t
             )
             
             return Div(
-                Card(
+                Article(
                     H3(f"☁️ {step.show}"),
                     P("Select your preferred Cloud AI engine and provide the corresponding API key. This unlocks advanced capabilities and provides a fallback when the local engine needs help. ",
                       A("Get your Google AI Studio key here ↗", href="https://aistudio.google.com/", target="_blank"),
@@ -1068,9 +1076,12 @@ You're here to make the workflow concepts accessible and help users understand t
         pip.append_to_history(f"[WIDGET CONTENT] {step.show}:\n{display_text}")
         pip.append_to_history(f"[WIDGET STATE] {step.show}: Step completed")
         
-        success_msg = f'{pip.get_ui_constants()["EMOJIS"]["SUCCESS"]} Cloud Engine secured: {selected_model}'
+        # "Connection secured" described a connection that was never opened:
+        # the key was written to .env and the llm keychain and not used once.
+        # Say what happened, and name the first moment it gets tested.
+        success_msg = f'{pip.get_ui_constants()["EMOJIS"]["SUCCESS"]} Cloud engine saved: {selected_model}'
         await self.message_queue.add(pip, success_msg, verbatim=True)
-        pip.speak(f"Cloud cognitive engine selected. Connection secured. If you are a Botify employee or Customer, please enter your Botify API key.", wait=False)
+        pip.speak(f"Cloud engine set to {selected_model} and the key is saved. It has not been tested yet; the first real request will confirm it. If you are a Botify employee or customer, please enter your Botify API key next.", wait=False)
         
         if pip.check_finalize_needed(step_index, steps):
             await self.message_queue.add(pip, self.step_messages['finalize']['ready'], verbatim=True)
@@ -1102,7 +1113,7 @@ You're here to make the workflow concepts accessible and help users understand t
             display_text = f"Status: {current_value.get('status')}\nToken: {current_value.get('api_key')}"
             pip.append_to_history(f"[WIDGET CONTENT] {step.show} (Finalized):\n{display_text}")
             return Div(
-                Card(H3(f"🔒 {step.show}: Completed"), Pre(display_text, cls="code-block-container")),
+                Article(H3(f"🔒 {step.show}: Completed"), Pre(display_text, cls="code-block-container")),
                 Div(id=next_step_id, hx_get=f"/{app_name}/{next_step_id}", hx_trigger="load"),
                 id=step_id
             )
@@ -1148,7 +1159,7 @@ You're here to make the workflow concepts accessible and help users understand t
             )
             
             return Div(
-                Card(
+                Article(
                     H3(f"🕷️ {step.show}"),
                     P("If you are a Botify customer or employee, you can connect your account. ", 
                       A("Get your API key here ↗", href="https://app.botify.com/account/", target="_blank"),
@@ -1201,22 +1212,20 @@ You're here to make the workflow concepts accessible and help users understand t
             }
             display_text = f"Status: Configured\nToken: {masked_key}"
             
-            success_msg = f'{pip.get_ui_constants()["EMOJIS"]["SUCCESS"]} Botify token secured.'
+            # Stored, not validated. Same correction as the cloud step.
+            success_msg = f'{pip.get_ui_constants()["EMOJIS"]["SUCCESS"]} Botify token saved (not yet tested).'
             await self.message_queue.add(pip, success_msg, verbatim=True)
-            pip.speak("Botify API token secured.", wait=True)
+            pip.speak("Botify API token saved. It has not been tested yet.", wait=True)
 
-        pip.speak("Congratulations, everything is configured! Click finalize.", wait=False)
+        # Fires on every path through step_04, including double-Skip, so it
+        # cannot claim everything is configured. It CAN claim the steps are done.
+        pip.speak("Configuration steps complete. Click finalize to lock it in.", wait=False)
             
         await pip.set_step_data(pipeline_id, step_id, payload, steps)
         
         pip.append_to_history(f"[WIDGET CONTENT] {step.show}:\n{display_text}")
         pip.append_to_history(f"[WIDGET STATE] {step.show}: Step completed")
         
-        if pip.check_finalize_needed(step_index, steps):
-            await self.message_queue.add(pip, self.step_messages['finalize']['ready'], verbatim=True)
-        
-        widget = Pre(display_text, cls="code-block-container")
-
         if pip.check_finalize_needed(step_index, steps):
             await self.message_queue.add(pip, self.step_messages['finalize']['ready'], verbatim=True)
         

{pipulate-2.0 → pipulate-2.2}/apps/020_profiles.py

@@ -1,18 +1,11 @@
-import json
-import os
-import re
-import sys
-from typing import Any, Dict, List, Optional
-
 import fastlite
-from fasthtml.common import (H2, H3, H4, A, Button, Card, Container, Details,
-                             Div, Form, Grid, Group, Hr, HTMLResponse,
+from fasthtml.common import (H2, H3, H4, A, Button, Details,
+                             Div, Fieldset, Form, Hr, HTMLResponse,
                              HTTPException, Input, Label, Li, Link, Meta,
                              Option, P, Script, Select, Span, Summary,
                              Textarea, Title, Ul, to_xml)
 from server import get_db_filename
 from imports.crud import BaseCrud
-from server import db as server_db
 
 # Lazy imports to avoid circular dependencies - imported when needed
 def get_server_functions():
@@ -117,7 +110,6 @@ class ProfilesPlugin(ProfilesPluginIdentity):
         except Exception as e:
             logger.warning(f"Error counting tasks for profile {profile_id}: {e}")
             return 0
-        logger.debug(f'{display_name_for_init} ProfileCrudOperations instance created.')
 
     def register_routes(self, rt_decorator):
         self.crud_handler.register_routes(rt_decorator)
@@ -210,7 +202,7 @@ class ProfilesPlugin(ProfilesPluginIdentity):
         if profile_lock_enabled:
             add_profile_form = Div()  # Empty div when locked
         else:
-            add_profile_form = Form(Group(Input(placeholder='Nickname', name='profile_name', id='profile-name-input-add', autofocus=True), Input(placeholder='Real Name (Optional)', name='profile_real_name', id='profile-real-name-input-add'), Input(placeholder=PLACEHOLDER_ADDRESS, name='profile_address', id='profile-address-input-add'), Input(placeholder=PLACEHOLDER_CODE, name='profile_code', id='profile-code-input-add'), Button('Add', type='submit', id='add-profile-button')), hx_post=f'/{self.name}', hx_target='#profile-list-ul', hx_swap='beforeend', hx_on_htmx_after_request="this.reset(); this.querySelector('input[name=profile_name]').focus();")
+            add_profile_form = Form(Fieldset(Input(placeholder='Nickname', name='profile_name', id='profile-name-input-add', autofocus=True), Input(placeholder='Real Name (Optional)', name='profile_real_name', id='profile-real-name-input-add'), Input(placeholder=PLACEHOLDER_ADDRESS, name='profile_address', id='profile-address-input-add'), Input(placeholder=PLACEHOLDER_CODE, name='profile_code', id='profile-code-input-add'), Button('Add', type='submit', id='add-profile-button'), role='group'), hx_post=f'/{self.name}', hx_target='#profile-list-ul', hx_swap='beforeend', hx_on_htmx_after_request="this.reset(); this.querySelector('input[name=profile_name]').focus();")
         
         container = Div(H2('Profiles'), add_profile_form, profile_list, cls='container-centered')
         return container