pipulate 1.99__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-1.99 → pipulate-2.2}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: pipulate
-Version: 1.99
-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,12 +59,17 @@ 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
 
-![Pipulate Free & Open Source SEO with & for LLMs](https://github.com/miklevin/pipulate/raw/main/assets/images/ai-seo-software.png)
-
-> **Your data. Your AI. Your machine. Your control.**  
-> No subscriptions, no vendor lock-in, no cloud costs.  
+```text
+( Like a canary you say? )                      
+                                           O        /)  ____            The "No Problem" Framework
+>  I HEREBY WILL NOT RE-GENERATE            o /)\__//  /    \        Pipulate - Protecting Your Code 
+>  Once upon machines be smarten          ___(/_ 0 0  |      |       just by being honest about text.
+>  ASCII sealing immutata art in        *(    ==(_T_)== NPvg |        (If mangled, then AI drifted.)
+>  This here cony if it's broken          \  )   ""\  |      |             https://pipulate.com
+>  Smokin gun drift now in token           |__>-\_>_>  \____/                     🥕🥕🥕
+```
 
 ## Quick Start: Be Running in 5 Minutes
 
@@ -78,7 +83,7 @@ curl -fsSL https://pipulate.com/install.sh | bash
 
 ```bash
 # 2. Launch it
-nix develop
+cd ~/pipulate && nix develop
 ```
 
 **What you get:** A local web app at `http://localhost:5001` with step-by-step workflows, integrated AI chat, and a JupyterLab instance at `http://localhost:8888`. No cloud required.
@@ -107,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
@@ -118,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.
@@ -127,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!"  ║     / " '\
@@ -172,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
 
 --------------------------------------------------------------------------------
 
@@ -272,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.
 
 --------------------------------------------------------------------------------
@@ -564,12 +569,19 @@ The installation procedures labeled "Quick Start Guide" and the main installatio
 
 ```bash
 rm -rf ~/TestProject
-curl -L https://pipulate.com/install.sh | bash -s TestProject
+curl -fsSL https://pipulate.com/install.sh | bash -s TestProject
 cd ~/TestProject
-./run
+nix develop
 ```
 
-Wait for ***BOTH TABS*** to auto-open in your browser.
+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
 
@@ -690,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:**
@@ -700,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
@@ -719,9 +731,9 @@ Just as a chef talks about knife techniques while a diner just wants amazing pas
 **After installation succeeds, here's what to expect:**
 
 ### What You'll See
-1. **Two browser tabs open automatically:**
+1. **JupyterLab opens automatically** for onboarding. Completing the Onboarding notebook unlocks the Pipulate app, which then opens automatically on future launches:
+   - `localhost:8888` - JupyterLab for development/experimentation (opens first)
    - `localhost:5001` - Pipulate web interface with navigation menu
-   - `localhost:8888` - JupyterLab for development/experimentation
 
 2. **In the Pipulate interface:**
    - Left sidebar with workflow plugins (Introduction, Profiles, etc.)
@@ -738,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?"
@@ -820,11 +832,11 @@ Traditional development follows DRY principles, creating abstract, complex syste
 
 ## Developer Setup & Environment Notes
 
-**Nix Environment Activation:** Always run `./run` (a.k.a. `nix develop`) from the `~/pipulate` directory *before* running any project commands (`python server.py`, `pip install`, etc.) in a new terminal. This ensures you are using the correct dependencies defined in `flake.nix`.
+**Nix Environment Activation:** Always run `nix develop` from the `~/pipulate` directory *before* running any project commands (`python server.py`, `pip install`, etc.) in a new terminal. This ensures you are using the correct dependencies defined in `flake.nix`.
 
 **Interactive vs. Quiet Shell:**
 
-**Standard Shell:** `./run` (same as `nix develop` or `nix develop .#default`) runs the startup script (`run-script` defined in `flake.nix`) with welcome messages and service startup. Ideal for general use.
+**Standard Shell:** `nix develop` (the same as `nix develop .#default`) runs the startup script (`run-script` defined in `flake.nix`) with welcome messages and service startup. Ideal for general use.
 
 **Quiet Shell:** `nix develop .#quiet` activates the Nix environment *without* running the full startup script or launching services automatically. It only sets up paths and installs pip requirements. Use this for:
 - Running specific commands without starting the servers (e.g., `nix develop .#quiet --command python -c "import pandas"`).
@@ -1407,10 +1419,10 @@ create_workflow.py               │ └──────┬──────
 ### Essential Commands
 ```bash
 # Development workflow
-cd ~/pipulate && ./run          # Start Pipulate
+cd ~/pipulate && nix develop          # Start Pipulate
 nix develop .#quiet                   # Start without auto-services
 python server.py                     # Manual server start
-git pull && ./run              # Update to latest
+git pull && nix develop              # Update to latest
 
 # Create new workflows  
 python helpers/workflow/create_workflow.py my_workflow.py MyClass my_internal_name
@@ -1702,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-1.99 → pipulate-2.2}/README.md

@@ -2,12 +2,17 @@
 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
 
-![Pipulate Free & Open Source SEO with & for LLMs](https://github.com/miklevin/pipulate/raw/main/assets/images/ai-seo-software.png)
-
-> **Your data. Your AI. Your machine. Your control.**  
-> No subscriptions, no vendor lock-in, no cloud costs.  
+```text
+( Like a canary you say? )                      
+                                           O        /)  ____            The "No Problem" Framework
+>  I HEREBY WILL NOT RE-GENERATE            o /)\__//  /    \        Pipulate - Protecting Your Code 
+>  Once upon machines be smarten          ___(/_ 0 0  |      |       just by being honest about text.
+>  ASCII sealing immutata art in        *(    ==(_T_)== NPvg |        (If mangled, then AI drifted.)
+>  This here cony if it's broken          \  )   ""\  |      |             https://pipulate.com
+>  Smokin gun drift now in token           |__>-\_>_>  \____/                     🥕🥕🥕
+```
 
 ## Quick Start: Be Running in 5 Minutes
 
@@ -21,7 +26,7 @@ curl -fsSL https://pipulate.com/install.sh | bash
 
 ```bash
 # 2. Launch it
-nix develop
+cd ~/pipulate && nix develop
 ```
 
 **What you get:** A local web app at `http://localhost:5001` with step-by-step workflows, integrated AI chat, and a JupyterLab instance at `http://localhost:8888`. No cloud required.
@@ -50,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
@@ -61,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.
@@ -70,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!"  ║     / " '\
@@ -115,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
 
 --------------------------------------------------------------------------------
 
@@ -215,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.
 
 --------------------------------------------------------------------------------
@@ -507,12 +512,19 @@ The installation procedures labeled "Quick Start Guide" and the main installatio
 
 ```bash
 rm -rf ~/TestProject
-curl -L https://pipulate.com/install.sh | bash -s TestProject
+curl -fsSL https://pipulate.com/install.sh | bash -s TestProject
 cd ~/TestProject
-./run
+nix develop
 ```
 
-Wait for ***BOTH TABS*** to auto-open in your browser.
+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
 
@@ -633,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:**
@@ -643,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
@@ -662,9 +674,9 @@ Just as a chef talks about knife techniques while a diner just wants amazing pas
 **After installation succeeds, here's what to expect:**
 
 ### What You'll See
-1. **Two browser tabs open automatically:**
+1. **JupyterLab opens automatically** for onboarding. Completing the Onboarding notebook unlocks the Pipulate app, which then opens automatically on future launches:
+   - `localhost:8888` - JupyterLab for development/experimentation (opens first)
    - `localhost:5001` - Pipulate web interface with navigation menu
-   - `localhost:8888` - JupyterLab for development/experimentation
 
 2. **In the Pipulate interface:**
    - Left sidebar with workflow plugins (Introduction, Profiles, etc.)
@@ -681,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?"
@@ -763,11 +775,11 @@ Traditional development follows DRY principles, creating abstract, complex syste
 
 ## Developer Setup & Environment Notes
 
-**Nix Environment Activation:** Always run `./run` (a.k.a. `nix develop`) from the `~/pipulate` directory *before* running any project commands (`python server.py`, `pip install`, etc.) in a new terminal. This ensures you are using the correct dependencies defined in `flake.nix`.
+**Nix Environment Activation:** Always run `nix develop` from the `~/pipulate` directory *before* running any project commands (`python server.py`, `pip install`, etc.) in a new terminal. This ensures you are using the correct dependencies defined in `flake.nix`.
 
 **Interactive vs. Quiet Shell:**
 
-**Standard Shell:** `./run` (same as `nix develop` or `nix develop .#default`) runs the startup script (`run-script` defined in `flake.nix`) with welcome messages and service startup. Ideal for general use.
+**Standard Shell:** `nix develop` (the same as `nix develop .#default`) runs the startup script (`run-script` defined in `flake.nix`) with welcome messages and service startup. Ideal for general use.
 
 **Quiet Shell:** `nix develop .#quiet` activates the Nix environment *without* running the full startup script or launching services automatically. It only sets up paths and installs pip requirements. Use this for:
 - Running specific commands without starting the servers (e.g., `nix develop .#quiet --command python -c "import pandas"`).
@@ -1350,10 +1362,10 @@ create_workflow.py               │ └──────┬──────
 ### Essential Commands
 ```bash
 # Development workflow
-cd ~/pipulate && ./run          # Start Pipulate
+cd ~/pipulate && nix develop          # Start Pipulate
 nix develop .#quiet                   # Start without auto-services
 python server.py                     # Manual server start
-git pull && ./run              # Update to latest
+git pull && nix develop              # Update to latest
 
 # Create new workflows  
 python helpers/workflow/create_workflow.py my_workflow.py MyClass my_internal_name
@@ -1645,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-1.99 → 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__ = "1.99"
-__version_description__ = "Softwired Paths"
+__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-1.99 → 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,