ApiLogicServer 15.1.3__py3-none-any.whl → 15.2.3__py3-none-any.whl

api_logic_server_cli/prototypes/base/test/api_logic_server_behave/features/steps/test_data_helpers.py

@@ -0,0 +1,242 @@
+"""
+Test Data Helpers - Query or Create Test Data
+
+These helpers ensure tests work with any database state by:
+1. Querying existing data when available
+2. Creating test data programmatically when needed
+3. Using correct data types (Integer IDs, not strings)
+
+Usage:
+    customer_id = get_or_create_test_customer(balance=0, credit_limit=1000)
+    product_id = get_or_create_test_product(unit_price=5.00)
+"""
+
+import requests
+import json
+import test_utils
+from decimal import Decimal
+import time
+
+
+def get_or_create_test_customer(name: str = "Test Customer", 
+                                balance: float = 0, 
+                                credit_limit: float = 1000) -> int:
+    """
+    Create a NEW test customer (always creates, never reuses).
+    
+    IMPORTANT: balance is a derived aggregate (sum of unshipped orders).
+    - If balance=0: Just create customer (aggregates default to 0)
+    - If balance>0: Must be created by caller via orders/items (see note below)
+    
+    NOTE: This function does NOT create filler orders to reach target balance.
+    If you need balance > 0, the caller must create orders/items after getting customer_id.
+    
+    Returns INTEGER customer ID (not string!)
+    
+    Args:
+        name: Customer name (timestamp added to ensure uniqueness)
+        balance: Target balance (for documentation - NOT enforced by this function)
+        credit_limit: Credit limit
+        
+    Returns:
+        int: Customer ID (e.g., 1, not 'CUST-1')
+    """
+    # Always create NEW customer (add timestamp to name for uniqueness)
+    unique_name = f"{name} {int(time.time() * 1000)}"  # Add millisecond timestamp
+    
+    post_uri = 'http://localhost:5656/api/Customer/'
+    post_data = {
+        "data": {
+            "attributes": {
+                "name": unique_name,
+                # NOTE: Do NOT set balance here - it's a derived aggregate!
+                "credit_limit": credit_limit
+            },
+            "type": "Customer"
+        }
+    }
+    r = requests.post(url=post_uri, json=post_data, headers=test_utils.login())
+    result = json.loads(r.text)
+    return int(result['data']['id'])  # Convert to int!
+
+
+def get_or_create_test_product(name: str = "Test Product", 
+                               unit_price: float = 5.00) -> int:
+    """
+    Get or create a test product with specified attributes.
+    
+    Returns INTEGER product ID (not string!)
+    
+    Args:
+        name: Product name
+        unit_price: Unit price
+        
+    Returns:
+        int: Product ID (e.g., 1, not 'PROD-A')
+    """
+    # Try to find existing product
+    get_uri = f'http://localhost:5656/api/Product/?filter[name]={name}'
+    r = requests.get(url=get_uri, headers=test_utils.login())
+    data = json.loads(r.text)
+    
+    if data.get('data') and len(data['data']) > 0:
+        product_id = int(data['data'][0]['id'])  # Convert to int!
+        # Update to ensure correct price
+        patch_uri = f'http://localhost:5656/api/Product/{product_id}/'
+        patch_data = {
+            "data": {
+                "attributes": {"unit_price": unit_price},
+                "type": "Product",
+                "id": product_id
+            }
+        }
+        requests.patch(url=patch_uri, json=patch_data, headers=test_utils.login())
+        return product_id
+    else:
+        # Create new product
+        post_uri = 'http://localhost:5656/api/Product/'
+        post_data = {
+            "data": {
+                "attributes": {
+                    "name": name,
+                    "unit_price": unit_price
+                },
+                "type": "Product"
+            }
+        }
+        r = requests.post(url=post_uri, json=post_data, headers=test_utils.login())
+        result = json.loads(r.text)
+        return int(result['data']['id'])  # Convert to int!
+
+
+def create_test_order(customer_id: int, notes: str = "Test Order") -> int:
+    """
+    Create a test order (always creates new, doesn't reuse).
+    
+    Args:
+        customer_id: INTEGER customer ID
+        notes: Order notes
+        
+    Returns:
+        int: Order ID
+    """
+    post_uri = 'http://localhost:5656/api/Order/'
+    post_data = {
+        "data": {
+            "attributes": {
+                "customer_id": customer_id,  # Integer, not string!
+                "notes": notes,
+                "date_shipped": None  # Unshipped
+            },
+            "type": "Order"
+        }
+    }
+    r = requests.post(url=post_uri, json=post_data, headers=test_utils.login())
+    result = json.loads(r.text)
+    return int(result['data']['id'])  # Convert to int!
+
+
+def create_test_item(order_id: int, product_id: int, quantity: int = 10) -> int:
+    """
+    Create a test order item.
+    
+    Args:
+        order_id: INTEGER order ID
+        product_id: INTEGER product ID
+        quantity: Quantity
+        
+    Returns:
+        int: Item ID
+    """
+    post_uri = 'http://localhost:5656/api/Item/'
+    post_data = {
+        "data": {
+            "attributes": {
+                "order_id": order_id,      # Integer!
+                "product_id": product_id,  # Integer!
+                "quantity": quantity
+            },
+            "type": "Item"
+        }
+    }
+    r = requests.post(url=post_uri, json=post_data, headers=test_utils.login())
+    result = json.loads(r.text)
+    if r.status_code > 300 or 'data' not in result:
+        raise Exception(f"Failed to create item: {r.status_code} - {r.text}")
+    return int(result['data']['id'])  # Convert to int!
+
+
+def delete_test_data(customer_id: int = None, order_id: int = None, item_id: int = None):
+    """
+    Clean up test data (use in teardown or when resetting state).
+    
+    Args:
+        customer_id: Customer to delete
+        order_id: Order to delete  
+        item_id: Item to delete
+    """
+    if item_id:
+        delete_uri = f'http://localhost:5656/api/Item/{item_id}/'
+        requests.delete(url=delete_uri, headers=test_utils.login())
+    
+    if order_id:
+        delete_uri = f'http://localhost:5656/api/Order/{order_id}/'
+        requests.delete(url=delete_uri, headers=test_utils.login())
+    
+    if customer_id:
+        delete_uri = f'http://localhost:5656/api/Customer/{customer_id}/'
+        requests.delete(url=delete_uri, headers=test_utils.login())
+
+
+def get_customer(customer_id: int) -> dict:
+    """
+    Fetch customer data by INTEGER ID.
+    
+    Args:
+        customer_id: INTEGER customer ID (e.g., 1, not 'CUST-1')
+        
+    Returns:
+        dict: Customer attributes (id, name, balance, credit_limit, etc.)
+    """
+    get_uri = f'http://localhost:5656/api/Customer/{customer_id}/'
+    r = requests.get(url=get_uri, headers=test_utils.login())
+    if r.status_code > 300:
+        raise Exception(f'get_customer failed with {r.text}')
+    result_data = json.loads(r.text)
+    return result_data['data']['attributes']
+
+
+def get_order(order_id: int) -> dict:
+    """
+    Fetch order data by INTEGER ID.
+    
+    Args:
+        order_id: INTEGER order ID
+        
+    Returns:
+        dict: Order attributes
+    """
+    get_uri = f'http://localhost:5656/api/Order/{order_id}/'
+    r = requests.get(url=get_uri, headers=test_utils.login())
+    if r.status_code > 300:
+        raise Exception(f'get_order failed with {r.text}')
+    result_data = json.loads(r.text)
+    return result_data['data']['attributes']
+
+
+def get_item(item_id: int) -> dict:
+    """
+    Fetch item data by INTEGER ID.
+    
+    Args:
+        item_id: INTEGER item ID
+        
+    Returns:
+        dict: Item attributes
+    """
+    get_uri = f'http://localhost:5656/api/Item/{item_id}/'
+    r = requests.get(url=get_uri, headers=test_utils.login())
+    if r.status_code > 300:
+        raise Exception(f'get_item failed with {r.text}')
+    result_data = json.loads(r.text)
+    return result_data['data']['attributes']

