ApiLogicServer 15.1.3__py3-none-any.whl → 15.2.3__py3-none-any.whl

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": {

api_logic_server_cli/prototypes/manager/samples/{basic_demo → basic_demo_sample}/.github/.copilot-instructions.md

@@ -1,3 +1,6 @@
+
+
+
 # GitHub Copilot Instructions for GenAI-Logic (aka API Logic Server) Projects
 
 ## Project Type: Auto-Generated Microservice
@@ -33,7 +36,7 @@ This is a **GenAI-Logic (aka API Logic Server) project** - a complete, working m
 4. **Authentication System** - JWT-based auth framework
 5. **Business Logic Engine** - Declarative rules system
 
-> **📋 Testing:** For comprehensive testing conventions, patterns, and examples, see `test/readme_test.md`
+> **📋 Testing:** For comprehensive testing conventions, patterns, and examples, see `docs/training/testing.md` (555 lines - MUST READ FIRST before creating any tests)
 
 ## 🎯 Common Tasks
 
@@ -41,6 +44,9 @@ If the user asks "what do I do now?", these subsections are good suggestions.
 
 List these as choices, do not just do all of them at once - that would be overwhelming.
 
+### Set Up Virtual Environment
+If it is not already set, you can often find a `venv` in the GenAI-Logic Manager - a parent or grandparent directory.
+
 ### 🚀 To Run This Project
 
 Use F5 (pre-configured run configuration - supports debugger for server logic), or (when focused on client apps):
@@ -96,6 +102,35 @@ Use case: App Integration
 **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.
+
+**Why the Rules Engine is a Correctness Guarantee:**
+
+The "2 critical bugs" mentioned above were:
+1. **Changing Order.customer_id** - procedural code failed to adjust BOTH the old and new customer balances
+2. **Changing Item.product_id** - procedural code failed to re-copy the unit_price from the new product
+
+These bugs illustrate why declarative rules are **mandatory, not optional**:
+
+**Dependency Chains:** In the logic above, `Customer.balance` has transitive dependencies:
+- Direct: `Order.amount_total`, `Order.date_shipped`
+- Through Order: `Item.amount` (affects Order.amount_total)
+- Through Item: `Item.quantity`, `Item.unit_price` (affect Item.amount)
+- Through Product: `Product.unit_price` (copied to Item.unit_price)
+
+**Automatic Completeness:** The declarative rules engine:
+- Listens to **SQLAlchemy ORM events** at the attribute level
+- When `Order.customer_id` changes, **automatically adjusts both old and new customer balances**
+- When `Item.product_id` changes, **automatically re-copies from the new product**
+- Uses **dependency ordering** to fire rules in correct sequence
+- Applies **optimized chaining** (uses deltas, not re-aggregation)
+
+**Why Procedural Code Fails:** Even AI-generated procedural code requires explicit handlers for EVERY possible change path. It's easy to miss:
+- Foreign key changes affecting multiple parents
+- Transitive dependencies through multiple tables
+- Where clause conditions that include/exclude rows
+
+The rules engine eliminates this entire class of bugs by automatically handling all change paths.
+
 </analysis>
 
 Generally CoPilot solicits Natural Language logic for translation (see logic/readme_logic.md), 
@@ -144,6 +179,127 @@ When users provide natural language with multiple use cases like:
 
 **NEVER put everything in `use_case.py`** - that defeats the discovery system purpose.
 
