ApiLogicServer 15.2.7__py3-none-any.whl → 15.3.0__py3-none-any.whl

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.02.07"  # last public release: 15.02.03
+__version__ = "15.03.00"  # last public release: 15.02.10
 recent_changes = \
     f'\n\nRecent Changes:\n' +\
+    "\t10/29/2025 - 15.03.00: Stable Tutor 3.3 (working, vibe transtion) \n"\
     "\t10/26/2025 - 15.02.07: Clarify order created for ship test, security fixes [105], tutor 2.1 \n"\
     "\t10/22/2025 - 15.02.03: Copilot test creation from rules and custom APIs with issues [103, 104] \n"\
     "\t10/06/2025 - 15.01.06: Incorrect dbml reln arrows [102] \n"\

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

@@ -6,6 +6,7 @@ Propagation: CLI create command → created projects (non-basic_demo)
 Usage: AI assistants read this when user opens any created project
 version: 2.1
 changelog:
+  - 2.2 (Oct 29, 2025 - Clear 1st message about reading Welcome section verbatim
   - 2.1 (Oct 2025) - Streamlined OBX for non-tutorial projects, friendly collaborative tone
   - 2.0 (Oct 2025) - Added front matter, updated for OBX improvements
   - 1.0 (Initial) - Comprehensive technical reference
@@ -13,7 +14,16 @@ changelog:
 
 # GitHub Copilot Instructions for GenAI-Logic (aka API Logic Server) Projects
 
-⚠️ **IMPORTANT FOR AI ASSISTANTS**: When user first opens this project or asks you to read instructions, present the Welcome section below directly to the user. Do not explain that you're following instructions - just present the welcome message naturally. The technical reference sections after the welcome are for later consultation only.
+---
+
+## ⚠️ CRITICAL INSTRUCTION FOR AI ASSISTANTS
+
+**When user first opens this project or asks "what can you help me with", respond with the following text VERBATIM (copy-paste exactly as shown below):**
+
+```
+# GitHub Copilot Instructions for GenAI-Logic (aka API Logic Server) Projects
+
+**INSTRUCTION**: When the user asks you to read these instructions, respond with the Welcome section content below as your greeting. Do not add preamble like "I've read the instructions" - just present the Welcome content directly.
 
 ---
 
@@ -50,6 +60,37 @@ Want to get started? Press **F5** to start the server with debugger support, the
 
 ---
 
+## 🔑 Key Technical Points
+```
+
+**DO NOT create your own summary. DO NOT rephrase. Copy the text above exactly.**
+
+The technical reference sections below are for later consultation when working on specific tasks.
+
+---
+
+## Welcome (Reference Copy)
+
+| # | Service | Description |
+|---|---------|-------------|
+| 1️⃣ | **Add business logic** | Describe your requirements in natural language, I'll generate declarative rules |
+| 2️⃣ | **Customize the API** | Add custom endpoints for your specific needs |
+| 3️⃣ | **Create custom UIs** | Build React apps with `genai-logic genai-add-app --vibe` |
+| 4️⃣ | **Add security** | Set up role-based access control with `genai-logic add-auth` |
+| 5️⃣ | **Test your logic** | Create Behave tests with requirements traceability |
+| 6️⃣ | **Configure Admin UI** | Customize the auto-generated admin interface |
+| 7️⃣ | **Add MCP integration** | Enable Model Context Protocol for external AI access |
+| 8️⃣ | **Create B2B APIs** | Complex integration endpoints with partner systems |
+| 9️⃣ | **Add events** | Integrate with Kafka, webhooks, or other event systems |
+| 🔟 | **Customize models** | Add tables, attributes, or derived fields |
+| 1️⃣1️⃣ | **Discovery systems** | Auto-load logic and APIs from discovery folders |
+
+---
+
+Want to get started? Press **F5** to start the server with debugger support, then open `http://localhost:5656`. (There are also run configurations for running tests and other tasks.) Or just ask me what you'd like to work on.
+
+---
+
 ## 🔑 Key Technical Points
 
 **Critical Implementation Details:**

api_logic_server_cli/prototypes/base/test/api_logic_server_behave/behave_logic_report.py

@@ -129,19 +129,32 @@ def show_logic(scenario: str, logic_logs_dir: str):
             best_section = max(rules_sections, key=lambda x: x['rule_count'])
             last_rules_start = best_section['start']
             last_rules_end = best_section['end']
+            # Find where the "These Rules Fired" line is (one line before rules start)
+            rules_fired_line = last_rules_start - 1
+            # Now search backwards to find the beginning of this logic section
+            logic_start_line = rules_fired_line - 1
+            while logic_start_line > 0:
+                line = logic_lines[logic_start_line].strip()
+                # Look for the start marker (usually after a blank line following "COMPLETE")
+                if 'Logic Phase:' in logic_lines[logic_start_line] and 'ROW LOGIC' in logic_lines[logic_start_line]:
+                    # Found the start of the logic section
+                    # Go back one more to include the header line (scenario name)
+                    if logic_start_line > 0 and logic_lines[logic_start_line-1].strip():
+                        logic_start_line -= 1
+                    break
+                logic_start_line -= 1
         else:
             last_rules_start = -1
             last_rules_end = -1
+            logic_start_line = 0
                     
-        # Now process the file, collecting logic log and extracting the last rules section
+        # Now process the file, collecting logic log and extracting the rules section
         for i, each_logic_line in enumerate(logic_lines):
             each_logic_line = remove_trailer(each_logic_line)
             
-            if is_logic_log:
-                if "These Rules Fired" in each_logic_line:
-                    is_logic_log = False
-                else:
-                    logic_log.append(each_logic_line)
+            # Collect logic log from the best section
+            if rules_sections and logic_start_line <= i < rules_fired_line:
+                logic_log.append(each_logic_line)
             
             # Extract rules from the last "These Rules Fired" section
             if last_rules_start <= i < last_rules_end:

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

@@ -4,17 +4,18 @@ Description: Project-level instructions for AI assistants conducting guided tour
 Source: ApiLogicServer-src/prototypes/basic_demo/.github/.copilot-instructions.md
 Propagation: CLI create command → created projects
 Usage: AI assistants read this when user says "guide me through"
-version: 2.1
+version: 2.3
 changelog:
+  - 2.4 10/28/2025 - Added "Ready to explore?" prompt to guide user to tutor.md
+  - 2.3 (Oct 2025) - Added positive instruction: respond WITH Welcome section content
+  - 2.2 (Oct 2025) - Removed meta-instruction; let structure speak for itself
   - 2.1 (Oct 2025) - Streamlined OBX, emphasized uncustomized template, friendly collaborative tone
   - 2.0 (Oct 2025) - Added provocation method, spreadsheet analogy, timing checkpoints
 ---
 
 # GitHub Copilot Instructions for GenAI-Logic (aka API Logic Server) Projects
 
-⚠️ **IMPORTANT FOR AI ASSISTANTS**: When user first opens this project or asks you to read instructions, present the Welcome section below directly to the user. Do not explain that you're following instructions - just present the welcome message naturally. The technical reference sections after the welcome are for later consultation only.
-
----
+**INSTRUCTION**: When the user asks you to read these instructions, respond with the Welcome section content below as your greeting. Do not add preamble like "I've read the instructions" - just present the Welcome content directly.
 
 ## Welcome
 
@@ -33,7 +34,8 @@ This is a complete, working microservice auto-generated from a database schema -
 
 **First, we'll briefly explore what's automatically created. Then I'll show you how I can help you customize it - adding logic, security, and API endpoints.**
 
-Want to get started? Press **F5** to start the server with debugger support, then open `http://localhost:5656`. (There are also run configurations for running tests and other tasks.)
+
+**Ready to explore?** Open `tutor.md` and tell me "guide me through" to begin the interactive tutorial.
 
 ---
 

api_logic_server_cli/prototypes/basic_demo/customizations/logic/declare_logic.py

@@ -32,7 +32,23 @@ def declare_logic():
         from logic.logic_discovery.auto_discovery import discover_logic
         discover_logic()
 
-    # Logic from GenAI: (or, use your IDE w/ code completion)
+    # Logic from GenAI
+    '''
+    You can enter logic in 2 ways:
+        1. Using your IDE and code completion (Rule.)
+
+        2. Use your AI Assistant and enter logic in Natural Language, e.g.:
+            Create Business Logic for 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.
+    Also, using logic/logic_discovery is a Best Practice - see logic/readme_logic.md
+    '''
     from database.models import Product, Order, Item, Customer, SysEmail
 
     # Ensure the customer's balance is less than their credit limit

api_logic_server_cli/prototypes/basic_demo/readme.md

@@ -31,7 +31,7 @@ Please find and read `.github/.copilot-instructions.md`.
 
 <br>
 
-The entire process takes 20 minutes; usage notes:
+The entire process takes 45 minutes; usage notes:
 
 * Important: look for **readme files** in created projects
 * You may find it more convenient to view this [in your Browser](https://apilogicserver.github.io/Docs/Sample-Basic-Tour)