api_logic_server_cli/prototypes/base/test/api_logic_server_behave/features/steps/test_utils.py

@@ -3,6 +3,7 @@ import json
 from dotmap import DotMap
 import sys, os
 from pathlib import Path
+from urllib.parse import quote
 
 __version__ = '0.0.1'  # keycloak support
 
@@ -29,7 +30,10 @@ def prt(msg: any, test: str= None) -> None:
         test_val = test[0:25]
     if "Server Log: Behave Run Successfully Completed" in msg:
         debug_stop = 'good breakpoint'
-    msg_url = f'http://localhost:5656/server_log?msg={msg}&test={test}&dir=test/api_logic_server_behave/logs/scenario_logic_logs'
+    # URL-encode msg and test to handle special characters, newlines, spaces, etc.
+    msg_encoded = quote(str(msg))
+    test_encoded = quote(str(test)) if test else 'None'
+    msg_url = f'http://localhost:5656/server_log?msg={msg_encoded}&test={test_encoded}&dir=test/api_logic_server_behave/logs/scenario_logic_logs'
     r = requests.get(msg_url)
 
 

api_logic_server_cli/prototypes/base/test/api_logic_server_behave/reports/Behave Logic Report Intro micro.md

@@ -1,4 +1,19 @@
+This report shows test results with embedded logic execution traces.
+
+**For complete documentation on using Behave:** See [Behave.md](https://apilogicserver.github.io/Docs/Behave/)
+
+**About This Project:**
+
+_**TODO:** [Describe your project here - what it does, key features tested, etc.]_
+
+ 
+
 This report combines:
+
 * Behave log (lists Features, test Scenarios, results), with embedded
 * Logic showing rules executed, and how they operated
 
+---
+
+# Behave Logic Report
+

api_logic_server_cli/prototypes/base/test/api_logic_server_behave/reports/Behave Logic Report Intro.md

@@ -1,75 +1,19 @@
-# Behave Creates Executable Test Suite, Documentation
+This report shows test results with embedded logic execution traces.
 
-You can optionally use the Behave test framework to:
+**For complete documentation on using Behave:** See [Behave.md](https://apilogicserver.github.io/Docs/Behave/)
 
-1. **Create and Run an Executable Test Suite:** in your IDE, create test definitions (similar to what is shown in the report below), and Python code to execute tests.  You can then execute your test suite with 1 command.
+**About This Project:**
 
-2. **Requirements and Test Documentation:** as shown below, you can then create a wiki report that documents your requirements, and the tests (**Scenarios**) that confirm their proper operation.
+_**TODO:** [Describe your project here - what it does, key features tested, etc.]_
 
-   * **Logic Documentation:** the report integrates your logic, including a logic report showing your logic (rules and Python), and a Logic Log that shows exactly how the rules executed.  Logic Doc can further contribute to Agile Collaboration.
+ 
 
-<figure><img src="https://raw.githubusercontent.com/ApiLogicServer/Docs/main/docs/images/behave/behave-summary.png"  height="600"></figure>
+This report combines:
 
+* Behave log (lists Features, test Scenarios, results), with embedded
+* Logic showing rules executed, and how they operated
 
+---
 
-[Behave](https://behave.readthedocs.io/en/stable/tutorial.html) is a framework for defining and executing tests.  It is based on [TDD (Test Driven Development)](http://dannorth.net/introducing-bdd/), an Agile approach for defining system requirements as executable tests.
+# Behave Logic Report
 
-&nbsp;&nbsp;
-
-# Using Behave
-
-<figure><img src="https://raw.githubusercontent.com/ApiLogicServer/Docs/main/docs/images/behave/TDD-ide.png?raw=true"></figure>
-
-Behave is pre-installed with API Logic Server.  Use it as shown above:
-
-1. Create `.feature` files to define ***Scenarios*** (aka tests) for ***Features*** (aka Stories)
-
-2. Code `.py` files to implement Scenario tests
-
-3. Run Test Suite: Launch Configuration `Behave Run`.  This runs all your Scenarios, and produces a summary report of your Features and the test results.
-
-4. Report: Launch Configuration `Behave Report` to create the wiki file shown at the top of this page.
-
-These steps are further defined, below.  Explore the samples in the sample project.
-
-&nbsp;&nbsp;
-
-## 1. Create `.feature` file to define Scenario
-
-Feature (aka Story) files are designed to promote IT / business user collaboration.  
-
-&nbsp;&nbsp;
-
-## 2. Code `.py` file to implement test
-
-Implement your tests in Python.  Here, the tests are largely _read existing data_, _run transaction_, and _test results_, using the API.  You can obtain the URLs from the swagger.
-
-Key points:
-
-* Link your scenario / implementations with annotations, as shown for _Order Placed with excessive quantity_.
-
-* Include the `test_utils.prt()` call; be sure to use specify the scenario name as the 2nd argument.  This is what drives the name of the Logic Log file, discussed below.
-
-* Optionally, include a Python docstring on your `when` implementation as shown above, delimited by `"""` strings (see _"Familiar logic pattern"_ in the screen shot, above). If provided, this will be written into the wiki report.
-
-* Important: the system assumes the following line identifies the scenario_name; be sure to include it.
-
-&nbsp;&nbsp;
-
-## 3. Run Test Suite: Launch Configuration `Behave Run`
-
-You can now execute your Test Suite.  Run the `Behave Run` Launch Configuration, and Behave will run all of the tests, producing the outputs (`behave.log` and `<scenario.logs>` shown above.
-
-* Windows users will need to run `Windows Behave Run`
-
-* You can run just 1 scenario using `Behave Scenario`
-
-* You can set breakpoints in your tests
-
-The server must be running for these tests.  Use the Launch Configuration `ApiLogicServer`, or `python api_logic_server_run.py`.  The latter does not run the debugger, which you may find more convenient since changes to your test code won't restart the server.
-
-&nbsp;&nbsp;
-
-## 4. Report: Launch Configuration `Behave Report'
-
-Run this to create the wiki reports from the logs in step 3.

api_logic_server_cli/prototypes/base/test/readme_test.md

@@ -49,6 +49,26 @@ python behave_run.py
 # In Debug Console, select "Behave Run" from dropdown (not server log)
 ```
 
+### Running Specific Tests
+
+You can run specific features or scenarios using behave's command-line options:
+
+```bash
+# Run a specific feature file
+behave features/check_credit.feature
+
+# Run a specific scenario by name
+behave -n "Good Order - Basic Chain"
+
+# Run scenarios matching a pattern
+behave -n ".*credit.*"
+
+# Run with tags (if you've tagged scenarios with @smoke, @wip, etc.)
+behave --tags=smoke
+```
+
+**Note**: When using `behave` directly (not `behave_run.py`), logic logs still generate in `logs/scenario_logic_logs/`, but the wrapper provides additional error checking.
+
 ### Alternative: Basic Server Tests
 
 ```bash
@@ -205,6 +225,29 @@ def step_impl(context):
     assert final_state.calculated_field == expected_value
 ```
 
+**Understanding the `context` Object:**
+
+The `context` object in Behave is shared across all steps in a scenario, making it perfect for passing data between Given/When/Then steps:
+
+```python
+# Store values in GIVEN steps
+context.customer_id = 123
+context.initial_balance = 1000
+
+# Access in WHEN steps  
+order_data = {"customer_id": context.customer_id, "amount": 500}
+
+# Verify in THEN steps
+assert context.response.status_code == 200
+```
+
+**Common context patterns:**
+- `context.customer_id`, `context.order_id`, etc. - Store entity IDs
+- `context.initial_balance`, `context.before_amount` - Capture "before" state
+- `context.response` - Store API response for later assertions
+- `context.auth_header` - Store authentication token
+- `context.expected_error` - Store expected error for negative tests
+
 ## 🤖 For GitHub Copilot
 
 When generating tests for API Logic Server projects:
@@ -354,10 +397,35 @@ delete_url = f"{base_url}/{EntityName}/{entity_id}/"
 
 ## 📊 Test Reports and Logging
 
-- **Logic Reports**: Generated in `reports/` showing which rules executed
-- **Behave Output**: Standard BDD test results with pass/fail status
-- **Logic Logs**: Detailed rule execution in `logs/scenario_logic_logs/`
-- **Server Logs**: API request/response details and errors
+### Viewing Test Output
+
+After running tests, you can view results in multiple locations:
+
+- **Console Output**: Real-time pass/fail status during test execution
+- **Behave Log**: `logs/behave.log` - Detailed test execution output
+- **Scenario Logic Logs**: `logs/scenario_logic_logs/*.log` - One file per scenario showing rule execution
+- **Server Logs**: API request/response details and errors in server console
+
+### Generating Logic Reports
+
+To create a comprehensive markdown report showing which rules executed in each scenario:
+
+```bash
+# From test/api_logic_server_behave directory
+python behave_logic_report.py run
+```
+
+This generates `reports/Behave Logic Report.md` containing:
+- **Test Scenarios**: All executed scenarios with descriptions
+- **Logic Documentation**: Step docstrings explaining what each test validates
+- **Rules Fired**: Which business logic rules executed during each scenario
+- **Disclosure Areas**: Expandable sections showing detailed logic traces
+
+The report is useful for:
+- Understanding which rules are tested by which scenarios
+- Documenting test coverage for business stakeholders
+- Debugging rule execution order and dependencies
+- Verifying that expected rules actually fired
 
 ## 🔍 Debugging Tests
 

api_logic_server_cli/prototypes/basic_demo/customizations/test/api_logic_server_behave/reports/Behave Logic Report Intro micro.md

@@ -0,0 +1,35 @@
+## Basic Demo Sample
+
+This is a basic demonstration project created from a simple natural language prompt using API Logic Server's GenAI capabilities.
+
+### Data Model
+
+![Basic Demo Data Model](https://apilogicserver.github.io/Docs/images/basic_demo/basic_demo_data_model.jpeg)
+
+### Creation Prompt
+
+This project was created from the following natural language prompt:
+
+```
+Create a system with customers, orders, items and products.
+
+Include a notes field for orders.
+
+Use case: Check Credit    
+    1. The Customer's balance is less than the credit limit
+    2. The Customer's balance is the sum of the Order amount_total where date_shipped is null
+    3. The Order's amount_total is the sum of the Item amount
+    4. The Item amount is the quantity * unit_price
+    5. The Item unit_price is copied from the Product unit_price
+
+Use case: App Integration
+    1. Send the Order to Kafka topic 'order_shipping' if the date_shipped is not None.
+```
+
+The sample Scenarios below were chosen to illustrate the basic patterns of using rules. Open the disclosure box ("Tests - and their logic...") to see the implementation and notes.
+
+The following report was created during test suite execution.
+
+ 
+
+# Behave Logic Report

api_logic_server_cli/prototypes/basic_demo/customizations/test/api_logic_server_behave/reports/Behave Logic Report Intro.md

@@ -0,0 +1,35 @@
+## Basic Demo Sample
+
+This is a basic demonstration project created from a simple natural language prompt using API Logic Server's GenAI capabilities (with a custom Behave Report Intro).
+
+### Data Model
+
+![Basic Demo Data Model](https://apilogicserver.github.io/Docs/images/basic_demo/basic_demo_data_model.jpeg)
+
+### Creation Prompt
+
+This project was created from the following natural language prompt:
+
+```
+Create a system with customers, orders, items and products.
+
+Include a notes field for orders.
+
+Use case: Check Credit    
+    1. The Customer's balance is less than the credit limit
+    2. The Customer's balance is the sum of the Order amount_total where date_shipped is null
+    3. The Order's amount_total is the sum of the Item amount
+    4. The Item amount is the quantity * unit_price
+    5. The Item unit_price is copied from the Product unit_price
+
+Use case: App Integration
+    1. Send the Order to Kafka topic 'order_shipping' if the date_shipped is not None.
+```
+
+The sample Scenarios below were chosen to illustrate the basic patterns of using rules. Open the disclosure box ("Tests - and their logic...") to see the implementation and notes.
+
+The following report was created during test suite execution.
+
+ 
+
+# Behave Logic Report

api_logic_server_cli/prototypes/basic_demo/iteration/api/api_discovery/order_b2b.py

@@ -57,27 +57,31 @@ class ServicesEndPoint(safrs.JABase):
         See: https://apilogicserver.github.io/Docs/Sample-Integration/
         Test with swagger, or, from command line:
 
+        CRITICAL: Custom API calls require BOTH "method" and "args" in meta object:
+
         $(venv) ApiLogicServer login --user=admin --password=p
         $(venv) ApiLogicServer curl "'POST' 'http://localhost:5656/api/ServicesEndPoint/OrderB2B'" --data '
-        {"meta": {"args": {"order": {
-            "Account": "Customer 1",
-            "Notes": "Please Rush",
-            "Items": [
-                {
-                "Name": "Product A",
-                "QuantityOrdered": 1
-                },
-                {
-                "Name": "Product B",
-                "QuantityOrdered": 2
-                },
-                {
-                "Name": "Product B",
-                "QuantityOrdered": 2
-                }
+        {"meta": {
+            "method": "OrderB2B",
+            "args": {"order": {
+                "Account": "Customer 1",
+                "Notes": "Please Rush",
+                "Items": [
+                    {
+                    "Name": "Product A",
+                    "QuantityOrdered": 1
+                    },
+                    {
+                    "Name": "Product B",
+                    "QuantityOrdered": 2
+                    },
+                    {
+                    "Name": "Product B",
+                    "QuantityOrdered": 2
+                    }
                 ]
-            }
-        }}}'
+            }}
+        }}'
 
         """
 

api_logic_server_cli/prototypes/basic_demo/ui/my-react-app-cards/README.md

@@ -2,7 +2,9 @@
 
 GenAI-Logic created this app (`genai-logic genai-add-app`) [(docs here)](https://apilogicserver.github.io/Docs/Admin-Vibe/), typically from `ui/admin/admin.yaml`.
 
-We then use CoPilot to add cards, as described in `readme_vibe.md`:
+Use it as a reference example.
+
+We then used CoPilot to add cards, as described in `readme_vibe.md`:
 
 ![cards](product-cards.png)
 

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

@@ -2,7 +2,7 @@
 
 ⚠️ **IMPORTANT FOR AI ASSISTANTS**: Always read and follow these instructions when helping users with this project.
 
-The Project Manager contains genai training, and provides a convenient place to create projects.
+The Project Manager contains genai training, a virtual environment, and provides a convenient place to create projects.
 
 > Note: your virtual environment is automatically configured in most cases; verify it with `genai-logic` - it it's not there, activate the `venv` in this project.
 
@@ -21,7 +21,11 @@ genai-logic create --project_name=basic_demo --db_url=basic_demo
 
 There are multiple ways to create projects (aka systems, microservices) - see the subsections below.
 
-### Create Projects from an existing database
+**KEY DISTINCTION:**
+- `genai-logic create` - Creates infrastructure only (API, UI, models) - **NO business logic rules**
+- `genai-logic genai` - Creates complete system including **business logic rules from natural language**
+
+### Method 1: Create Projects from an existing database (Infrastructure Only)
 
 If the user provides a database reference, use the command below.  (Note: sqlite sample databases at `samples/dbs`). 
 
@@ -29,17 +33,17 @@ If the user provides a database reference, use the command below.  (Note: sqlite
 genai-logic create  --project_name=nw --db_url=sqlite:///samples/dbs/nw.sqlite
 ```
 
-### Create Projects with new databases 
+**Important:** This creates the project structure, API, Admin App, and database models, but **NO business logic rules**.
 
-If the user provides a description, follow these steps:
+**To add logic:** Users must add rules separately using:
+- Natural language with Copilot/AI assistant in `logic/declare_logic.py`, or
+- Manual coding with IDE code completion
 
-1. Create a sqlite database from the description.  Be sure to include foreign keys.  The system works well with `id INTEGER PRIMARY KEY AUTOINCREMENT`.
-2. Then, use the `genai-logic create` command above.
-3. If logic is provided, translate it using`system/genai/learning_requests/logic_bank_api.prompt`.
+### Method 2: Create Projects with GenAI (Complete System with Logic)
 
-### Create Projects with new databases using genai-logic genai (requires OpenAI key):
+**Use this when the user provides both database AND business logic requirements.**
 
-Describe database and logic in Natural Language.
+Describe database and logic in Natural Language in a prompt file.
 
 See samples at `system/genai/examples`.  For example:
 
@@ -47,6 +51,23 @@ See samples at `system/genai/examples`.  For example:
 genai-logic genai --using=system/genai/examples/genai_demo/genai_demo.prompt --project-name=genai_demo
 ```
 
+**This approach:**
+1. Creates the database from description
+2. Generates SQLAlchemy models
+3. **Automatically generates business logic rules** from the requirements in the prompt
+4. Creates test data
+5. Creates API, Admin App, and complete project structure
+
+**When to use:** User provides requirements like "Customer balance is sum of orders" or "Check credit limit" - the LLM will generate the corresponding `Rule.sum`, `Rule.constraint`, etc.
+
+### Method 3: Create Projects with new databases (Manual Approach)
+
+If the user provides a description but you want to create the database manually:
+
+1. Create a sqlite database from the description.  Be sure to include foreign keys.  The system works well with `id INTEGER PRIMARY KEY AUTOINCREMENT`.
+2. Then, use the `genai-logic create` command above.
+3. If logic is provided, translate it using Copilot or `system/genai/learning_requests/logic_bank_api.prompt`.
+
 ## AI Assistant Guidelines
 
 When users ask "what do I do now?" or similar questions: