ApiLogicServer 15.0.65__py3-none-any.whl → 15.1.0__py3-none-any.whl

api_logic_server_cli/api_logic_server.py

@@ -12,11 +12,11 @@ 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.65"  # last public release: 15.00.52 (15.00.12)
+__version__ = "15.01.00"  # last public release: 15.00.65
 recent_changes = \
     f'\n\nRecent Changes:\n' +\
+    "\t08/09/2024 - 15.01.00: improved vibe instructions \n"\
     "\t08/06/2024 - 15.00.65: instructions for custom API endpoints, behave testing \n"\
-    "\t07/30/2024 - 15.00.62: rename for clarity, no mgr fix, confluent-kafka==2.6.0 for 3.13, system vibe support -- initial testing \n"\
     "\t07/20/2024 - 15.00.52: Python 3.13 compatibility fixes - psycopg2→psycopg3, SQLAlchemy 2.0+, pkg_resources→importlib.metadata.  mgr dbs \n"\
     "\t07/17/2024 - 15.00.49: venv fix+, ext bldr * 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"\

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

@@ -106,7 +106,9 @@ but you can also offer to suggest rules.
 **IMPORTANT**: The project uses automated discovery systems that:
 
 **Logic Discovery:**
-1. **Automatically loads business logic** from `logic/logic_discovery/use_case.py`
+1. **Automatically loads business logic** from `logic/logic_discovery/*.py`
+    * **CRITICAL: Always create separate files named for each use case** (e.g., `check_credit.py`, `app_integration.py`)
+    * **Never put multiple use cases in `use_case.py`** - that file is for templates/examples only
 2. **Discovers rules at startup** via `logic/logic_discovery/auto_discovery.py`
 3. **No manual rule loading required** - the `discover_logic()` function automatically finds and registers rules
 
