ApiLogicServer 15.1.2__py3-none-any.whl → 15.2.0__py3-none-any.whl

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:

api_logic_server_cli/prototypes/manager/.github/sync-to-dev-src.sh

@@ -0,0 +1,42 @@
+#!/bin/bash
+
+# Sync training files from basic_demo_2 to dev source templates
+# Run this after updating testing.md or .copilot-instructions.md
+
+echo "Syncing training files to dev source..."
+echo ""
+
+# 1. Update the base template (trains all new projects)
+echo "1. Updating base template (api_logic_server_cli/prototypes/base)..."
+cp basic_demo_2/docs/training/testing.md \
+   /Users/val/dev/ApiLogicServer/ApiLogicServer-dev/org_git/ApiLogicServer-src/api_logic_server_cli/prototypes/base/docs/training/testing.md
+
+cp basic_demo_2/.github/.copilot-instructions.md \
+   /Users/val/dev/ApiLogicServer/ApiLogicServer-dev/org_git/ApiLogicServer-src/api_logic_server_cli/prototypes/base/.github/.copilot-instructions.md
+
+echo "   ✅ Base template updated"
+echo ""
+
+# 2. Update the Manager's reference sample (for basic_demo examples)
+echo "2. Updating Manager reference sample (prototypes/manager/samples/basic_demo_sample)..."
+cp basic_demo_2/docs/training/testing.md \
+   /Users/val/dev/ApiLogicServer/ApiLogicServer-dev/org_git/ApiLogicServer-src/api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/docs/training/testing.md
+
+cp basic_demo_2/.github/.copilot-instructions.md \
+   /Users/val/dev/ApiLogicServer/ApiLogicServer-dev/org_git/ApiLogicServer-src/api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/.github/.copilot-instructions.md
+
+echo "   ✅ Manager reference sample updated"
+echo ""
+
+echo "✅ Sync complete!"
+echo ""
+echo "Files synced:"
+echo "  - docs/training/testing.md (593 lines)"
+echo "  - .github/.copilot-instructions.md (740 lines)"
+echo ""
+echo "Next steps:"
+echo "  1. cd /Users/val/dev/ApiLogicServer/ApiLogicServer-dev/org_git/ApiLogicServer-src"
+echo "  2. git status  # Review changes"
+echo "  3. git diff    # Check specific changes"
+echo "  4. git commit -am 'Updated training: Rule #0.5 (step ordering) + documentation consolidation'"
+echo "  5. git push"

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

@@ -8,7 +8,7 @@
             "name": "1. GENAI - Create genai_logic demo project",
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}",
             "env": {
@@ -27,7 +27,7 @@
             "name": "  - 1.1  GENAI - Iterate (first, add prompt to system/genai/temp/<project>)",
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}",
             "env": {
@@ -46,7 +46,7 @@
             "name": "  - 1.2  GENAI - Retry from repaired chatgpt response",
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}",
             "env": {
@@ -66,7 +66,7 @@
             "name": "  - 1.3  GENAI - Retry from repaired model",
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}",
             "env": {
@@ -87,7 +87,7 @@
             "name": "  - 1.4  GENAI - Postgresql",
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}",
             "env": {
@@ -107,7 +107,7 @@
             "name": "  - 1.5  GENAI - repaired-response=genai_demo.response_example",
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}",
             "env": {
@@ -128,7 +128,7 @@
             "name": "ApiLogicServer Create",
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}",
             "env": {
@@ -148,7 +148,7 @@
             "name": "  - ApiLogicServer Create nw_sample_nocust",
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}",
             "env": {
@@ -167,7 +167,7 @@
             "name": "  - ApiLogicServer Create nw_sample With Customizations",
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}",
             "env": {
@@ -243,7 +243,7 @@
             "name": "Internal - GenAI smoke test - genai_demo (with informal logic)",
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}",
             "env": {
@@ -263,7 +263,7 @@
 //  typical start for suggestiosn - just the model
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}",
             "env": {
@@ -283,7 +283,7 @@
 // typical next step - suggest logic
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}/genai_demo_no_logic",
             "env": {
@@ -303,7 +303,7 @@
 // typical next step - explore rules for supplied logic
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}/genai_demo_no_logic",
             "env": {
@@ -323,7 +323,7 @@
 // typical next step - explore rules for supplied logic
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}/genai_demo_no_logic",
             "env": {
@@ -343,7 +343,7 @@
 // typical next step - activate suggested logic created above
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}",
             "env": {
@@ -363,7 +363,7 @@
 // Simulate WebG: cp docs/genai_demo_no_logic_003.prompt docs/logic/active_rules.json
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}",
             "env": {
@@ -383,7 +383,7 @@
             "name": "  - GenAI - FixUp f0 genai_demo_with_logic (setup in readme) - upd model and test data from logic",
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}",
             "env": {
@@ -406,7 +406,7 @@
 // note; can't use pre-installed nw - this relies on docs files
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}/genai_demo_fixup_required",
             "env": {
@@ -425,7 +425,7 @@
             "name": "  - GenAI - FixUp f2 - rebuild from response -> genai_demo_with_logic_fixed",
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}",
             "env": {
@@ -448,7 +448,7 @@
 // typical step - iterate the model, now with logic
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}/genai_demo_no_logic",
             "env": {
@@ -508,7 +508,7 @@
 // iterate from WebG suggestions -- GenAI - no logic, then remove suffix from ...genai_demo/genai_demo_iteration/logic/active_rules_webg.json
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}",
             "env": {
@@ -529,7 +529,7 @@
 // see system/genai/examples/genai_demo/multiple_logic_files/docs
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}/genai_demo_no_logic",
             "env": {
@@ -548,7 +548,7 @@
 // typical next step - rebuild
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}/genai_demo_no_logic",
             "env": {
@@ -566,7 +566,7 @@
             "name": "  - GenAI - no logic - rebuild fixed up project",
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}",
             "env": {
@@ -586,7 +586,7 @@
             "name": "  - GenAI informal logic - emp_depts",
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}",
             "env": {
@@ -607,7 +607,7 @@
             "request": "launch",
             "env": {"APILOGICSERVER_DEBUG": "True"},
             "cwd": "${workspaceFolder}",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "args": ["genai", "--test-data-rows=4", "--temperature=0.7",
                 "--using=${workspaceFolder}/system/genai/examples/students_classes_informal_iteration",
@@ -621,7 +621,7 @@
             "env": {"APILOGICSERVER_DEBUG": "True"},
             "cwd": "${workspaceFolder}/system/genai/examples/genai_demo/wg_dev_merge/dev_demo_no_logic_fixed",
             "justMyCode": false,
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "args": ["genai-utils", "--import-genai"
                 , "--using=../wg_demo_no_logic_fixed"
@@ -636,7 +636,7 @@
             "env": {"APILOGICSERVER_DEBUG": "True"},
             "cwd": "${workspaceFolder}/system/genai/examples/genai_demo/wg_dev_merge/dev_demo_no_logic_fixed",
             "justMyCode": false,
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "args": ["genai-utils", "--import-genai"
                 . "--import-resume"
@@ -649,7 +649,7 @@
             "name": "  - retry repaired-response",
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}",
             "env": {
@@ -669,7 +669,7 @@
             "name": "  - retry conversation",
             "type": "debugpy",
             "request": "launch",
-            "program": "${workspaceFolder}/venv/lib/python3.12/site-packages/api_logic_server_cli/cli.py",
+            "program": "${workspaceFolder}/venv/lib/python3.13/site-packages/api_logic_server_cli/cli.py",
             "redirectOutput": true,
             "cwd": "${workspaceFolder}",
             "env": {