ApiLogicServer 15.0.28__py3-none-any.whl → 15.0.33__py3-none-any.whl

api_logic_server_cli/add_cust/add_cust.py

@@ -158,7 +158,7 @@ def add_basic_demo_customizations(project: Project, do_show_messages: bool = Tru
         # log.info(".. curl -X 'POST' 'http://localhost:5656/api/SysMcp/' -H 'accept: application/vnd.api+json' -H 'Content-Type: application/json' -d '{ \"data\": { \"attributes\": {\"request\": \"List the orders date_shipped is null and CreatedOn before 2023-07-14, and send a discount email (subject: '\\''Discount Offer'\\'') to the customer for each one.\"}, \"type\": \"SysMcp\"}}'")
         log.info('')
         log.info(f'Next Steps: activate security')
-        log.info(f'..ApiLogicServer add-auth --db_url=auth')
+        log.info(f'..genai-logic add-auth --db_url=auth')
         if project.is_tutorial == False:
             log.info(".. complete\n")
 
@@ -178,7 +178,7 @@ def add_basic_demo_iteration(project: Project, do_show_messages: bool = True, do
     create_utils.recursive_overwrite(nw_path, project.project_directory)  # ~/dev/ApiLogicServer/ApiLogicServer-dev/servers/basic_demo
     if do_show_messages:
         log.info("\nNext Step:")
-        log.info(f'..ApiLogicServer rebuild-from-database --db_url=sqlite:///database/db.sqlite')
+        log.info(f'..genai-logic rebuild-from-database --db_url=sqlite:///database/db.sqlite')
         log.info(".. complete\n")
 
 
@@ -210,7 +210,7 @@ def add_sample_ai_customizations(project: Project, do_show_messages: bool = True
         log.info(f'..logic/declare_logic.py')
         log.info(f'..security/declare_security.py\n')
         log.info(f'Next Steps: activate security')
-        log.info(f'..ApiLogicServer add-auth --db_url=auth')
+        log.info(f'..genai-logic add-auth --db_url=auth')
         if project.is_tutorial == False:
             log.info(".. complete\n")
 
@@ -230,7 +230,7 @@ def add_sample_ai_iteration(project: Project, do_show_messages: bool = True, do_
     create_utils.recursive_overwrite(nw_path, project.project_directory)  # '/Users/val/dev/ApiLogicServer/ApiLogicServer-dev/org_git/tutorial/1. Instant_Creation'
     if do_show_messages:
         log.info("\nNext Step:")
-        log.info(f'..ApiLogicServer rebuild-from-database --project_name=./ --db_url=sqlite:///database/db.sqlite')
+        log.info(f'..genai-logic rebuild-from-database --project_name=./ --db_url=sqlite:///database/db.sqlite')
         log.info(".. complete\n")
 
 

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.00.28"  # last public release: 15.00.25 (15.00.12)
+__version__ = "15.00.33"  # last public release: 15.00.25 (15.00.12)
 recent_changes = \
     f'\n\nRecent Changes:\n' +\
-    "\t06/26/2024 - 15.00.28: Tech Preview: als genai-app w/ sra provider+model+grid_cascadeAdd, imports+, bug [96] \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"\
     "\t06/08/2024 - 15.00.10: MCP, optional shortening of stacktrace lines, bugfix[92] \n"\
     "\t05/16/2024 - 14.05.00: safrs 3.1.7, running mcp preview \n"\
@@ -946,9 +946,16 @@ class ProjectRun(Project):
                     defaultInterpreterPath = self.api_logic_server_dir_path.parent.parent.parent.joinpath('clean/ApiLogicServer/venv/bin/python')
         self.default_interpreter_path = defaultInterpreterPath
         """ used to compute manager_path """
-        self.manager_path = self.default_interpreter_path.parent.parent.parent
-        log.debug(f'.. ..Manager path: {self.manager_path}')  # eg ApiLogicServer/ApiLogicServer-dev/clean/ApiLogicServer
-        log.debug(f'.. ..Interp path: manager_path / venv/bin/python')
+        self.venv_path = Path(sys.prefix) if is_docker() == False else Path('/home/api_logic_server/api_logic_server_cli')
+        self.manager_path = self.venv_path.parent
+        check_system_genai = self.manager_path.joinpath('system/genai/temp')
+        if not check_system_genai.exists():
+            self.manager_path = (self.venv_path / '../api_logic_server_cli/prototypes/manager').resolve()
+            log.debug(f'.. ..Manager path from dev env - customizations not active')  # eg ...ApiLogicServer-src/api_logic_server_cli/prototypes/manager
+        log.debug(f'.. ..Manager path: {self.manager_path}')  
+        # log.debug(f'.. ..Interp path: {self.manager_path / 'venv/bin/python'}')
+        if sys.prefix == sys.base_prefix:
+            log.warning(f'.. ..Warning - venv not being used: {self.venv_path}')
 
         self.api_logic_server_home = self.api_logic_server_dir_path.parent
 
@@ -1591,6 +1598,14 @@ from database import <project.bind_key>_models
             log.debug("1. Not Deleting Existing Project")
             log.debug("2. Using Existing Project")
             if self.command == "add_db":
+                check_bind_key_exists = 'DATABASE_URI_' + self.bind_key.upper()
+                config_path = self.project_directory_path / 'config/config.py'
+                bind_key_exists = create_utils.does_file_contain(in_file=config_path,
+                                                                 search_for=check_bind_key_exists)
+                if bind_key_exists and self.bind_key != 'authentication':
+                    log.error(f'\nLooks like database already added')
+                    log.error(f'..`{check_bind_key_exists}` found in `config/config.py`\n\n')
+                    sys.exit(1)
                 self.abs_db_url = self.update_config_and_copy_sqlite_db(
                     f".. ..Adding Database [{self.bind_key}] to existing project")
         else:                                                                            # normal path - clone, [overlay nw]

api_logic_server_cli/api_logic_server_info.yaml

@@ -1,3 +1,3 @@
-last_created_date: June 26, 2025 08:44:28
-last_created_project_name: ../../../servers/mycircles
-last_created_version: 15.00.26
+last_created_date: June 30, 2025 09:36:49
+last_created_project_name: samples/nw_sample_nocust
+last_created_version: 15.00.32

api_logic_server_cli/cli.py

@@ -12,6 +12,8 @@ To add a new arg:
     * update Project.run() 
 
 Main code is api_logic_server.py (PR)
+
+To expand commands: ctx.forward(existing_command))
 '''
 
 from contextlib import closing
@@ -447,7 +449,7 @@ def curl_test(ctx, message):
               help="App directory name")
 @click.option('--admin-app', 'admin_app',
               default='admin',
-              help="Input admin app")
+              help="Input admin app (schema)")
 @click.pass_context
 def app_create(ctx, project_name, app, admin_app):
     """
@@ -778,13 +780,16 @@ def genai_graphics(ctx, using, genai_version: str, replace_with: str):
     pass
     log.info("")
 
-
-
-
-@main.command("genai-app", cls=HideDunderCommand)
+@main.command("genai-add-app", cls=HideDunderCommand)
 @click.option('--app-name', 'app_name',
               default='react_app',
               help="Name of generated app in ui/")
+@click.option('--vibe/--no-vibe',
+              default=True, is_flag=True,
+              help="Show vibe docs")
+@click.option('--retries',
+              default=1,
+              help="lint retries - 1 means none (see setup)")
 @click.option('--schema',
               default='admin.yaml',
               help="Model file in ui/admin/")
@@ -792,9 +797,9 @@ def genai_graphics(ctx, using, genai_version: str, replace_with: str):
               default='gpt-4o',
               help="Eg, gpt-3.5-turbo, gpt-4o")
 @click.pass_context
-def genai_admin_app(ctx, app_name: str, schema: str, genai_version: str):
+def genai_add_app(ctx, app_name: str, vibe: click.BOOL, retries: int, schema: str, genai_version: str):
     """
-        Adds a customizable react app to project
+        Creates a customizable react app in ui/, ready for vibe
     """
     global command
     project_dir = resolve_blank_project_name('')
@@ -817,11 +822,57 @@ def genai_admin_app(ctx, app_name: str, schema: str, genai_version: str):
         log.info(f'... Typical usage - cd into project, use --project_name=. \n')
         exit (1)
     from api_logic_server_cli.genai.genai_admin_app import GenAIAdminApp
-    genai_admin = GenAIAdminApp(project=project, app_name=app_name, schema=schema, genai_version=genai_version)
+    genai_admin = GenAIAdminApp(project=project, app_name=app_name, vibe=vibe, schema=schema, retries=retries, genai_version=genai_version)
+    pass
+    log.info("")
+
+
+@main.command("genai-add-mcp-client", cls=HideDunderCommand)
+@click.option('--admin-app', is_flag=True,
+              default=True,
+              help="Update Admin App")
+@click.pass_context
+def genai_add_mcp_client(ctx, admin_app: click.BOOL):
+    """
+        Adds mcp-client to project: db, logic, admin app
+    """
+    global command
+
+    project_name = resolve_blank_project_name('')
+    log.info("")
+
+    mcp_db_path = get_api_logic_server_path().joinpath("database/mcp.sqlite")
+    assert mcp_db_path.exists(), "Unable to find api_logic_server_cli/database/mcp.sqlite"
+    mcp_uri = fr"sqlite:////{str(mcp_db_path)}"
+    project = PR.ProjectRun(command="add_db", 
+              project_name=project_name, 
+              api_name='api', 
+              db_url=mcp_uri, 
+              bind_key='mcp',
+              bind_key_url_separator=default_bind_key_url_separator
+              )
+    print("MCP DB Added")
+
+    project.project_directory, project.api_name, project.merge_into_prototype = \
+        create_utils.get_project_directory_and_api_name(project)
+    project.project_directory_actual = os.path.abspath(os.getcwd())  # make path absolute, not relative (no /../)
+    project.project_directory_path = Path(project.project_directory_actual)
+    models_py_path = project.project_directory_path.joinpath('database/models.py')
+    project.abs_db_url, project.nw_db_status, project.model_file_name = \
+        create_utils.get_abs_db_url("0. Using Sample DB", project, is_auth=True)
+
+    if not models_py_path.exists():
+        log.info(f'... Error - does not appear to be a project: {str(project.project_directory_path)}')
+        log.info(f'... Typical usage - cd into project, use --project_name=. \n')
+        exit (1)
+    from api_logic_server_cli.genai.genai_mcp import GenMCP
+    genai_mcp = GenMCP(project=project, admin_app=admin_app, api_logic_server_path=get_api_logic_server_path())
     pass
+
     log.info("")
 
 
+
 @main.command("genai-create", cls=HideDunderCommand) 
 @click.option('--project-name', 'project_name',
               default=f'{last_created_project_name}',
@@ -1386,7 +1437,7 @@ def rebuild_from_database(ctx, project_name: str, db_url: str, api_name: str, no
 \b
         ex
 \b
-        ApiLogicServer rebuild-from-database --project_name=~/dev/servers/ApiLogicProject --db_url=nw
+        genai-logic rebuild-from-database --project_name=~/dev/servers/ApiLogicProject --db_url=nw
 
     """
     db_types = ""
@@ -2053,7 +2104,7 @@ def check_ports():
 
 
 def start():               # target of setup.py
-    sys.stdout.write("\nWelcome to API Logic Server " + PR.__version__ + "\n\n")
+    sys.stdout.write("\nWelcome to Genai-Logic " + PR.__version__ + "\n\n")
     hostname, local_ip = check_ports()  #  = socket.gethostname()
     # sys.stdout.write("    SQLAlchemy Database URI help: https://docs.sqlalchemy.org/en/14/core/engines.html\n")
     main(obj={})

api_logic_server_cli/cli_args_base.py

@@ -1,5 +1,5 @@
 from enum import Enum
-
+from pathlib import Path
 
 class ExtendedEnum(Enum):
     """

api_logic_server_cli/create_from_model/dbml.py

@@ -210,7 +210,7 @@ class DBMLCreator(object):
         # copy mcp learning from manager (to enable user to extend)
         docs_path = Path(self.mod_gen.project_directory).joinpath('docs')
         docs_path.mkdir(parents=True, exist_ok=True)
-        mcp_learning_src = genai_svcs.get_manager_path(use_env=True).joinpath('system/genai/mcp_learning')
+        mcp_learning_src = genai_svcs.get_manager_path(project=self.mod_gen.project).joinpath('system/genai/mcp_learning')
         mcp_learning_dst = Path(self.mod_gen.project_directory).joinpath('docs/mcp_learning')
         if mcp_learning_dst.exists():
             shutil.rmtree(mcp_learning_dst)

api_logic_server_cli/create_from_model/ont_create.py

@@ -120,6 +120,11 @@ class OntCreator(object):
             if each_resource["hidden"] == True:
                 continue
             each_entity = self.create_model_entity(each_resource, resources=resources)
+            is_missing = not each_resource_name in resources
+            if is_missing:  # might occur with add-db
+                log.warning(f"\n⚠️ Warning - ont_create() finds admin.yaml resource '{each_resource_name}' - not present in database model")
+                log.warning(f"..Can occur when using multiple databases - update your ontimize app as required")
+                continue
             app_model_out.entities[each_resource_name] = each_entity
 
             app_model_out.entities[each_resource_name].columns = []
@@ -249,7 +254,7 @@ class OntCreator(object):
             if compute_type:
                 is_missing = not each_resource_name in resources
                 if is_missing:  # might occur with add-db, using wrong model
-                    sys.exit(f"Sys Err - ont_create missing resource: {each_resource_name}\n\n")
+                    sys.exit(f"❌ Sys Err - ont_create missing resource: {each_resource_name}\n\n")
                 else:
                     resource = resources[each_resource_name]
                     resource_attributes = resource.attributes

api_logic_server_cli/fragments/mcp_admin.yml

@@ -0,0 +1,11 @@
+  mcp-SysMcp:
+    attributes:
+    - name: request
+      type: textarea
+    - label: ' id*'
+      name: id
+      search: true
+      sort: true
+      show_when: isInserting == false
+    type: SysMcp
+    user_key: id

api_logic_server_cli/genai/genai_admin_app.py

@@ -6,7 +6,7 @@ from pathlib import Path
 import importlib
 from api_logic_server_cli.genai.genai_utils import call_chatgpt
 import requests
-import os, time
+import os, time, sys
 import datetime
 import create_from_model.api_logic_server_utils as utils
 import time
@@ -27,6 +27,7 @@ import json
 from pathlib import Path
 from openai import OpenAI
 import yaml
+import subprocess
 import api_logic_server_cli.genai.genai_svcs as genai_svcs
 
 log = logging.getLogger(__name__)
@@ -38,12 +39,15 @@ class JSResponseFormat(BaseModel):  # must match system/genai/prompt_inserts/res
 
 class GenAIAdminApp:
 
-    def __init__(self, project: Project, app_name: str, schema: str, genai_version: str):
+    def __init__(self, project: Project, app_name: str, vibe: bool, schema: str, genai_version: str, retries: int):
         self.start_time = time.time()
         
+        self.project = project
         self.api_version = genai_version
+        self.retries = retries
+
         self.project_root = project.project_directory_path
-        self.app_templates_path = genai_svcs.get_manager_path(use_env=True).joinpath('system/genai/app_templates')
+        self.app_templates_path = genai_svcs.get_manager_path(project=project).joinpath('system/genai/app_templates')
 
         log.info(f'\ngenai_app here..')
         log.info(f'..model: {schema}')
@@ -56,13 +60,18 @@ class GenAIAdminApp:
         self.admin_yaml_path = self.project_root / f"ui/admin/{schema}"
         self.admin_config_prompt_path = self.app_templates_path / f"app_learning/Admin-config-prompt.md"
         self.admin_json_api_model_prompt_path = self.app_templates_path / f"app_learning/Admin-json-api-model-prompt.md"
-        assert self.admin_config_prompt_path.exists(), "sys err - self.admin_config_prompt_path"
-        assert self.admin_json_api_model_prompt_path.exists(), "sys err - self.admin_json_api_model_prompt_path"
+        if not self.admin_config_prompt_path.exists():
+            log.error('\nUnable to find Manager for app_learning/Admin-config-prompt.md')
+            log.error('..Please set env variable APILOGICSERVER_HOME to manager root\n')
+            sys.exit(1)
+        if not self.admin_json_api_model_prompt_path.exists():
+            log.error('\nUnable to find Manager for app_learning/Admin-json-api-model-prompt.md')
+            log.error('..Please set env variable APILOGICSERVER_HOME to manager root\n')
+            sys.exit(1)
 
         self.ui_project_path = self.project_root / f"ui/{app_name}"
         self.ui_src_path = self.ui_project_path / "src"
 
-        self.app_templates_path = genai_svcs.get_manager_path(use_env=True).joinpath('system/genai/app_templates')
         self.react_admin_template_path = self.app_templates_path / 'react-admin-template'
         self.prompts_path = self.app_templates_path / "app_learning"
         # self.admin_app_learning = utils.read_file(self.prompts_path / "Admin-App-Learning-Prompt.md")
@@ -99,6 +108,8 @@ class GenAIAdminApp:
         log.info(f'> cd ui/{app_name}')
         log.info('> npm install')
         log.info('> npm start\n')
+        if vibe:
+            log.info('\n💡 Suggestion: Customize with Vibe: https://apilogicserver.github.io/Docs/Admin-Vibe/#vibe-customization')
 
     def read_standard_imports(self) -> List[str]:
         '''grr
@@ -127,7 +138,6 @@ class GenAIAdminApp:
         def fix_resource(genai_app: GenAIAdminApp, raw_source: str) -> str:
             ''' Remove occasional begin/end code markers <br>
             And horrific override of ChatGPT refusal to generate imports AS DIRECTED!<br>
-            ToDo: lint, and repeat generation if errors detected
             '''
 
             source_lines = raw_source.splitlines()
@@ -140,13 +150,38 @@ class GenAIAdminApp:
                         continue
                     else:
                         break
-                if do_mandatory_imports := True and not imports_done and ' props ' in each_line:
+                if do_mandatory_imports := True and not imports_done and 'props' in each_line:
                     result_lines = list(genai_app.standard_imports)
                     imports_done = True
                 result_lines.append(each_line)              
+            parse_result = True
             # return source_lines as a string
             return "\n".join(result_lines)
 
+        def js_lint_source_code(target_file: Path):
+            # js lint target_file: npx eslint target_file.js
+            # needs: eslint
+            # needs: npm install eslint-plugin-jsdoc
+            # works manually: npx eslint /Users/val/dev/ApiLogicServer/ApiLogicServer-dev/servers/basic_demo/ui/basic_demo_app/src/Customer.js -c .eslintrc.js
+            # failing: Value for 'config' of type 'path::String' required.\nYou're using eslint.config.js
+            config = self.project.api_logic_server_dir_path / 'tools/.eslintrc.js'
+            assert config.exists()
+            try:  
+                result = subprocess.run(
+                    ["npx", "eslint", str(target_file), '-c ' + str(config)[1:]],
+                    capture_output=True,
+                    text=True
+                )
+                if result.returncode == 0:
+                    source_code_fixed = True
+                else:
+                    log.warning(f"ESLint issues in {target_file}:\n{result.stdout}\n{result.stderr}")
+                    source_code_fixed = False
+            except Exception as e:
+                log.warning(f"Could not lint {target_file}: {e}")
+                # If linting fails, assume code is okay to proceed
+                source_code_fixed = True
+            return source_code_fixed
 
         for each_resource_name, each_resource in self.resources.items():
             learning = self.admin_app_resource_learning
@@ -154,20 +189,33 @@ class GenAIAdminApp:
             messages = [
                 {"role": "user", "content": "You are a helpful expert in react and JavaScript"},
                 {"role": "user", "content": learning},
-                # {"role": "user", "content": example_image_content},
-                # {"role": "user", "content": f'Schema:\n{self.schema_yaml}'},
                 {"role": "user", "content": f'Schema:\n{self.schema}'},
                 {"role": "user", "content": f'Generate the full javascript source code for the `{each_resource_name}.js` React Admin file, formatted as a JSResponseFormat'}]
             save_response = self.project_root / f"docs/admin_app/{each_resource_name}"
-            output = genai_svcs.call_chatgpt(messages = messages, 
-                                             api_version=self.api_version,
-                                             using=save_response,
-                                             response_as=JSResponseFormat)
-            response_dict = json.loads(output)
-            target_file = self.ui_src_path / f"{each_resource_name}.js"
-            source_code = fix_resource(self, response_dict['code'])
-            utils.write_file(target_file, source_code)
-            log.info(f"..✅ Wrote: {each_resource_name}.js")
+            retry_number = 0
+            
+            max_retries = 2
+            while retry_number <= self.retries:  # loop until lint succeeds, max retry_number times
+                retry_number += 1
+                output = genai_svcs.call_chatgpt(
+                    messages=messages,
+                    api_version=self.api_version,
+                    using=save_response,
+                    response_as=JSResponseFormat
+                )
+                response_dict = json.loads(output)
+                target_file = self.ui_src_path / f"{each_resource_name}.js"
+                source_code = fix_resource(self, response_dict['code'])
+                utils.write_file(target_file, source_code)
+                source_code_fixed = True
+                if self.retries > 1:  # 1 retry (current , per setup issues) means no lint
+                    source_code_fixed = js_lint_source_code(target_file=target_file)
+                    if source_code_fixed:
+                        break
+            if source_code_fixed:
+                log.info(f"..✅ Wrote: {each_resource_name}.js")
+            else:
+                log.warning(f"..❌ {self.retries} retries did not fix: {each_resource_name}.js")
 
 
     def b_generate_app_js(self):

api_logic_server_cli/genai/genai_mcp.py

@@ -0,0 +1,43 @@
+import shutil
+from typing import Dict, List
+from api_logic_server_cli.cli_args_project import Project
+import logging
+from pathlib import Path
+import importlib
+import requests
+import os, time
+import datetime
+import json
+from typing import List, Dict
+from pydantic import BaseModel
+import create_from_model.api_logic_server_utils as create_utils
+import json
+
+log = logging.getLogger(__name__)
+
+
+class JSResponseFormat(BaseModel):  # must match system/genai/prompt_inserts/response_format.prompt
+    code : str # generated javascript code (only)
+
+
+class GenMCP:
+
+    def __init__(self, project: Project, admin_app: bool, api_logic_server_path: Path):
+        self.start_time = time.time()
+        
+        self.project_root = project.project_directory_path
+
+        log.info(f'\ngenai_mcp here..')
+
+        shutil.copyfile(api_logic_server_path / 'templates/mcp_client_executor_request.py',
+                        project.project_directory_path / 'logic/logic_discovery/mcp_client_executor_request.py')
+        
+        if admin_app:
+            lines = create_utils.read_file(path = api_logic_server_path / 'fragments/mcp_admin.yml')
+            admin_yaml_path = project.project_directory_path / 'ui/admin/admin.yaml'
+            create_utils.insert_lines_at(lines = lines,
+                                         at = 'settings:',
+                                         file_name = admin_yaml_path)
+            pass
+        pass
+

api_logic_server_cli/genai/genai_svcs.py

@@ -966,7 +966,7 @@ def call_chatgpt(messages: List[Dict[str, str]], api_version: str, using: str, r
         log.error(f"\n\nError: ChatGPT call failed\n- please see https://apilogicserver.github.io/Docs/WebGenAI-CLI/#configuratio\n{inst}\n\n")
         sys.exit(1)
 
-def get_manager_path(use_env: bool = False) -> Path:
+def get_manager_path(project: object = None) -> Path:
     """ Checks cwd, parent, and grandparent for system/genai
 
     * Possibly could add cli arg later
@@ -978,46 +978,47 @@ def get_manager_path(use_env: bool = False) -> Path:
         Path: Manager path (contains system/genai)
     """
 
-    if use_env and os.getenv("APILOGICSERVER_HOME") is not None:
-        result_path = Path(os.getenv("APILOGICSERVER_HOME")).joinpath('api_logic_server_cli/prototypes/manager')
+    if project is not None:
+        result_path = project.manager_path
+        check_system_genai = result_path.joinpath('system/genai/temp')    
+        if check_system_genai.exists():
+            return result_path
         return result_path
 
     result_path = Path(os.getcwd())  # normal case - project at manager root
-    check_system_genai = result_path.joinpath('system/genai')    
+    check_system_genai = result_path.joinpath('system/genai/temp')    
     if check_system_genai.exists():
         return result_path
     
     result_path = result_path.parent  # try pwd parent
-    check_system_genai = result_path.joinpath('system/genai')
+    check_system_genai = result_path.joinpath('system/genai/temp')
     if check_system_genai.exists():
         return result_path
     
     result_path = result_path.parent  # try pwd grandparent
-    check_system_genai = result_path.joinpath('system/genai')
+    check_system_genai = result_path.joinpath('system/genai/temp')
     if check_system_genai.exists():
         return result_path
     
     result_path = result_path.parent 
-    check_system_genai = result_path.joinpath('system/genai')
+    check_system_genai = result_path.joinpath('system/genai/temp')
     if check_system_genai.exists():
         return result_path
     
     result_path = result_path.parent  
-    check_system_genai = result_path.joinpath('system/genai')
+    check_system_genai = result_path.joinpath('system/genai/temp')
     if check_system_genai.exists():
         return result_path
     
     result_path = result_path.parent  
-    check_system_genai = result_path.joinpath('system/genai')
+    check_system_genai = result_path.joinpath('system/genai/temp')
     if check_system_genai.exists():
         return result_path
 
     result_path = result_path.parent  # try ancestors - this is for import testing
-    check_system_genai = result_path.joinpath('system/genai')
+    check_system_genai = result_path.joinpath('system/genai/temp')
 
     if not check_system_genai.exists():
-        if use_env:
-            result_path = Path(create_utils.get_api_logic_server_dir()).joinpath('prototypes/manager')
         check_system_genai.exists(), f"Manager Directory not found and APILOGICSERVER_HOME not set: {check_system_genai}"
     return result_path
 

api_logic_server_cli/manager.py

@@ -31,10 +31,35 @@ def create_manager(clean: bool, open_with: str, api_logic_server_path: Path,
         clean (bool): Overlay existing manager (projects and web_genai retained)
         open_with (str): IDE to use
         api_logic_server_path (Path): _description_
-        volume (str, optional): _description_. Defaults to "".
+        volume (str, optional): for docker. Defaults to "".
         open_manager (bool, optional): Whether to open IDE at Manager. Defaults to True.
+        samples (bool, optional): Whether to create large samples (prevent win max file length)
     """    
     
+    def create_sym_links(cli_path: Path, mgr_path: Path):
+        """
+        Creates symbolic links to sample dbs and prompts (clearer than db abbreviations).
+
+        Args:
+            cli_path (Path): loc of cli.py in the manager's venv
+            mgr_path (Path): path of manager being created
+
+        Side Effects:
+            Creates a symbolic link from 'cli_path/database/basic_demo.sqlite' to 'mgr_path/samples/dbs/basic_demo'.
+            Prints a confirmation message upon successful creation.
+
+        Raises:
+            OSError: If the symbolic link cannot be created (e.g., due to permissions or existing link).
+        """
+        
+        # create symbolic link - thanks https://www.geeksforgeeks.org/python/python-os-symlink-method/
+        try:
+            os.symlink(cli_path.parent / 'database/basic_demo.sqlite', mgr_path / 'samples/db/basic_demo.sqlite')
+            print("Link created")
+        except Exception as e:
+            pass
+
+
     log = logging.getLogger(__name__)
 
     project = PR.ProjectRun(command= "start", project_name='ApiLogicServer', db_url='sqlite', execute=False)
@@ -55,6 +80,7 @@ def create_manager(clean: bool, open_with: str, api_logic_server_path: Path,
     log.info(f"\nStarting manager at: {os.getcwd()}")  # eg, ...ApiLogicServer-dev/clean/ApiLogicServer
 
     docker_volume = ''
+    ''' normally volume " '/'  '''
     if project.is_docker:
         # volume typically /ApiLogicServer... % docker run -it --name api_logic_server --rm --net dev-network -p 5656:5656 -p 5002:5002 -v ${PWD}:/ApiLogicServer apilogicserver/api_logic_server
         if do_local_docker_test == False:   # normal path
@@ -161,7 +187,7 @@ def create_manager(clean: bool, open_with: str, api_logic_server_path: Path,
         codegen_logger.setLevel(codegen_logger_save_level)
     pass
 
-    # find cli in subdirectories of the lib path for manager run launches, and update run/debug config
+    # find cli in subdirectories of the lib path for manager run launches, and update `.vscode/launch.json`
     if manager_exists or project.is_docker:
         log.debug(f"    docker -- not updating .env and launch.json\n\n")
     else:
@@ -187,6 +213,7 @@ def create_manager(clean: bool, open_with: str, api_logic_server_path: Path,
         create_utils.replace_string_in_file(search_for = 'cli_path',
                                             replace_with=str(cli_str),
                                             in_file=vscode_launch_path)
+        create_sym_links(cli_path=cli_path, mgr_path=to_dir)
 
     if env_path.exists():
         create_utils.replace_string_in_file(search_for = 'APILOGICSERVER_AUTO_OPEN=code',

api_logic_server_cli/prototypes/base/config/default.env

@@ -6,6 +6,9 @@ SQLAlCHEMY_ECHO = False
 # APILOGICPROJECT_KAFKA_PRODUCER = "{\"bootstrap.servers\": \"localhost:9092\"}"
 # SQLALCHEMY_DATABASE_URI=db.sqlite
 
+# required if you are not running from venv or docker apilogicserver/api_logic_server (eg, azure)
+# APILOGICPROJECT_APILOGICSERVERHOME=src/ApiLogicServer-src
+
 SECURITY_ENABLED = false
 
 # if using tunnel for mcp, function, or ai_plugin

api_logic_server_cli/prototypes/base/devops/docker-compose-dev-azure/azure-deploy.sh

@@ -55,9 +55,9 @@ echo " "
 if [ ! -f "./database/authentication_models.py" ] 
 then
     echo "\nYou need to activate security first.  With you database running, ...\n" 
-    echo "ApiLogicServer add-auth --project_name=. --db_url=mysql+pymysql://root:p@localhost:3306/authdb, or..."
-    echo "ApiLogicServer add-auth --project_name=. --db_url=postgresql://postgres:p@localhost/authdb", or...
-    echo "ApiLogicServer add-auth --project_name=. --db_url=authdb"
+    echo "genai-logic add-auth --project_name=. --db_url=mysql+pymysql://root:p@localhost:3306/authdb, or..."
+    echo "genai-logic add-auth --project_name=. --db_url=postgresql://postgres:p@localhost/authdb", or...
+    echo "genai-logic add-auth --project_name=. --db_url=authdb"
     echo "\nRebuild your image"
     echo "\nThen, stop mysql/postgres containers to avoid port conflicts with services\n"
     exit 1

api_logic_server_cli/prototypes/base/devops/docker-compose-dev-local/docker-compose.sh

@@ -21,7 +21,7 @@ pwd
 if [ ! -f "./../../database/database_discovery/authentication_models.py" ] 
 then
     echo "\nYou need to activate security first.  With mysql-container running...\n" 
-    echo "ApiLogicServer add-auth --project_name=. --db_url=mysql+pymysql://root:p@localhost:3306/authdb"
+    echo "genai-logic add-auth --project_name=. --db_url=mysql+pymysql://root:p@localhost:3306/authdb"
     echo "\nRebuild your image"
     echo "\nThen, stop mysql-container\n"
     exit 1