+### Automated Testing
+
+**CRITICAL WORKFLOW - When User Says "Create Tests":**
+
+```
+1. STOP ✋ - Do NOT create tests yet!
+2. READ docs/training/testing.md FIRST (555 lines - comprehensive guide with ALL patterns)
+3. This file contains EVERY discovered bug pattern from achieving 11/11 test success
+4. Pay special attention to:
+   - Rule #0: Test Repeatability (timestamps for uniqueness)
+   - Rule #0.5: Behave Step Ordering (specific before general patterns)
+   - Top 5 Critical Bugs section (common AI mistakes)
+   - Filter format: filter[column]=value (NOT OData)
+   - No circular imports (test files = black box, API only)
+   - Null-safe constraints (handle None values)
+   - Fresh test data (timestamps for uniqueness)
+5. THEN create tests following the patterns exactly
+6. NEVER create duplicate rules - all patterns already documented
+```
+
+**Why This Matters:** AI-generated tests fail 80% of the time without reading this guide first. The training material documents every common mistake (circular imports, wrong filter format, null-unsafe constraints, step ordering, etc.) with exact fixes. This guide achieved 11/11 test success (100%) and contains all discovered patterns.
+
+**`docs/training/testing.md`** explains how to create Behave tests from declarative rules, execute test suites, and generate automated documentation with complete logic traceability.
+
+**Key capabilities:**
+- **Create tests from rules** - Analyze declarative rules to generate appropriate test scenarios
+- **Execute test suite** - Run all tests with one command (Launch Configuration: "Behave Run")
+- **Generate documentation** - Auto-create wiki reports showing requirements, tests, rules used, and execution traces
+- **Requirements traceability** - Complete chain from business requirement → test → declarative rule → execution log
+
+**The Innovation:** Unlike traditional testing, Behave Logic Reports show **which declarative rules fired** during each test, providing complete transparency from requirement to execution. This solves the 44X advantage in testing - tests verify "what" (business rules) not "how" (procedural code).
+
+See `test/api_logic_server_behave/` for examples and [published report](https://apilogicserver.github.io/Docs/Behave-Logic-Report/).
+
+**Common Mistakes to Avoid (from testing.md):**
+1. ❌ Wrong filter: `filter="name eq 'Alice'"` → ✅ Use: `filter[name]="Alice"`
+2. ❌ Importing logic/database modules → ✅ Import only: behave, requests, test_utils
+3. ❌ Unsafe constraints: `row.x <= row.y` → ✅ Use: `row.x is None or row.y is None or row.x <= row.y`
+4. ❌ Step execution: `step_impl.execute_step()` → ✅ Use: `context.execute_steps('when Step')`
+5. ❌ Reusing test data → ✅ Create fresh with: `f"{name} {int(time.time()*1000)}"`
+
+**For detailed test creation patterns, see `docs/training/testing.md` which documents all critical rules including Rule #0.5 (Behave Step Ordering).**
+
+#### Critical Learnings: Behave Logic Report Generation
+
+**PROBLEM**: Reports not showing logic details for test scenarios.
+
+**ROOT CAUSES DISCOVERED**:
+
+1. **Empty behave.log** (Most Common Issue)
+   - ❌ Running: `python behave_run.py` 
+   - ✅ Must run: `python behave_run.py --outfile=logs/behave.log`
+   - Without `--outfile`, behave.log remains empty (0 bytes) and report has no content
+
+2. **Scenario Name Mismatch** 
+   - Log files must match scenario names from .feature file
+   - ❌ Using custom names: `scenario_name = f'B2B Order - {quantity} {product_name}'`
+   - ✅ Use actual scenario: `scenario_name = context.scenario.name`
+   - Report generator truncates to 25 chars and looks for matching .log files
+
+3. **Report Generator Logic Bug**
+   - Original code only showed logic when blank line followed "Then" step
+   - Only worked for ~30% of scenarios (those with blank lines in behave.log)
+   - ✅ Fixed: Trigger logic display when next scenario starts OR at end of file
+
+**CORRECT PATTERN FOR WHEN STEPS**:
+
+```python
+@when('B2B order placed for "{customer_name}" with {quantity:d} {product_name}')
+def step_impl(context, customer_name, quantity, product_name):
+    """
+    Phase 2: CREATE using OrderB2B API - Tests OrderB2B integration
+    """
+    scenario_name = context.scenario.name  # ← CRITICAL: Use actual scenario name
+    test_utils.prt(f'\n{scenario_name}\n', scenario_name)
+    
+    # ... test implementation ...
+```
+
+**WORKFLOW FOR REPORT GENERATION**:
+
+```bash
+# 1. Run tests WITH outfile to generate behave.log
+python behave_run.py --outfile=logs/behave.log
+
+# 2. Generate report (reads behave.log + scenario_logic_logs/*.log)
+python behave_logic_report.py run
+
+# 3. View report
+open reports/Behave\ Logic\ Report.md
+```
+
+**WHAT THE REPORT SHOWS**:
+- Each scenario gets a `<details>` section with:
+  - **Rules Used**: Which declarative rules fired (numbered list)
+  - **Logic Log**: Complete trace showing before→after values for all adjustments
+- Demonstrates the 44X code reduction by showing rule automation
+
+**DEBUGGING TIPS**:
+
+```bash
+# Check if behave.log has content
+ls -lh logs/behave.log  # Should be several KB, not 0 bytes
+
+# Check if scenario logs exist with correct names
+ls logs/scenario_logic_logs/ | head -10
+
+# Count detail sections in report (should equal number of scenarios)
+grep -c "<details markdown>" reports/Behave\ Logic\ Report.md
+
+# View a specific scenario's log directly
+cat logs/scenario_logic_logs/Delete_Item_Reduces_Order.log
+```
+
+**KEY INSIGHT**: The report generator uses a two-step process:
+1. Reads behave.log for scenario structure (Given/When/Then steps)
+2. Matches scenario names to .log files in scenario_logic_logs/
+3. Injects logic details at the right location in the report
+
+If scenario names don't match between behave.log and .log filenames, logic details won't appear!
+
 ### Adding MCP
 
 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:
@@ -219,12 +375,16 @@ Customize using CoPilot chat, with `docs/training`.
    // AVOID: Trying to use data[id] pattern - this is for older React Admin versions
    ```
 
+
 2. **Component Naming Consistency**: Ensure component names match their usage in JSX - mismatched names cause runtime errors.
 
 3. **Simple Error Handling**: Use straightforward loading states rather than complex error checking:
-   ```javascript
-   if (isLoading) return <div>Loading...</div>;
-   ```
+    ```javascript
+    if (isLoading) return <div>Loading...</div>;
+    ```
+
+4. 🃏 Card View Action Links (Show, Edit, Delete) **IMPORTANT:** All card views (e.g., Product cards) must include action links or buttons for **Show**, **Edit**, and **Delete** for each record (not just the display fields), matching the functionality of the table/list view.
+
 
 **Common Mistakes to Avoid**:
 - Using `{ data, ids }` destructuring and trying to map over `ids` - this pattern is outdated

api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/docs/db.dbml

@@ -0,0 +1,43 @@
+// Copy this text, paste to https://dbdiagram.io/d
+// Or, https://databasediagram.com/app
+// Or, view in VSCode with extension: "DBML Live Preview"
+
+Table Customer {
+    id INTEGER [primary key]
+    name VARCHAR 
+    balance DECIMAL 
+    credit_limit DECIMAL 
+    email VARCHAR 
+    email_opt_out BOOLEAN 
+    }
+
+Table Item {
+    id INTEGER [primary key]
+    order_id INTEGER 
+    product_id INTEGER 
+    quantity INTEGER 
+    amount DECIMAL 
+    unit_price DECIMAL 
+    }
+
+Table Order {
+    id INTEGER [primary key]
+    notes VARCHAR 
+    customer_id INTEGER 
+    CreatedOn DATE 
+    date_shipped DATE 
+    amount_total DECIMAL 
+    }
+
+Table Product {
+    id INTEGER [primary key]
+    name VARCHAR 
+    unit_price DECIMAL 
+    }
+
+
+
+// Relationships
+    Ref: Item.(order_id) < Order.(id)
+    Ref: Item.(product_id) < Product.(id)
+    Ref: Order.(customer_id) < Customer.(id)

api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/docs/training/readme_training.md

@@ -0,0 +1,3 @@
+This directory contains training for your AI Assistant.
+
+Its use it bootstrapped from `.github/.copilot-instructions.md`