ApiLogicServer 15.0.41__tar.gz → 15.0.46__tar.gz

{apilogicserver-15.0.41 → apilogicserver-15.0.46}/ApiLogicServer.egg-info/PKG-INFO

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

{apilogicserver-15.0.41 → apilogicserver-15.0.46}/ApiLogicServer.egg-info/SOURCES.txt

@@ -526,7 +526,6 @@ api_logic_server_cli/prototypes/allocation/images/allocation/logic-diagram.png
 api_logic_server_cli/prototypes/allocation/logic/declare_logic.py
 api_logic_server_cli/prototypes/allocation/test/test.sh
 api_logic_server_cli/prototypes/base/.DS_Store
-api_logic_server_cli/prototypes/base/.copilot-instructions.md
 api_logic_server_cli/prototypes/base/.gitignore
 api_logic_server_cli/prototypes/base/README_PROJECT.md
 api_logic_server_cli/prototypes/base/api_logic_server_run.py
@@ -539,13 +538,13 @@ api_logic_server_cli/prototypes/base/.devcontainer-option/For_VSCode.dockerfile
 api_logic_server_cli/prototypes/base/.devcontainer-option/devcontainer.json
 api_logic_server_cli/prototypes/base/.devcontainer-option/readme.md
 api_logic_server_cli/prototypes/base/.devcontainer-option/setup.sh
+api_logic_server_cli/prototypes/base/.github/.copilot-instructions.md
 api_logic_server_cli/prototypes/base/.idea/runConfigurations/ApiLogicServer.xml
 api_logic_server_cli/prototypes/base/.idea/runConfigurations/Report_Behave_Logic.xml
 api_logic_server_cli/prototypes/base/.idea/runConfigurations/Run_Behave.xml
 api_logic_server_cli/prototypes/base/.idea/runConfigurations/Windows_Run_Behave.xml
 api_logic_server_cli/prototypes/base/.idea/runConfigurations/run___No_Security.xml
 api_logic_server_cli/prototypes/base/.idea/runConfigurations/run_docker.xml
-api_logic_server_cli/prototypes/base/.vscode/.copilot-instructions.md
 api_logic_server_cli/prototypes/base/.vscode/launch.json
 api_logic_server_cli/prototypes/base/.vscode/settings.json
 api_logic_server_cli/prototypes/base/api/__init__.py
@@ -829,7 +828,6 @@ api_logic_server_cli/prototypes/genai_demo/logic/load_verify_rules.py
 api_logic_server_cli/prototypes/genai_demo/logic/readme_declare_logic.md
 api_logic_server_cli/prototypes/genai_demo/security/declare_security.py
 api_logic_server_cli/prototypes/genai_demo/ui/admin/admin.yaml
-api_logic_server_cli/prototypes/manager/.copilot-instructions.md
 api_logic_server_cli/prototypes/manager/.gitignore
 api_logic_server_cli/prototypes/manager/README.md
 api_logic_server_cli/prototypes/manager/run_sample.sh
@@ -841,7 +839,7 @@ api_logic_server_cli/prototypes/manager/.vscode/ApiLogicServer.code-workspace
 api_logic_server_cli/prototypes/manager/.vscode/launch.json
 api_logic_server_cli/prototypes/manager/.vscode/settings.json
 api_logic_server_cli/prototypes/manager/samples/readme_samples.md
-api_logic_server_cli/prototypes/manager/samples/dbs/readme_samples.md
+api_logic_server_cli/prototypes/manager/samples/dbs/readme_dbs.md
 api_logic_server_cli/prototypes/manager/system/Manager_workspace.code-workspace
 api_logic_server_cli/prototypes/manager/system/readme_ssystem.md
 api_logic_server_cli/prototypes/manager/system/style-guide.yaml

{apilogicserver-15.0.41 → apilogicserver-15.0.46}/PKG-INFO

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

{apilogicserver-15.0.41 → apilogicserver-15.0.46}/api_logic_server_cli/api_logic_server.py

