ApiLogicServer 15.3.0__py3-none-any.whl → 15.3.6__py3-none-any.whl

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

@@ -1,21 +1,23 @@
 ---
-title: Copilot Instructions for basic_demo Project
-Description: Project-level instructions for AI assistants conducting guided tours
-Source: ApiLogicServer-src/prototypes/basic_demo/.github/.copilot-instructions.md
-Propagation: CLI create command → created projects
-Usage: AI assistants read this when user says "guide me through"
-version: 2.3
+title: Copilot Instructions for GenAI-Logic Projects
+Description: Project-level instructions for working with generated projects
+Source: ApiLogicServer-src/prototypes/base/.github/.copilot-instructions.md
+Propagation: CLI create command → created projects (non-basic_demo)
+Instrucions: Changes must be copied to api_logic_server_cli/prototypes/basic_demo/.github - see instructions there
+Usage: AI assistants read this when user opens any created project
+version: 2.4
 changelog:
-  - 2.4 10/28/2025 - Added "Ready to explore?" prompt to guide user to tutor.md
-  - 2.3 (Oct 2025) - Added positive instruction: respond WITH Welcome section content
-  - 2.2 (Oct 2025) - Removed meta-instruction; let structure speak for itself
-  - 2.1 (Oct 2025) - Streamlined OBX, emphasized uncustomized template, friendly collaborative tone
-  - 2.0 (Oct 2025) - Added provocation method, spreadsheet analogy, timing checkpoints
+  - 2.4 (Nov 05, 2025 - Added MCP Integration section, Copilot as MCP client capability)
+  - 2.3 (Nov 04, 2025 - Clear 1st message about reading Welcome section verbatim, again for non basic_demo)
+  - 2.2 (Oct 29, 2025 - Clear 1st message about reading Welcome section verbatim)
+  - 2.1 (Oct 2025) - Streamlined OBX for non-tutorial projects, friendly collaborative tone
+  - 2.0 (Oct 2025) - Added front matter, updated for OBX improvements
+  - 1.0 (Initial) - Comprehensive technical reference
 ---
 
 # GitHub Copilot Instructions for GenAI-Logic (aka API Logic Server) Projects
 
-**INSTRUCTION**: When the user asks you to read these instructions, respond with the Welcome section content below as your greeting. Do not add preamble like "I've read the instructions" - just present the Welcome content directly.
+**INSTRUCTION**: When the user asks you to load these instructions, respond with the Welcome section content below as your greeting. Do not add preamble like "I've read the instructions" - just present the Welcome content directly. The Welcome section ends at the "---" marker before "🔑 Key Technical Points".
 
 ## Welcome
 
@@ -39,20 +41,94 @@ This is a complete, working microservice auto-generated from a database schema -
 
 ---
 
-## Technical Reference (For AI Assistant - Do Not Present to User Unless Asked)
+**DO NOT include the content below in the welcome greeting. It is reference material only.**
 
-The sections below contain detailed technical information for when we're actively working on specific tasks. These are reference materials, not introductory content.
+## Here are some things I can help you with
+
+1. **Add business logic** - Describe your requirements in natural language, I'll generate declarative rules
+2. **Customize the API** - Add custom endpoints for your specific needs
+3. **Create custom UIs** - Build React apps with `genai-logic genai-add-app --vibe`
+4. **Add security** - Set up role-based access control with `genai-logic add-auth`
+5. **Test your logic** - Create Behave tests with requirements traceability
+6. **Configure Admin UI** - Customize the auto-generated admin interface
+7. **Query via natural language** - I can act as MCP client to read/update data (see `docs/training/MCP_Copilot_Integration.md`)
+8. **Create B2B APIs** - Complex integration endpoints with partner systems
+9. **Add events** - Integrate with Kafka, webhooks, or other event systems
+10. **Customize models** - Add tables, attributes, or derived fields
+11. **Discovery systems** - Auto-load logic and APIs from discovery folders
+
+Want to get started? Press **F5** to start the server with debugger support, then open `http://localhost:5656`. (There are also run configurations for running tests and other tasks.) Or just ask me what you'd like to work on.
 
 ---
 