@@ -132,14 +134,35 @@ def declare_logic():
     # ... other rules
 ```
 
+**PATTERN RECOGNITION for Business Logic**:
+When users provide natural language with multiple use cases like:
+- "Use case: Check Credit" + "Use case: App Integration"
+
+**ALWAYS create separate files**:
+- `logic/logic_discovery/check_credit.py` - for credit checking rules
+- `logic/logic_discovery/app_integration.py` - for integration rules
+
+**NEVER put everything in `use_case.py`** - that defeats the discovery system purpose.
+
 ### Adding MCP
 
-The API is automatically MCP-enabled.  This adds the MCP Client:
+The API is automatically MCP-enabled. The project includes a comprehensive MCP client executor at `integration/mcp/mcp_client_executor.py`, but to enable the **user interface** for MCP requests, you must run this command:
 
 ```bash
 genai-logic genai-add-mcp-client
 ```
 
+**CRITICAL DISTINCTION**:
+- **`integration/mcp/mcp_client_executor.py`** = MCP processing engine (already exists)
+- **`genai-logic genai-add-mcp-client`** = Command to add SysMcp table and UI infrastructure (must be run)
+
+**When users ask to "Create the MCP client executor"**, they mean run the `genai-logic genai-add-mcp-client` command, NOT recreate the existing processing engine.
+
+This command adds:
+1. **SysMcp table** for business users to enter natural language requests
+2. **Admin App integration** for MCP request interface
+3. **Database infrastructure** for MCP client operations
+
 ### Configuring Admin UI
 
 This is built when project is created - no need to add it.

api_logic_server_cli/prototypes/manager/.vscode/launch.json

@@ -194,7 +194,8 @@
             "justMyCode": false,
             "program": "api_logic_server_run.py",
             "redirectOutput": true,
-            "console": "integratedTerminal"
+            "console": "integratedTerminal",
+            "internalConsoleOptions": "openOnSessionStart"
         },
         {
             "name": "App Model Editor - Prepare",

api_logic_server_cli/prototypes/manager/samples/basic_demo/.devcontainer-option/For_VSCode.dockerfile

@@ -0,0 +1,10 @@
+# VSCode uses this file to create a development container, for you to customize and test API Logic Projects.
+#
+# Per .devcontainer/devcontainer.json, VSCode will offer to open your API Logic Server Project in this docker container
+#    Same as: View > Command > Remote-Containers: Open Folder in Container.
+#
+# https://apilogicserver.github.io/Docs/DevOps-Docker/
+#
+FROM apilogicserver/api_logic_server
+USER api_logic_server
+CMD ["bash"]

api_logic_server_cli/prototypes/manager/samples/basic_demo/.devcontainer-option/devcontainer.json

@@ -0,0 +1,64 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the README at:
+// https://github.com/microsoft/vscode-dev-containers/tree/v0.194.0/containers/docker-existing-dockerfile
+{
+	"name": "Existing Dockerfile",
+
+	// Sets the run context to one level up instead of the .devcontainer folder.
+	"context": "..",
+
+	// Update the 'dockerFile' property if you aren't using the standard 'Dockerfile' filename.
+	"dockerFile": "For_VSCode.dockerfile",
+
+	// Set *default* container specific settings.json values on container create.
+	// "settings": {},
+
+	// add network -- enable this as required, e.g., https://apilogicserver.github.io/Docs/Database-Connectivity/
+	// "runArgs": ["--network=dev-network"],
+
+	// Add the IDs of extensions you want installed when the container is created.
+	// "extensions": [],   **** Note - Python added in customizations (autoloads Python in devcontainer)
+
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                "ms-python.python",
+                "ms-python.vscode-pylance",
+                "ms-python.black-formatter",
+                "ms-python.flake8",
+                "ms-python.isort",
+				// "ms-python.debugpy",
+				"atariq11700.debugpy-old"
+            ],
+            "settings": {
+                "python.defaultInterpreterPath": "/usr/local/bin/python"
+            }
+        }
+    },
+	
+	"portsAttributes": {
+		"5656": {
+			"label": "AdminApp"
+		}
+	},
+
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	"forwardPorts": [5656],
+	
+	"features": {
+		"github-cli": "latest"
+	  }
+
+	// "postAttachCommand": "/bin/bash .devcontainer/setup.sh"
+
+	// Uncomment the next line to run commands after the container is created - for example installing curl.
+	// "postCreateCommand": "apt-get update && apt-get install -y curl",
+
+	// Uncomment when using a ptrace-based debugger like C++, Go, and Rust
+	// "runArgs": [ "--cap-add=SYS_PTRACE", "--security-opt", "seccomp=unconfined" ],
+
+	// Uncomment to use the Docker CLI from inside the container. See https://aka.ms/vscode-remote/samples/docker-from-docker.
+	// "mounts": [ "source=/var/run/docker.sock,target=/var/run/docker.sock,type=bind" ],
+
+	// Uncomment to connect as a non-root user if you've added one. See https://aka.ms/vscode-remote/containers/non-root.
+	// "remoteUser": "vscode"
+}

api_logic_server_cli/prototypes/manager/samples/basic_demo/.devcontainer-option/readme.md

@@ -0,0 +1 @@
+Rename (remove *-option*) to use [dev containers](https://apilogicserver.github.io/Docs/DevOps-Docker/).

api_logic_server_cli/prototypes/manager/samples/basic_demo/.devcontainer-option/setup.sh

@@ -0,0 +1,10 @@
+# echo "gh codespace ports -c $CODESPACE_NAME" >> ~/.bashrc
+
+if [ -z "$CODESPACE_NAME" ]
+then
+    echo "devcontainer ready with defined ports"
+else
+    echo ".devcontainer/setup: port creation..."
+    gh codespace ports visibility 5656:public -c $CODESPACE_NAME
+    echo ".devcontainer/setup: port created"
+fi

api_logic_server_cli/prototypes/manager/samples/basic_demo/.env

@@ -0,0 +1,4 @@
+# Virtual Environment Configuration
+VIRTUAL_ENV=/Users/val/dev/ApiLogicServer/ApiLogicServer-dev/build_and_test/ApiLogicServer/venv
+PATH=/Users/val/dev/ApiLogicServer/ApiLogicServer-dev/build_and_test/ApiLogicServer/venv/bin:$PATH
+PYTHONPATH=/Users/val/dev/ApiLogicServer/ApiLogicServer-dev/build_and_test/ApiLogicServer/venv/lib/python3.13/site-packages