@@ -12,9 +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.00.41"  # last public release: 15.00.40 (15.00.12)
+__version__ = "15.00.46"  # last public release: 15.00.41 (15.00.12)
 recent_changes = \
     f'\n\nRecent Changes:\n' +\
+    "\t07/14/2024 - 15.00.46: venv fix, copilot vibe tweaks - creation, mcp logic, basic_demo autonums \n"\
     "\t07/10/2024 - 15.00.41: copilot vibe support for logic, UI, MCP,  bug[98] \n"\
     "\t06/30/2024 - 15.00.33: Tech Preview: genai-logic genai-add-app --vibe, bug [96, 97] \n"\
     "\t06/10/2024 - 15.00.12: MCP Security, win fixes for readme, graphics quotes \n"\
@@ -622,11 +623,12 @@ def final_project_fixup(msg, project) -> str:
 
     # **********************************
     # set python.defaultInterpreterPath
+    # yuck: https://apilogicserver.github.io/Docs/Architecture-venv-defaulting/
     # **********************************
-    do_default_interpreter_path = True  # compute startup (only) python / venv location, from creating venv (here)
-    if do_default_interpreter_path:
+    if do_default_interpreter_path := True:  # compute startup (only) python / venv location, from creating venv (here)
         defaultInterpreterPath_str = sys.executable  # python location, unless running from blt or dev-src
         defaultInterpreterPath = Path(defaultInterpreterPath_str)
+        venv_path_str = str(project.venv_path)  # project.manager_path also there...
         if 'ApiLogicServer-dev' in str(project.api_logic_server_dir_path):  # blt & dev-src are special case
             if os.name == "nt":  # cases: blt, or dev source
                 defaultInterpreterPath = project.api_logic_server_dir_path.parent.parent.parent.parent.joinpath('venv/scripts/python.exe')
@@ -646,9 +648,116 @@ def final_project_fixup(msg, project) -> str:
         create_utils.replace_string_in_file(search_for = 'ApiLogicServerPython',
                                             replace_with=defaultInterpreterPath_str,
                                             in_file=vscode_settings_path)
