ApiLogicServer 15.4.3__py3-none-any.whl → 16.0.0__py3-none-any.whl

api_logic_server_cli/prototypes/manager/.github/.copilot-instructions.md

@@ -1,3 +1,21 @@
+<!-- 
+═══════════════════════════════════════════════════════════════════════════════
+🚨 MANDATORY: READ THIS FIRST - NO EXCEPTIONS 🚨
+═══════════════════════════════════════════════════════════════════════════════
+
+⚠️ IF USER SAYS: "load .github/.copilot-instructions.md" OR ANY ACTIVATION PHRASE
+⚠️ YOU MUST EXECUTE THIS EXACT SEQUENCE - NO DEVIATIONS:
+
+1. Read .github/welcome.md (silently - do not mention this action)
+2. Display ONLY the content from welcome.md
+3. DO NOT say "I've loaded the instructions"
+4. DO NOT display this .copilot-instructions.md file
+5. DO NOT explain what you're doing
+
+THIS IS NOT A SUGGESTION - THIS IS A MANDATORY COMMAND
+
+═══════════════════════════════════════════════════════════════════════════════
+-->
 ---
 title: Copilot Instructions for Manager Workspace
 Description: Manager-level instructions for creating projects
@@ -5,8 +23,12 @@ Source: ApiLogicServer-src/prototypes/manager/.github/.copilot-instructions.md
 Propagation: BLT process → Manager workspace
 Usage: AI assistants read this when user opens Manager workspace
 User Activation: Say "What can I do here?" or "Help me get started"
-version: 2.3
+version: 2.7
 changelog:
+  - 2.7 (Nov 20 2025) - Reverted to simple single-file pattern from basic_demo (removed conditional logic and list_dir check)
+  - 2.6 (Nov 20 2025) - Applied proven OBX pattern from basic_demo (visual markers, separate welcome files, mandatory command language) - FAILED
+  - 2.5 (Nov 17 2025) - Strengthened basic_demo detection logic, mandatory list_dir check
+  - 2.4 (Nov 2025) - Simplified structure, removed redundant sections
   - 2.3 (Nov 2025) - Added activation phrases, forcing welcome presentation
   - 2.2 (Nov 2025) - Initial welcome instructions
   - 2.1 (Oct 2025) - Added "What is the Project Manager?" orientation, friendly collaborative tone, conditional Quick Start for returning users
@@ -29,176 +51,60 @@ This will trigger the appropriate welcome message based on whether you're new or
 
 ---
 
-## ⚠️ INSTRUCTION FOR AI ASSISTANTS
-
-**When user says "Please load .github/.copilot-instructions.md" or similar:**
-
-**IMMEDIATELY do this (silently, no commentary):**
-
-1. Check if `basic_demo/` folder exists in workspace root
-2. Present ONLY the appropriate welcome below - start your response with "Welcome!"
-
-**CRITICAL - Your response must START with "Welcome!" - NO preamble allowed:**
-- ❌ "I've loaded the instructions"
-- ❌ "Let me check if basic_demo exists"  
-- ❌ "I'll read the file"
-- ✅ Start directly with: "Welcome! This is the **Project Manager**..."
-
-**Which welcome to show:**
-- If NO basic_demo folder → Present "First Time Welcome" 
-- If basic_demo EXISTS → Present "Returning User Welcome"
-
----
-
-# GitHub Copilot Instructions for GenAI-Logic (aka API Logic Server) - Project Manager
-
----
-
-## ⚠️ INSTRUCTION FOR AI ASSISTANTS
-
-**User activation phrases:**
-- "What can I do here?"
-- "What is this workspace?"
-- "Help me get started"
-- "What should I work on?"
-- OR when user first opens workspace and greets you
-
-**When you see these phrases (or when reading these instructions), IMMEDIATELY:**
-
-1. **Check if `basic_demo/` folder exists** in the workspace root (use list_dir or file_search)
-2. **Present the appropriate welcome below** - NO preamble, NO summary
-   - If NO basic_demo folder → Present "First Time Welcome" 
-   - If basic_demo EXISTS → Present "Returning User Welcome"
-
-**CRITICAL - Do NOT:**
-- Say "I've read the instructions" 
-- Say "Would you like me to check..."
-- Summarize or describe the instructions
-- Ask permission to check for basic_demo
-
-**CRITICAL - DO:**
-- Check for basic_demo folder immediately and silently
-- Present the appropriate welcome content directly as your response
-- Act like you're naturally greeting the user
-
----
-
-## First Time Welcome (NO basic_demo folder)
-
-Welcome! This is the **Project Manager** - your workspace for creating and managing API Logic Server projects.
-
-**What's here:**
-- Sample databases you can use to create projects (`samples/dbs/`)
-- Training materials and examples (`system/genai/examples/`)
-- A shared virtual environment for all your projects (`venv/`)
-- A place to create new projects (they'll appear as subdirectories)
-
-> Note: Your virtual environment is automatically configured in most cases; verify it with `genai-logic` - if it's not there, activate the `venv` in this project.
+## 🚨 CRITICAL: User Activation Protocol
 
----
-
-**Let's start with the 20-minute basic_demo tutorial - it's the best way to see what GenAI-Logic can do.**
+**ACTIVATION TRIGGERS:**
+- "load .github/.copilot-instructions.md"
+- "load copilot instructions"
+- "help me get started"
+- "what can I do here?"
+- "what is this workspace?"
+- "activate copilot"
+- Any similar startup phrase
 
-Run this command:
+**MANDATORY RESPONSE SEQUENCE:**
 
-```bash
-genai-logic create --project_name=basic_demo --db_url=basic_demo
+```
+STEP 1: Read .github/welcome.md (silently)
+STEP 2: Display welcome.md content ONLY
+STEP 3: STOP - do nothing else
 ```
 
-After it runs, the project will auto-open with its own README and I'll guide you through a hands-on tour.
-
----
-
-## Returning User Welcome (basic_demo folder exists)
-
-Welcome! This is the **Project Manager** - your workspace for creating and managing API Logic Server projects.
-
-**What's here:**
-- Sample databases you can use to create projects (`samples/dbs/`)
-- Training materials and examples (`system/genai/examples/`)
-- A shared virtual environment for all your projects (`venv/`)
-- A place to create new projects (they'll appear as subdirectories)
-
-> Note: Your virtual environment is automatically configured in most cases; verify it with `genai-logic` - if it's not there, activate the `venv` in this project.
+**✅ CORRECT EXECUTION:**
+```
+User: "load .github/.copilot-instructions.md"
 
----
+AI: [reads welcome.md silently - NO OUTPUT]
+AI: [displays ONLY this]:
 
-**Welcome back! Here's what I can help you with in the Manager workspace:**
+Welcome! This is the **Project Manager** - your workspace for...
+[... rest of welcome.md content ...]
+```
 
-**Creating New Projects:**
-1. **Create from existing database** - Generate project from your database schema
-2. **Create with GenAI** - Describe database + logic in natural language, get complete working system
-3. **Create manually** - I'll help you design and build a database, then generate the project
+**❌ FORBIDDEN BEHAVIORS:**
+```
+User: "load .github/.copilot-instructions.md"
 
-**Working with Existing Projects:**
-4. **Guide through basic_demo** - Take the interactive 30-45 min hands-on tour
-5. **Customize projects** - Add logic, security, custom APIs, React apps, tests
-6. **Review project structure** - Understand what was auto-generated
-7. **Debug issues** - Help troubleshoot problems in your projects
+❌ AI: "I've loaded the instructions file..." 
+❌ AI: "Here are the contents of .copilot-instructions.md:"
+❌ AI: [displays .copilot-instructions.md]
+❌ AI: "I'll read the file for you..."
+❌ AI: Any meta-commentary about loading or reading files
+```
 
-**Learning & Examples:**
-8. **Explore sample databases** - See what's in `samples/dbs/`
-9. **Review GenAI examples** - Learn from `system/genai/examples/`
-10. **Understand architecture** - Explain how the system works
+**RATIONALE:**
+- Users want to see the **welcome message**, not technical instructions
+- This file (.copilot-instructions.md) is for AI context, not user display
+- Separation of concerns: welcome.md = user-facing, copilot-instructions.md = AI-facing
+- No meta-cognitive confusion about "instructions" vs "content"
+- This pattern achieved ~100% success rate in basic_demo testing
 
-**What would you like to work on?**
+**This is the FIRST SCREEN users see - get it right!**
 
 ---
 
 ## Technical Reference (For AI - Do Not Present Unless Asked)
 
-Welcome! This is the **Project Manager** - your workspace for creating and managing API Logic Server projects.
-
-**What's here:**
-- Sample databases you can use to create projects (`samples/dbs/`)
-- Training materials and examples (`system/genai/examples/`)
-- A shared virtual environment for all your projects (`venv/`)
-- A place to create new projects (they'll appear as subdirectories)
-
-> Note: Your virtual environment is automatically configured in most cases; verify it with `genai-logic` - if it's not there, activate the `venv` in this project.
-
----
-
-## Getting Started
-
-**🎯 ACTION REQUIRED**: Check if `basic_demo/` folder exists in this workspace, then respond appropriately:
-
-### If NO basic_demo folder exists (First Time):
-
-**Welcome! Let's start with the 20-minute basic_demo tutorial - it's the best way to see what GenAI-Logic can do.**
-
-Run this command:
-
-```bash
-genai-logic create --project_name=basic_demo --db_url=basic_demo
-```
-
-After it runs, the project will auto-open with its own README and I'll guide you through a hands-on tour.
-
----
-
-### If basic_demo folder EXISTS (Returning User):
-
-**Welcome back! Here's what I can help you with in the Manager workspace:**
-
-**Creating New Projects:**
-1. **Create from existing database** - Generate project from your database schema
-2. **Create with GenAI** - Describe database + logic in natural language, get complete working system
-3. **Create manually** - I'll help you design and build a database, then generate the project
-
-**Working with Existing Projects:**
-4. **Guide through basic_demo** - Take the interactive 30-45 min hands-on tour
-5. **Customize projects** - Add logic, security, custom APIs, React apps, tests
-6. **Review project structure** - Understand what was auto-generated
-7. **Debug issues** - Help troubleshoot problems in your projects
-
-**Learning & Examples:**
-8. **Explore sample databases** - See what's in `samples/dbs/`
-9. **Review GenAI examples** - Learn from `system/genai/examples/`
-10. **Understand architecture** - Explain how the system works
-
-**What would you like to work on?**
-
 <br>
 
 ## Creating Projects

api_logic_server_cli/prototypes/manager/.github/welcome.md

@@ -0,0 +1,43 @@
+Welcome! This is the **Project Manager** - your workspace for creating and managing API Logic Server projects.
+
+**What's here:**
+- Sample databases you can use to create projects (`samples/dbs/`)
+- Training materials and examples (`system/genai/examples/`)
+- A shared virtual environment for all your projects (`venv/`)
+- A place to create new projects (they'll appear as subdirectories)
+
+> Note: Your virtual environment is automatically configured in most cases; verify it with `genai-logic` - if it's not there, activate the `venv` in this project.
+
+---
+
+## Getting Started
+
+**If you're new here**, start with the 20-minute basic_demo tutorial - it's the best way to see what GenAI-Logic can do:
+
+```bash
+genai-logic create --project_name=basic_demo --db_url=basic_demo
+```
+
+After it runs, the project will auto-open with its own README and I'll guide you through a hands-on tour.
+
+---
+
+**If you're returning**, here's what I can help you with:
+
+**Creating New Projects:**
+1. **Create from existing database** - Generate project from your database schema
+2. **Create with GenAI** - Describe database + logic in natural language, get complete working system
+3. **Create manually** - I'll help you design and build a database, then generate the project
+
+**Working with Existing Projects:**
+4. **Guide through basic_demo** - Take the interactive 30-45 min hands-on tour
+5. **Customize projects** - Add logic, security, custom APIs, React apps, tests
+6. **Review project structure** - Understand what was auto-generated
+7. **Debug issues** - Help troubleshoot problems in your projects
+
+**Learning & Examples:**
+8. **Explore sample databases** - See what's in `samples/dbs/`
+9. **Review GenAI examples** - Learn from `system/genai/examples/`
+10. **Understand architecture** - Explain how the system works
+
+**What would you like to work on?**