-I'll present these as choices - we'll tackle them one at a time.
+## 🔑 Key Technical Points
+```
+
+**DO NOT create your own summary. DO NOT rephrase. Copy the text above exactly.**
 
-### Set Up Virtual Environment
-If it's not already set, we can often find a `venv` in the GenAI-Logic Manager - a parent or grandparent directory.
+The technical reference sections below are for later consultation when working on specific tasks.
 
-### 🚀 To Run This Project
+---
+
+## Welcome (Reference Copy)
+
+| # | Service | Description |
+|---|---------|-------------|
+| 1️⃣ | **Add business logic** | Describe your requirements in natural language, I'll generate declarative rules |
+| 2️⃣ | **Customize the API** | Add custom endpoints for your specific needs |
+| 3️⃣ | **Create custom UIs** | Build React apps with `genai-logic genai-add-app --vibe` |
+| 4️⃣ | **Add security** | Set up role-based access control with `genai-logic add-auth` |
+| 5️⃣ | **Test your logic** | Create Behave tests with requirements traceability |
+| 6️⃣ | **Configure Admin UI** | Customize the auto-generated admin interface |
+| 7️⃣ | **Add MCP integration** | Enable Model Context Protocol for external AI access |
+| 8️⃣ | **Create B2B APIs** | Complex integration endpoints with partner systems |
+| 9️⃣ | **Add events** | Integrate with Kafka, webhooks, or other event systems |
+| 🔟 | **Customize models** | Add tables, attributes, or derived fields |
+| 1️⃣1️⃣ | **Discovery systems** | Auto-load logic and APIs from discovery folders |
+
+---
 
-Use F5 (pre-configured run configuration - supports debugger for server logic), or (when focused on client apps):
+Want to get started? Press **F5** to start the server with debugger support, then open `http://localhost:5656`. (There are also run configurations for running tests and other tasks.) Or just ask me what you'd like to work on.
+
+---
+
+## 🔑 Key Technical Points
+
+**Critical Implementation Details:**
+
+1. **Discovery Systems**: 
+   - **Logic Discovery**: Business rules automatically loaded from `logic/logic_discovery/use_case.py` via `logic/logic_discovery/auto_discovery.py`
+   - **API Discovery**: Custom APIs automatically loaded from `api/api_discovery/[service_name].py` via `api/api_discovery/auto_discovery.py`
+   - Do NOT manually duplicate rule calls or API registrations
+
+2. **API Record ID Pattern**: When creating records via custom APIs, use `session.flush()` before accessing the ID to ensure it's generated:
+   ```python
+   session.add(sql_alchemy_row)
+   session.flush()  # Ensures ID is generated
+   record_id = sql_alchemy_row.id
+   return {"message": "Success", "record_id": record_id}
+   ```
+
+3. **Automatic Business Logic**: All APIs (standard and custom) automatically inherit LogicBank rules without additional code.
+
+4. **CLI Commands**: Use `genai-logic --help` to see all available commands. When CLI commands exist for a task (e.g., `add-auth`, `genai-add-mcp-client`, `genai-add-app`), ALWAYS use them instead of manual configuration - they handle all setup correctly.
+
+> **📋 Testing:** For comprehensive testing conventions, patterns, and examples, see `docs/training/testing.md` (555 lines - I'll read this before we create any tests)
+
+---
+
+## Detailed Service Documentation
+
+The sections below provide complete details on each service. I'll reference these as needed when we work together.
+
+### `venv` is required
+
+To establish the virtual environment:
+
+1. Attempt to find a `venv` folder in the parent or grandparent directory
+2. Or, create it using requirements.txt
+
+### Starting the server
 
 ```bash
 python api_logic_server_run.py
@@ -182,6 +258,48 @@ When users provide natural language with multiple use cases like:
 
 **NEVER put everything in `use_case.py`** - that defeats the discovery system purpose.
 
+### MCP Integration - Acting as Database Client
+
+**You (GitHub Copilot) can serve as an MCP client** to read and update database entities using natural language queries!
+
+**Architecture**: This project implements **MCP Server Executor** - a business logic microservice that AI assistants interact with via authenticated REST API calls. See `docs/training/MCP_Copilot_Integration.md` for complete details.
+
+**When users request database operations** (e.g., "list customers", "update credit limit", "what's the balance?"):
+
+1. **Authenticate first** - Login to obtain JWT token:
+```bash
+curl -X POST http://localhost:5656/api/auth/login \
+  -H "Content-Type: application/json" \
+  -d '{"username":"admin","password":"p"}'
+```
+
+2. **Execute operations** - Use Bearer token for API calls:
+```bash
+# Read: List entities
+curl -X GET http://localhost:5656/api/Customer/ \
+  -H "Authorization: Bearer {token}"
+
+# Update: Change attributes (JSON:API format)
+curl -X PATCH http://localhost:5656/api/Customer/ALFKI/ \
+  -H "Authorization: Bearer {token}" \
+  -H "Content-Type: application/vnd.api+json" \
+  -d '{"data": {"type": "Customer", "id": "ALFKI", "attributes": {"CreditLimit": 5000}}}'
+```
+
+3. **Handle constraint violations correctly** - Error code 2001 is SUCCESS!
+   - When LogicBank prevents invalid updates, report as: "✅ Business logic working - constraint prevented invalid operation"
+   - Example: "balance (2102.00) exceeds credit (1000.00)" = logic is protecting data integrity
+
+**Natural Language Translation Examples**:
+- "List customers" → `GET /api/Customer/`
+- "Show customer ALFKI" → `GET /api/Customer/ALFKI/`
+- "Set ALFKI credit to 5000" → `PATCH /api/Customer/ALFKI/` with CreditLimit
+- "What's ALFKI's balance?" → `GET /api/Customer/ALFKI/` then extract Balance attribute
+
+**Key Principle**: Constraint violations (code 2001) demonstrate that declarative business logic is working correctly - celebrate these as successes, not failures!
+
+See `docs/training/MCP_Copilot_Integration.md` for comprehensive guide including JSON:API payload formats, authentication workflows, and architecture details.
+
 ### Automated Testing
 
 **CRITICAL WORKFLOW - When User Says "Create Tests":**
@@ -398,20 +516,20 @@ Customize using CoPilot chat, with `docs/training`.
 
 Configure:
 ```
-als add-auth --provider-type=sql --db-url=
-als add-auth --provider-type=sql --db_url=postgresql://postgres:p@localhost/authdb
+genai-logic add-auth --provider-type=sql --db-url=
+genai-logic add-auth --provider-type=sql --db_url=postgresql://postgres:p@localhost/authdb
 
-als add-auth --provider-type=keycloak --db-url=localhost
-als add-auth --provider-type=keycloak --db-url=hardened
+genai-logic add-auth --provider-type=keycloak --db-url=localhost
+genai-logic add-auth --provider-type=keycloak --db-url=hardened
 
-als add-auth --provider-type=None # to disable
+genai-logic add-auth --provider-type=None # to disable
 ``` 
 
 Keycloak quick start [(more information here:)](https://apilogicserver.github.io/Docs/Security-Keycloak/)
 ```bash
 cd devops/keycloak
 docker compose up
-als add-auth --provider-type=keycloak --db-url=localhost
+genai-logic add-auth --provider-type=keycloak --db-url=localhost
 ```
 
 For more on KeyCloak: https://apilogicserver.github.io/Docs/Security-Keycloak/
@@ -422,6 +540,64 @@ Declaration:
 Grant(on_entity=Customer, to_role=sales, filter=lambda: Customer.SalesRep == current_user())
 ```
 
+
+#### Testing with Security Enabled
+
+**CRITICAL:** When `SECURITY_ENABLED=True`, test code must obtain and include JWT authentication tokens.
+
+**Pattern for test steps:**
+```python
+from pathlib import Path
+import os
+from dotenv import load_dotenv
+
+# Load config to check SECURITY_ENABLED
+config_path = Path(__file__).parent.parent.parent.parent.parent / 'config' / 'default.env'
+load_dotenv(config_path)
+
+# Cache for auth token (obtained once per test session)
+_auth_token = None
+
+def get_auth_token():
+    """Login and get JWT token if security is enabled"""
+    global _auth_token
+    
+    if _auth_token is not None:
+        return _auth_token
+    
+    # Login with default admin credentials
+    login_url = f'{BASE_URL}/api/auth/login'
+    login_data = {'username': 'admin', 'password': 'p'}
+    
+    response = requests.post(login_url, json=login_data)
+    if response.status_code == 200:
+        _auth_token = response.json().get('access_token')
+        return _auth_token
+    else:
+        raise Exception(f"Login failed: {response.status_code}")
+
+def get_headers():
+    """Get headers including auth token if security is enabled"""
+    security_enabled = os.getenv('SECURITY_ENABLED', 'false').lower() not in ['false', 'no']
+    
+    headers = {'Content-Type': 'application/json'}
+    
+    if security_enabled:
+        token = get_auth_token()
+        if token:
+            headers['Authorization'] = f'Bearer {token}'
+    
+    return headers
+
+# Use in all API requests
+response = requests.post(url=api_url, json=data, headers=get_headers())
+```
+
+**Key points:**
+- Tests DO NOT automatically include auth headers - you must code this pattern
+- Token is cached to avoid repeated logins during test session
+- Pattern works for both `SECURITY_ENABLED=True` and `SECURITY_ENABLED=False`
+- See `test/api_logic_server_behave/features/steps/order_processing_steps.py` for complete example
 ### Adding Custom API Endpoints
 
 For simple endpoints:

api_logic_server_cli/prototypes/basic_demo/.github/welcome.md

@@ -0,0 +1,26 @@
+---
+use: welcome for basic_demo - please start the tour
+instuctions: copy api_logic_server_cli/prototypes/base/.github/.copilot-instructions.md, then paste as the Welcome section 
+---
+
+## Welcome
+
+**Welcome! This is your basic_demo project.**
+
+This is a complete, working microservice auto-generated from a database schema - **uncustomized**, so you can see what to expect when you create projects from your own databases.
+
+**What's already created from introspecting the database schema:**
+- **Admin Web Application** - Live at `http://localhost:5656`
+- **REST API Endpoints** - All database tables exposed at `/api/*`
+- **Database Models** - Complete SQLAlchemy ORM in `database/models.py`
+- **Authentication System** - JWT-based auth framework
+- **Business Logic Engine** - Declarative rules system
+
+---
+
+**First, we'll briefly explore what's automatically created. Then I'll show you how I can help you customize it - adding logic, security, and API endpoints.**
+
+
+**Ready to explore?** Open `tutor.md` and tell me "guide me through" to begin the interactive tutorial.
+
+---

api_logic_server_cli/prototypes/basic_demo/customizations/logic/declare_logic.py

@@ -47,7 +47,12 @@ def declare_logic():
 
             Use case: App Integration
                 1. Send the Order to Kafka topic 'order_shipping' if the date_shipped is not None.
+    
     Also, using logic/logic_discovery is a Best Practice - see logic/readme_logic.md
+
+    The 5 *declarative* lines below represent the same logic as 200 lines of *declarative* Python
+        1. To view the AI procedural/declarative comparison, [click here](https://github.com/ApiLogicServer/ApiLogicServer-src/blob/main/api_logic_server_cli/prototypes/basic_demo/logic/procedural/declarative-vs-procedural-comparison.md)
+        2. Consider a 100 table system: 1,000 rules vs. 40,000 lines of code
     '''
     from database.models import Product, Order, Item, Customer, SysEmail
 

api_logic_server_cli/prototypes/basic_demo/docs/system-creation-vibe.md

@@ -29,7 +29,7 @@ This is a record of how we created the system using CoPilot Chat (*Vibe*).
 ## Initialize CoPilot
 
 ```
-Please find and read `.github/.copilot-instructions.md`.
+Please load `.github/.copilot-instructions.md`.
 ```
 
 <br>
@@ -48,7 +48,7 @@ Create a database project from samples/dbs/basic_demo.sqlite
 The project should automatically open a new window in VSCode.  Again, open CoPilot and bootstrap it with: <br>
 
 ```bash title="Initialize CoPilot"
-Please find and read `.github/.copilot-instructions.md`**.
+Please load `.github/.copilot-instructions.md`**.
 ```
 
 Verify it as follows:

api_logic_server_cli/prototypes/basic_demo/readme.md

@@ -26,7 +26,7 @@ This illustrates basic [GenAI-Logic](https://www.genai-logic.com/product/key-fea
 
 **Bootstrap Copilot:**
 ```bash title='🤖 Bootstrap Copilot by pasting the following into the chat'
-Please find and read `.github/.copilot-instructions.md`.
+Please load `.github/.copilot-instructions.md`.
 ```
 
 <br>

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

@@ -4,8 +4,11 @@ Description: Manager-level instructions for creating projects
 Source: ApiLogicServer-src/prototypes/manager/.github/.copilot-instructions.md
 Propagation: BLT process → Manager workspace
 Usage: AI assistants read this when user opens Manager workspace
-version: 2.1
+User Activation: Say "What can I do here?" or "Help me get started"
+version: 2.3
 changelog:
+  - 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
   - 2.0 (Oct 2025) - OBX improvements, strengthen basic_demo as default path
   - 1.0 (Initial) - Established project creation methods
@@ -13,11 +16,102 @@ changelog:
 
 # GitHub Copilot Instructions for GenAI-Logic (aka API Logic Server) - Project Manager
 
-⚠️ **IMPORTANT FOR AI ASSISTANTS**: Always read and follow these instructions when helping with this project.
+---
+
+## 👤 FOR USERS: How to Get Started
+
+**When you open this workspace, say:**
+- "What can I do here?"
+- "Help me get started"
+- "What is this workspace?"
+
+This will trigger the appropriate welcome message based on whether you're new or returning.
+
+---
+
+## ⚠️ 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.
+
+---
+
+**Let's start with the 20-minute basic_demo tutorial - it's the best way to see what GenAI-Logic can do.**
 
-## What is the Project Manager?
+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.
+
+---
+
+## Returning User Welcome (basic_demo folder exists)
 
-Welcome! This is the **Project Manager** - think of it as your workspace for creating and managing API Logic Server projects.
+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/`)
@@ -25,14 +119,53 @@ Welcome! This is the **Project Manager** - think of it as your workspace for cre
 - A shared virtual environment for all your projects (`venv/`)
 - A place to create new projects (they'll appear as subdirectories)
 
-**What you'll do here:**
-Create projects from databases - each project becomes a complete, working microservice with API, Admin UI, and business logic support. Once created, you'll work inside that project to customize and extend it.
+> 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.
+
+---
+
+**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?**
+
+---
+
+## 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.
 
-## Quick Start
+---
+
+## Getting Started
 
-**First time here?** Let's start with the 20-minute basic_demo tutorial - it's the best way to see what GenAI-Logic can do.
+**🎯 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:
 
@@ -42,7 +175,29 @@ 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.
 
-**Already have basic_demo?** Open it and say "Guide me through basic_demo" for the hands-on tour, or ask me what else we can work on.
+---
+
+### 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>
 

api_logic_server_cli/prototypes/manager/README.md

@@ -21,7 +21,7 @@ Instructions: Copy in Sample-Basic-Demo (Replace "This illustrates" up to "Explo
 
 **Bootstrap Copilot by pasting the following into the chat:**
 ```
-Please find and read `.github/.copilot-instructions.md`.
+Please load `.github/.copilot-instructions.md`.
 ```
 
 <br>

api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/docs/system-creation-vibe.md

@@ -29,7 +29,7 @@ This is a record of how we created the system using CoPilot Chat (*Vibe*).
 ## Initialize CoPilot
 
 ```
-Please find and read `.github/.copilot-instructions.md`.
+Please load `.github/.copilot-instructions.md`.
 ```
 
 <br>
@@ -48,7 +48,7 @@ Create a database project from samples/dbs/basic_demo.sqlite
 The project should automatically open a new window in VSCode.  Again, open CoPilot and bootstrap it with: <br>
 
 ```bash title="Initialize CoPilot"
-Please find and read `.github/.copilot-instructions.md`**.
+Please load `.github/.copilot-instructions.md`**.
 ```
 
 Verify it as follows:

api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/logic/logic_discovery/check_credit.py

@@ -11,7 +11,10 @@ app_logger = logging.getLogger(__name__)
 
 def declare_logic():
     """
-    Check Credit Use Case Logic
+
+    The 5 *declarative* lines below represent the same logic as 200 lines of *declarative* Python
+        1. To view the AI procedural/declarative comparison, [click here](https://github.com/ApiLogicServer/ApiLogicServer-src/blob/main/api_logic_server_cli/prototypes/basic_demo/logic/procedural/declarative-vs-procedural-comparison.md)
+        2. Consider a 100 table system: 1,000 rules vs. 40,000 lines of code
     
     Natural Language Requirements:
     1. The Customer's balance is less than the credit limit

api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/readme.md

@@ -21,7 +21,7 @@ This illustrates basic [GenAI-Logic](https://www.genai-logic.com/product/key-fea
 
 **🤖 Bootstrap Copilot by pasting the following into the chat:**
 ```bash title='🤖 Bootstrap Copilot by pasting the following into the chat'
-Please find and read `.github/.copilot-instructions.md`.
+Please load `.github/.copilot-instructions.md`.
 ```
 
 <br>

api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/readme_standard.md

@@ -20,7 +20,7 @@ This illustrates basic [GenAI-Logic](https://www.genai-logic.com/product/key-fea
 
 > 🤖 **Bootstrap Copilot by pasting the following into the chat:**
 ```
-Please find and read `.github/.copilot-instructions.md`.
+Please load `.github/.copilot-instructions.md`.
 ```
 
 <br>

api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/readme_vibe.md

@@ -19,7 +19,7 @@ This illustrates [GenAI-Logic](https://apilogicserver.github.io/Docs/Sample-Basi
 
 **🤖 Bootstrap Copilot by pasting the following into the chat:**
 ``` bash title='🤖 Bootstrap Copilot by pasting the following into the chat'
-Please find and read `.github/.copilot-instructions.md`.
+Please load `.github/.copilot-instructions.md`.
 ```
 
 <br>
@@ -102,7 +102,7 @@ The project should automatically open a new window in VSCode. <br>
 
 **🤖 Again, bootstrap Copilot by pasting the following into the chat:**
 ``` bash title='🤖 Again, bootstrap Copilot by pasting the following into the chat'
-Please find and read `.github/.copilot-instructions.md`.
+Please load `.github/.copilot-instructions.md`.
 ```
 
 Run it as follows:

{apilogicserver-15.3.0.dist-info → apilogicserver-15.3.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ApiLogicServer
-Version: 15.3.0
+Version: 15.3.6
 Author-email: Val Huber <apilogicserver@gmail.com>
 License-Expression: BSD-3-Clause
 Project-URL: Homepage, https://www.genai-logic.com