Command-Line Surgery: A Live Refactor to Untangle a Codebase

✦ You've hit on a crucial point of architectural clarity. Having multiple, conceptually
  overlapping systems (plugins, modules, tools) can definitely lead to confusion down the road.
  Your instinct to define and perhaps rename them based on their distinct functions is a great
  one for long-term maintainability.

  I will now analyze the repository to confirm your observations about these three systems. I
  will not change any code. My goal is to explore the structure and purpose of each directory
  and report back on how they align with your proposed clarification (imports, apps, and tools).


  First, I'll start by listing the contents of the plugins/ and modules/ directories to see
  their structure.
 ╭──────────────────────────────────────────────────────────────────────────────────────────╮
 │ ✓  ReadFolder plugins                                                                    │
 │                                                                                          │
 │    Listed 40 item(s).                                                                    │
 │                                                                                          │
 │ ✓  ReadFolder modules                                                                    │
 │                                                                                          │
 │    Listed 15 item(s).                                                                    │
 ╰──────────────────────────────────────────────────────────────────────────────────────────╯
✦ Okay, the directory listings are very revealing and support your assessment:

   * `plugins/`: The numbered file names (010_introduction.py, 040_hello_workflow.py) strongly
     imply a system where modules are loaded in a specific order to build the application's
     navigation and features. This fits your "apps" concept perfectly.
   * `modules/`: These look exactly like standard Python library code (crud.py,
     voice_synthesis.py). They are self-contained units of functionality, fitting your "imports"
     concept.

  To confirm this, I'll now dive one level deeper. I will read a sample file from each directory
   (plugins/040_hello_workflow.py and modules/crud.py) and, most importantly, I'll search
  server.py to find the custom logic that loads the plugins/ directory, as you correctly
  suspected it's not a standard import system.
 ╭───────────────────────────────────────────────────────────────────────────────────────╮
 │ ✓  ReadFile plugins/040_hello_workflow.py                                             │
 │                                                                                       │
 │ ✓  ReadFile modules/crud.py                                                           │
 │                                                                                       │
 │ x  SearchText {"pattern":"plugins/","path":"/home/mike/repos/pipulate/server.py"}     │
 │                                                                                       │
 │    Failed to access path stats for /home/mike/repos/pipulate/server.py: Error: Path   │
 │    is not a directory: /home/mike/repos/pipulate/server.py                            │
 ╰───────────────────────────────────────────────────────────────────────────────────────╯
✦ You are absolutely correct in your assessment. My analysis of the codebase confirms that you
  have three distinct systems with different purposes, and your proposed naming clarification
  (imports, apps, tools) is spot on.

  Here is the evidence from the repository:

  1. modules/ are indeed "Imports"

   * What's Inside: This directory contains files like crud.py, voice_synthesis.py, and
     server_logging.py.
   * My Analysis: Reading modules/crud.py shows that it provides a generic BaseCrud class and a
     Step definition. It contains no user-facing UI or specific application logic. It's a library
     of reusable components.
   * Proof: The plugins/040_hello_workflow.py file explicitly imports from it with the line: from 
     modules.crud import Step.
   * Conclusion: You are correct. modules/ serves as an internal library of shared code, and
     "imports" is a perfectly descriptive name for its function.

  2. plugins/ are indeed "Apps"

   * What's Inside: This directory contains numbered files like 010_introduction.py,
     040_hello_workflow.py, and 110_parameter_buster.py.
   * My Analysis: The 040_hello_workflow.py file is a self-contained web application. It defines a
      HelloFlow class with methods that handle HTTP requests (landing, step_01, step_01_submit),
     generate HTML for a user interface, and manage a specific piece of application logic.
   * The Loading Mechanism: I was unable to search inside server.py to find the loading mechanism.
      However, the structure of the plugins directory and the contents of the files strongly
     suggest a custom loader that iterates through the numbered files, instantiates the classes
     within them, and uses a method like the pipulate.register_workflow_routes(self) call I saw to
      integrate them into the main application.
   * Conclusion: You are correct. These are not simple plugins; they are full-featured "apps" or
     "workflows" that take over the main UI.

  3. tools/ are indeed "Tools"

   * What's Inside: As we've just worked on, this directory contains modules like mcp_tools.py
     and botify_tools.py.
   * My Analysis: These files export individual, non-UI functions (browser_scrape_page,
     botify_ping) that are designed to be called programmatically, either from the command line
     or by an AI assistant. They perform specific, discrete actions.
   * Conclusion: You are correct. "Tools" is the perfect name for this system of callable,
     command-like functions.

  You have a very clear understanding of your own architecture. The conceptual overlap is real,
  and your proposed clarification into Imports, Apps, and Tools accurately reflects the distinct
   role each system plays in Pipulate.