+        
+        # Create venv initialization script for terminal
+        venv_init_path = project.project_directory_path.joinpath('.vscode/venv_init.sh')
+        venv_activate_script = str(Path(defaultInterpreterPath_str).parent.joinpath('activate'))
+        
+        venv_init_content = f"""#!/bin/bash
+# Virtual Environment Initialization Script
+# This script activates the virtual environment for terminal use
+
+# Set DEBUG_VENV_INIT=1 to enable debug output
+DEBUG_VENV_INIT=0
+
+if [ "$DEBUG_VENV_INIT" = "1" ]; then
+    echo "=== VENV INIT DEBUG ==="
+    echo "Shell: $0"
+    echo "ZSH_VERSION: $ZSH_VERSION"
+    echo "BASH_VERSION: $BASH_VERSION"
+    echo "Current PS1: $PS1"
+    echo "VIRTUAL_ENV before: $VIRTUAL_ENV"
+fi
+
+# Source the virtual environment activation script
+if [ -f "{venv_activate_script}" ]; then
+    if [ "$DEBUG_VENV_INIT" = "1" ]; then
+        echo "Found activation script: {venv_activate_script}"
+    fi
+    source {venv_activate_script}
+    echo "Virtual environment activated: $(basename $(dirname $(dirname {venv_activate_script})))"
+    
+    if [ "$DEBUG_VENV_INIT" = "1" ]; then
+        echo "VIRTUAL_ENV after activation: $VIRTUAL_ENV"
+    fi
+    
+    # Don't let virtualenv override the prompt
+    export VIRTUAL_ENV_DISABLE_PROMPT=1
+    if [ "$DEBUG_VENV_INIT" = "1" ]; then
+        echo "Set VIRTUAL_ENV_DISABLE_PROMPT=1"
+    fi
+    
+    # Override the prompt to ensure (venv) shows
+    if [ -n "${{ZSH_VERSION}}" ]; then
+        if [ "$DEBUG_VENV_INIT" = "1" ]; then
+            echo "Setting zsh prompt"
+        fi
+        export PS1="(venv) %n@%m %1~ %# "
+    elif [ -n "${{BASH_VERSION}}" ]; then
+        if [ "$DEBUG_VENV_INIT" = "1" ]; then
+            echo "Setting bash prompt"
+        fi
+        export PS1="(venv) \\u@\\h \\W \\$ "
+    else
+        if [ "$DEBUG_VENV_INIT" = "1" ]; then
+            echo "Unknown shell - trying generic prompt"
+        fi
+        export PS1="(venv) $ "
+    fi
+    
+    if [ "$DEBUG_VENV_INIT" = "1" ]; then
+        echo "Final PS1: $PS1"
+        echo "Final VIRTUAL_ENV: $VIRTUAL_ENV"
+    fi
+    
+else
+    echo "Warning: Virtual environment activation script not found at {venv_activate_script}"
+fi
+
+if [ "$DEBUG_VENV_INIT" = "1" ]; then
+    echo "=== END DEBUG ==="
+fi
+"""
+        
+        with open(venv_init_path, 'w') as venv_init_file:
+            venv_init_file.write(venv_init_content)
+        
+        # Make the script executable
+        import stat
+        os.chmod(venv_init_path, stat.S_IRWXU | stat.S_IRGRP | stat.S_IROTH)
+        
+        # Set the site-packages path for Python analysis
+        venv_lib_dir = Path(defaultInterpreterPath_str).parent.parent.joinpath('lib')
+        site_packages_dirs = list(venv_lib_dir.glob('python*/site-packages'))
+        if site_packages_dirs:
+            venv_site_packages = str(site_packages_dirs[0])
+        else:
+            # Fallback for different structures
+            venv_site_packages = str(venv_lib_dir.joinpath('site-packages'))
+        if os.name == "nt":
+            venv_site_packages = get_windows_path_with_slashes(url=venv_site_packages)
+        create_utils.replace_string_in_file(search_for = 'ApiLogicServerVenvSitePackages',
+                                            replace_with=venv_site_packages,
+                                            in_file=vscode_settings_path)
+        
+        # Create .env file to help with virtual environment activation
+        env_file_path = project.project_directory_path.joinpath('.env')
+        venv_dir = str(Path(defaultInterpreterPath_str).parent.parent)  # Get the venv directory
+        
+        env_content = f"""# Virtual Environment Configuration
+VIRTUAL_ENV={venv_dir}
+PATH={Path(defaultInterpreterPath_str).parent}:$PATH
+PYTHONPATH={venv_site_packages}
+"""
+        with open(env_file_path, 'w') as env_file:
+            env_file.write(env_content)
+        
         log.debug(f'.. ..Updated .vscode/settings.json with "python.defaultInterpreterPath": "{defaultInterpreterPath_str}"...')
+        log.debug(f'.. ..Created .vscode/venv_init.sh for terminal venv activation...')
+        log.debug(f'.. ..Updated .vscode/settings.json with site-packages: "{venv_site_packages}"...')
+        log.debug(f'.. ..Created .env file with VIRTUAL_ENV: "{venv_dir}"...')
     else:
-        log.debug(f'.. ..Updated .vscode/settings.json NOT SET')
+        log.warning(f'.. ..Updated .vscode/settings.json NOT SET')
     return
 
 

apilogicserver-15.0.46/api_logic_server_cli/api_logic_server_info.yaml

@@ -0,0 +1,3 @@
+last_created_date: July 14, 2025 19:56:50
+last_created_project_name: ApiLogicProject
+last_created_version: 15.00.46

{apilogicserver-15.0.41 → apilogicserver-15.0.46}/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, if 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
 
@@ -192,7 +192,10 @@ def copy_md(project, from_doc_file: str, to_project_file: str = "README.md"):
                         r'(https://apilogicserver.github.io/Docs/\1)',
                         each_line
                     )
-                    each_line = each_line.replace('.md', '')
+                    if 'copilot' in each_line or 'Copilot' in each_line:  
+                        pass
+                    else:
+                        each_line = each_line.replace('.md', '')  # hmm... todo: find out why this exists
                     pass
                 readme_lines_md.append(each_line)
         with open(str(to_file), "w") as readme_file:

{apilogicserver-15.0.41 → apilogicserver-15.0.46}/api_logic_server_cli/manager.py

@@ -144,24 +144,27 @@ def create_manager(clean: bool, open_with: str, api_logic_server_path: Path,
             from_docker_dir = api_logic_server_path.joinpath('prototypes/manager_docker')
             copied_path = shutil.copytree(src=from_docker_dir, dst=to_dir, dirs_exist_ok=True)
 
-        # get latest readme from git (eg, has been updated since pip install)
-        get_readme_url = f"https://raw.githubusercontent.com/ApiLogicServer/ApiLogicServer-src/main/api_logic_server_cli/prototypes/manager/README.md"
-        #            https://github.com/ApiLogicServer/ApiLogicServer-src/main/api_logic_server_cli/prototypes/manager/README.md
-        readme_path = to_dir.joinpath('README.md')
-        try:
-            r = requests.get(get_readme_url)  # , params=params)
-            if r.status_code == 200:
-                readme_data = r.content.decode('utf-8')
-                with open(str(readme_path), "w", encoding="utf-8") as readme_file:
-                    readme_file.write(readme_data)
-                log.debug("✅ Wrote Manager Readme from git")
-        except requests.exceptions.ConnectionError as conerr: 
-            # without this, windows fails if network is down
-            log.debug("❌ Manager Readme from git failed, using pip-installed version")
-        except Exception as e:     # do NOT fail 
-            log.error(f'❌ Manager Readme from git excp installed: {e}')
-            pass    # just fall back to using the pip-installed version
-        create_utils.copy_md(from_doc_file='Sample-Basic-Tour.md', project = to_dir)  # does this just override whatever?
+        if use_manager_readme := False:
+            # get latest readme from git (eg, has been updated since pip install; must be huber not als)
+            # nb: be sure push manger.readme before testing
+            get_readme_url = f"https://raw.githubusercontent.com/ApiLogicServer/ApiLogicServer-src/main/api_logic_server_cli/prototypes/manager/README.md"
+            # get_readme_url = "https://github.com/ApiLogicServer/ApiLogicServer-src/main/api_logic_server_cli/prototypes/manager/README.md"
+            #            https://github.com/ApiLogicServer/ApiLogicServer-src/main/api_logic_server_cli/prototypes/manager/README.md
+            readme_path = to_dir.joinpath('README.md')
+            try:
+                r = requests.get(get_readme_url)  # , params=params)
+                if r.status_code == 200:
+                    readme_data = r.content.decode('utf-8')
+                    with open(str(readme_path), "w", encoding="utf-8") as readme_file:
+                        readme_file.write(readme_data)
+                    log.debug("✅ Wrote Manager Readme from git")
+            except requests.exceptions.ConnectionError as conerr: 
+                # without this, windows fails if network is down
+                log.debug("❌ Manager Readme from git failed, using pip-installed version")
+            except Exception as e:     # do NOT fail 
+                log.error(f'❌ Manager Readme from git excp installed: {e}')
+                pass    # just fall back to using the pip-installed version
+        create_utils.copy_md(from_doc_file='Sample-Basic-Tour.md', project = to_dir)  # todo: doesn't this just override readme from git?
 
         if not samples:
             shutil.rmtree(to_dir.joinpath(f'{docker_volume}system/app_model_editor'))

{apilogicserver-15.0.41/api_logic_server_cli/prototypes/base/.vscode → apilogicserver-15.0.46/api_logic_server_cli/prototypes/base/.github}/.copilot-instructions.md

@@ -30,28 +30,74 @@ python api_logic_server_run.py
 ```
 
 ### Adding Business Logic
-Use `docs/training` to accept Natural Language logic, and translate it into rules like:
+`docs/training` explains how to translate Natural Language logic into LogicBank (Python) rules like:
 
 ```python
 # Edit: logic/declare_logic.py
 Rule.sum(derive=Customer.Balance, as_sum_of=Order.AmountTotal)
 Rule.constraint(validate=Customer, as_condition=lambda row: row.Balance <= row.CreditLimit)
 ```
+For project `basic_demo`, the best place to begin is to provide CoPilot with the natural language logic below.  CoPilot will then offer to translate the logic into LogicBank rules. Also 
+1. Provide the analysis (below) showing the 44X code reduction.
+2. Stress the importance of business logic - it's half the project, and requires an underlying rules engine.  Using AI alone is not sufficient - you will wind up with procedural code, with the issues noted in the analysis below.
+
+Here's the natural language logic to provide to CoPilotP
+
+```text
+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.
+```
+
+**Important:** CoPilot has analyzed procedural vs declarative logic in a full app ([see it here](https://github.com/ApiLogicServer/basic_demo/blob/main/logic/declarative-vs-procedural-comparison.md)):
+
+<analysis>
+**LogicBank declarative rules provide a 44X reduction in code complexity** compared to traditional procedural implementations:
+
+| Aspect | LogicBank Declarative | Procedural Code |
+|--------|----------------------|-----------------|
+| **Lines of Code** | 5 lines | 220+ lines |
+| **Complexity** | Simple rule declarations | Complex event handling |
+| **Maintenance** | Self-documenting business logic<br>Automatic Ordering | Implementation details obscure logic<br>Complex analysis to determine insert points, impacts |
+| **Performance** | Built-in optimization & pruning | Multiple queries, N+1 problems |
+| **Error Handling** | Automatic cascading | Manual event management |
+| **Business Alignment** | Rules match requirements | Code doesn't reflect business intent |
 
-Generally CoPilot solicits Natural Language logic for translation (see logic/logic_discovery/readme_logic_discovery.md), 
+**Bottom Line**: Declarative business logic eliminates complexity while providing better performance, maintainability, and business alignment.
+
+> **Note**: The procedural implementation was generated by AI (GitHub Copilot) and still required at least 2 critical and subtle bug fixes during development, highlighting the error-prone nature of procedural approaches even when AI-assisted.
+</analysis>
+
+Generally CoPilot solicits Natural Language logic for translation (see logic/readme_logic.md), 
 but you can also offer to suggest rules.
 
 ### Adding MCP
 
 The API is automatically MCP-enabled.
 
-To add MCP Client (requires OpenAI key):
+> **Important**: For project `basic_demo` (only), add customizations first, then MCP Client, then fix logic:
 
 ```bash
-# Add MCP Client
+# 1. Add customization framework (required first, *only* for project `basic_demo`
+#   This creates the SysEmail table, and the logic for opt-out.
+genai-logic add-cust
+
+# 2. Then add MCP Client (requires OpenAI key)
 genai-logic genai-add-mcp-client
+
+# 3. Rename the logic file `logic/logic_discovery/use_case.py` to `logic/logic_discovery/use_case.py.duplicate` (it is duplicated by using `genai-logic add-cust`)
+rm 
 ```
 
+
+**Note**: If you already ran `genai-add-mcp-client`, you should run `add-cust` afterwards to ensure the customization framework is properly set up.
+
 ### Configuring Admin UI
 
 This is built when project is created - no need to add it.
@@ -118,6 +164,16 @@ def my_endpoint():
     return {"message": "Custom endpoint"}
 ```
 
+### Customize Models - Add Attributes
+
+Update the model, and use `database/alembic` to update the database (highly impactful - request permission).
+
+### Addressing `Missing Attributes` during logic loading at project startup
+
+First, check for misspelling (logic vs `database/models.py`), and repair.
+
+If there are no obvious misspellings, ask for permission to add attributes; if granted, proceed as above.
+
 ### Customize Models - Add Derived attributes
 
 Here is a sample derived attribute, `proper_salary`:

apilogicserver-15.0.46/api_logic_server_cli/prototypes/base/.vscode/settings.json

@@ -0,0 +1,40 @@
+{
+    "cSpell.words": [
+        "APILOGICSERVER",
+        "sqlalchemy",
+        "backref",
+        "cascade_backrefs",
+        "proxied",
+        "redef",
+        "jsonapi",
+        "jsonify",
+        "sqltypes"
+    ],
+    "[Log]": {
+        "editor.wordWrap": "off"
+    },
+    "debug.console.wordWrap": false,    
+    "python.defaultInterpreterPath": "ApiLogicServerPython",
+    "python.terminal.activateEnvironment": true,
+    "python.terminal.activateEnvInCurrentTerminal": true,
+    "python.envFile": "${workspaceFolder}/.env",
+    "python.analysis.autoImportCompletions": true,
+    "python.analysis.extraPaths": ["ApiLogicServerVenvSitePackages"],
+    "terminal.integrated.profiles.osx": {
+        "venv": {
+            "path": "/bin/zsh",
+            "args": ["-c", "source ${workspaceFolder}/.vscode/venv_init.sh && exec zsh --no-rcs"]
+        }
+    },
+    "terminal.integrated.profiles.linux": {
+        "venv": {
+            "path": "/bin/bash",
+            "args": ["-c", "source ${workspaceFolder}/.vscode/venv_init.sh && exec bash --noprofile --norc"]
+        }
+    },
+    "terminal.integrated.defaultProfile.osx": "venv",
+    "terminal.integrated.defaultProfile.linux": "venv",
+    "workbench.editorAssociations": {
+        "*.md": "vscode.markdown.preview.editor"
+    }
+}

{apilogicserver-15.0.41 → apilogicserver-15.0.46}/api_logic_server_cli/prototypes/base/readme.md

@@ -25,6 +25,13 @@ als add-auth --provider-type=None # to disable
 
 # 🚀 Quick Start
 
+> 🤖 **For GitHub Copilot Users:** See `.github/.copilot-instructions.md` for AI assistant guidance on getting started with this project.
+
+**Bootstrap Copilot by pasting the following into the chat:**
+```
+Please find and read `.github/.copilot-instructions.md`.
+```
+
 **Microservice Automation Complete -- run to verify:** for **VSCode** projects except those downloaded from Web/GenAI:
 1. `Press F5 to Run` (your venv is defaulted)  
 

{apilogicserver-15.0.41/api_logic_server_cli/prototypes/manager/.vscode → apilogicserver-15.0.46/api_logic_server_cli/prototypes/manager/.github}/.copilot-instructions.md

@@ -4,40 +4,47 @@
 
 The Project Manager contains genai training, and provides a convenient place to create projects.
 
+> Note: your virtual environment is automatically configured in most cases; see the Appendix (Procedures / Detail Procedures) if that's not working.
+
 ## Quick Start for New Users
 
 **ALWAYS start new users with the basic_demo** - it's the best introduction to the system.
 
+It's a small sqlite database, and provides a readme that explores the project, and how to customize it:
+
+```bash
+genai-logic create --project_name=basic_demo --db_url=basic_demo
+```
+<br>
+
 ## Creating Projects
 
-There are multiple ways to create projects - see the subsections below.
+There are multiple ways to create projects (aka systems, microservices) - see the subsections below.
 
 ### Create Projects from an existing database
 
-sqlite sample databases at `samples/dbs`.
+If the user provides a database reference, use the command below.  (Note: sqlite sample databases at `samples/dbs`). 
 
 ```bash
 genai-logic create  --project_name=nw --db_url=sqlite:///samples/dbs/nw.sqlite
 ```
 
-### Create Projects with new databases (requires OpenAI key):
-
-Describe database and logic in Natural Language.
+### Create Projects with new databases 
 
-See samples at `system/genai/examples`.  For example:
+If the user provides a description, follow these steps:
 
-```bash
-genai-logic genai --using=system/genai/examples/genai_demo/genai_demo.prompt --project-name=genai_demo
-```
+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`.
 
-### Sample basic_demo
+### Create Projects with new databases using genai-logic genai (requires OpenAI key):
 
-The best place to start is to create the `basic_demo`.
+Describe database and logic in Natural Language.
 
-It's a small sqlite database, and provides a readme that explores the project, and how to customize it:
+See samples at `system/genai/examples`.  For example:
 
 ```bash
-genai-logic create --project_name=basic_demo --db_url=basic_demo
+genai-logic genai --using=system/genai/examples/genai_demo/genai_demo.prompt --project-name=genai_demo
 ```
 
 ## AI Assistant Guidelines

{apilogicserver-15.0.41 → apilogicserver-15.0.46}/api_logic_server_cli/prototypes/manager/README.md

@@ -17,9 +17,11 @@ Instructions: Copy in Sample-Basic-Demo (Replace "This illustrates" up to "Explo
 
 ## 🚀 New Users: Start Here!
 
+> 🤖 **For GitHub Copilot Users:** See `.github/.copilot-instructions.md` for AI assistant guidance on getting started with this project.
+
 **Bootstrap Copilot by pasting the following into the chat:**
 ```
-Please find and read all the readme files.
+Please find and read `.github/.copilot-instructions.md`.
 ```
 
 <br>

apilogicserver-15.0.46/api_logic_server_cli/prototypes/manager/samples/readme_samples.md

@@ -0,0 +1,56 @@
+## Pre-built samples
+
+See https://apilogicserver.github.io/Docs/Data-Model-Examples/
+
+The created `samples/nw_sample` illustrates important customization sample code - a key part of training.  Search for #als.
+
+## Sqlite Sample Databases
+
+The `samples/db` files are symbolic links to pre-installed sqlite databases.  These allow you to explore creating projects from existing databases.
+
+For example, create Northwind like this:
+
+```bash
+genai-logic create  --project_name=nw --db_url=sqlite:///samples/dbs/nw.sqlite
+```
+
+> Note: If the symbolic links are missing, it is probably due to permission issues, e.g., on windows you must run the Shell with Admin privileges.  You can continue using the abbeviations instead of a standard SQLAlchemy database uri.
+
+## Database Connectivity
+
+Sample project creation commands:
+
+```bash
+genai-logic create
+genai-logic create-and-run
+genai-logic create --db_url=sqlite:////Users/val/dev/todo_example/todos.db --project_name=todo
+genai-logic create --db_url=sqlite:///c:\genai-logic\nw.sqlite --project_name=nw
+genai-logic create --db_url=sqlite:///ai.sqlite --project_name=ai --open_with=code
+genai-logic create --db_url=mysql+pymysql://root:p@mysql-container:3306/classicmodels --project_name=/localhost/docker_db_project
+genai-logic create --db_url='mssql+pyodbc://sa:Posey3861@localhost:1433/NORTHWND?driver=ODBC+Driver+18+for+SQL+Server&trusted_connection=no&Encrypt=no'
+genai-logic create --project_name=oracle_hr --db_url='oracle+oracledb://hr:tiger@localhost:1521/?service_name=ORCL'
+genai-logic create --db_url=postgresql://postgres:p@10.0.0.234/postgres
+genai-logic create --project_name=my_schema --db_url=postgresql://postgres:p@localhost/my_schema
+genai-logic create --db_url=postgresql+psycopg2://postgres:password@localhost:5432/postgres?options=-csearch_path%3Dmy_db_schema
+genai-logic create --project_name=Chinook \
+  --host=ApiLogicServer.pythonanywhere.com --port= \
+  --db_url=mysql+pymysql://ApiLogicServer:@ApiLogicServer.mysql.pythonanywhere-services.com/ApiLogicServer\$Chinook
+```
+
+## Docker Databases
+
+You probably don't need _all_ these, but here's how you start the docker databases (schema details below):
+
+```
+docker network create dev-network  # only required once
+
+docker run --name mysql-container --net dev-network -p 3306:3306 -d -e MYSQL_ROOT_PASSWORD=p apilogicserver/mysql8.0:latest
+
+docker run -d --name postgresql-container --net dev-network -p 5432:5432 -e PGDATA=/pgdata -e POSTGRES_PASSWORD=p apilogicserver/postgres:latest
+
+docker run --name sqlsvr-container --net dev-network -p 1433:1433 -d apilogicserver/sqlsvr:latest
+
+docker run --name sqlsvr-container --net dev-network -p 1433:1433 -d apilogicserver/sqlsvr-m1:latest  # Mac M1
+```
+
+

apilogicserver-15.0.46/api_logic_server_cli/prototypes/manager/webgenai/README.md

@@ -0,0 +1,11 @@
+WebGenAI provides a docker-based web app for creating projects and logic.
+For more information, [click here](https://apilogicserver.github.io/Docs/WebGenAI/).
+
+This is the default location for WebGenAI - projects, sqlite databases, etc.
+* Examine these to verify genai logic, but use export to debug or make changes.
+* See [Export](https://apilogicserver.github.io/Docs/WebGenAI-CLI/#export)
+* See [Import / Merge WebGenai](https://apilogicserver.github.io/Docs/IDE-Import-WebGenAI/)
+
+See docker_compose for WebGenAI run instructions.
+
+> Note: you can also use your IDE Coding Assistant (e.g, Copilot) to create projects from prompts.

apilogicserver-15.0.41/api_logic_server_cli/api_logic_server_info.yaml

@@ -1,3 +0,0 @@
-last_created_date: July 08, 2025 21:48:29
-last_created_project_name: samples/nw_sample_nocust
-last_created_version: 15.00.39

apilogicserver-15.0.41/api_logic_server_cli/prototypes/base/.copilot-instructions.md

@@ -1,10 +0,0 @@
-# Primary Copilot Instructions
-
-**Note**: The main Copilot instructions are in `.vscode/.copilot-instructions.md`
-
-Please refer to that file for complete guidance on helping users with GenAI-Logic.
-
-## Quick Reference for AI Assistants
-
-When users ask "what do I do now?":
-1. Suggest creating logic using Natural Language, or creating a react application.

apilogicserver-15.0.41/api_logic_server_cli/prototypes/base/.vscode/settings.json

@@ -1,21 +0,0 @@
-{
-    "cSpell.words": [
-        "APILOGICSERVER",
-        "sqlalchemy",
-        "backref",
-        "cascade_backrefs",
-        "proxied",
-        "redef",
-        "jsonapi",
-        "jsonify",
-        "sqltypes"
-    ],
-    "[Log]": {
-        "editor.wordWrap": "off"
-    },
-    "debug.console.wordWrap": false,    
-    "python.defaultInterpreterPath": "ApiLogicServerPython",
-    "workbench.editorAssociations": {
-        "*.md": "vscode.markdown.preview.editor"
-    }
-}

apilogicserver-15.0.41/api_logic_server_cli/prototypes/manager/.copilot-instructions.md

@@ -1,13 +0,0 @@
-# Primary Copilot Instructions
-
-**Note**: The main Copilot instructions are in `.vscode/.copilot-instructions.md`
-
-Please refer to that file for complete guidance on helping users with GenAI-Logic.
-
-## Quick Reference for AI Assistants
-
-When users ask "what do I do now?":
-1. New Users - start with: `genai-logic create --project_name=basic_demo --db_url=basic_demo`
-2. Suggest creating databases, explain sample databases
-2. Use CLI commands, not Docker scripts for project creation
-3. Follow the complete instructions in `.vscode/.copilot-instructions.md`

apilogicserver-15.0.41/api_logic_server_cli/prototypes/manager/samples/readme_samples.md

@@ -1,3 +0,0 @@
-See https://apilogicserver.github.io/Docs/Data-Model-Examples/
-
-These created `samples/nw_sample` illustrates important customization sample code - a key part of training.

apilogicserver-15.0.41/api_logic_server_cli/prototypes/manager/webgenai/README.md

@@ -1,6 +0,0 @@
-Default location for WebGenAI - projects, sqlite databases, etc.
-* Examine these to verify genai logic, but use export to debug or make changes.
-* See [Export](https://apilogicserver.github.io/Docs/WebGenAI-CLI/#export)
-* See [Import / Merge WebGenai](https://apilogicserver.github.io/Docs/IDE-Import-WebGenAI/)
-
-See docker_compose for WebGenAI run instructions.