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

api_logic_server_cli/api_logic_server.py

@@ -12,10 +12,10 @@ ApiLogicServer CLI: given a database url, create [and run] customizable ApiLogic
 Called from api_logic_server_cli.py, by instantiating the ProjectRun object.
 '''
 
-__version__ = "15.03.02"  # last public release: 15.03.00
+__version__ = "15.03.06"  # last public release: 15.03.02
 recent_changes = \
     f'\n\nRecent Changes:\n' +\
-    "\t11/04/2025 - 15.03.02: Fix Manager/Copilot startup \n"\
+    "\t11/06/2025 - 15.03.06: Nat lang Copilot data access, fix Manager/Copilot startup, finding venv in project \n"\
     "\t10/29/2025 - 15.03.00: Stable Tutor 3.3 (working, vibe transtion) \n"\
     "\t10/26/2025 - 15.02.07: Clarify order created for ship test, security fixes [105], tutor 2.1 \n"\
     "\t10/22/2025 - 15.02.03: Copilot test creation from rules and custom APIs with issues [103, 104] \n"\

api_logic_server_cli/create_from_model/api_logic_server_utils.py

@@ -84,7 +84,7 @@ def copy_md(project, from_doc_file: str, to_project_file: str = "README.md"):
     
     1. github (to acquire more recent version since release)
     
-    2. dev docs, iff exists (gold version in docs, not prototypes).
+    2. dev docs, iff exists (**gold version in docs, not prototypes**).
 
     Used by Sample-AI; Sample-Integration (nw-), Tutorial, Tutorial-3 (3 projects), Sample-Basic-Demo; Manager
 
@@ -98,6 +98,8 @@ def copy_md(project, from_doc_file: str, to_project_file: str = "README.md"):
 
     Doc Links are made absolute.
 
+    See: https://apilogicserver.github.io/Docs/Architecture-Internals/#docs-used-in-project-creation
+
     Args:
         project (ProjectRun or Path): project object (project name, etc)
         from_doc_file (str): eg, Sample-Basic_Demo.md (no docs/)

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

@@ -3,9 +3,11 @@ 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.3
+version: 2.4
 changelog:
+  - 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
@@ -15,7 +17,8 @@ changelog:
 
 # GitHub Copilot Instructions for GenAI-Logic (aka API Logic Server) Projects
 
-**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.
+
+**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
 
@@ -40,7 +43,7 @@ This is a complete, working microservice auto-generated from your database schem
 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
+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
@@ -109,6 +112,17 @@ Want to get started? Press **F5** to start the server with debugger support, the
 ## 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
 # Then open: http://localhost:5656
 ```
@@ -236,6 +250,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":**

api_logic_server_cli/prototypes/base/docs/training/MCP_Copilot_Integration.md

@@ -0,0 +1,295 @@
+# MCP Integration Guide for Copilot
+
+## Overview
+
+This GenAI-Logic project implements **MCP Server Executor** architecture - providing business logic services that AI assistants (like GitHub Copilot) can invoke to read and update database entities using natural language.
+
+**Key Distinction**: GenAI-Logic is NOT a standard "MCP Protocol Server" (JSON-RPC over stdio). Instead, it's a **business logic microservice** that AI assistants interact with via authenticated REST API calls. This architecture is more scalable and enterprise-ready than stdio-based MCP servers.
+
+## Architecture
+
+```
+┌─────────────────────────────────┐
+│  GitHub Copilot / Claude        │  Natural language interface
+│  (MCP Client / AI Assistant)    │
+└────────────┬────────────────────┘
+             │ HTTP REST API (JSON:API format)
+             │ JWT Authentication
+┌────────────▼────────────────────┐
+│  GenAI-Logic Server             │  MCP Server Executor
+│  (Flask + LogicBank)            │  - Business logic enforcement
+│                                 │  - Constraint validation
+│  Endpoints:                     │  - Declarative rules (44X reduction)
+│  - /api/auth/login              │  - Schema metadata
+│  - /api/{Entity}                │
+│  - /.well-known/mcp.json        │
+│  - /mcp                         │
+└────────────┬────────────────────┘
+             │
+┌────────────▼────────────────────┐
+│  Database (SQLAlchemy ORM)      │
+└─────────────────────────────────┘
+```
+
+## How Copilot Acts as MCP Client
+
+GitHub Copilot can serve as an interactive MCP client by:
+
+1. **Authenticating** - Login to obtain JWT token
+2. **Translating** - Convert natural language to API operations
+3. **Executing** - Make authenticated HTTP calls
+4. **Reporting** - Present results or explain constraint violations
+
+## Copilot Usage Pattern
+
+### Step 1: Authentication
+
+When user requests database operations, Copilot should first authenticate:
+
+```bash
+curl -X POST http://localhost:5656/api/auth/login \
+  -H "Content-Type: application/json" \
+  -d '{"username":"admin","password":"p"}'
+```
+
+Response contains JWT token:
+```json
+{
+  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGc...",
+  "token_type": "Bearer"
+}
+```
+
+### Step 2: Execute Operations
+
+Use token for authenticated requests:
+
+#### Read Operations (GET)
+```bash
+# List customers
+curl -X GET http://localhost:5656/api/Customer/ \
+  -H "Authorization: Bearer {token}"
+
+# Get specific customer
+curl -X GET http://localhost:5656/api/Customer/ALFKI/ \
+  -H "Authorization: Bearer {token}"
+```
+
+#### Update Operations (PATCH)
+```bash
+# Update customer credit limit
+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
+      }
+    }
+  }'
+```
+
+#### Create Operations (POST)
+```bash
+# Create new customer
+curl -X POST http://localhost:5656/api/Customer/ \
+  -H "Authorization: Bearer {token}" \
+  -H "Content-Type: application/vnd.api+json" \
+  -d '{
+    "data": {
+      "type": "Customer",
+      "attributes": {
+        "Id": "NEWCO",
+        "CompanyName": "New Company Inc",
+        "ContactName": "John Doe",
+        "CreditLimit": 1000
+      }
+    }
+  }'
+```
+
+### Step 3: Handle Constraint Violations
+
+**CRITICAL**: Constraint violations are SUCCESS demonstrations of business logic!
+
+When an update violates business rules, the server returns error code 2001:
+
+```json
+{
+  "error": {
+    "code": 2001,
+    "message": "balance (2102.00) exceeds credit (1000.00)"
+  }
+}
+```
+
+**Copilot should report this as**: "✅ Business logic working correctly - constraint prevented invalid update: balance exceeds credit limit"
+
+Common constraint codes:
+- **2001** - Business rule violation (the valuable demonstration!)
+- **401** - Unauthorized (need to authenticate)
+- **404** - Entity not found
+- **422** - Validation error
+
+## Natural Language → API Translation Examples
+
+| User Request | Copilot Action | API Call |
+|--------------|----------------|----------|
+| "List all customers" | GET collection | `GET /api/Customer/` |
+| "Show customer ALFKI" | GET single entity | `GET /api/Customer/ALFKI/` |
+| "Update ALFKI credit to 5000" | PATCH entity | `PATCH /api/Customer/ALFKI/` with CreditLimit |
+| "What's ALFKI's balance?" | GET entity, extract attribute | `GET /api/Customer/ALFKI/` → read Balance |
+| "Increase ALFKI credit by 1000" | GET then PATCH | GET current → calculate → PATCH new value |
+| "Create customer NEWCO" | POST entity | `POST /api/Customer/` with attributes |
+
+## MCP Discovery Endpoints
+
+The server exposes schema metadata for AI assistants:
+
+### Well-Known Endpoint
+```bash
+curl http://localhost:5656/.well-known/mcp.json
+```
+
+Returns full schema including:
+- Available entities (tables)
+- Attributes and types
+- Relationships
+- Business rules documentation
+
+### MCP Endpoint
+```bash
+curl http://localhost:5656/mcp
+```
+
+Same schema as well-known endpoint, alternate path for compatibility.
+
+## Key Implementation Files
+
+- **`api/api_discovery/mcp_discovery.py`** - MCP discovery endpoints
+- **`integration/mcp/mcp_client_executor.py`** - Example MCP client script
+- **`docs/mcp_learning/mcp_schema.json`** - Schema metadata
+- **`logic/declare_logic.py`** - Declarative business rules (LogicBank)
+- **`config/default.env`** - Server configuration (SECURITY_ENABLED)
+
+## Testing Workflow for Copilot
+
+When user says: "Can you query the database for me?"
+
+1. **Acknowledge**: "I'll act as MCP client and query the server"
+2. **Authenticate**: Login via `/api/auth/login` to get JWT token
+3. **Execute**: Make appropriate GET/PATCH/POST call with Bearer token
+4. **Present**: Format results or explain constraint violations as logic success
+5. **Iterate**: Accept follow-up natural language requests
+
+Example interaction:
+```
+User: "List customers with balance over 1000"
+Copilot: 
+  1. Login to get token
+  2. GET /api/Customer/?filter[Balance]=>1000
+  3. Present: "Found 3 customers: ALFKI (2102.00), ANATR (1500.50), ..."
+
+User: "Try to set ALFKI credit to 500"
+Copilot:
+  1. PATCH /api/Customer/ALFKI/ with CreditLimit=500
+  2. Receive error 2001: "balance (2102.00) exceeds credit (500.00)"
+  3. Present: "✅ Business logic prevented this - ALFKI's balance of 2102.00 
+     exceeds the proposed credit limit of 500.00. The system is correctly 
+     enforcing the constraint that credit must be >= balance."
+```
+
+## Business Logic Layer (LogicBank)
+
+The real power is in declarative business rules that auto-execute on all API operations:
+
+```python
+# From logic/declare_logic.py
+
+# Constraint: Customer balance cannot exceed credit limit
+Rule.constraint(validate=models.Customer,
+    as_condition=lambda row: row.Balance <= row.CreditLimit,
+    error_msg="balance ({row.Balance}) exceeds credit ({row.CreditLimit})")
+
+# Sum rule: Customer balance = sum of unpaid order amounts
+Rule.sum(derive=models.Customer.Balance, 
+    as_sum_of=models.Order.AmountTotal,
+    where=lambda row: row.ShippedDate is None)
+
+# Formula: Order amount = sum of items
+Rule.sum(derive=models.Order.AmountTotal,
+    as_sum_of=models.OrderDetail.Amount)
+```
+
+These rules:
+- Execute automatically on INSERT/UPDATE/DELETE
+- Provide **44X code reduction** vs. traditional procedural code
+- Enforce multi-table constraints
+- Chain automatically (Order → Customer balance)
+
+## Why This Architecture?
+
+**GenAI-Logic's HTTP-based approach** vs **stdio-based MCP servers**:
+
+| Aspect | GenAI-Logic (HTTP) | Stdio MCP |
+|--------|-------------------|-----------|
+| Transport | HTTP REST API | JSON-RPC over stdin/stdout |
+| Authentication | JWT Bearer tokens | Process isolation |
+| Scalability | Horizontal scaling | One process per client |
+| Network | Works across machines | Same machine only |
+| Protocol | JSON:API standard | Custom JSON-RPC |
+| Enterprise Ready | ✅ Yes | ⚠️ Limited |
+
+For Microsoft demo: Position GenAI-Logic as the **business logic layer** that any MCP client can invoke, rather than trying to fit into stdio-based protocol constraints.
+
+## Optional: JSON-RPC Wrapper
+
+If standard MCP protocol compatibility is desired, you could add a thin JSON-RPC wrapper:
+
+```python
+# Optional enhancement - not required for Copilot usage
+@app.route('/mcp/jsonrpc', methods=['POST'])
+def mcp_jsonrpc():
+    """Translate JSON-RPC 2.0 to internal API calls"""
+    request_data = request.json
+    method = request_data.get('method')
+    params = request_data.get('params', {})
+    
+    if method == 'customers/list':
+        # Translate to GET /api/Customer/
+        response = internal_api_call('GET', '/api/Customer/', params)
+        return jsonify({'jsonrpc': '2.0', 'result': response, 'id': request_data['id']})
+    # ... more method translations
+```
+
+**Effort estimate**: Half-day for experienced developer. But this is optional - Copilot can work directly with REST API.
+
+## Demo Strategy
+
+For Microsoft presentation:
+
+1. **Position correctly**: "GenAI-Logic implements MCP Server Executor - the valuable business logic layer"
+2. **Show constraint violations**: "Error 2001 is the success - logic is working!"
+3. **Demonstrate declarative rules**: "44X code reduction with automatic multi-table chaining"
+4. **Use Copilot as client**: "AI assistant translates natural language to authenticated API calls"
+5. **Highlight enterprise architecture**: "HTTP-based, JWT auth, horizontally scalable"
+
+The MCP discovery endpoints (`/.well-known/mcp.json` and `/mcp`) allow AI assistants to understand the schema and available operations, but the real innovation is the declarative business logic layer that enforces rules automatically.
+
+## Quick Reference for Copilot
+
+**Authentication**:
+```bash
+curl -X POST http://localhost:5656/api/auth/login -d '{"username":"admin","password":"p"}'
+```
+
+**Common operations**:
+- List: `GET /api/{Entity}/` with Bearer token
+- Read: `GET /api/{Entity}/{id}/` with Bearer token  
+- Update: `PATCH /api/{Entity}/{id}/` with JSON:API payload and Bearer token
+- Create: `POST /api/{Entity}/` with JSON:API payload and Bearer token
+
+**Remember**: Constraint violations (code 2001) = business logic success! Report them positively.

api_logic_server_cli/prototypes/base/logic/readme_logic.md

@@ -1,12 +1,12 @@
 This describes how to use Logic; for more information, [see here](https://apilogicserver.github.io/Docs/Logic-Why).
 
-> What is Logic: Multi-table Derivation and Constraint Rules, Extensible with Python 
-<br>Rules are:
-<br>1. **Declared** in your IDE - 40X more concise
-<br>2. **Activated** on server start
-<br>3. **Executed** - *automatically* -  on updates (using SQLAlchemy events)
-<br>4. **Debugged** in your IDE, and with the console log
-<br>For more on rules, [click here](https://apilogicserver.github.io/Docs/Logic-Why/).
+> What is Logic: Multi-table Derivation and Constraint Rules, Extensible with Python
+> <br>Rules are:
+> <br>1. **Declared** in your IDE - 40X more concise
+> <br>2. **Activated** on server start
+> <br>3. **Executed** - *automatically* -  on updates (using SQLAlchemy events)
+> <br>4. **Debugged** in your IDE, and with the console log
+> <br>For more on rules, [click here](https://apilogicserver.github.io/Docs/Logic-Why/).
 
 &nbsp;
 
@@ -27,11 +27,13 @@ Use case: App Integration
 ```
 
 Basic process:
+
 1. Create a file such as `logic/logic_discovery/check_credit.py` (e.g., copy from `use_case.py`).
-2. Paste the prompt above into CoPilot - use `docs/training` to generate logic
+2. Paste the prompt above into CoPilot - it uses `docs/training` to generate logic
 3. Paste the generated logic into `logic/logic_discovery/check_credit.py`
 
 From the Natural Language, Copilot will create Python rules (you can also create these directly using code completion):
+
 ```python
     if os.environ.get("WG_PROJECT"):
         # Inside WG: Load rules from docs/expprt/export.json
@@ -67,7 +69,7 @@ From the Natural Language, Copilot will create Python rules (you can also create
 
 ## Natural Language vs. IDE
 
-If you are using WebGenAI, you can specify rules in Natural Language. You can also augment them in the IDE using code completion.  There are some important usage guidelines.  
+If you are using WebGenAI, you can specify rules in Natural Language. You can also augment them in the IDE using code completion.  There are some important usage guidelines.
 
 > You should generally not alter any files in the `wg_rules` directory.  For more information, see [WebGenAI](https://apilogicserver.github.io/Docs/WebGenAI/), and [WebGenAI Logic](https://apilogicserver.github.io/Docs/WebGenAI-CLI.md#natural-language-logic).
 
@@ -79,7 +81,7 @@ You can declare logic in `declare_logic.py`,
 but that can lead to a lot of rules in 1 file.
 
 A *best practice* is to create logic files in `logic/logic_discovery`,
-named after the use case (e.g., `check_credit.py`).  
+named after the use case (e.g., `check_credit.py`).
 
 The easiest way to to copy/paste `use_case.py` to a new file, then
 add your logic either by Natural Language (use your Coding Assistant, such as CoPilot),
@@ -87,8 +89,10 @@ or your IDE's code completion.
 
 <br>
 
-## Examples      
+## Examples
+
 Examples from tutorial project:
+
 * Examples drawn from [tutorial project](https://github.com/ApiLogicServer/demo/blob/main/logic/declare_logic.py)
 * Use Shift + "." to view in project mode
 
@@ -105,11 +109,13 @@ This declares the Customer.Balance as the sum of the unshipped Order.AmountTotal
             as_sum_of=models.Order.AmountTotal,
             where=lambda row: row.ShippedDate is None)
 ```
+
 It means the rule engine **watches** for these changes:
+
 * Order inserted/deleted, or
 * AmountTotal or ShippedDate or CustomerID changes
 
-Iff changes are detected, the engine **reacts** by *adjusting* the Customer.Balance.  SQLs are [optimized](#declarative-logic-important-notes).
+Iff changes are detected, the engine **reacts** by *adjusting* the Customer.Balance.  SQLs are [optimized - see Important Notes, below](#declarative-logic-important-notes).
 
 This would **chain** to check the Customers' Constraint rule, described below.
 
@@ -120,6 +126,7 @@ This would **chain** to check the Customers' Constraint rule, described below.
 Constraints are multi-field conditions which must be true for transactions to succeed (else an exception is raised).  You can express the condition as a lambda or a function:
 
 **As a lambda:**
+
 ```python
     Rule.constraint(validate=models.Customer,
         as_condition=lambda row: row.Balance <= row.CreditLimit,  # parent references are supported
@@ -127,6 +134,7 @@ Constraints are multi-field conditions which must be true for transactions to su
 ```
 
 **Or, as a function:**
+
 ```python
     def check_balance(row: models.Customer, old_row: models.Customer, logic_row: LogicRow):
         if logic_row.ins_upd_dlt != "dlt":  # see also: logic_row.old_row
@@ -144,12 +152,14 @@ Constraints are multi-field conditions which must be true for transactions to su
 ### 3. Row Events: Extensible with Python
 
 Events are procedural Python code, providing extensibility for declarative rules:
+
 ```python
     def congratulate_sales_rep(row: models.Order, old_row: models.Order, logic_row: LogicRow):
         pass  # event code here - sending email, messages, etc.
 
     Rule.commit_row_event(on_class=models.Order, calling=congratulate_sales_rep)
 ```
+
 Note there are multiple kinds of events, so you can control whether they run before or after rule execution.  For more information, [see here](https://apilogicserver.github.io/Docs/Logic-Type-Constraint).
 
 &nbsp;
@@ -159,9 +169,7 @@ Note there are multiple kinds of events, so you can control whether they run bef
 A key argument to functions is `logic_row`:
 
 * **Wraps row and old_row,** plus methods for insert, update and delete - rule enforcement
-
 * **Additional instance variables:** ins_upd_dlt, nest_level, session, etc.
-
 * **Helper Methods:** are_attributes_changed, set_same_named_attributes, get_parent_logic_row(role_name), get_derived_attributes, log, is_inserted, etc
 
 Here is an example:
@@ -194,13 +202,11 @@ logic_row.log("no manager for this order's salesrep")
 Logic *declarative*, which differs from conventional *procedural* logic:
 
 1. **Automatic Invocation:** you don't call the rules; they execute in response to updates (via SQLAlchemy events).
-
 2. **Automatic Ordering:** you don't order the rules; execution order is based on system-discovered depencencies.
-
 3. **Automatic Optimizations:** logic is optimized to reduce SQLs.
 
-    * Rule execution is *pruned* if dependent attributes are not altered
-    * SQL is optimized, e.g., `sum` rules operate by *adjustment*, not expensive SQL `select sum`
+   * Rule execution is *pruned* if dependent attributes are not altered
+   * SQL is optimized, e.g., `sum` rules operate by *adjustment*, not expensive SQL `select sum`
 
 These simplify maintenance / iteration: you can be sure new logic is always called, in the correct order.
 
@@ -226,14 +232,15 @@ Logging is performed using standard Python logging, with a logger named `logic_l
 
 In addition, the system logs all rules that fire, to aid in debugging.  Referring the the screen shot above:
 
-*   Each line represents a rule execution, showing row state (old/new values), and the _{reason}_ that caused the update (e.g., client, sum adjustment)
-*   Log indention shows multi-table chaining
+* Each line represents a rule execution, showing row state (old/new values), and the _{reason}_ that caused the update (e.g., client, sum adjustment)
+* Log indention shows multi-table chaining
 
 &nbsp;
 
 ## How Logic works
 
 *Activation* occurs in `api_logic_server_run.py`:
+
 ```python
     LogicBank.activate(session=session, activator=declare_logic, constraint_event=constraint_handler)
 ```
@@ -242,8 +249,14 @@ This installs the rule engine as a SQLAlchemy event listener (`before_flush`).
 
 Rules plug into SQLAlchemy events, and execute as follows:
 
-| Logic Phase | Why It Matters |
-|:-----------------------------|:---------------------|
-| **Watch** for changes at the attribute level | Performance - Automatic Attribute-level Pruning |
-| **React** by recomputing value | Ensures Reuse - Invocation is automatic<br>Derivations are optimized (e.g. *adjustment updates* - not aggregate queries) |
-| **Chain** to other referencing data | Simplifies Maintenance - ordering is automatic<br>Multi-table logic automation |
+
+| Logic Phase                                  | Why It Matters                                                                                                           |
+| :--------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------- |
+| **Watch** for changes at the attribute level | Performance - Automatic Attribute-level Pruning                                                                          |
+| **React** by recomputing value               | Ensures Reuse - Invocation is automatic<br>Derivations are optimized (e.g. *adjustment updates* - not aggregate queries) |
+| **Chain** to other referencing data          | Simplifies Maintenance - ordering is automatic<br>Multi-table logic automation                                           |
+
+This pattern is sometimes called Reactive Dependency Propagation.  Automatic dependency management accounts is why 5 *declarative* lines represent the same logic as 200 lines of *declarative* Python
+
+1. To view a 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. Rules typically automate over 95% of your logic, so the results can be significant.  Consider a 100 table system: 1,000 rules vs. 40,000 lines of code

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/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

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

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

{apilogicserver-15.3.2.dist-info → apilogicserver-15.3.6.dist-info}/RECORD

@@ -1,5 +1,5 @@
 api_logic_server_cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-api_logic_server_cli/api_logic_server.py,sha256=NcViYeSCIiDw_Gb91Epg-N0K0u6MmOg7YCW0RKTQhkw,104746
+api_logic_server_cli/api_logic_server.py,sha256=0FeGwB6aLxRnAdORSAsTy-k0qoiMVxEcD7CWALUP688,104801
 api_logic_server_cli/api_logic_server_info.yaml,sha256=xwH5ENyjrlv3XbKx7IaY2iaF0Cc4zHi3x7qtpEWTzBI,139
 api_logic_server_cli/cli.py,sha256=xAqTOhq-OnXU2HEQgzsGC9yKrGcAgKUt_8b9U2bV5No,87831
 api_logic_server_cli/cli_args_base.py,sha256=7cVM6BeizwttYAwUu1FUyuLuvWufvgt0TFeA8FI6tu0,3304
@@ -10,7 +10,7 @@ api_logic_server_cli/manager.py,sha256=So_Oa2FIP9h6PBUk1jqIOZveqtf7aOCZUORIZI4zw
 api_logic_server_cli/add_cust/add_cust.py,sha256=yi_6qoiBm19K1u5VNhDW-KaTVcnsU-uTQ8-GYioojMI,14034
 api_logic_server_cli/create_from_model/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 api_logic_server_cli/create_from_model/api_expose_api_models_creator.py,sha256=V-u3Hm404doztw66YuD2A043RCFmtw5QF5tMioC_1b0,7900
-api_logic_server_cli/create_from_model/api_logic_server_utils.py,sha256=H0t_hpN6TGzhe9CAzkonX3dUvZ2k9qeemKHexoXtIQI,28624
+api_logic_server_cli/create_from_model/api_logic_server_utils.py,sha256=Aj211XUd-Ns81lJqU53owvIEfKVSJA0ssGmlWb1owo4,28730
 api_logic_server_cli/create_from_model/create_db_from_model.py,sha256=2H7slGnk39XOSnvL7vxrg6Ewx4bxeBJBgLo8fcXHTB4,4382
 api_logic_server_cli/create_from_model/dbml.py,sha256=SdSD1D8ZIjtHdqr559SUiZ05rwQjeppKS550q-hSydo,11573
 api_logic_server_cli/create_from_model/meta_model.py,sha256=bzkpaC0ePrxpAPiJGh5GbSrZ7N-DETL5eW6-LxcmOZs,5885
@@ -423,7 +423,7 @@ api_logic_server_cli/prototypes/base/.devcontainer-option/For_VSCode.dockerfile,
 api_logic_server_cli/prototypes/base/.devcontainer-option/devcontainer.json,sha256=tk-mGd4XdmbpKUqUeGmcPMzX3RDc6am9-de8c-rFmSo,2361
 api_logic_server_cli/prototypes/base/.devcontainer-option/readme.md,sha256=-sSneMDne1fqEoox2hXUGmoO8ewgi34y7lJwGTidSpY,104
 api_logic_server_cli/prototypes/base/.devcontainer-option/setup.sh,sha256=pOvGjZ7jgRQzFkD93mNICmcC2y66Dexrq4bCnSSVwtU,310
-api_logic_server_cli/prototypes/base/.github/.copilot-instructions.md,sha256=dHUl52qF-dhZHfpxCoqc3Cc_VtWss0aikqLVMZu5rPg,38360
+api_logic_server_cli/prototypes/base/.github/.copilot-instructions.md,sha256=llNDE0SUTPiBztVlQdr3xqqD66BS_rtzRUMGxNkI8Eo,41031
 api_logic_server_cli/prototypes/base/.idea/runConfigurations/ApiLogicServer.xml,sha256=eFzhe9NH-VNjcPWbPsRQy5o-MugJR9IWklA1Fo8wtYg,1127
 api_logic_server_cli/prototypes/base/.idea/runConfigurations/Report_Behave_Logic.xml,sha256=I3jlEf-TPzc-1NY843v6AcQIQ8QJD3z9KvxTYSZWMtY,1306
 api_logic_server_cli/prototypes/base/.idea/runConfigurations/Run_Behave.xml,sha256=CTzF0P4w7o4FzOi-eSpru0HczSEGtJsKqkQ7VWRyxPc,1196
@@ -526,6 +526,7 @@ api_logic_server_cli/prototypes/base/devops/python-anywhere/python_anywhere_wsgi
 api_logic_server_cli/prototypes/base/docs/graphics/readme.md,sha256=GaNOkrzT_nlcrIpmmwLQtoGC6aPZnM8bSGgmc5fM8yk,402
 api_logic_server_cli/prototypes/base/docs/logic/readme.md,sha256=fIQypEQ7Ny7q385AhpwndYRBFquG6P6xpM41-zrIseE,871
 api_logic_server_cli/prototypes/base/docs/logic_suggestions/readme_logic_suggestions.md,sha256=44ibQYGOy84J4zGFaChLCOf-GU9pOBrbgBbprujMtIs,184
+api_logic_server_cli/prototypes/base/docs/training/MCP_Copilot_Integration.md,sha256=hR88Th7XNaT2051sEMniPTf9v1cVEblpuAXWGmVNd5w,10686
 api_logic_server_cli/prototypes/base/docs/training/admin_app_1_context.prompt.md,sha256=IpBkTI7BLdF7885Q0k5CTu_8Gunl5FdqH_t6fHVjAq0,1740
 api_logic_server_cli/prototypes/base/docs/training/admin_app_2_functionality.prompt.md,sha256=iWMoAkETeQjWWPrNj1AcI4HFGLlgS0-HP9oBYXhdTNI,1705
 api_logic_server_cli/prototypes/base/docs/training/admin_app_3_architecture.prompt.md,sha256=5KtRBihPbxTQEvLJ51w104Z0HfDGFEmQc3ysek6EsXA,925
@@ -555,7 +556,7 @@ api_logic_server_cli/prototypes/base/integration/system/FlaskKafka.py,sha256=QK5
 api_logic_server_cli/prototypes/base/integration/system/RowDictMapper.py,sha256=DSdmeAQZZ_wUWHHiSS_6ZgeTKIuEycNlgX140l3fnSE,19986
 api_logic_server_cli/prototypes/base/logic/declare_logic.py,sha256=7-lMGq0PVkHv3q-Hvor1itSjcj1VVNKLW25QAhmUAJ8,3391
 api_logic_server_cli/prototypes/base/logic/load_verify_rules.py,sha256=dYEb-UxqQ5N08ry22I04vtFy8JtQe2pL7Jw8gR8nGu4,7742
-api_logic_server_cli/prototypes/base/logic/readme_logic.md,sha256=teXyg9-7b-1OAj_kLC7gQ37zNllTRFnovdq2LGsyg6E,10178
+api_logic_server_cli/prototypes/base/logic/readme_logic.md,sha256=zns_MTCq3nCqpwezTPhrNuGSTe8mvdcLrwWYe6mNnxg,11193
 api_logic_server_cli/prototypes/base/logic/logic_discovery/auto_discovery.py,sha256=m97W6DYi6ouTDuFCiU1rPq1UqzJuNnVePyOeLU33D1s,2645
 api_logic_server_cli/prototypes/base/logic/logic_discovery/readme_logic_discovery.md,sha256=SRg3Hrq3vCjqtAL1XijcbPGvfLLgkqsODLtIKfZUEaI,396
 api_logic_server_cli/prototypes/base/logic/logic_discovery/use_case.py,sha256=XR3o8cnmBzsdLobzNX1kbBqqNVVFFdQmfiVHi3I4hyQ,970
@@ -620,7 +621,8 @@ api_logic_server_cli/prototypes/base/venv_setup/venv.sh,sha256=aWX9fa8fe6aO9ifBI
 api_logic_server_cli/prototypes/basic_demo/_config.yml,sha256=KIUQQpjgj7hP_Z2Fksq90E52UnbKnyom-v9L_eIfqZo,170
 api_logic_server_cli/prototypes/basic_demo/readme.md,sha256=Ii0WojbHMHpg6bgMlg9WyadzXVZePM2Nk89kmKHuGTM,18722
 api_logic_server_cli/prototypes/basic_demo/tutor.md,sha256=nlIkqcqkVXBDe3Rktcr4puZxrrTFDl1s_Id8nA5GwA4,45516
-api_logic_server_cli/prototypes/basic_demo/.github/.copilot-instructions.md,sha256=asxo9m-3BInN5Stb8G5W3AL6d1eiq9cuzjP2EIU0Cmw,33260
+api_logic_server_cli/prototypes/basic_demo/.github/.copilot-instructions.md,sha256=e8UZpBpJf_-A788HblOZWzeplHM85-JaL1pVIp5_vKU,41515
+api_logic_server_cli/prototypes/basic_demo/.github/welcome.md,sha256=sdT1Jz9rDgkjTQK2IC1EHs_rFI1bRhwTsOZ21i3oJ0k,1077
 api_logic_server_cli/prototypes/basic_demo/_layouts/redirect.html,sha256=-0kMPGYI88fb787IzYmdi7ySZUhgpUlP0vodrg8-NRM,457
 api_logic_server_cli/prototypes/basic_demo/customizations/api/api_discovery/openapi.py,sha256=kLQ7Fn1J7tzuNJHBXF2AiwtzvQ-0JxJ6z-MfFryAtLk,3887
 api_logic_server_cli/prototypes/basic_demo/customizations/config/default.env,sha256=-rjXJrjR4vjMr9YCVYVchaJw7qMBlbvQ3KfR_wri_XM,412
@@ -628,7 +630,7 @@ api_logic_server_cli/prototypes/basic_demo/customizations/database/db.sqlite,sha
 api_logic_server_cli/prototypes/basic_demo/customizations/database/models.py,sha256=bmM2TNXZXYlb4HpGjlPO_QJW_Ps0MvNlqJQPXB9TWdU,4545
 api_logic_server_cli/prototypes/basic_demo/customizations/docs/mcp_learning/mcp_discovery.json,sha256=juCiWJ_BEBgj-8JMXw-ewW6i8vL9ZkLQCd7Dkf_xWmc,3249
 api_logic_server_cli/prototypes/basic_demo/customizations/logic/cocktail-napkin.jpg,sha256=5rNSy6wvcWSHPJQZqkf2DHs19QLWiyqMBNwxGqjstZU,133075
-api_logic_server_cli/prototypes/basic_demo/customizations/logic/declare_logic.py,sha256=95TuOgNKvO7yMfncSqJ7HKlXZQB0zhEso4l-9l-nVUw,5436
+api_logic_server_cli/prototypes/basic_demo/customizations/logic/declare_logic.py,sha256=huUQg5kjo1XscU5U_NjE7yj4b4QIhaXmcVdw2iUki9Y,5855
 api_logic_server_cli/prototypes/basic_demo/customizations/logic/logic_discovery/email_request.py,sha256=3UnBUBpHSThHHRLLJuV-sgRAs6sS-UCzsTjBzf0onns,1851
 api_logic_server_cli/prototypes/basic_demo/customizations/logic/logic_discovery/simple_constraints.py,sha256=4HRLOXuLJP1eOosONeEtpA9DehxiZME0-FBKuG1RaI0,760
 api_logic_server_cli/prototypes/basic_demo/customizations/security/declare_security.py,sha256=gbdH29cPY656lgROPm_w20Q-g6AhlIMES3wiIrqBTdk,2439
@@ -1023,7 +1025,7 @@ api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/logic/load_ver
 api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/logic/readme_logic.md,sha256=teXyg9-7b-1OAj_kLC7gQ37zNllTRFnovdq2LGsyg6E,10178
 api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/logic/logic_discovery/app_integration.py,sha256=wy8MXTKbYRhv-N5Jm5Q-mW4UtFrk6Q2y1ZeGbUoUVas,863
 api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/logic/logic_discovery/auto_discovery.py,sha256=m97W6DYi6ouTDuFCiU1rPq1UqzJuNnVePyOeLU33D1s,2645
-api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/logic/logic_discovery/check_credit.py,sha256=NoJ2UO3NG35R55wCgoQQm9GLR8T0PMSlglhuBLgdeGY,1756
+api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/logic/logic_discovery/check_credit.py,sha256=cFqPHYBBOGnUT_TpPWCZ8HHXTFwE-4mF7aycH4d9xO0,2138
 api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/logic/logic_discovery/mcp_client_executor_request.py,sha256=X6jlA_xcR7RpbFgc5uY5yDFTCKp0eGHnVubIT2M0AbU,2184
 api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/logic/logic_discovery/readme_logic_discovery.md,sha256=SRg3Hrq3vCjqtAL1XijcbPGvfLLgkqsODLtIKfZUEaI,396
 api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/logic/logic_discovery/use_case.py,sha256=M3TQZwBaAtgEyNjP_Hl8s35x_zEpzpnIrtxmD7sL1NY,916
@@ -2862,9 +2864,9 @@ api_logic_server_cli/tools/mini_skel/database/system/SAFRSBaseX.py,sha256=p8C7AF
 api_logic_server_cli/tools/mini_skel/database/system/TestDataBase.py,sha256=U02SYqThsbY5g3DX7XGaiMxjZBuOpzvtPS6RfI1WQFg,371
 api_logic_server_cli/tools/mini_skel/logic/declare_logic.py,sha256=fTrlHyqMeZsw_TyEXFa1VlYBL7fzjZab5ONSXO7aApo,175
 api_logic_server_cli/tools/mini_skel/logic/load_verify_rules.py,sha256=Rr5bySJpYCZmNPF2h-phcPJ53nAOPcT_ohZpCD93-a0,7530
-apilogicserver-15.3.2.dist-info/licenses/LICENSE,sha256=67BS7VC-Z8GpaR3wijngQJkHWV04qJrwQArVgn9ldoI,1485
-apilogicserver-15.3.2.dist-info/METADATA,sha256=xZIDZwpBx5n1GunlhwhdYCpWBXgsTrmLH8MUewaN2Pc,26461
-apilogicserver-15.3.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-apilogicserver-15.3.2.dist-info/entry_points.txt,sha256=W9EVNvf09h8n6rJChmVj2gzxVQ6BXXZa2x3wri0lFGc,259
-apilogicserver-15.3.2.dist-info/top_level.txt,sha256=-r0AT_GEApleihg-jIh0OMvzzc0BO1RuhhOpE91H5qI,21
-apilogicserver-15.3.2.dist-info/RECORD,,
+apilogicserver-15.3.6.dist-info/licenses/LICENSE,sha256=67BS7VC-Z8GpaR3wijngQJkHWV04qJrwQArVgn9ldoI,1485
+apilogicserver-15.3.6.dist-info/METADATA,sha256=SuVFzjcqSb6S35JTbId2k5fxHeypu8Dz2kkBG5kjmus,26461
+apilogicserver-15.3.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+apilogicserver-15.3.6.dist-info/entry_points.txt,sha256=W9EVNvf09h8n6rJChmVj2gzxVQ6BXXZa2x3wri0lFGc,259
+apilogicserver-15.3.6.dist-info/top_level.txt,sha256=-r0AT_GEApleihg-jIh0OMvzzc0BO1RuhhOpE91H5qI,21
+apilogicserver-15.3.6.dist-info/RECORD,,