README.md:   - Left sidebar with workflow plugins (Introduction, Profiles, etc.)
README.md:- Check out `plugins/010_introduction.py` to see workflow code structure
README.md:│   │   │   ├── Input [id='nav-plugin-search', role='searchbox', aria-label='Search plugins']
README.md:    ├── plugins/                   # Workflow plugins (010_introduction.py, 400_trifecta.py, etc.)
README.md:plugins/
README.md:* Files in `plugins/` directory are auto-discovered
README.md:plugins/                    # Your workflows (auto-discovered)
README.md:The repository includes not only polished plugins but also experimental scripts and notebooks under development (e.g., in the root directory or marked with `xx_` prefix in plugin directories). These represent ongoing work and exploration.
requirements.txt:mdit-py-plugins==0.4.2
config.py:            'description': 'Essential plugins available to all users.',
config.py:            'description': 'Tools for creating, debugging, and managing workflows and plugins.',
server.py:    logger.warning(f'🚨 PRODUCTION_DATABASE_WARNING: If demo is triggered, plugins using static DB_FILENAME may cause issues!')
server.py:# This registry allows plugins to register MCP tools that can be called
server.py:# Global registry for MCP tools - populated by plugins during startup
server.py:    This class serves as the main interface for plugins to access
server.py:        Centralizes the folder button pattern used across many plugins.
server.py:            blank_placeholder_module = importlib.import_module('plugins.910_blank_placeholder')
server.py:# BaseCrud class moved to plugins/crud.py to avoid circular imports
server.py:if not os.path.exists('plugins'):
server.py:    os.makedirs('plugins')
server.py:    logger.info('📁 FINDER_TOKEN: PLUGINS_DIR - Created plugins directory')
server.py:    """Discover and import all Python files in the plugins directory.
server.py:    This function scans the 'plugins' directory and imports each .py file
server.py:    - Starting with 'xx_' or 'XX_' (indicating experimental/in-progress plugins)
server.py:    plugins_dir = os.path.join(os.path.dirname(__file__), 'plugins')
server.py:    logger.debug(f'Looking for plugins in: {plugins_dir}')
server.py:    if not os.path.isdir(plugins_dir):
server.py:        logger.warning(f'Plugins directory not found: {plugins_dir}')
server.py:    sorted_files = sorted(os.listdir(plugins_dir), key=numeric_prefix_sort)
server.py:                module = importlib.import_module(f'plugins.{original_name}')
server.py:                module = importlib.import_module(f'plugins.{original_name}')
server.py:                        # Only log classes that look like they might be plugins (have common plugin attributes)
server.py:    figlet_banner("plugins", "Pipulate Workflows and CRUD Apps", font='standard', color='orange3')
server.py:            module = importlib.import_module(f'plugins.{original_name}')
server.py:                            # Inject centralized configuration for plugins that need it
server.py:ordered_plugins = []
server.py:    if module_name not in ordered_plugins and module_name in plugin_instances:
server.py:        ordered_plugins.append(module_name)
server.py:        plugins_discovered=discovered_count,
server.py:        plugins_registered=registered_count,
server.py:    failed_plugins = []
server.py:            failed_plugins.append(f'{module_name}.{class_name}')
server.py:    server_whisper(f"Some plugins need attention: {', '.join(failed_plugins)}", "⚠️")
server.py:    logger.warning(f'FINDER_TOKEN: PLUGIN_REGISTRATION_SUMMARY - Failed plugins: {", ".join(failed_plugins)}')
server.py:    chip_says("All plugins loaded successfully! The workshop is fully equipped.", BANNER_COLORS['plugin_registry_success'])
server.py:MENU_ITEMS = base_menu_items + ordered_plugins + additional_menu_items
server.py:            placeholder='Search plugins (Ctrl+K)',
server.py:            hx_post='/search-plugins',
server.py:            aria_label='Search plugins',
server.py:    plugins_by_role = group_plugins_by_role(active_role_names)
server.py:            role_plugins = plugins_by_role.get(role_name, [])
server.py:            role_plugins.sort(key=lambda x: get_plugin_numeric_prefix(x))
server.py:            for plugin_key in role_plugins:
server.py:def group_plugins_by_role(active_role_names):
server.py:    """Group plugins by their primary role for hierarchical menu organization."""
server.py:    plugins_by_role = {}
server.py:    for plugin_key in ordered_plugins:
server.py:            if role_name not in plugins_by_role:
server.py:                plugins_by_role[role_name] = []
server.py:            plugins_by_role[role_name].append(plugin_key)
server.py:    logger.debug(f'Plugins grouped by role: {plugins_by_role}')
server.py:    return plugins_by_role
server.py:@rt('/search-plugins', methods=['POST'])
server.py:async def search_plugins(request):
server.py:    """Search plugins based on user input - Carson Gross style active search."""
server.py:        searchable_plugins = []
server.py:            if module_name in ['profiles', 'roles']:  # Skip system plugins
server.py:            searchable_plugins.append(plugin_entry)
server.py:        # Filter plugins based on search term
server.py:            filtered_plugins = []
server.py:            for plugin in searchable_plugins:
server.py:                    filtered_plugins.append(plugin)
server.py:            # Show ALL plugins on empty search (dropdown menu behavior)
server.py:            filtered_plugins = searchable_plugins
server.py:        if filtered_plugins:
server.py:            auto_select_single = len(filtered_plugins) == 1
server.py:            for i, plugin in enumerate(filtered_plugins):  # Show all results - no artificial limit
server.py:        logger.error(f"Error in search_plugins: {e}")
server.py:                "plugins": "Workflow applications and business logic",
pyproject.toml:include = ["plugins*", "static*"]
tools/advanced_automation_tools.py:            "command": "ls -la server.py plugins browser_automation"
tools/mcp_tools.py:        chrome_options.add_argument('--disable-plugins')
tools/mcp_tools.py:        plugin_name = plugin_filename.replace('plugins/', '').replace('.py', '')
tools/mcp_tools.py:            plugin_name = plugin_filename.replace('plugins/', '').replace('.py', '')
tools/mcp_tools.py:                    # For file upload plugins, we need to initialize the workflow first
tools/mcp_tools.py:        plugins_exists = os.path.exists("plugins/")
tools/mcp_tools.py:            "plugins_directory_exists": plugins_exists,
tools/mcp_tools.py:            "environment_ready": server_exists and plugins_exists
assets/pipulate-init.js:- plugins/ (41 plugin files)
training/roles.md:The Roles system is Pipulate's **homepage and menu control center** - a sophisticated CRUD application that determines which plugins appear in your APP menu. It's both the **landing page** and the **role-based access control system** that customizes your experience.
training/roles.md:2. **Menu Control System**: Determines which plugins appear in the APP dropdown
training/roles.md:- **Self-discovering**: New plugins automatically appear in the appropriate roles
training/roles.md:- **Always up-to-date**: The system finds and categorizes plugins as they're added
training/roles.md:- **Core**: Essential system plugins (always available)
training/roles.md:- **Plugin count**: Shows how many plugins this role provides
training/roles.md:- **Expandable plugin list**: Click to see all plugins in this role
training/roles.md:1. **Start with Core**: Essential plugins only
training/roles.md:4. **Custom ordering**: Prioritize most-used plugins
training/roles.md:- **Real-time scanning**: Discovers plugins as they're added
training/roles.md:- **Missing plugins**: Check `ROLES = ['Role Name']` in plugin files
training/roles.md:The Roles system is the **orchestrator** of the entire Pipulate experience - it conducts the symphony of plugins, profiles, and user preferences to create a harmonious, personalized interface.
assets/styles.css:   Consolidated from form input plugins (text_area, text_field, radios)
assets/styles.css:   Styles for the search plugins dropdown with keyboard navigation support.
assets/pipulate.js:   Keyboard navigation for search plugins dropdown following HTMX principles:
assets/pipulate.js:// Global search plugins keyboard navigation functions
assets/pipulate.js:        console.warn('⚠️ Search plugins elements not found, skipping keyboard nav setup');
assets/css/prism.css:https://prismjs.com/download#themes=prism-okaidia&languages=markup+css+clike+javascript+bash+diff+json+json5+jsonp+liquid+lua+markdown+markup-templating+mermaid+nix+python+regex+yaml&plugins=line-highlight+line-numbers+toolbar+copy-to-clipboard+diff-highlight+treeview */
training/widget_examples.md:    * **Widget:** A container using `<pre>` and `<code>` tags, styled by `Prism.js` to apply syntax highlighting based on the detected or specified language. It also includes line numbers and a copy-to-clipboard button provided by Prism plugins.
apps/440_browser_automation.py:            driver.execute_cdp_cmd('Page.addScriptToEvaluateOnNewDocument', {'source': "\n                    Object.defineProperty(navigator, 'webdriver', {\n                        get: () => undefined\n                    });\n                    Object.defineProperty(navigator, 'plugins', {\n                        get: () => [1, 2, 3, 4, 5]\n                    });\n                    Object.defineProperty(navigator, 'languages', {\n                        get: () => ['en-US', 'en']\n                    });\n                "})
apps/440_browser_automation.py:            driver.execute_cdp_cmd('Page.addScriptToEvaluateOnNewDocument', {'source': "\n                    Object.defineProperty(navigator, 'webdriver', {\n                        get: () => undefined\n                    });\n                    Object.defineProperty(navigator, 'plugins', {\n                        get: () => [1, 2, 3, 4, 5]\n                    });\n                    Object.defineProperty(navigator, 'languages', {\n                        get: () => ['en-US', 'en']\n                    });\n                "})
training/tasks.md:   - Discovers new plugins based on filename
apps/130_gap_analysis.py:# File: plugins/130_content_gap_analysis.py
apps/030_roles.py:    affected_plugins = [plugin for plugin in plugin_list if item.text in plugin['roles']]
apps/030_roles.py:    plugin_count = len(affected_plugins)
apps/030_roles.py:    """Get list of all available plugins with their roles."""
apps/030_roles.py:    plugins = []
apps/030_roles.py:            # Skip the special plugins that don't belong in role lists
apps/030_roles.py:                # Most plugins have numeric prefixes, so we need to find the actual filename
apps/030_roles.py:                plugins.append({
apps/030_roles.py:    logger.debug(f"get_plugin_list: Returning {len(plugins)} plugins")
apps/030_roles.py:    core_plugins = [p for p in plugins if 'Core' in p['roles']]
apps/030_roles.py:    logger.debug(f"get_plugin_list: Found {len(core_plugins)} Core plugins: {[p['display_name'] for p in core_plugins]}")
apps/030_roles.py:    return sorted(plugins, key=lambda x: x['filename'])
apps/030_roles.py:    plugins = []
apps/030_roles.py:                plugins.append({
apps/030_roles.py:    return sorted(plugins, key=lambda x: x['filename'])
apps/030_roles.py:    """Create a discrete expandable list showing plugins with real emojis."""
apps/030_roles.py:    affected_plugins = [plugin for plugin in plugin_list if role_name in plugin['roles']]
apps/030_roles.py:    logger.debug(f"create_plugin_visibility_table: Role '{role_name}' has {len(affected_plugins)} plugins")
apps/030_roles.py:    for plugin in affected_plugins:
apps/030_roles.py:    if not affected_plugins:
apps/030_roles.py:            P("No plugins assigned to this role.", style="font-style: italic; color: var(--pico-muted-color); margin: 0.5rem 0;"),
apps/030_roles.py:    for plugin in affected_plugins:
apps/050_documentation.py:        pipulate_root = current_file.parent.parent  # plugins/050_documentation.py -> plugins/ -> pipulate/
apps/240_simon_mcp.py:# File: plugins/830_simon_mcp.py
helpers/prompt_foo/generate_files_list.py:        f"{base_paths['pipulate']}/plugins", 
helpers/release/publish.py:    trifecta_file = "plugins/400_botify_trifecta.py"
helpers/release/publish.py:    print("\n🏗️ Step 4.5: Rebuilding Trifecta derivative plugins...")
helpers/release/publish.py:        'plugins_rebuilt': 0,
helpers/release/publish.py:        if "Successfully processed: 2/2 plugins" in output:
helpers/release/publish.py:            stats['plugins_rebuilt'] = 2
helpers/release/publish.py:        elif "Successfully processed: 1/2 plugins" in output:
helpers/release/publish.py:            stats['plugins_rebuilt'] = 1
helpers/release/publish.py:            print(f"   🔨 Plugins rebuilt: {stats['plugins_rebuilt']}/2")
helpers/release/publish.py:        f"{stats['plugins_rebuilt']}/2",
helpers/release/publish.py:            print(f"🏗️ Trifecta Derivatives Rebuilt: {trifecta_stats.get('plugins_rebuilt', 0)}/2 plugins")
helpers/release/publish.py:            f"{trifecta_stats.get('plugins_rebuilt', 0)}/2 plugins",
apps/230_dev_assistant.py:# File: plugins/320_dev_assistant.py
apps/230_dev_assistant.py:            (f'/{internal_route_prefix}/search_plugins_step01', self.search_plugins_step01, ['POST'])
apps/230_dev_assistant.py:        # Check dropdown functions ONLY if they exist (don't penalize plugins without dropdowns)
apps/230_dev_assistant.py:        # BONUS: Perfect score message for plugins without dropdown dependencies
apps/230_dev_assistant.py:            # Show positive message for plugins without dropdown dependencies
apps/230_dev_assistant.py:            command = f"python helpers/workflow/swap_workflow_step.py TARGET_FILE.py {step_id} plugins/{source_filename} {step_id} --force"
apps/230_dev_assistant.py:    async def search_plugins_step01(self, request):
apps/230_dev_assistant.py:        """Search plugins for step 1 based on user input - Carson Gross style active search."""
apps/230_dev_assistant.py:            plugins_dir = Path("plugins")
apps/230_dev_assistant.py:            if plugins_dir.exists():
apps/230_dev_assistant.py:                plugin_files = [f.name for f in plugins_dir.glob("*.py") if not f.name.startswith("__")]
apps/230_dev_assistant.py:            # Filter plugins based on search term
apps/230_dev_assistant.py:                filtered_plugins = []
apps/230_dev_assistant.py:                        filtered_plugins.append({
apps/230_dev_assistant.py:                # Show ALL plugins on empty search (dropdown menu behavior)
apps/230_dev_assistant.py:                filtered_plugins = []
apps/230_dev_assistant.py:                    filtered_plugins.append({
apps/230_dev_assistant.py:            if filtered_plugins:
apps/230_dev_assistant.py:                auto_select_single = len(filtered_plugins) == 1
apps/230_dev_assistant.py:                for i, plugin in enumerate(sorted(filtered_plugins, key=lambda x: x['filename'])):  # Show all results - no artificial limit
apps/230_dev_assistant.py:            logger.error(f"Error in search_plugins_step01: {e}")
apps/230_dev_assistant.py:        file_path = Path("plugins") / filename
apps/230_dev_assistant.py:        blank_cmd = f"python helpers/workflow/create_workflow.py plugins/{next_filename} {version_data['class_name']} {version_data['app_name']} \\\n" + \
apps/230_dev_assistant.py:        hello_cmd = f"python helpers/workflow/create_workflow.py plugins/{next_filename} {version_data['class_name']} {version_data['app_name']} \\\n" + \
apps/230_dev_assistant.py:        trifecta_cmd = f"python helpers/workflow/create_workflow.py plugins/{next_filename} {version_data['class_name']} {version_data['app_name']} \\\n" + \
apps/230_dev_assistant.py:        plugins_dir = Path("plugins")
apps/230_dev_assistant.py:        if plugins_dir.exists():
apps/230_dev_assistant.py:            plugin_files = [f.name for f in plugins_dir.glob("*.py") if not f.name.startswith("__")]
apps/230_dev_assistant.py:                            placeholder='Search plugins by name...',
apps/230_dev_assistant.py:                            hx_post=f'/{app_name}/search_plugins_step01',
apps/230_dev_assistant.py:        file_path = Path("plugins") / selected_file
apps/200_workflow_genesis.py:# File: plugins/200_workflow_genesis.py
apps/200_workflow_genesis.py:        # Ensure consistent plugins/ prefix for all commands
apps/200_workflow_genesis.py:        plugins_filename = f"plugins/{filename}" if not filename.startswith('plugins/') else filename
apps/200_workflow_genesis.py:        create_cmd = f"python helpers/workflow/create_workflow.py {plugins_filename} {class_name} {internal_name} \\\n" + \
apps/200_workflow_genesis.py:        splice_bottom_cmd = f"python helpers/workflow/splice_workflow_step.py {plugins_filename} --position bottom"
apps/200_workflow_genesis.py:        splice_top_cmd = f"python helpers/workflow/splice_workflow_step.py {plugins_filename} --position top"
apps/200_workflow_genesis.py:        combined_cmd = f"python helpers/workflow/create_workflow.py {plugins_filename} {class_name} {internal_name} \\\n" + \
apps/200_workflow_genesis.py:        # Ensure consistent plugins/ prefix for all commands (matching working example)
apps/200_workflow_genesis.py:        plugins_filename = f"plugins/{filename}" if not filename.startswith('plugins/') else filename
apps/200_workflow_genesis.py:        cmd1 = f"python helpers/workflow/create_workflow.py {plugins_filename} {class_name} {internal_name} " + \
apps/200_workflow_genesis.py:        cmd2 = f"python helpers/workflow/manage_class_attributes.py {plugins_filename} plugins/040_hello_workflow.py --attributes-to-merge UI_CONSTANTS --force"
apps/200_workflow_genesis.py:        cmd3 = f"python helpers/workflow/swap_workflow_step.py {plugins_filename} step_01 plugins/040_hello_workflow.py step_01 --force"
apps/200_workflow_genesis.py:        cmd4 = f"python helpers/workflow/splice_workflow_step.py {plugins_filename} --position bottom"
apps/200_workflow_genesis.py:        cmd5 = f"python helpers/workflow/swap_workflow_step.py {plugins_filename} step_02 plugins/040_hello_workflow.py step_02 --force"
apps/200_workflow_genesis.py:        combined_cmd = f"python helpers/workflow/create_workflow.py {plugins_filename} {class_name} {internal_name} \\\n" + \
apps/200_workflow_genesis.py:                      f"python helpers/workflow/manage_class_attributes.py {plugins_filename} \\\n" + \
apps/200_workflow_genesis.py:                      f"  plugins/040_hello_workflow.py \\\n" + \
apps/200_workflow_genesis.py:                      f"python helpers/workflow/swap_workflow_step.py {plugins_filename} step_01 \\\n" + \
apps/200_workflow_genesis.py:                      f"  plugins/040_hello_workflow.py step_01 --force && \\\n" + \
apps/200_workflow_genesis.py:                      f"python helpers/workflow/splice_workflow_step.py {plugins_filename} --position bottom && \\\n" + \
apps/200_workflow_genesis.py:                      f"python helpers/workflow/swap_workflow_step.py {plugins_filename} step_02 \\\n" + \
apps/200_workflow_genesis.py:                      f"  plugins/040_hello_workflow.py step_02 --force"
apps/200_workflow_genesis.py:        # Ensure consistent plugins/ prefix for all commands
apps/200_workflow_genesis.py:        plugins_filename = f"plugins/{filename}" if not filename.startswith('plugins/') else filename
apps/200_workflow_genesis.py:        cmd1 = f"python helpers/workflow/create_workflow.py {plugins_filename} {class_name} {internal_name} " + \
apps/200_workflow_genesis.py:        cmd2 = f"python helpers/workflow/splice_workflow_step.py {plugins_filename} --position bottom"
apps/200_workflow_genesis.py:        combined_cmd = f"python helpers/workflow/create_workflow.py {plugins_filename} {class_name} {internal_name} \\\n" + \
apps/200_workflow_genesis.py:                      f"python helpers/workflow/splice_workflow_step.py {plugins_filename} --position bottom"
apps/200_workflow_genesis.py:            # Ensure plugins/ prefix for path display
apps/200_workflow_genesis.py:            if not target_filename.startswith('plugins/'):
apps/200_workflow_genesis.py:                display_filename = f"plugins/{target_filename}"
apps/200_workflow_genesis.py:            # Create filesystem button to open plugins directory
apps/200_workflow_genesis.py:            plugins_dir = os.path.join(os.getcwd(), 'plugins')
apps/200_workflow_genesis.py:            open_plugins_folder_ui = A(
apps/200_workflow_genesis.py:                hx_get="/open-folder?path=" + urllib.parse.quote(plugins_dir),
apps/200_workflow_genesis.py:                title=f"Open folder: {plugins_dir}",
apps/200_workflow_genesis.py:                    open_plugins_folder_ui,
apps/200_workflow_genesis.py:        # Ensure plugins/ prefix for path display
apps/200_workflow_genesis.py:        if not target_filename.startswith('plugins/'):
apps/200_workflow_genesis.py:            display_filename = f"plugins/{target_filename}"
apps/200_workflow_genesis.py:        plugins_filename = f"plugins/{target_filename}" if not target_filename.startswith('plugins/') else target_filename
apps/200_workflow_genesis.py:            combined_cmd = f"python helpers/workflow/create_workflow.py {plugins_filename} {class_name} {internal_name} " + \
apps/200_workflow_genesis.py:                          f"python helpers/workflow/manage_class_attributes.py {plugins_filename} " + \
apps/200_workflow_genesis.py:                          f"plugins/040_hello_workflow.py " + \
apps/200_workflow_genesis.py:                          f"python helpers/workflow/swap_workflow_step.py {plugins_filename} step_01 " + \
apps/200_workflow_genesis.py:                          f"plugins/040_hello_workflow.py step_01 --force && " + \
apps/200_workflow_genesis.py:                          f"python helpers/workflow/splice_workflow_step.py {plugins_filename} --position bottom && " + \
apps/200_workflow_genesis.py:                          f"python helpers/workflow/swap_workflow_step.py {plugins_filename} step_02 " + \
apps/200_workflow_genesis.py:                          f"plugins/040_hello_workflow.py step_02 --force"
apps/200_workflow_genesis.py:            combined_cmd = f"python helpers/workflow/create_workflow.py {plugins_filename} {class_name} {internal_name} " + \
apps/200_workflow_genesis.py:                          f"python helpers/workflow/splice_workflow_step.py {plugins_filename} --position bottom"
apps/200_workflow_genesis.py:            combined_cmd = f"python helpers/workflow/create_workflow.py {plugins_filename} {class_name} {internal_name} " + \
apps/200_workflow_genesis.py:        # Create filesystem button to open plugins directory
apps/200_workflow_genesis.py:        plugins_dir = os.path.join(os.getcwd(), 'plugins')
apps/200_workflow_genesis.py:        open_plugins_folder_ui = A(
apps/200_workflow_genesis.py:            hx_get="/open-folder?path=" + urllib.parse.quote(plugins_dir),
apps/200_workflow_genesis.py:            title=f"Open folder: {plugins_dir}",
apps/200_workflow_genesis.py:        execution_summary += f"📂 Location: {plugins_dir}\n"
apps/200_workflow_genesis.py:                    P(f"Created in: {plugins_dir}", cls="text-description"),
apps/200_workflow_genesis.py:                    open_plugins_folder_ui,
apps/200_workflow_genesis.py:                    P(f"Check: {plugins_dir}", cls="text-description"),
apps/200_workflow_genesis.py:                    open_plugins_folder_ui,
apps/300_blank_placeholder.py:# File: plugins/300_blank_placeholder.py
imports/botify/code_generators.py:# Convenience instance for backward compatibility with existing plugins
apps/001_dom_visualizer.py:# File: plugins/001_dom_visualizer.py
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:python helpers/workflow/splice_workflow_step.py plugins/035_my_workflow.py  # path optional
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:    plugins/035_my_workflow.py step_01 \
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:    plugins/500_source_workflow.py step_01
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:    plugins/035_target_workflow.py \
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:    plugins/500_source_workflow.py \
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:rm plugins/045_evolved_flowtest.py
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:mkdir -p plugins/components/
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:mv plugins/200_parameter_engine.py plugins/components/  # Archive proven components
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:plugins/
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:mkdir -p plugins/components/
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:mv plugins/800_parameter_component.py plugins/components/
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:cp plugins/400_botify_trifecta.py plugins/410_enhanced_trifecta.py
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:rm plugins/999_*
helpers/workflow/workflow_reconstructor.py:        self.plugins_dir = self.base_dir / "plugins"
helpers/workflow/workflow_reconstructor.py:            template_path = self.plugins_dir / f"{template_name}.py"
helpers/workflow/workflow_reconstructor.py:            source_path = self.plugins_dir / f"{source_name}.py" 
helpers/workflow/workflow_reconstructor.py:            target_path = self.plugins_dir / f"{target_name}.py"
helpers/workflow/workflow_reconstructor.py:        existing_path = self.plugins_dir / f"{existing_name}.py"
helpers/workflow/workflow_reconstructor.py:            source_tree = reconstructor.parse_file(reconstructor.plugins_dir / f"{args.source}.py")
helpers/workflow/swap_workflow_step.py:    python swap_workflow_step.py plugins/035_kungfu_workflow.py step_01 plugins/500_hello_workflow.py step_01
imports/crud.py:Common classes and utilities for plugins.
imports/crud.py:This module contains shared classes that plugins can import without creating
imports/crud.py:# 🎯 STANDARDIZED STEP DEFINITION - Used by all workflow plugins
imports/crud.py:# Eliminates 34+ identical namedtuple definitions across plugins
imports/crud.py:# Simple import pattern - plugins can copy these lines instead of massive import blocks
imports/crud.py:# 🌐 API WORKFLOW IMPORTS - For plugins that call external APIs
imports/crud.py:# 🎨 WIDGET IMPORTS - For UI component demonstration plugins
imports/crud.py:# Instead of copying massive import blocks from complex plugins,
imports/crud.py:# ✅ Widget plugins: Use the 5-line widget import pattern
imports/crud.py:# ✅ API plugins: Use the 8-line API workflow pattern  
imports/crud.py:# ✅ Basic plugins: Use the 4-line basic workflow pattern
imports/crud.py:        Extracted from: plugins/110_parameter_buster.py, 120_link_graph.py, 400_botify_trifecta.py
imports/crud.py:        Extracted from: plugins/110_parameter_buster.py (and similar patterns)
imports/crud.py:        Extracted from: plugins/440_browser_automation.py  
imports/crud.py:        Extracted from: Multiple workflow plugins with repetitive form handling
helpers/workflow/create_workflow.py:        if (current_dir / "plugins").is_dir() and (current_dir / "server.py").is_file():
helpers/workflow/create_workflow.py:        if root.exists() and (root / "plugins").is_dir() and (root / "server.py").is_file():
helpers/workflow/create_workflow.py:    "blank": PROJECT_ROOT / "plugins" / "300_blank_placeholder.py",
helpers/workflow/create_workflow.py:    "hello": PROJECT_ROOT / "plugins" / "500_hello_workflow.py",
helpers/workflow/create_workflow.py:    "trifecta": PROJECT_ROOT / "plugins" / "400_botify_trifecta.py",
helpers/workflow/create_workflow.py:    # "my_custom_template": PROJECT_ROOT / "plugins" / "0XX_my_custom_template.py",
helpers/workflow/create_workflow.py:PLUGINS_DIR = PROJECT_ROOT / "plugins"
helpers/workflow/create_workflow.py:python create_workflow.py plugins/035_kungfu_workflow.py KungfuWorkflow kungfu "Kung Fu Download" "Welcome message" "Training prompt"  # plugins/ prefix optional
helpers/workflow/create_workflow.py:  python create_workflow.py plugins/035_kungfu_workflow.py KungfuWorkflow kungfu "Kung Fu Download" "Welcome message" "Training prompt"
helpers/workflow/create_workflow.py:    # 2. With plugins/ prefix: "plugins/035_kungfu_workflow.py"  
helpers/workflow/create_workflow.py:    # 3. Full path: "/some/path/plugins/035_kungfu_workflow.py"
helpers/workflow/create_workflow.py:    if target_filename.startswith('plugins/'):
helpers/workflow/create_workflow.py:        target_filename = target_filename[8:]  # Remove 'plugins/' prefix
helpers/workflow/create_workflow.py:            header_pattern = r'^# File: plugins/[^.]+\.py'
helpers/workflow/create_workflow.py:            new_header = f'# File: plugins/{target_filename}'
imports/botify_code_generation.py:eliminating ~400+ lines of duplicated code across plugins.
imports/botify_code_generation.py:    Centralizes the header generation logic to reduce duplication across plugins.
imports/botify_code_generation.py:    This eliminates ~100+ lines of duplicated f-string blocks across Botify plugins.
imports/botify_code_generation.py:            # Try different template config keys that plugins use
imports/botify_code_generation.py:    This eliminates ~150+ lines of duplicated f-string blocks across Botify plugins.
imports/botify_code_generation.py:    This eliminates path construction duplication across Botify plugins.
helpers/workflow/manage_class_attributes.py:    python manage_class_attributes.py plugins/035_kungfu_workflow.py plugins/500_hello_workflow.py --attributes-to-merge UI_CONSTANTS
helpers/workflow/splice_workflow_step.py:python splice_workflow_step.py plugins/035_kungfu_workflow.py  # plugins/ prefix optional
helpers/workflow/splice_workflow_step.py:        if (current_dir / "plugins").is_dir() and (current_dir / "server.py").is_file():
helpers/workflow/splice_workflow_step.py:        if root.exists() and (root / "plugins").is_dir() and (root / "server.py").is_file():
helpers/workflow/splice_workflow_step.py:TEMPLATE_FILE_PATH = PROJECT_ROOT / "plugins" / "300_blank_placeholder.py"
helpers/workflow/splice_workflow_step.py:PLUGINS_DIR = PROJECT_ROOT / "plugins"
helpers/workflow/splice_workflow_step.py:  python splice_workflow_step.py plugins/035_kungfu_workflow.py --position top
helpers/workflow/splice_workflow_step.py:  python splice_workflow_step.py /full/path/to/plugins/035_kungfu_workflow.py --position bottom
helpers/workflow/splice_workflow_step.py:    # 2. With plugins/ prefix: "plugins/035_kungfu_workflow.py"  
helpers/workflow/splice_workflow_step.py:    # 3. Full path: "/some/path/plugins/035_kungfu_workflow.py"
helpers/workflow/splice_workflow_step.py:    if target_filename.startswith('plugins/'):
helpers/workflow/splice_workflow_step.py:        target_filename = target_filename[8:]  # Remove 'plugins/' prefix
imports/ascii_displays.py:    plugins_discovered: int, 
imports/ascii_displays.py:    plugins_registered: int, 
imports/ascii_displays.py:    status_table.add_row("📦 Plugins", "✅ Loaded", f"{plugins_registered}/{plugins_discovered} registered")
imports/ascii_displays.py:✅ Plugins: {plugins_registered}/{plugins_discovered} registered

server.py:# BaseCrud class moved to plugins/crud.py to avoid circular imports
tools/mcp_tools.py:        plugin_name = plugin_filename.replace('plugins/', '').replace('.py', '')
tools/mcp_tools.py:            plugin_name = plugin_filename.replace('plugins/', '').replace('.py', '')
tools/mcp_tools.py:        plugins_exists = os.path.exists("plugins/")
README.md:- Check out `plugins/010_introduction.py` to see workflow code structure
README.md:    ├── plugins/                   # Workflow plugins (010_introduction.py, 400_trifecta.py, etc.)
README.md:plugins/
README.md:* Files in `plugins/` directory are auto-discovered
README.md:plugins/                    # Your workflows (auto-discovered)
assets/pipulate-init.js:- plugins/ (41 plugin files)
apps/130_gap_analysis.py:# File: plugins/130_content_gap_analysis.py
apps/230_dev_assistant.py:# File: plugins/320_dev_assistant.py
apps/230_dev_assistant.py:            command = f"python helpers/workflow/swap_workflow_step.py TARGET_FILE.py {step_id} plugins/{source_filename} {step_id} --force"
apps/230_dev_assistant.py:        blank_cmd = f"python helpers/workflow/create_workflow.py plugins/{next_filename} {version_data['class_name']} {version_data['app_name']} \\\n" + \
apps/230_dev_assistant.py:        hello_cmd = f"python helpers/workflow/create_workflow.py plugins/{next_filename} {version_data['class_name']} {version_data['app_name']} \\\n" + \
apps/230_dev_assistant.py:        trifecta_cmd = f"python helpers/workflow/create_workflow.py plugins/{next_filename} {version_data['class_name']} {version_data['app_name']} \\\n" + \
apps/240_simon_mcp.py:# File: plugins/830_simon_mcp.py
apps/300_blank_placeholder.py:# File: plugins/300_blank_placeholder.py
apps/050_documentation.py:        pipulate_root = current_file.parent.parent  # plugins/050_documentation.py -> plugins/ -> pipulate/
apps/001_dom_visualizer.py:# File: plugins/001_dom_visualizer.py
apps/200_workflow_genesis.py:# File: plugins/200_workflow_genesis.py
apps/200_workflow_genesis.py:        # Ensure consistent plugins/ prefix for all commands
apps/200_workflow_genesis.py:        plugins_filename = f"plugins/{filename}" if not filename.startswith('plugins/') else filename
apps/200_workflow_genesis.py:        # Ensure consistent plugins/ prefix for all commands (matching working example)
apps/200_workflow_genesis.py:        plugins_filename = f"plugins/{filename}" if not filename.startswith('plugins/') else filename
apps/200_workflow_genesis.py:        cmd2 = f"python helpers/workflow/manage_class_attributes.py {plugins_filename} plugins/040_hello_workflow.py --attributes-to-merge UI_CONSTANTS --force"
apps/200_workflow_genesis.py:        cmd3 = f"python helpers/workflow/swap_workflow_step.py {plugins_filename} step_01 plugins/040_hello_workflow.py step_01 --force"
apps/200_workflow_genesis.py:        cmd5 = f"python helpers/workflow/swap_workflow_step.py {plugins_filename} step_02 plugins/040_hello_workflow.py step_02 --force"
apps/200_workflow_genesis.py:                      f"  plugins/040_hello_workflow.py \\\n" + \
apps/200_workflow_genesis.py:                      f"  plugins/040_hello_workflow.py step_01 --force && \\\n" + \
apps/200_workflow_genesis.py:                      f"  plugins/040_hello_workflow.py step_02 --force"
apps/200_workflow_genesis.py:        # Ensure consistent plugins/ prefix for all commands
apps/200_workflow_genesis.py:        plugins_filename = f"plugins/{filename}" if not filename.startswith('plugins/') else filename
apps/200_workflow_genesis.py:            # Ensure plugins/ prefix for path display
apps/200_workflow_genesis.py:            if not target_filename.startswith('plugins/'):
apps/200_workflow_genesis.py:                display_filename = f"plugins/{target_filename}"
apps/200_workflow_genesis.py:        # Ensure plugins/ prefix for path display
apps/200_workflow_genesis.py:        if not target_filename.startswith('plugins/'):
apps/200_workflow_genesis.py:            display_filename = f"plugins/{target_filename}"
apps/200_workflow_genesis.py:        plugins_filename = f"plugins/{target_filename}" if not target_filename.startswith('plugins/') else target_filename
apps/200_workflow_genesis.py:                          f"plugins/040_hello_workflow.py " + \
apps/200_workflow_genesis.py:                          f"plugins/040_hello_workflow.py step_01 --force && " + \
apps/200_workflow_genesis.py:                          f"plugins/040_hello_workflow.py step_02 --force"
imports/crud.py:        Extracted from: plugins/110_parameter_buster.py, 120_link_graph.py, 400_botify_trifecta.py
imports/crud.py:        Extracted from: plugins/110_parameter_buster.py (and similar patterns)
imports/crud.py:        Extracted from: plugins/440_browser_automation.py  
helpers/workflow/splice_workflow_step.py:python splice_workflow_step.py plugins/035_kungfu_workflow.py  # plugins/ prefix optional
helpers/workflow/splice_workflow_step.py:  python splice_workflow_step.py plugins/035_kungfu_workflow.py --position top
helpers/workflow/splice_workflow_step.py:  python splice_workflow_step.py /full/path/to/plugins/035_kungfu_workflow.py --position bottom
helpers/workflow/splice_workflow_step.py:    # 2. With plugins/ prefix: "plugins/035_kungfu_workflow.py"  
helpers/workflow/splice_workflow_step.py:    # 3. Full path: "/some/path/plugins/035_kungfu_workflow.py"
helpers/workflow/splice_workflow_step.py:    if target_filename.startswith('plugins/'):
helpers/workflow/splice_workflow_step.py:        target_filename = target_filename[8:]  # Remove 'plugins/' prefix
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:python helpers/workflow/splice_workflow_step.py plugins/035_my_workflow.py  # path optional
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:    plugins/035_my_workflow.py step_01 \
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:    plugins/500_source_workflow.py step_01
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:    plugins/035_target_workflow.py \
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:    plugins/500_source_workflow.py \
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:rm plugins/045_evolved_flowtest.py
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:mkdir -p plugins/components/
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:mv plugins/200_parameter_engine.py plugins/components/  # Archive proven components
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:plugins/
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:mkdir -p plugins/components/
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:mv plugins/800_parameter_component.py plugins/components/
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:cp plugins/400_botify_trifecta.py plugins/410_enhanced_trifecta.py
helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md:rm plugins/999_*
helpers/workflow/manage_class_attributes.py:    python manage_class_attributes.py plugins/035_kungfu_workflow.py plugins/500_hello_workflow.py --attributes-to-merge UI_CONSTANTS
helpers/workflow/create_workflow.py:python create_workflow.py plugins/035_kungfu_workflow.py KungfuWorkflow kungfu "Kung Fu Download" "Welcome message" "Training prompt"  # plugins/ prefix optional
helpers/workflow/create_workflow.py:  python create_workflow.py plugins/035_kungfu_workflow.py KungfuWorkflow kungfu "Kung Fu Download" "Welcome message" "Training prompt"
helpers/workflow/create_workflow.py:    # 2. With plugins/ prefix: "plugins/035_kungfu_workflow.py"  
helpers/workflow/create_workflow.py:    # 3. Full path: "/some/path/plugins/035_kungfu_workflow.py"
helpers/workflow/create_workflow.py:    if target_filename.startswith('plugins/'):
helpers/workflow/create_workflow.py:        target_filename = target_filename[8:]  # Remove 'plugins/' prefix
helpers/workflow/create_workflow.py:            header_pattern = r'^# File: plugins/[^.]+\.py'
helpers/workflow/create_workflow.py:            new_header = f'# File: plugins/{target_filename}'
helpers/workflow/swap_workflow_step.py:    python swap_workflow_step.py plugins/035_kungfu_workflow.py step_01 plugins/500_hello_workflow.py step_01
helpers/release/publish.py:    trifecta_file = "plugins/400_botify_trifecta.py"

diff --git a/README.md b/README.md
index 9c67c88..c873627 100644
--- a/README.md
+++ b/README.md
@@ -684,7 +684,7 @@ Just as a chef talks about knife techniques while a diner just wants amazing pas
 
 **👨‍💻 If you're a developer:**
 - Open JupyterLab tab and run the introduction notebook
-- Check out `plugins/010_introduction.py` to see workflow code structure
+- Check out `apps/010_introduction.py` to see workflow code structure
 - Try creating a simple workflow: `python helpers/workflow/create_workflow.py`
 
 **🤖 If you're an AI assistant:**
@@ -1077,7 +1077,7 @@ This structure enables AI assistants to programmatically interact with all UI co
     │   ├── server-1.log           # N-rotations of server log per run per config
     │   └── server.log             # The server log of most recent run, contains app state
     ├── /assets/                    # JS, CSS, images, icons
-    ├── plugins/                   # Workflow plugins (010_introduction.py, 400_trifecta.py, etc.)
+    ├── apps/                   # Workflow plugins (010_introduction.py, 400_trifecta.py, etc.)
     ├── pyproject.toml             # Python packaging configuration and metadata
     ├── training/                  # Markdown files for AI context/prompts
     ├── vulture_whitelist.py       # Code analysis whitelist for unused code detection
@@ -1200,7 +1200,7 @@ The `run_all_cells()` method encapsulates the workflow initialization pattern an
 <!-- START_ASCII_ART: plugin-discovery-system -->
 ```
 📁 PLUGIN DISCOVERY SYSTEM
-plugins/
+apps/
 ├── 010_introduction.py       ✅ Registered as "introduction" (menu order: 1)
 ├── 020_profiles.py           ✅ Registered as "profiles" (menu order: 2)
 ├── hello_flow (Copy).py      ❌ SKIPPED - Contains "()"
@@ -1216,7 +1216,7 @@ plugins/
 ```
 <!-- END_ASCII_ART: plugin-discovery-system -->
 
-* Files in `plugins/` directory are auto-discovered
+* Files in `apps/` directory are auto-discovered
 * Numeric prefixes control menu ordering
 * Classes must have `landing` method and name attributes
 * Automatic dependency injection based on `__init__` signature
@@ -1377,7 +1377,7 @@ pip.set_step_data(step_id, updated_data)
 
 ### File Structure Quick Reference
 ```
-plugins/                    # Your workflows (auto-discovered)
+apps/                    # Your workflows (auto-discovered)
 ├── 010_introduction.py     # Menu order 1
 ├── xx_draft.py            # Disabled (xx_ prefix)
 └── draft (Copy).py        # Ignored (parentheses)
diff --git a/apps/001_dom_visualizer.py b/apps/001_dom_visualizer.py
index b077930..179f941 100644
--- a/apps/001_dom_visualizer.py
+++ b/apps/001_dom_visualizer.py
@@ -1,4 +1,4 @@
-# File: plugins/001_dom_visualizer.py
+# File: apps/001_dom_visualizer.py
 import asyncio
 from datetime import datetime
 from fasthtml.common import * # type: ignore
diff --git a/apps/050_documentation.py b/apps/050_documentation.py
index be0fa1a..3bac7f3 100644
--- a/apps/050_documentation.py
+++ b/apps/050_documentation.py
@@ -121,7 +121,7 @@ This system provides unprecedented debugging power:
         # Get the project root directory dynamically
         # Start from the current file's directory and go up to find the project root
         current_file = Path(__file__).resolve()
-        pipulate_root = current_file.parent.parent  # plugins/050_documentation.py -> plugins/ -> pipulate/
+        pipulate_root = current_file.parent.parent  # apps/050_documentation.py -> apps/ -> pipulate/
         
         # Verify we found the right directory by checking for key files
         if not (pipulate_root / 'server.py').exists():
diff --git a/apps/130_gap_analysis.py b/apps/130_gap_analysis.py
index b0a5d50..4948032 100644
--- a/apps/130_gap_analysis.py
+++ b/apps/130_gap_analysis.py
@@ -1,4 +1,4 @@
-# File: plugins/130_content_gap_analysis.py
+# File: apps/130_content_gap_analysis.py
 import asyncio
 from datetime import datetime
 from fasthtml.common import * # type: ignore
diff --git a/apps/200_workflow_genesis.py b/apps/200_workflow_genesis.py
index 978f7dc..886043b 100644
--- a/apps/200_workflow_genesis.py
+++ b/apps/200_workflow_genesis.py
@@ -1,4 +1,4 @@
-# File: plugins/200_workflow_genesis.py
+# File: apps/200_workflow_genesis.py
 import asyncio
 from datetime import datetime
 from fasthtml.common import * # type: ignore
@@ -259,8 +259,8 @@ class WorkflowGenesis:
         endpoint_message = workflow_params.get('endpoint_message', 'Welcome to workflow creation')
         training_prompt = workflow_params.get('training_prompt', 'Help users create workflows step by step')
 
-        # Ensure consistent plugins/ prefix for all commands
-        plugins_filename = f"plugins/{filename}" if not filename.startswith('plugins/') else filename
+        # Ensure consistent apps/ prefix for all commands
+        plugins_filename = f"apps/{filename}" if not filename.startswith('apps/') else filename
 
         # Single create command - uses blank template specifically
         create_cmd = f"python helpers/workflow/create_workflow.py {plugins_filename} {class_name} {internal_name} \\\n" + \
@@ -333,8 +333,8 @@ class WorkflowGenesis:
         hello_endpoint_message = "🥋 This workflow will become a Hello World equivalent using helper scripts."
         hello_training_prompt = "You are assisting with the Kung Fu Hello World workflow recreation. This demonstrates the complete helper tool sequence for building workflows from scratch. The secret word is 'MORPHEUS'."
 
-        # Ensure consistent plugins/ prefix for all commands (matching working example)
-        plugins_filename = f"plugins/{filename}" if not filename.startswith('plugins/') else filename
+        # Ensure consistent apps/ prefix for all commands (matching working example)
+        plugins_filename = f"apps/{filename}" if not filename.startswith('apps/') else filename
 
         # The corrected 5-command sequence - starts with blank template, becomes Hello World
         cmd1 = f"python helpers/workflow/create_workflow.py {plugins_filename} {class_name} {internal_name} " + \
@@ -342,13 +342,13 @@ class WorkflowGenesis:
                f"{self.format_bash_command(hello_endpoint_message)} " + \
                f"{self.format_bash_command(hello_training_prompt)} --template blank --role Core --force"
 
-        cmd2 = f"python helpers/workflow/manage_class_attributes.py {plugins_filename} plugins/040_hello_workflow.py --attributes-to-merge UI_CONSTANTS --force"
+        cmd2 = f"python helpers/workflow/manage_class_attributes.py {plugins_filename} apps/040_hello_workflow.py --attributes-to-merge UI_CONSTANTS --force"
 
-        cmd3 = f"python helpers/workflow/swap_workflow_step.py {plugins_filename} step_01 plugins/040_hello_workflow.py step_01 --force"
+        cmd3 = f"python helpers/workflow/swap_workflow_step.py {plugins_filename} step_01 apps/040_hello_workflow.py step_01 --force"
 
         cmd4 = f"python helpers/workflow/splice_workflow_step.py {plugins_filename} --position bottom"
 
-        cmd5 = f"python helpers/workflow/swap_workflow_step.py {plugins_filename} step_02 plugins/040_hello_workflow.py step_02 --force"
+        cmd5 = f"python helpers/workflow/swap_workflow_step.py {plugins_filename} step_02 apps/040_hello_workflow.py step_02 --force"
 
         # Combined command with proper && chaining for complete automation
         combined_cmd = f"python helpers/workflow/create_workflow.py {plugins_filename} {class_name} {internal_name} \\\n" + \
@@ -357,13 +357,13 @@ class WorkflowGenesis:
                       f"  {self.format_bash_command(hello_training_prompt)} \\\n" + \
                       f"  --template blank --role Core --force && \\\n" + \
                       f"python helpers/workflow/manage_class_attributes.py {plugins_filename} \\\n" + \
-                      f"  plugins/040_hello_workflow.py \\\n" + \
+                      f"  apps/040_hello_workflow.py \\\n" + \
                       f"  --attributes-to-merge UI_CONSTANTS --force && \\\n" + \
                       f"python helpers/workflow/swap_workflow_step.py {plugins_filename} step_01 \\\n" + \
-                      f"  plugins/040_hello_workflow.py step_01 --force && \\\n" + \
+                      f"  apps/040_hello_workflow.py step_01 --force && \\\n" + \
                       f"python helpers/workflow/splice_workflow_step.py {plugins_filename} --position bottom && \\\n" + \
                       f"python helpers/workflow/swap_workflow_step.py {plugins_filename} step_02 \\\n" + \
-                      f"  plugins/040_hello_workflow.py step_02 --force"
+                      f"  apps/040_hello_workflow.py step_02 --force"
 
         return Div(
             H4("Hello World Recreation Experience", cls="section-title"),
@@ -438,8 +438,8 @@ class WorkflowGenesis:
         endpoint_message = workflow_params.get('endpoint_message', 'Advanced data collection workflow')
         training_prompt = workflow_params.get('training_prompt', 'Help users create complex data workflows')
 
-        # Ensure consistent plugins/ prefix for all commands
-        plugins_filename = f"plugins/{filename}" if not filename.startswith('plugins/') else filename
+        # Ensure consistent apps/ prefix for all commands
+        plugins_filename = f"apps/{filename}" if not filename.startswith('apps/') else filename
 
         # Trifecta workflow commands - uses trifecta template
         cmd1 = f"python helpers/workflow/create_workflow.py {plugins_filename} {class_name} {internal_name} " + \
@@ -809,9 +809,9 @@ class WorkflowGenesis:
             target_filename = workflow_params.get('target_filename', '001_kungfu_workflow.py')
             display_name = workflow_params.get('display_name', 'Kung Fu Download')
 
-            # Ensure plugins/ prefix for path display
-            if not target_filename.startswith('plugins/'):
-                display_filename = f"plugins/{target_filename}"
+            # Ensure apps/ prefix for path display
+            if not target_filename.startswith('apps/'):
+                display_filename = f"apps/{target_filename}"
             else:
                 display_filename = target_filename
 
@@ -880,14 +880,14 @@ class WorkflowGenesis:
         display_name = workflow_params.get('display_name', 'Kung Fu Download')
         selected_template = template_choice.get('template', 'blank')
 
-        # Ensure plugins/ prefix for path display
-        if not target_filename.startswith('plugins/'):
-            display_filename = f"plugins/{target_filename}"
+        # Ensure apps/ prefix for path display
+        if not target_filename.startswith('apps/'):
+            display_filename = f"apps/{target_filename}"
         else:
             display_filename = target_filename
 
         # Get the combined command based on template choice
-        plugins_filename = f"plugins/{target_filename}" if not target_filename.startswith('plugins/') else target_filename
+        plugins_filename = f"apps/{target_filename}" if not target_filename.startswith('apps/') else target_filename
         class_name = workflow_params.get('class_name', 'KungfuWorkflow')
         internal_name = workflow_params.get('internal_app_name', 'kungfu')
         endpoint_message = workflow_params.get('endpoint_message', 'Welcome message')
@@ -905,13 +905,13 @@ class WorkflowGenesis:
                           f"{self.format_bash_command(hello_endpoint_message)} " + \
                           f"{self.format_bash_command(hello_training_prompt)} --template blank --role Core --force && " + \
                           f"python helpers/workflow/manage_class_attributes.py {plugins_filename} " + \
-                          f"plugins/040_hello_workflow.py " + \
+                          f"apps/040_hello_workflow.py " + \
                           f"--attributes-to-merge UI_CONSTANTS --force && " + \
                           f"python helpers/workflow/swap_workflow_step.py {plugins_filename} step_01 " + \
-                          f"plugins/040_hello_workflow.py step_01 --force && " + \
+                          f"apps/040_hello_workflow.py step_01 --force && " + \
                           f"python helpers/workflow/splice_workflow_step.py {plugins_filename} --position bottom && " + \
                           f"python helpers/workflow/swap_workflow_step.py {plugins_filename} step_02 " + \
-                          f"plugins/040_hello_workflow.py step_02 --force"
+                          f"apps/040_hello_workflow.py step_02 --force"
         elif selected_template == 'trifecta':
             # Trifecta workflow commands - use template-specific display name
             trifecta_display_name = "Kung Fu Trifecta 🏇"
diff --git a/apps/230_dev_assistant.py b/apps/230_dev_assistant.py
index fa33285..530e21b 100644
--- a/apps/230_dev_assistant.py
+++ b/apps/230_dev_assistant.py
@@ -1,4 +1,4 @@
-# File: plugins/320_dev_assistant.py
+# File: apps/320_dev_assistant.py
 import asyncio
 from datetime import datetime
 from fasthtml.common import * # type: ignore
@@ -1259,7 +1259,7 @@ class DevAssistant:
             step_info = step_dependencies.get(step_id, {})
 
             # Generate command for swapping this step to a target workflow
-            command = f"python helpers/workflow/swap_workflow_step.py TARGET_FILE.py {step_id} plugins/{source_filename} {step_id} --force"
+            command = f"python helpers/workflow/swap_workflow_step.py TARGET_FILE.py {step_id} apps/{source_filename} {step_id} --force"
 
             compatibility_notes = []
             if not step_info.get('has_swappable_markers', False):
@@ -1632,21 +1632,21 @@ class DevAssistant:
         commands = []
         
         # Default: Blank template (generic use)
-        blank_cmd = f"python helpers/workflow/create_workflow.py plugins/{next_filename} {version_data['class_name']} {version_data['app_name']} \\\n" + \
+        blank_cmd = f"python helpers/workflow/create_workflow.py apps/{next_filename} {version_data['class_name']} {version_data['app_name']} \\\n" + \
                    f"  {format_bash_command(version_data['display_name'])} \\\n" + \
                    f"  {format_bash_command(version_data['endpoint_message'])} \\\n" + \
                    f"  {format_bash_command(version_data['training_prompt'])} \\\n" + \
                    f"  --template blank --role Core --force"
         
         # Hello template option
-        hello_cmd = f"python helpers/workflow/create_workflow.py plugins/{next_filename} {version_data['class_name']} {version_data['app_name']} \\\n" + \
+        hello_cmd = f"python helpers/workflow/create_workflow.py apps/{next_filename} {version_data['class_name']} {version_data['app_name']} \\\n" + \
                    f"  {format_bash_command(version_data['display_name'])} \\\n" + \
                    f"  {format_bash_command(version_data['endpoint_message'])} \\\n" + \
                    f"  {format_bash_command(version_data['training_prompt'])} \\\n" + \
                    f"  --template hello --role Core --force"
         
         # Trifecta template option
-        trifecta_cmd = f"python helpers/workflow/create_workflow.py plugins/{next_filename} {version_data['class_name']} {version_data['app_name']} \\\n" + \
+        trifecta_cmd = f"python helpers/workflow/create_workflow.py apps/{next_filename} {version_data['class_name']} {version_data['app_name']} \\\n" + \
                        f"  {format_bash_command(version_data['display_name'])} \\\n" + \
                        f"  {format_bash_command(version_data['endpoint_message'])} \\\n" + \
                        f"  {format_bash_command(version_data['training_prompt'])} \\\n" + \
diff --git a/apps/240_simon_mcp.py b/apps/240_simon_mcp.py
index 8af3ccd..0d4f8cf 100644
--- a/apps/240_simon_mcp.py
+++ b/apps/240_simon_mcp.py
@@ -1,4 +1,4 @@
-# File: plugins/830_simon_mcp.py
+# File: apps/830_simon_mcp.py
 import asyncio
 from datetime import datetime
 import json
diff --git a/apps/300_blank_placeholder.py b/apps/300_blank_placeholder.py
index 89489da..4c716fe 100644
--- a/apps/300_blank_placeholder.py
+++ b/apps/300_blank_placeholder.py
@@ -1,4 +1,4 @@
-# File: plugins/300_blank_placeholder.py
+# File: apps/300_blank_placeholder.py
 import asyncio
 from datetime import datetime
 from fasthtml.common import * # type: ignore
diff --git a/assets/pipulate-init.js b/assets/pipulate-init.js
index 12617da..e5c0de7 100644
--- a/assets/pipulate-init.js
+++ b/assets/pipulate-init.js
@@ -1908,7 +1908,7 @@ async function executeCleanMcpToolCallStep(step) {
 - server.py (Main application)
 - mcp_tools.py (MCP tool definitions)
 - cli.py (Command line interface)
-- plugins/ (41 plugin files)
+- apps/ (41 plugin files)
 - /assets/ (Web assets)
 - browser_automation/ (Automation scripts)
 
diff --git a/helpers/release/publish.py b/helpers/release/publish.py
index 5871f61..30225b7 100755
--- a/helpers/release/publish.py
+++ b/helpers/release/publish.py
@@ -436,7 +436,7 @@ alwaysApply: true
 
 def detect_trifecta_changes():
     """Check if the Botify Trifecta template has been modified in git."""
-    trifecta_file = "plugins/400_botify_trifecta.py"
+    trifecta_file = "apps/400_botify_trifecta.py"
     
     try:
         # Check if file is in staged changes
diff --git a/helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md b/helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md
index c111cd3..fef6387 100644
--- a/helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md
+++ b/helpers/workflow/WORKFLOW_DEVELOPMENT_GUIDE.md
@@ -93,7 +93,7 @@ python helpers/workflow/splice_workflow_step.py 035_my_workflow.py --position to
 
 # Works with flexible filename handling
 python helpers/workflow/splice_workflow_step.py 035_my_workflow    # .py optional
-python helpers/workflow/splice_workflow_step.py plugins/035_my_workflow.py  # path optional
+python helpers/workflow/splice_workflow_step.py apps/035_my_workflow.py  # path optional
 ```
 
 **What It Does:**
@@ -127,8 +127,8 @@ async def step_XX_submit(self, request):
 ```bash
 # Replace step_01 in target with step_01 from source
 python helpers/workflow/swap_workflow_step.py \
-    plugins/035_my_workflow.py step_01 \
-    plugins/500_source_workflow.py step_01
+    apps/035_my_workflow.py step_01 \
+    apps/500_source_workflow.py step_01
 
 # Force replacement without confirmation
 python helpers/workflow/swap_workflow_step.py \
@@ -231,8 +231,8 @@ ENDPOINT_MESSAGE = 'Workflow-specific welcome message'    # ✅ Carried over fro
 ```bash
 # Merge UI_CONSTANTS from source to target
 python helpers/workflow/manage_class_attributes.py \
-    plugins/035_target_workflow.py \
-    plugins/500_source_workflow.py \
+    apps/035_target_workflow.py \
+    apps/500_source_workflow.py \
     --attributes-to-merge UI_CONSTANTS
 
 # Merge multiple attributes
@@ -328,7 +328,7 @@ curl http://localhost:5001/evolved_flowtest  # Test the workflow
 python helpers/workflow/workflow_reconstructor.py --template 045_evolved_flow --source 110_parameter_buster --target 045_evolved_flow
 
 # 5. Clean up test files
-rm plugins/045_evolved_flowtest.py
+rm apps/045_evolved_flowtest.py
 ```
 
 ### **Pattern 3: Component Library Development**
@@ -346,8 +346,8 @@ python helpers/workflow/create_workflow.py 200_parameter_engine.py ParameterEngi
 python helpers/workflow/workflow_reconstructor.py --template 400_botify_trifecta --source 200_parameter_engine --target 300_advanced_params
 
 # 4. Create component library pattern
-mkdir -p plugins/components/
-mv plugins/200_parameter_engine.py plugins/components/  # Archive proven components
+mkdir -p apps/components/
+mv apps/200_parameter_engine.py apps/components/  # Archive proven components
 ```
 
 ---
@@ -386,7 +386,7 @@ app.route(f'/{app_name}/custom_handler', methods=['GET'])            # ❌ No ma
 
 #### **4. File Organization**
 ```
-plugins/
+apps/
 ├── 000-099: Core system workflows
 ├── 100-199: Parameter/optimization workflows  
 ├── 200-299: Creation and management tools
@@ -455,8 +455,8 @@ python helpers/workflow/create_workflow.py 800_parameter_component.py ParameterC
 
 # 2. Perfect the component (extensive testing)
 # 3. Archive as atomic source
-mkdir -p plugins/components/
-mv plugins/800_parameter_component.py plugins/components/
+mkdir -p apps/components/
+mv apps/800_parameter_component.py apps/components/
 
 # 4. Use across multiple workflows
 python helpers/workflow/workflow_reconstructor.py --template 400_botify_trifecta --source components/800_parameter_component --target 100_new_param_flow
@@ -469,7 +469,7 @@ Evolve templates with new capabilities:
 
 ```bash
 # 1. Start with proven template
-cp plugins/400_botify_trifecta.py plugins/410_enhanced_trifecta.py
+cp apps/400_botify_trifecta.py apps/410_enhanced_trifecta.py
 
 # 2. Add capabilities via reconstruction
 python helpers/workflow/workflow_reconstructor.py --template 410_enhanced_trifecta --source 200_advanced_ui --target 410_enhanced_trifecta
@@ -495,7 +495,7 @@ curl http://localhost:5001/protoA
 curl http://localhost:5001/protoB
 
 # 4. Clean up
-rm plugins/999_*
+rm apps/999_*
 ```
 
 ---
diff --git a/helpers/workflow/create_workflow.py b/helpers/workflow/create_workflow.py
index 150dade..464be14 100644
--- a/helpers/workflow/create_workflow.py
+++ b/helpers/workflow/create_workflow.py
@@ -52,7 +52,7 @@ PLUGINS_DIR = PROJECT_ROOT / "plugins"
 # Works from any location - script automatically finds Pipulate project root:
 python create_workflow.py 035_kungfu_workflow.py KungfuWorkflow kungfu "Kung Fu Download" "Welcome message" "Training prompt"
 python create_workflow.py 035_kungfu_workflow KungfuWorkflow kungfu "Kung Fu Download" "Welcome message" "Training prompt"  # .py extension optional
-python create_workflow.py plugins/035_kungfu_workflow.py KungfuWorkflow kungfu "Kung Fu Download" "Welcome message" "Training prompt"  # plugins/ prefix optional
+python create_workflow.py apps/035_kungfu_workflow.py KungfuWorkflow kungfu "Kung Fu Download" "Welcome message" "Training prompt"  # apps/ prefix optional
 
 # Can be run from project root:
 python helpers/workflow/create_workflow.py 035_kungfu_workflow.py KungfuWorkflow kungfu "Kung Fu Download" "Welcome message" "Training prompt"
@@ -168,7 +168,7 @@ def main():
 Examples:
   python create_workflow.py 035_kungfu_workflow.py KungfuWorkflow kungfu "Kung Fu Download" "Welcome message" "Training prompt"
   python create_workflow.py 035_kungfu_workflow KungfuWorkflow kungfu "Kung Fu Download" "Welcome message" "Training prompt"
-  python create_workflow.py plugins/035_kungfu_workflow.py KungfuWorkflow kungfu "Kung Fu Download" "Welcome message" "Training prompt"
+  python create_workflow.py apps/035_kungfu_workflow.py KungfuWorkflow kungfu "Kung Fu Download" "Welcome message" "Training prompt"
   
   # Using different templates:
   python create_workflow.py 036_botify_custom.py MyBotify my_botify "My Botify Flow" "Welcome" "Training" --template trifecta
@@ -211,10 +211,10 @@ Examples:
     
     # Handle various input formats:
     # 1. Just filename: "035_kungfu_workflow.py"
-    # 2. With plugins/ prefix: "plugins/035_kungfu_workflow.py"  
-    # 3. Full path: "/some/path/plugins/035_kungfu_workflow.py"
-    if target_filename.startswith('plugins/'):
-        target_filename = target_filename[8:]  # Remove 'plugins/' prefix
+    # 2. With apps/ prefix: "apps/035_kungfu_workflow.py"  
+    # 3. Full path: "/some/path/apps/035_kungfu_workflow.py"
+    if target_filename.startswith('apps/'):
+        target_filename = target_filename[8:]  # Remove 'apps/' prefix
     elif '/' in target_filename:
         # Extract just the filename from any path
         target_filename = Path(target_filename).name
@@ -299,8 +299,8 @@ Examples:
                  print(f"WARNING: Docstring for '{ORIGINAL_CLASS_NAME_IDENTIFIER} Workflow' not found or not replaced.")
             
             # Replace file header comment
-            header_pattern = r'^# File: plugins/[^.]+\.py'
-            new_header = f'# File: plugins/{target_filename}'
+            header_pattern = r'^# File: apps/[^.]+\.py'
+            new_header = f'# File: apps/{target_filename}'
             content, header_count = re.subn(header_pattern, new_header, content, count=1, flags=re.MULTILINE)
             if header_count == 0:
                 print(f"WARNING: File header comment not found or not replaced.")
diff --git a/helpers/workflow/manage_class_attributes.py b/helpers/workflow/manage_class_attributes.py
index a7cfbf1..fbebf67 100644
--- a/helpers/workflow/manage_class_attributes.py
+++ b/helpers/workflow/manage_class_attributes.py
@@ -10,7 +10,7 @@ Usage:
     python manage_class_attributes.py TARGET_FILE SOURCE_FILE --attributes-to-merge ATTR1 ATTR2 [--force]
 
 Example:
-    python manage_class_attributes.py plugins/035_kungfu_workflow.py plugins/500_hello_workflow.py --attributes-to-merge UI_CONSTANTS
+    python manage_class_attributes.py apps/035_kungfu_workflow.py apps/500_hello_workflow.py --attributes-to-merge UI_CONSTANTS
 
 The script:
 1. Extracts class attributes from source file using CLASS_ATTRIBUTES_BUNDLE markers
diff --git a/helpers/workflow/splice_workflow_step.py b/helpers/workflow/splice_workflow_step.py
index c0e0615..721fbf4 100755
--- a/helpers/workflow/splice_workflow_step.py
+++ b/helpers/workflow/splice_workflow_step.py
@@ -17,7 +17,7 @@ python splice_workflow_step.py 035_kungfu_workflow.py --position top
 
 # Flexible filename handling:
 python splice_workflow_step.py 035_kungfu_workflow    # .py extension optional
-python splice_workflow_step.py plugins/035_kungfu_workflow.py  # plugins/ prefix optional
+python splice_workflow_step.py apps/035_kungfu_workflow.py  # apps/ prefix optional
 
 # Can be run from project root:
 python helpers/workflow/splice_workflow_step.py 035_kungfu_workflow.py --position top
@@ -309,8 +309,8 @@ Examples:
   python splice_workflow_step.py 035_kungfu_workflow.py --position top
   
   # Works with various path formats:
-  python splice_workflow_step.py plugins/035_kungfu_workflow.py --position top
-  python splice_workflow_step.py /full/path/to/plugins/035_kungfu_workflow.py --position bottom
+  python splice_workflow_step.py apps/035_kungfu_workflow.py --position top
+  python splice_workflow_step.py /full/path/to/apps/035_kungfu_workflow.py --position bottom
         """
     )
     parser.add_argument("target_filename", help="The filename of the workflow to modify (e.g., 035_kungfu_workflow.py)")
@@ -328,10 +328,10 @@ Examples:
     
     # Handle various input formats:
     # 1. Just filename: "035_kungfu_workflow.py"
-    # 2. With plugins/ prefix: "plugins/035_kungfu_workflow.py"  
-    # 3. Full path: "/some/path/plugins/035_kungfu_workflow.py"
-    if target_filename.startswith('plugins/'):
-        target_filename = target_filename[8:]  # Remove 'plugins/' prefix
+    # 2. With apps/ prefix: "apps/035_kungfu_workflow.py"  
+    # 3. Full path: "/some/path/apps/035_kungfu_workflow.py"
+    if target_filename.startswith('apps/'):
+        target_filename = target_filename[8:]  # Remove 'apps/' prefix
     elif '/' in target_filename:
         # Extract just the filename from any path
         target_filename = Path(target_filename).name
diff --git a/helpers/workflow/swap_workflow_step.py b/helpers/workflow/swap_workflow_step.py
index 775f1e3..ef68d99 100644
--- a/helpers/workflow/swap_workflow_step.py
+++ b/helpers/workflow/swap_workflow_step.py
@@ -14,7 +14,7 @@ Usage:
     python swap_workflow_step.py TARGET_FILE TARGET_STEP_ID SOURCE_FILE SOURCE_BUNDLE_ID [--force]
 
 Example:
-    python swap_workflow_step.py plugins/035_kungfu_workflow.py step_01 plugins/500_hello_workflow.py step_01
+    python swap_workflow_step.py apps/035_kungfu_workflow.py step_01 apps/500_hello_workflow.py step_01
 
 The script:
 1. Extracts the source step bundle using START_STEP_BUNDLE/END_STEP_BUNDLE markers
diff --git a/imports/crud.py b/imports/crud.py
index 19883c4..f9d6b49 100644
--- a/imports/crud.py
+++ b/imports/crud.py
@@ -616,7 +616,7 @@ class WorkflowUtilities:
                                       analysis_slug: str, data_type: str = None) -> str:
         """Generate deterministic file paths for data caching.
         
-        Extracted from: plugins/110_parameter_buster.py, 120_link_graph.py, 400_botify_trifecta.py
+        Extracted from: apps/110_parameter_buster.py, 120_link_graph.py, 400_botify_trifecta.py
         Pattern: FILE MANAGEMENT - Create consistent paths for file caching
         
         Args:
@@ -653,7 +653,7 @@ class WorkflowUtilities:
     async def check_file_exists(filepath: str) -> tuple[bool, dict]:
         """Check if file exists and return metadata.
         
-        Extracted from: plugins/110_parameter_buster.py (and similar patterns)
+        Extracted from: apps/110_parameter_buster.py (and similar patterns)
         Pattern: FILE VALIDATION - Consistent file existence checking
         
         Args:
@@ -680,7 +680,7 @@ class WorkflowUtilities:
     def url_to_safe_path(url: str) -> tuple[str, str]:
         """Convert URL to filesystem-safe path components.
         
-        Extracted from: plugins/440_browser_automation.py  
+        Extracted from: apps/440_browser_automation.py  
         Pattern: URL PROCESSING - Safe filesystem path generation
         
         Args:
diff --git a/server.py b/server.py
index 0efd7cc..50fcfad 100644
--- a/server.py
+++ b/server.py
@@ -3449,7 +3449,7 @@ def create_chat_scripts(sortable_selector='.sortable', ghost_class='blue-backgro
     return (Script(src='/assets/pipulate.js'), Script(python_generated_init_script), Link(rel='stylesheet', href='/assets/styles.css'))
 
 
-# BaseCrud class moved to plugins/crud.py to avoid circular imports
+# BaseCrud class moved to apps/crud.py to avoid circular imports
 
 # Initialize FastApp with database and configuration
 app, rt, (store, Store), (profiles, Profile), (pipeline, Pipeline) = fast_app(
diff --git a/tools/mcp_tools.py b/tools/mcp_tools.py
index f7acfa6..71ebd4f 100644
--- a/tools/mcp_tools.py
+++ b/tools/mcp_tools.py
@@ -2822,7 +2822,7 @@ async def browser_automate_workflow_walkthrough(params: dict) -> dict:
 
         # === AGGRESSIVE URL VALIDATION BEFORE BROWSER OPENING ===
         # Map plugin filename to app name and construct URL
-        plugin_name = plugin_filename.replace('plugins/', '').replace('.py', '')
+        plugin_name = plugin_filename.replace('apps/', '').replace('.py', '')
         plugin_to_app_mapping = {
             '010_introduction': 'introduction',
             '580_upload': 'file_upload_widget',
@@ -3047,7 +3047,7 @@ async def browser_automate_workflow_walkthrough(params: dict) -> dict:
         try:
             # Step 1: Navigate to the specific plugin requested
             # Extract plugin name from filename and construct URL
-            plugin_name = plugin_filename.replace('plugins/', '').replace('.py', '')
+            plugin_name = plugin_filename.replace('apps/', '').replace('.py', '')
 
             # Map plugin filename to app name (this is the key fix!)
             plugin_to_app_mapping = {
@@ -4624,7 +4624,7 @@ async def test_environment_access() -> dict:
         import os
         current_dir = os.getcwd()
         server_exists = os.path.exists("server.py")
-        plugins_exists = os.path.exists("plugins/")
+        plugins_exists = os.path.exists("apps/")
 
         return {
             "success": True,

requirements.txt:mdit-py-plugins==0.4.2
tools/advanced_automation_tools.py:            "command": "ls -la server.py plugins browser_automation"
server.py:    logger.warning(f'🚨 PRODUCTION_DATABASE_WARNING: If demo is triggered, plugins using static DB_FILENAME may cause issues!')
server.py:# This registry allows plugins to register MCP tools that can be called
server.py:# Global registry for MCP tools - populated by plugins during startup
server.py:    This class serves as the main interface for plugins to access
server.py:        Centralizes the folder button pattern used across many plugins.
server.py:            blank_placeholder_module = importlib.import_module('plugins.910_blank_placeholder')
server.py:if not os.path.exists('plugins'):
server.py:    os.makedirs('plugins')
server.py:    logger.info('📁 FINDER_TOKEN: PLUGINS_DIR - Created plugins directory')
server.py:    """Discover and import all Python files in the plugins directory.
server.py:    This function scans the 'plugins' directory and imports each .py file
server.py:    - Starting with 'xx_' or 'XX_' (indicating experimental/in-progress plugins)
server.py:    plugins_dir = os.path.join(os.path.dirname(__file__), 'plugins')
server.py:    logger.debug(f'Looking for plugins in: {plugins_dir}')
server.py:    if not os.path.isdir(plugins_dir):
server.py:        logger.warning(f'Plugins directory not found: {plugins_dir}')
server.py:    sorted_files = sorted(os.listdir(plugins_dir), key=numeric_prefix_sort)
server.py:                module = importlib.import_module(f'plugins.{original_name}')
server.py:                module = importlib.import_module(f'plugins.{original_name}')
server.py:                        # Only log classes that look like they might be plugins (have common plugin attributes)
server.py:    figlet_banner("plugins", "Pipulate Workflows and CRUD Apps", font='standard', color='orange3')
server.py:            module = importlib.import_module(f'plugins.{original_name}')
server.py:                            # Inject centralized configuration for plugins that need it
server.py:ordered_plugins = []
server.py:    if module_name not in ordered_plugins and module_name in plugin_instances:
server.py:        ordered_plugins.append(module_name)
server.py:        plugins_discovered=discovered_count,
server.py:        plugins_registered=registered_count,
server.py:    failed_plugins = []
server.py:            failed_plugins.append(f'{module_name}.{class_name}')
server.py:    server_whisper(f"Some plugins need attention: {', '.join(failed_plugins)}", "⚠️")
server.py:    logger.warning(f'FINDER_TOKEN: PLUGIN_REGISTRATION_SUMMARY - Failed plugins: {", ".join(failed_plugins)}')
server.py:    chip_says("All plugins loaded successfully! The workshop is fully equipped.", BANNER_COLORS['plugin_registry_success'])
server.py:MENU_ITEMS = base_menu_items + ordered_plugins + additional_menu_items
server.py:            placeholder='Search plugins (Ctrl+K)',
server.py:            hx_post='/search-plugins',
server.py:            aria_label='Search plugins',
server.py:    plugins_by_role = group_plugins_by_role(active_role_names)
server.py:            role_plugins = plugins_by_role.get(role_name, [])
server.py:            role_plugins.sort(key=lambda x: get_plugin_numeric_prefix(x))
server.py:            for plugin_key in role_plugins:
server.py:def group_plugins_by_role(active_role_names):
server.py:    """Group plugins by their primary role for hierarchical menu organization."""
server.py:    plugins_by_role = {}
server.py:    for plugin_key in ordered_plugins:
server.py:            if role_name not in plugins_by_role:
server.py:                plugins_by_role[role_name] = []
server.py:            plugins_by_role[role_name].append(plugin_key)
server.py:    logger.debug(f'Plugins grouped by role: {plugins_by_role}')
server.py:    return plugins_by_role
server.py:@rt('/search-plugins', methods=['POST'])
server.py:async def search_plugins(request):
server.py:    """Search plugins based on user input - Carson Gross style active search."""
server.py:        searchable_plugins = []
server.py:            if module_name in ['profiles', 'roles']:  # Skip system plugins
server.py:            searchable_plugins.append(plugin_entry)
server.py:        # Filter plugins based on search term
server.py:            filtered_plugins = []
server.py:            for plugin in searchable_plugins:
server.py:                    filtered_plugins.append(plugin)
server.py:            # Show ALL plugins on empty search (dropdown menu behavior)
server.py:            filtered_plugins = searchable_plugins
server.py:        if filtered_plugins:
server.py:            auto_select_single = len(filtered_plugins) == 1
server.py:            for i, plugin in enumerate(filtered_plugins):  # Show all results - no artificial limit
server.py:        logger.error(f"Error in search_plugins: {e}")
server.py:                "plugins": "Workflow applications and business logic",
assets/pipulate.js:   Keyboard navigation for search plugins dropdown following HTMX principles:
assets/pipulate.js:// Global search plugins keyboard navigation functions
assets/pipulate.js:        console.warn('⚠️ Search plugins elements not found, skipping keyboard nav setup');
tools/mcp_tools.py:        chrome_options.add_argument('--disable-plugins')
tools/mcp_tools.py:                    # For file upload plugins, we need to initialize the workflow first
tools/mcp_tools.py:        plugins_exists = os.path.exists("apps/")
tools/mcp_tools.py:            "plugins_directory_exists": plugins_exists,
tools/mcp_tools.py:            "environment_ready": server_exists and plugins_exists
training/roles.md:The Roles system is Pipulate's **homepage and menu control center** - a sophisticated CRUD application that determines which plugins appear in your APP menu. It's both the **landing page** and the **role-based access control system** that customizes your experience.
training/roles.md:2. **Menu Control System**: Determines which plugins appear in the APP dropdown
training/roles.md:- **Self-discovering**: New plugins automatically appear in the appropriate roles
training/roles.md:- **Always up-to-date**: The system finds and categorizes plugins as they're added
training/roles.md:- **Core**: Essential system plugins (always available)
training/roles.md:- **Plugin count**: Shows how many plugins this role provides
training/roles.md:- **Expandable plugin list**: Click to see all plugins in this role
training/roles.md:1. **Start with Core**: Essential plugins only
training/roles.md:4. **Custom ordering**: Prioritize most-used plugins
training/roles.md:- **Real-time scanning**: Discovers plugins as they're added
training/roles.md:- **Missing plugins**: Check `ROLES = ['Role Name']` in plugin files
training/roles.md:The Roles system is the **orchestrator** of the entire Pipulate experience - it conducts the symphony of plugins, profiles, and user preferences to create a harmonious, personalized interface.
README.md:   - Left sidebar with workflow plugins (Introduction, Profiles, etc.)
README.md:│   │   │   ├── Input [id='nav-plugin-search', role='searchbox', aria-label='Search plugins']
README.md:    ├── apps/                   # Workflow plugins (010_introduction.py, 400_trifecta.py, etc.)
README.md:The repository includes not only polished plugins but also experimental scripts and notebooks under development (e.g., in the root directory or marked with `xx_` prefix in plugin directories). These represent ongoing work and exploration.
assets/styles.css:   Consolidated from form input plugins (text_area, text_field, radios)
assets/styles.css:   Styles for the search plugins dropdown with keyboard navigation support.
pyproject.toml:include = ["plugins*", "static*"]
helpers/prompt_foo/generate_files_list.py:        f"{base_paths['pipulate']}/plugins", 
assets/css/prism.css:https://prismjs.com/download#themes=prism-okaidia&languages=markup+css+clike+javascript+bash+diff+json+json5+jsonp+liquid+lua+markdown+markup-templating+mermaid+nix+python+regex+yaml&plugins=line-highlight+line-numbers+toolbar+copy-to-clipboard+diff-highlight+treeview */
training/tasks.md:   - Discovers new plugins based on filename
training/widget_examples.md:    * **Widget:** A container using `<pre>` and `<code>` tags, styled by `Prism.js` to apply syntax highlighting based on the detected or specified language. It also includes line numbers and a copy-to-clipboard button provided by Prism plugins.
helpers/workflow/create_workflow.py:        if (current_dir / "plugins").is_dir() and (current_dir / "server.py").is_file():
helpers/workflow/create_workflow.py:        if root.exists() and (root / "plugins").is_dir() and (root / "server.py").is_file():
helpers/workflow/create_workflow.py:    "blank": PROJECT_ROOT / "plugins" / "300_blank_placeholder.py",
helpers/workflow/create_workflow.py:    "hello": PROJECT_ROOT / "plugins" / "500_hello_workflow.py",
helpers/workflow/create_workflow.py:    "trifecta": PROJECT_ROOT / "plugins" / "400_botify_trifecta.py",
helpers/workflow/create_workflow.py:    # "my_custom_template": PROJECT_ROOT / "plugins" / "0XX_my_custom_template.py",
helpers/workflow/create_workflow.py:PLUGINS_DIR = PROJECT_ROOT / "plugins"
apps/440_browser_automation.py:            driver.execute_cdp_cmd('Page.addScriptToEvaluateOnNewDocument', {'source': "\n                    Object.defineProperty(navigator, 'webdriver', {\n                        get: () => undefined\n                    });\n                    Object.defineProperty(navigator, 'plugins', {\n                        get: () => [1, 2, 3, 4, 5]\n                    });\n                    Object.defineProperty(navigator, 'languages', {\n                        get: () => ['en-US', 'en']\n                    });\n                "})
apps/440_browser_automation.py:            driver.execute_cdp_cmd('Page.addScriptToEvaluateOnNewDocument', {'source': "\n                    Object.defineProperty(navigator, 'webdriver', {\n                        get: () => undefined\n                    });\n                    Object.defineProperty(navigator, 'plugins', {\n                        get: () => [1, 2, 3, 4, 5]\n                    });\n                    Object.defineProperty(navigator, 'languages', {\n                        get: () => ['en-US', 'en']\n                    });\n                "})
helpers/workflow/splice_workflow_step.py:        if (current_dir / "plugins").is_dir() and (current_dir / "server.py").is_file():
helpers/workflow/splice_workflow_step.py:        if root.exists() and (root / "plugins").is_dir() and (root / "server.py").is_file():
helpers/workflow/splice_workflow_step.py:TEMPLATE_FILE_PATH = PROJECT_ROOT / "plugins" / "300_blank_placeholder.py"
helpers/workflow/splice_workflow_step.py:PLUGINS_DIR = PROJECT_ROOT / "plugins"
config.py:            'description': 'Essential plugins available to all users.',
config.py:            'description': 'Tools for creating, debugging, and managing workflows and plugins.',
helpers/workflow/workflow_reconstructor.py:        self.plugins_dir = self.base_dir / "plugins"
helpers/workflow/workflow_reconstructor.py:            template_path = self.plugins_dir / f"{template_name}.py"
helpers/workflow/workflow_reconstructor.py:            source_path = self.plugins_dir / f"{source_name}.py" 
helpers/workflow/workflow_reconstructor.py:            target_path = self.plugins_dir / f"{target_name}.py"
helpers/workflow/workflow_reconstructor.py:        existing_path = self.plugins_dir / f"{existing_name}.py"
helpers/workflow/workflow_reconstructor.py:            source_tree = reconstructor.parse_file(reconstructor.plugins_dir / f"{args.source}.py")
apps/030_roles.py:    affected_plugins = [plugin for plugin in plugin_list if item.text in plugin['roles']]
apps/030_roles.py:    plugin_count = len(affected_plugins)
apps/030_roles.py:    """Get list of all available plugins with their roles."""
apps/030_roles.py:    plugins = []
apps/030_roles.py:            # Skip the special plugins that don't belong in role lists
apps/030_roles.py:                # Most plugins have numeric prefixes, so we need to find the actual filename
apps/030_roles.py:                plugins.append({
apps/030_roles.py:    logger.debug(f"get_plugin_list: Returning {len(plugins)} plugins")
apps/030_roles.py:    core_plugins = [p for p in plugins if 'Core' in p['roles']]
apps/030_roles.py:    logger.debug(f"get_plugin_list: Found {len(core_plugins)} Core plugins: {[p['display_name'] for p in core_plugins]}")
apps/030_roles.py:    return sorted(plugins, key=lambda x: x['filename'])
apps/030_roles.py:    plugins = []
apps/030_roles.py:                plugins.append({
apps/030_roles.py:    return sorted(plugins, key=lambda x: x['filename'])
apps/030_roles.py:    """Create a discrete expandable list showing plugins with real emojis."""
apps/030_roles.py:    affected_plugins = [plugin for plugin in plugin_list if role_name in plugin['roles']]
apps/030_roles.py:    logger.debug(f"create_plugin_visibility_table: Role '{role_name}' has {len(affected_plugins)} plugins")
apps/030_roles.py:    for plugin in affected_plugins:
apps/030_roles.py:    if not affected_plugins:
apps/030_roles.py:            P("No plugins assigned to this role.", style="font-style: italic; color: var(--pico-muted-color); margin: 0.5rem 0;"),
apps/030_roles.py:    for plugin in affected_plugins:
apps/230_dev_assistant.py:            (f'/{internal_route_prefix}/search_plugins_step01', self.search_plugins_step01, ['POST'])
apps/230_dev_assistant.py:        # Check dropdown functions ONLY if they exist (don't penalize plugins without dropdowns)
apps/230_dev_assistant.py:        # BONUS: Perfect score message for plugins without dropdown dependencies
apps/230_dev_assistant.py:            # Show positive message for plugins without dropdown dependencies
apps/230_dev_assistant.py:    async def search_plugins_step01(self, request):
apps/230_dev_assistant.py:        """Search plugins for step 1 based on user input - Carson Gross style active search."""
apps/230_dev_assistant.py:            plugins_dir = Path("plugins")
apps/230_dev_assistant.py:            if plugins_dir.exists():
apps/230_dev_assistant.py:                plugin_files = [f.name for f in plugins_dir.glob("*.py") if not f.name.startswith("__")]
apps/230_dev_assistant.py:            # Filter plugins based on search term
apps/230_dev_assistant.py:                filtered_plugins = []
apps/230_dev_assistant.py:                        filtered_plugins.append({
apps/230_dev_assistant.py:                # Show ALL plugins on empty search (dropdown menu behavior)
apps/230_dev_assistant.py:                filtered_plugins = []
apps/230_dev_assistant.py:                    filtered_plugins.append({
apps/230_dev_assistant.py:            if filtered_plugins:
apps/230_dev_assistant.py:                auto_select_single = len(filtered_plugins) == 1
apps/230_dev_assistant.py:                for i, plugin in enumerate(sorted(filtered_plugins, key=lambda x: x['filename'])):  # Show all results - no artificial limit
apps/230_dev_assistant.py:            logger.error(f"Error in search_plugins_step01: {e}")
apps/230_dev_assistant.py:        file_path = Path("plugins") / filename
apps/230_dev_assistant.py:        plugins_dir = Path("plugins")
apps/230_dev_assistant.py:        if plugins_dir.exists():
apps/230_dev_assistant.py:            plugin_files = [f.name for f in plugins_dir.glob("*.py") if not f.name.startswith("__")]
apps/230_dev_assistant.py:                            placeholder='Search plugins by name...',
apps/230_dev_assistant.py:                            hx_post=f'/{app_name}/search_plugins_step01',
apps/230_dev_assistant.py:        file_path = Path("plugins") / selected_file
helpers/release/publish.py:    print("\n🏗️ Step 4.5: Rebuilding Trifecta derivative plugins...")
helpers/release/publish.py:        'plugins_rebuilt': 0,
helpers/release/publish.py:        if "Successfully processed: 2/2 plugins" in output:
helpers/release/publish.py:            stats['plugins_rebuilt'] = 2
helpers/release/publish.py:        elif "Successfully processed: 1/2 plugins" in output:
helpers/release/publish.py:            stats['plugins_rebuilt'] = 1
helpers/release/publish.py:            print(f"   🔨 Plugins rebuilt: {stats['plugins_rebuilt']}/2")
helpers/release/publish.py:        f"{stats['plugins_rebuilt']}/2",
helpers/release/publish.py:            print(f"🏗️ Trifecta Derivatives Rebuilt: {trifecta_stats.get('plugins_rebuilt', 0)}/2 plugins")
helpers/release/publish.py:            f"{trifecta_stats.get('plugins_rebuilt', 0)}/2 plugins",
apps/200_workflow_genesis.py:        plugins_filename = f"apps/{filename}" if not filename.startswith('apps/') else filename
apps/200_workflow_genesis.py:        create_cmd = f"python helpers/workflow/create_workflow.py {plugins_filename} {class_name} {internal_name} \\\n" + \
apps/200_workflow_genesis.py:        splice_bottom_cmd = f"python helpers/workflow/splice_workflow_step.py {plugins_filename} --position bottom"
apps/200_workflow_genesis.py:        splice_top_cmd = f"python helpers/workflow/splice_workflow_step.py {plugins_filename} --position top"
apps/200_workflow_genesis.py:        combined_cmd = f"python helpers/workflow/create_workflow.py {plugins_filename} {class_name} {internal_name} \\\n" + \
apps/200_workflow_genesis.py:        plugins_filename = f"apps/{filename}" if not filename.startswith('apps/') else filename
apps/200_workflow_genesis.py:        cmd1 = f"python helpers/workflow/create_workflow.py {plugins_filename} {class_name} {internal_name} " + \
apps/200_workflow_genesis.py:        cmd2 = f"python helpers/workflow/manage_class_attributes.py {plugins_filename} apps/040_hello_workflow.py --attributes-to-merge UI_CONSTANTS --force"
apps/200_workflow_genesis.py:        cmd3 = f"python helpers/workflow/swap_workflow_step.py {plugins_filename} step_01 apps/040_hello_workflow.py step_01 --force"
apps/200_workflow_genesis.py:        cmd4 = f"python helpers/workflow/splice_workflow_step.py {plugins_filename} --position bottom"
apps/200_workflow_genesis.py:        cmd5 = f"python helpers/workflow/swap_workflow_step.py {plugins_filename} step_02 apps/040_hello_workflow.py step_02 --force"
apps/200_workflow_genesis.py:        combined_cmd = f"python helpers/workflow/create_workflow.py {plugins_filename} {class_name} {internal_name} \\\n" + \
apps/200_workflow_genesis.py:                      f"python helpers/workflow/manage_class_attributes.py {plugins_filename} \\\n" + \
apps/200_workflow_genesis.py:                      f"python helpers/workflow/swap_workflow_step.py {plugins_filename} step_01 \\\n" + \
apps/200_workflow_genesis.py:                      f"python helpers/workflow/splice_workflow_step.py {plugins_filename} --position bottom && \\\n" + \
apps/200_workflow_genesis.py:                      f"python helpers/workflow/swap_workflow_step.py {plugins_filename} step_02 \\\n" + \
apps/200_workflow_genesis.py:        plugins_filename = f"apps/{filename}" if not filename.startswith('apps/') else filename
apps/200_workflow_genesis.py:        cmd1 = f"python helpers/workflow/create_workflow.py {plugins_filename} {class_name} {internal_name} " + \
apps/200_workflow_genesis.py:        cmd2 = f"python helpers/workflow/splice_workflow_step.py {plugins_filename} --position bottom"
apps/200_workflow_genesis.py:        combined_cmd = f"python helpers/workflow/create_workflow.py {plugins_filename} {class_name} {internal_name} \\\n" + \
apps/200_workflow_genesis.py:                      f"python helpers/workflow/splice_workflow_step.py {plugins_filename} --position bottom"
apps/200_workflow_genesis.py:            # Create filesystem button to open plugins directory
apps/200_workflow_genesis.py:            plugins_dir = os.path.join(os.getcwd(), 'plugins')
apps/200_workflow_genesis.py:            open_plugins_folder_ui = A(
apps/200_workflow_genesis.py:                hx_get="/open-folder?path=" + urllib.parse.quote(plugins_dir),
apps/200_workflow_genesis.py:                title=f"Open folder: {plugins_dir}",
apps/200_workflow_genesis.py:                    open_plugins_folder_ui,
apps/200_workflow_genesis.py:        plugins_filename = f"apps/{target_filename}" if not target_filename.startswith('apps/') else target_filename
apps/200_workflow_genesis.py:            combined_cmd = f"python helpers/workflow/create_workflow.py {plugins_filename} {class_name} {internal_name} " + \
apps/200_workflow_genesis.py:                          f"python helpers/workflow/manage_class_attributes.py {plugins_filename} " + \
apps/200_workflow_genesis.py:                          f"python helpers/workflow/swap_workflow_step.py {plugins_filename} step_01 " + \
apps/200_workflow_genesis.py:                          f"python helpers/workflow/splice_workflow_step.py {plugins_filename} --position bottom && " + \
apps/200_workflow_genesis.py:                          f"python helpers/workflow/swap_workflow_step.py {plugins_filename} step_02 " + \
apps/200_workflow_genesis.py:            combined_cmd = f"python helpers/workflow/create_workflow.py {plugins_filename} {class_name} {internal_name} " + \
apps/200_workflow_genesis.py:                          f"python helpers/workflow/splice_workflow_step.py {plugins_filename} --position bottom"
apps/200_workflow_genesis.py:            combined_cmd = f"python helpers/workflow/create_workflow.py {plugins_filename} {class_name} {internal_name} " + \
apps/200_workflow_genesis.py:        # Create filesystem button to open plugins directory
apps/200_workflow_genesis.py:        plugins_dir = os.path.join(os.getcwd(), 'plugins')
apps/200_workflow_genesis.py:        open_plugins_folder_ui = A(
apps/200_workflow_genesis.py:            hx_get="/open-folder?path=" + urllib.parse.quote(plugins_dir),
apps/200_workflow_genesis.py:            title=f"Open folder: {plugins_dir}",
apps/200_workflow_genesis.py:        execution_summary += f"📂 Location: {plugins_dir}\n"
apps/200_workflow_genesis.py:                    P(f"Created in: {plugins_dir}", cls="text-description"),
apps/200_workflow_genesis.py:                    open_plugins_folder_ui,
apps/200_workflow_genesis.py:                    P(f"Check: {plugins_dir}", cls="text-description"),
apps/200_workflow_genesis.py:                    open_plugins_folder_ui,
imports/ascii_displays.py:    plugins_discovered: int, 
imports/ascii_displays.py:    plugins_registered: int, 
imports/ascii_displays.py:    status_table.add_row("📦 Plugins", "✅ Loaded", f"{plugins_registered}/{plugins_discovered} registered")
imports/ascii_displays.py:✅ Plugins: {plugins_registered}/{plugins_discovered} registered
imports/botify/code_generators.py:# Convenience instance for backward compatibility with existing plugins
imports/botify_code_generation.py:eliminating ~400+ lines of duplicated code across plugins.
imports/botify_code_generation.py:    Centralizes the header generation logic to reduce duplication across plugins.
imports/botify_code_generation.py:    This eliminates ~100+ lines of duplicated f-string blocks across Botify plugins.
imports/botify_code_generation.py:            # Try different template config keys that plugins use
imports/botify_code_generation.py:    This eliminates ~150+ lines of duplicated f-string blocks across Botify plugins.
imports/botify_code_generation.py:    This eliminates path construction duplication across Botify plugins.
imports/crud.py:Common classes and utilities for plugins.
imports/crud.py:This module contains shared classes that plugins can import without creating
imports/crud.py:# 🎯 STANDARDIZED STEP DEFINITION - Used by all workflow plugins
imports/crud.py:# Eliminates 34+ identical namedtuple definitions across plugins
imports/crud.py:# Simple import pattern - plugins can copy these lines instead of massive import blocks
imports/crud.py:# 🌐 API WORKFLOW IMPORTS - For plugins that call external APIs
imports/crud.py:# 🎨 WIDGET IMPORTS - For UI component demonstration plugins
imports/crud.py:# Instead of copying massive import blocks from complex plugins,
imports/crud.py:# ✅ Widget plugins: Use the 5-line widget import pattern
imports/crud.py:# ✅ API plugins: Use the 8-line API workflow pattern  
imports/crud.py:# ✅ Basic plugins: Use the 4-line basic workflow pattern
imports/crud.py:        Extracted from: Multiple workflow plugins with repetitive form handling

requirements.txt:mdit-py-plugins==0.4.2
tools/advanced_automation_tools.py:            "command": "ls -la server.py plugins browser_automation"
server.py:    logger.warning(f'🚨 PRODUCTION_DATABASE_WARNING: If demo is triggered, plugins using static DB_FILENAME may cause issues!')
server.py:# This registry allows plugins to register MCP tools that can be called
server.py:# Global registry for MCP tools - populated by plugins during startup
server.py:    This class serves as the main interface for plugins to access
server.py:        Centralizes the folder button pattern used across many plugins.
server.py:            blank_placeholder_module = importlib.import_module('plugins.910_blank_placeholder')
server.py:    logger.info('📁 FINDER_TOKEN: PLUGINS_DIR - Created plugins directory')
server.py:    """Discover and import all Python files in the plugins directory.
server.py:    - Starting with 'xx_' or 'XX_' (indicating experimental/in-progress plugins)
server.py:    logger.debug(f'Looking for plugins in: {apps_dir}')
server.py:                module = importlib.import_module(f'plugins.{original_name}')
server.py:                module = importlib.import_module(f'plugins.{original_name}')
server.py:                        # Only log classes that look like they might be plugins (have common plugin attributes)
server.py:            module = importlib.import_module(f'plugins.{original_name}')
server.py:                            # Inject centralized configuration for plugins that need it
server.py:ordered_plugins = []
server.py:    if module_name not in ordered_plugins and module_name in plugin_instances:
server.py:        ordered_plugins.append(module_name)
server.py:    failed_plugins = []
server.py:            failed_plugins.append(f'{module_name}.{class_name}')
server.py:    server_whisper(f"Some plugins need attention: {', '.join(failed_plugins)}", "⚠️")
server.py:    logger.warning(f'FINDER_TOKEN: PLUGIN_REGISTRATION_SUMMARY - Failed plugins: {", ".join(failed_plugins)}')
server.py:    chip_says("All plugins loaded successfully! The workshop is fully equipped.", BANNER_COLORS['plugin_registry_success'])
server.py:MENU_ITEMS = base_menu_items + ordered_plugins + additional_menu_items
server.py:            placeholder='Search plugins (Ctrl+K)',
server.py:            aria_label='Search plugins',
server.py:            role_plugins = apps_by_role.get(role_name, [])
server.py:            role_plugins.sort(key=lambda x: get_plugin_numeric_prefix(x))
server.py:            for plugin_key in role_plugins:
server.py:    """Group plugins by their primary role for hierarchical menu organization."""
server.py:    for plugin_key in ordered_plugins:
server.py:async def search_plugins(request):
server.py:    """Search plugins based on user input - Carson Gross style active search."""
server.py:        searchable_plugins = []
server.py:            if module_name in ['profiles', 'roles']:  # Skip system plugins
server.py:            searchable_plugins.append(plugin_entry)
server.py:        # Filter plugins based on search term
server.py:            filtered_plugins = []
server.py:            for plugin in searchable_plugins:
server.py:                    filtered_plugins.append(plugin)
server.py:            # Show ALL plugins on empty search (dropdown menu behavior)
server.py:            filtered_plugins = searchable_plugins
server.py:        if filtered_plugins:
server.py:            auto_select_single = len(filtered_plugins) == 1
server.py:            for i, plugin in enumerate(filtered_plugins):  # Show all results - no artificial limit
server.py:        logger.error(f"Error in search_plugins: {e}")
assets/styles.css:   Consolidated from form input plugins (text_area, text_field, radios)
assets/styles.css:   Styles for the search plugins dropdown with keyboard navigation support.
tools/mcp_tools.py:        chrome_options.add_argument('--disable-plugins')
tools/mcp_tools.py:                    # For file upload plugins, we need to initialize the workflow first
helpers/prompt_foo/generate_files_list.py:        f"{base_paths['pipulate']}/plugins", 
training/roles.md:The Roles system is Pipulate's **homepage and menu control center** - a sophisticated CRUD application that determines which plugins appear in your APP menu. It's both the **landing page** and the **role-based access control system** that customizes your experience.
training/roles.md:2. **Menu Control System**: Determines which plugins appear in the APP dropdown
training/roles.md:- **Self-discovering**: New plugins automatically appear in the appropriate roles
training/roles.md:- **Always up-to-date**: The system finds and categorizes plugins as they're added
training/roles.md:- **Core**: Essential system plugins (always available)
training/roles.md:- **Plugin count**: Shows how many plugins this role provides
training/roles.md:- **Expandable plugin list**: Click to see all plugins in this role
training/roles.md:1. **Start with Core**: Essential plugins only
training/roles.md:4. **Custom ordering**: Prioritize most-used plugins
training/roles.md:- **Real-time scanning**: Discovers plugins as they're added
training/roles.md:- **Missing plugins**: Check `ROLES = ['Role Name']` in plugin files
training/roles.md:The Roles system is the **orchestrator** of the entire Pipulate experience - it conducts the symphony of plugins, profiles, and user preferences to create a harmonious, personalized interface.
assets/pipulate.js:   Keyboard navigation for search plugins dropdown following HTMX principles:
assets/pipulate.js:// Global search plugins keyboard navigation functions
assets/pipulate.js:        console.warn('⚠️ Search plugins elements not found, skipping keyboard nav setup');
training/tasks.md:   - Discovers new plugins based on filename
training/widget_examples.md:    * **Widget:** A container using `<pre>` and `<code>` tags, styled by `Prism.js` to apply syntax highlighting based on the detected or specified language. It also includes line numbers and a copy-to-clipboard button provided by Prism plugins.
apps/030_roles.py:    affected_plugins = [plugin for plugin in plugin_list if item.text in plugin['roles']]
apps/030_roles.py:    plugin_count = len(affected_plugins)
apps/030_roles.py:    """Get list of all available plugins with their roles."""
apps/030_roles.py:    plugins = []
apps/030_roles.py:            # Skip the special plugins that don't belong in role lists
apps/030_roles.py:                # Most plugins have numeric prefixes, so we need to find the actual filename
apps/030_roles.py:                plugins.append({
apps/030_roles.py:    logger.debug(f"get_plugin_list: Returning {len(plugins)} plugins")
apps/030_roles.py:    core_plugins = [p for p in plugins if 'Core' in p['roles']]
apps/030_roles.py:    logger.debug(f"get_plugin_list: Found {len(core_plugins)} Core plugins: {[p['display_name'] for p in core_plugins]}")
apps/030_roles.py:    return sorted(plugins, key=lambda x: x['filename'])
apps/030_roles.py:    plugins = []
apps/030_roles.py:                plugins.append({
apps/030_roles.py:    return sorted(plugins, key=lambda x: x['filename'])
apps/030_roles.py:    """Create a discrete expandable list showing plugins with real emojis."""
apps/030_roles.py:    affected_plugins = [plugin for plugin in plugin_list if role_name in plugin['roles']]
apps/030_roles.py:    logger.debug(f"create_plugin_visibility_table: Role '{role_name}' has {len(affected_plugins)} plugins")
apps/030_roles.py:    for plugin in affected_plugins:
apps/030_roles.py:    if not affected_plugins:
apps/030_roles.py:            P("No plugins assigned to this role.", style="font-style: italic; color: var(--pico-muted-color); margin: 0.5rem 0;"),
apps/030_roles.py:    for plugin in affected_plugins:
helpers/release/publish.py:    print("\n🏗️ Step 4.5: Rebuilding Trifecta derivative plugins...")
helpers/release/publish.py:        if "Successfully processed: 2/2 plugins" in output:
helpers/release/publish.py:        elif "Successfully processed: 1/2 plugins" in output:
helpers/release/publish.py:            print(f"🏗️ Trifecta Derivatives Rebuilt: {trifecta_stats.get('apps_rebuilt', 0)}/2 plugins")
helpers/release/publish.py:            f"{trifecta_stats.get('apps_rebuilt', 0)}/2 plugins",
config.py:            'description': 'Essential plugins available to all users.',
config.py:            'description': 'Tools for creating, debugging, and managing workflows and plugins.',
README.md:   - Left sidebar with workflow plugins (Introduction, Profiles, etc.)
README.md:│   │   │   ├── Input [id='nav-plugin-search', role='searchbox', aria-label='Search plugins']
README.md:    ├── apps/                   # Workflow plugins (010_introduction.py, 400_trifecta.py, etc.)
README.md:The repository includes not only polished plugins but also experimental scripts and notebooks under development (e.g., in the root directory or marked with `xx_` prefix in plugin directories). These represent ongoing work and exploration.
assets/css/prism.css:https://prismjs.com/download#themes=prism-okaidia&languages=markup+css+clike+javascript+bash+diff+json+json5+jsonp+liquid+lua+markdown+markup-templating+mermaid+nix+python+regex+yaml&plugins=line-highlight+line-numbers+toolbar+copy-to-clipboard+diff-highlight+treeview */
pyproject.toml:include = ["plugins*", "static*"]
imports/crud.py:Common classes and utilities for plugins.
imports/crud.py:This module contains shared classes that plugins can import without creating
imports/crud.py:# 🎯 STANDARDIZED STEP DEFINITION - Used by all workflow plugins
imports/crud.py:# Eliminates 34+ identical namedtuple definitions across plugins
imports/crud.py:# Simple import pattern - plugins can copy these lines instead of massive import blocks
imports/crud.py:# 🌐 API WORKFLOW IMPORTS - For plugins that call external APIs
imports/crud.py:# 🎨 WIDGET IMPORTS - For UI component demonstration plugins
imports/crud.py:# Instead of copying massive import blocks from complex plugins,
imports/crud.py:# ✅ Widget plugins: Use the 5-line widget import pattern
imports/crud.py:# ✅ API plugins: Use the 8-line API workflow pattern  
imports/crud.py:# ✅ Basic plugins: Use the 4-line basic workflow pattern
imports/crud.py:        Extracted from: Multiple workflow plugins with repetitive form handling
imports/botify/code_generators.py:# Convenience instance for backward compatibility with existing plugins
apps/230_dev_assistant.py:        # Check dropdown functions ONLY if they exist (don't penalize plugins without dropdowns)
apps/230_dev_assistant.py:        # BONUS: Perfect score message for plugins without dropdown dependencies
apps/230_dev_assistant.py:            # Show positive message for plugins without dropdown dependencies
apps/230_dev_assistant.py:        """Search plugins for step 1 based on user input - Carson Gross style active search."""
apps/230_dev_assistant.py:            # Filter plugins based on search term
apps/230_dev_assistant.py:                filtered_plugins = []
apps/230_dev_assistant.py:                        filtered_plugins.append({
apps/230_dev_assistant.py:                # Show ALL plugins on empty search (dropdown menu behavior)
apps/230_dev_assistant.py:                filtered_plugins = []
apps/230_dev_assistant.py:                    filtered_plugins.append({
apps/230_dev_assistant.py:            if filtered_plugins:
apps/230_dev_assistant.py:                auto_select_single = len(filtered_plugins) == 1
apps/230_dev_assistant.py:                for i, plugin in enumerate(sorted(filtered_plugins, key=lambda x: x['filename'])):  # Show all results - no artificial limit
apps/230_dev_assistant.py:                            placeholder='Search plugins by name...',
apps/200_workflow_genesis.py:            # Create filesystem button to open plugins directory
apps/200_workflow_genesis.py:        # Create filesystem button to open plugins directory
imports/botify_code_generation.py:eliminating ~400+ lines of duplicated code across plugins.
imports/botify_code_generation.py:    Centralizes the header generation logic to reduce duplication across plugins.
imports/botify_code_generation.py:    This eliminates ~100+ lines of duplicated f-string blocks across Botify plugins.
imports/botify_code_generation.py:            # Try different template config keys that plugins use
imports/botify_code_generation.py:    This eliminates ~150+ lines of duplicated f-string blocks across Botify plugins.
imports/botify_code_generation.py:    This eliminates path construction duplication across Botify plugins.