PyPI - ApiLogicServer - Versions diffs - 15.2.0__tar.gz → 15.2.3__tar.gz - Mend

ApiLogicServer 15.2.0tar.gz → 15.2.3tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2871) hide show

{apilogicserver-15.2.0 → apilogicserver-15.2.3}/ApiLogicServer.egg-info/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ApiLogicServer
-Version: 15.2.0
+Version: 15.2.3
 Author-email: Val Huber <apilogicserver@gmail.com>
 License-Expression: BSD-3-Clause
 Project-URL: Homepage, https://www.genai-logic.com
@@ -83,7 +83,7 @@ Dynamic: license-file
 [![Latest Version](https://img.shields.io/pypi/v/apilogicserver.svg)](https://pypi.python.org/pypi/apilogicserver/)
 [![Supported Python versions](https://img.shields.io/pypi/pyversions/apilogicserver.svg)](https://pypi.python.org/pypi/apilogicserver/)
-**Transform 30-40 years of backend development requests into 3-4 days** with GenAI-powered microservice automation.
+**Create instant microservices from your database or natural language prompt** - working API + Admin App + Logic in 5 seconds, with 40X code reduction through declarative rules.
 Create **instant microservices** (MCP-enabled API + Admin App + Business Logic) from your database or a natural language prompt:
@@ -121,7 +121,7 @@ python api_logic_server_run.py
 - 🔐 **Security** - Row-level authorization, JWT authentication
 - 🐳 **Docker-ready** - Pre-configured containers for deployment
-**[📖 4-minute video demo](https://www.youtube.com/watch?v=7I33Fa9Ulos)** | **[📚 Full Documentation](https://apilogicserver.github.io/Docs/)** | **[🏠 Home](https://www.genai-logic.com)**
+**[📖 8-minute video demo](https://www.youtube.com/watch?v=Z4_NJIm5rFs&t=323s)** | **[📚 Full Documentation](https://apilogicserver.github.io/Docs/)** | **[🏠 Home](https://www.genai-logic.com)**
 ---
@@ -144,16 +144,68 @@ python api_logic_server_run.py
 ---
-## 💡 Use Cases
+## 💡 When to Use API Logic Server
-- **🔌 Application Integration** - Instant APIs for legacy databases
-- **⚡ Rapid Prototyping** - Working backend in minutes, not weeks
+### ✅ Ideal Use Cases
+API Logic Server excels at **data-centric business applications** where the complexity is in multi-table calculations, constraints, and derivations:
+- **🔌 Application Integration** - Instant APIs for legacy databases (modernization without rewrite)
+- **⚡ Rapid Prototyping** - Working backend in minutes for validation
 - **🤖 GenAI Backends** - Natural language → working microservice
 - **🏢 Backoffice Apps** - Admin dashboards for data maintenance
 - **🔗 Microservices** - Decompose monoliths with instant services
+- **📊 Business Rule Automation** - Complex calculations, cascading updates, constraint checking
+- **🔄 CRUD-Heavy Applications** - Order management, inventory, customer systems
+- **🏛️ Legacy Modernization** - MCP-enable existing databases, create modern API layer while legacy apps continue running
+**Sweet Spot:** Applications where business logic complexity >> UI complexity
+### ⚠️ Not Recommended For
+API Logic Server is optimized for data-centric business logic, but **less suited** for:
+- **Real-time streaming systems** - Use Kafka/Flink for high-throughput event processing
+- **Complex UI/UX interactions** - Works great as the backend, but not a UI framework
+- **Machine learning pipelines** - Use TensorFlow/PyTorch for ML workflows
+- **Low-level system programming** - Traditional languages better suited
+- **Document/content management** - Use specialized CMS platforms
+- **Simple static websites** - Overkill for basic content delivery
+**For these scenarios, traditional approaches are more appropriate.** API Logic Server can still serve as the backend for hybrid architectures.
 ---
+## ❓ Frequently Asked Questions
+**Q: How is this different from low-code platforms (Retool, OutSystems, Hasura)?**
+A: Unlike pure low-code platforms, API Logic Server generates **standard Python projects you own, extend and deploy**. Screen creation is by vibe tools rather than screen painting. Unlike API generators, it includes sophisticated multi-table logic automation (40X code reduction). **[Read detailed comparison →](https://medium.com/@valjhuber/declarative-genai-the-architecture-behind-enterprise-vibe-automation-1b8a4fe4fbd7)**
+**Q: Isn't this just vendor lock-in?**
+A: It's **free and open source**. The declarative rules sit on top of standard (readable, version-controlled) Python — you can always drop down to procedural code. If you ever need to migrate away, you can either keep using the rules engine (it's just a library) or replace declarative rules with equivalent procedural code using standard SQLAlchemy events.
+**Q: Can I customize the generated app?**
+A: **Absolutely.** You can override the UI, extend APIs, and plug in your own logic — using standard Python, SQLAlchemy, and any Vibe tool. The generated project is a starting point, not a black box. **[See customization patterns →](https://apilogicserver.github.io/Docs/Logic/)**
+**Q: What happens when logic doesn't fit the declarative model?**
+A: The declarative engine handles **over 95%** of typical business logic (calculations, validations, cascading updates). For complex workflows, state machines, or external integrations, you write standard Python event handlers that coexist with declarative rules. The engine calls your code at the right time — no conflict, full extensibility.
+**Q: How long does it take developers to become productive?**
+A: Developers can start writing rules immediately using natural language, and the DSL syntax is intuitive. Understanding the engine's optimization strategies (pruning, chaining) takes a few days of practice. **Most teams are fully productive within a week.**
+**Q: What if I have questions or need help?**
+A: Join our **[Discord community](https://discord.gg/fNRTTVFT)** for real-time help, check **[GitHub Discussions](https://github.com/ApiLogicServer/ApiLogicServer-src/discussions)**, or browse the **[comprehensive documentation](https://apilogicserver.github.io/Docs/)**.
+**[→ More FAQs in detailed article](https://medium.com/@valjhuber/declarative-genai-the-architecture-behind-enterprise-vibe-automation-1b8a4fe4fbd7#faqs)**
+---
 ## 🏗️ Architecture
 ```
@@ -302,11 +354,11 @@ python behave_logic_report.py
 ---
-## 🎬 Video Overview (4 min)
+## 🎬 Video Overview (8 min)
 See how **Microservice Automation** creates and runs a microservice - a multi-page app and an API:
-[![GenAI Automation](https://raw.githubusercontent.com/ApiLogicServer/Docs/main/docs/images/sample-ai/copilot/genai-automation-video.png)](https://www.youtube.com/watch?v=7I33Fa9Ulos "Microservice Automation")
+[![GenAI Automation](https://raw.githubusercontent.com/ApiLogicServer/Docs/main/docs/images/sample-ai/copilot/genai-automation-video.png)](https://www.youtube.com/watch?v=Z4_NJIm5rFs&t=323s "Microservice Automation")
 ---
@@ -485,6 +537,25 @@ Built on the shoulders of giants:
 ---
+## 📝 In-Depth Articles
+These Medium articles provide comprehensive context on architecture, use cases, and the reasoning behind API Logic Server:
+| Article | Topic | Key Insights |
+|---------|-------|--------------|
+| **[Welcome to GenAI-Logic](https://medium.com/@valjhuber/welcome-to-genai-logic-a610ba14bd72)** | Vision & Overview | Big picture: Does GenAI deliver business agility? Start here for context. |
+| **[Declarative GenAI Architecture](https://medium.com/@valjhuber/declarative-genai-the-architecture-behind-enterprise-vibe-automation-1b8a4fe4fbd7)** | Technical Deep Dive | NL → DSL → Engines pattern, FrankenCode problem, **includes FAQ section** |
+| **[Declarative Logic: Living in a Procedural World](https://medium.com/@valjhuber/declarative-logic-living-in-a-procedural-world-6c5b20552c6b)** | Architecture Philosophy | How declarative rules work in Python, the paradox resolved |
+| **[Living With Logic in the Enterprise](https://medium.com/@valjhuber/living-with-logic-7e202782d0c5)** | Production Patterns | Debugging, testing, performance, customization in real deployments |
+| **[Business User / IT Collaboration](https://medium.com/@valjhuber/declarative-genai-business-user-it-collaboration-c5547776ff7d)** | Team Dynamics | How logic acts as a contract between business and IT |
+| **[Vibe an MCP Server](https://medium.com/@valjhuber/vibe-an-mcp-server-declarative-genai-logic-dec16719c004)** | MCP Integration | Creating MCP-enabled services with natural language |
+| **[Probabilistic and Deterministic Logic](https://medium.com/@valjhuber/probabilistic-and-deterministic-logic-9a38f98d24a8)** | AI + Rules | Engineering reliability into agentic systems (AI at runtime + rules) |
+| **[Enterprise Vibe Automation](https://medium.com/@valjhuber/enterprise-vibe-automation-b40c8f750a1d)** | GenAI Workflows | Full-stack automation from prompts |
+**These articles represent significant research and real-world experience** - they address common questions, architectural decisions, and lessons learned from 40+ years of declarative technology evolution.
+---
 ## 📞 Connect
 - **🏠 Home:** [genai-logic.com](https://www.genai-logic.com)

{apilogicserver-15.2.0 → apilogicserver-15.2.3}/ApiLogicServer.egg-info/SOURCES.txt RENAMED Viewed

@@ -434,7 +434,6 @@ api_logic_server_cli/prototypes/base/.devcontainer-option/devcontainer.json
 api_logic_server_cli/prototypes/base/.devcontainer-option/readme.md
 api_logic_server_cli/prototypes/base/.devcontainer-option/setup.sh
 api_logic_server_cli/prototypes/base/.github/.copilot-instructions.md
-api_logic_server_cli/prototypes/base/.github/.copilot-instructionsZ.mdx
 api_logic_server_cli/prototypes/base/.idea/runConfigurations/ApiLogicServer.xml
 api_logic_server_cli/prototypes/base/.idea/runConfigurations/Report_Behave_Logic.xml
 api_logic_server_cli/prototypes/base/.idea/runConfigurations/Run_Behave.xml
@@ -587,6 +586,7 @@ api_logic_server_cli/prototypes/base/test/readme_test.md
 api_logic_server_cli/prototypes/base/test/api_logic_server_behave/AI-Generated-Tests-from-Rules.md
 api_logic_server_cli/prototypes/base/test/api_logic_server_behave/__init__.py
 api_logic_server_cli/prototypes/base/test/api_logic_server_behave/behave_logic_report.py
+api_logic_server_cli/prototypes/base/test/api_logic_server_behave/behave_logic_report.py.bak
 api_logic_server_cli/prototypes/base/test/api_logic_server_behave/behave_run.py
 api_logic_server_cli/prototypes/base/test/api_logic_server_behave/check_step_order.py
 api_logic_server_cli/prototypes/base/test/api_logic_server_behave/features/about.feature
@@ -640,6 +640,8 @@ api_logic_server_cli/prototypes/basic_demo/customizations/logic/declare_logic.py
 api_logic_server_cli/prototypes/basic_demo/customizations/logic/logic_discovery/email_request.py
 api_logic_server_cli/prototypes/basic_demo/customizations/logic/logic_discovery/simple_constraints.py
 api_logic_server_cli/prototypes/basic_demo/customizations/security/declare_security.py
+api_logic_server_cli/prototypes/basic_demo/customizations/test/api_logic_server_behave/reports/Behave Logic Report Intro micro.md
+api_logic_server_cli/prototypes/basic_demo/customizations/test/api_logic_server_behave/reports/Behave Logic Report Intro.md
 api_logic_server_cli/prototypes/basic_demo/customizations/ui/admin/admin.yaml
 api_logic_server_cli/prototypes/basic_demo/customizations/ui/admin/home.js
 api_logic_server_cli/prototypes/basic_demo/customizations/ui/reference_react_app/README.md
@@ -1053,6 +1055,7 @@ api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/test/readme_te
 api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/test/api_logic_server_behave/AI-Generated-Tests-from-Rules.md
 api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/test/api_logic_server_behave/__init__.py
 api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/test/api_logic_server_behave/behave_logic_report.py
+api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/test/api_logic_server_behave/behave_logic_report.py.bak
 api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/test/api_logic_server_behave/behave_run.py
 api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/test/api_logic_server_behave/features/about.feature
 api_logic_server_cli/prototypes/manager/samples/basic_demo_sample/test/api_logic_server_behave/features/order_processing.feature
@@ -1538,6 +1541,7 @@ api_logic_server_cli/prototypes/manager/system/app_model_editor/security/system/
 api_logic_server_cli/prototypes/manager/system/app_model_editor/test/__init__.py
 api_logic_server_cli/prototypes/manager/system/app_model_editor/test/api_logic_server_behave/__init__.py
 api_logic_server_cli/prototypes/manager/system/app_model_editor/test/api_logic_server_behave/behave_logic_report.py
+api_logic_server_cli/prototypes/manager/system/app_model_editor/test/api_logic_server_behave/behave_logic_report.py.bak
 api_logic_server_cli/prototypes/manager/system/app_model_editor/test/api_logic_server_behave/behave_run.py
 api_logic_server_cli/prototypes/manager/system/app_model_editor/test/api_logic_server_behave/features/about.feature
 api_logic_server_cli/prototypes/manager/system/app_model_editor/test/api_logic_server_behave/features/steps/about.py
@@ -2041,6 +2045,7 @@ api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_d
 api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/test/__init__.py
 api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/test/api_logic_server_behave/__init__.py
 api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/test/api_logic_server_behave/behave_logic_report.py
+api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/test/api_logic_server_behave/behave_logic_report.py.bak
 api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/test/api_logic_server_behave/behave_run.py
 api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/test/api_logic_server_behave/features/about.feature
 api_logic_server_cli/prototypes/manager/system/genai/examples/genai_demo/genai_demo_docs_logic/test/api_logic_server_behave/features/steps/about.py
@@ -2475,6 +2480,8 @@ api_logic_server_cli/prototypes/nw/test/api_logic_server_behave/features/steps/p
 api_logic_server_cli/prototypes/nw/test/api_logic_server_behave/features/steps/salary_change.py
 api_logic_server_cli/prototypes/nw/test/api_logic_server_behave/features/steps/test_utils.py
 api_logic_server_cli/prototypes/nw/test/api_logic_server_behave/features/steps/tests_successful.py
+api_logic_server_cli/prototypes/nw/test/api_logic_server_behave/reports/Behave Logic Report Intro micro.md
+api_logic_server_cli/prototypes/nw/test/api_logic_server_behave/reports/Behave Logic Report Intro.md
 api_logic_server_cli/prototypes/nw/test/api_logic_server_behave/wip/espression_parser.py
 api_logic_server_cli/prototypes/nw/test/api_logic_server_behave/wip/expression_parser.feature
 api_logic_server_cli/prototypes/nw/test/basic/__init__.py

{apilogicserver-15.2.0 → apilogicserver-15.2.3}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ApiLogicServer
-Version: 15.2.0
+Version: 15.2.3
 Author-email: Val Huber <apilogicserver@gmail.com>
 License-Expression: BSD-3-Clause
 Project-URL: Homepage, https://www.genai-logic.com
@@ -83,7 +83,7 @@ Dynamic: license-file
 [![Latest Version](https://img.shields.io/pypi/v/apilogicserver.svg)](https://pypi.python.org/pypi/apilogicserver/)
 [![Supported Python versions](https://img.shields.io/pypi/pyversions/apilogicserver.svg)](https://pypi.python.org/pypi/apilogicserver/)
-**Transform 30-40 years of backend development requests into 3-4 days** with GenAI-powered microservice automation.
+**Create instant microservices from your database or natural language prompt** - working API + Admin App + Logic in 5 seconds, with 40X code reduction through declarative rules.
 Create **instant microservices** (MCP-enabled API + Admin App + Business Logic) from your database or a natural language prompt:
@@ -121,7 +121,7 @@ python api_logic_server_run.py
 - 🔐 **Security** - Row-level authorization, JWT authentication
 - 🐳 **Docker-ready** - Pre-configured containers for deployment
-**[📖 4-minute video demo](https://www.youtube.com/watch?v=7I33Fa9Ulos)** | **[📚 Full Documentation](https://apilogicserver.github.io/Docs/)** | **[🏠 Home](https://www.genai-logic.com)**
+**[📖 8-minute video demo](https://www.youtube.com/watch?v=Z4_NJIm5rFs&t=323s)** | **[📚 Full Documentation](https://apilogicserver.github.io/Docs/)** | **[🏠 Home](https://www.genai-logic.com)**
 ---
@@ -144,16 +144,68 @@ python api_logic_server_run.py
 ---
-## 💡 Use Cases
+## 💡 When to Use API Logic Server
-- **🔌 Application Integration** - Instant APIs for legacy databases
-- **⚡ Rapid Prototyping** - Working backend in minutes, not weeks
+### ✅ Ideal Use Cases
+API Logic Server excels at **data-centric business applications** where the complexity is in multi-table calculations, constraints, and derivations:
+- **🔌 Application Integration** - Instant APIs for legacy databases (modernization without rewrite)
+- **⚡ Rapid Prototyping** - Working backend in minutes for validation
 - **🤖 GenAI Backends** - Natural language → working microservice
 - **🏢 Backoffice Apps** - Admin dashboards for data maintenance
 - **🔗 Microservices** - Decompose monoliths with instant services
+- **📊 Business Rule Automation** - Complex calculations, cascading updates, constraint checking
+- **🔄 CRUD-Heavy Applications** - Order management, inventory, customer systems
+- **🏛️ Legacy Modernization** - MCP-enable existing databases, create modern API layer while legacy apps continue running
+**Sweet Spot:** Applications where business logic complexity >> UI complexity
+### ⚠️ Not Recommended For
+API Logic Server is optimized for data-centric business logic, but **less suited** for:
+- **Real-time streaming systems** - Use Kafka/Flink for high-throughput event processing
+- **Complex UI/UX interactions** - Works great as the backend, but not a UI framework
+- **Machine learning pipelines** - Use TensorFlow/PyTorch for ML workflows
+- **Low-level system programming** - Traditional languages better suited
+- **Document/content management** - Use specialized CMS platforms
+- **Simple static websites** - Overkill for basic content delivery
+**For these scenarios, traditional approaches are more appropriate.** API Logic Server can still serve as the backend for hybrid architectures.
 ---
+## ❓ Frequently Asked Questions
+**Q: How is this different from low-code platforms (Retool, OutSystems, Hasura)?**
+A: Unlike pure low-code platforms, API Logic Server generates **standard Python projects you own, extend and deploy**. Screen creation is by vibe tools rather than screen painting. Unlike API generators, it includes sophisticated multi-table logic automation (40X code reduction). **[Read detailed comparison →](https://medium.com/@valjhuber/declarative-genai-the-architecture-behind-enterprise-vibe-automation-1b8a4fe4fbd7)**
+**Q: Isn't this just vendor lock-in?**
+A: It's **free and open source**. The declarative rules sit on top of standard (readable, version-controlled) Python — you can always drop down to procedural code. If you ever need to migrate away, you can either keep using the rules engine (it's just a library) or replace declarative rules with equivalent procedural code using standard SQLAlchemy events.
+**Q: Can I customize the generated app?**
+A: **Absolutely.** You can override the UI, extend APIs, and plug in your own logic — using standard Python, SQLAlchemy, and any Vibe tool. The generated project is a starting point, not a black box. **[See customization patterns →](https://apilogicserver.github.io/Docs/Logic/)**
+**Q: What happens when logic doesn't fit the declarative model?**
+A: The declarative engine handles **over 95%** of typical business logic (calculations, validations, cascading updates). For complex workflows, state machines, or external integrations, you write standard Python event handlers that coexist with declarative rules. The engine calls your code at the right time — no conflict, full extensibility.
+**Q: How long does it take developers to become productive?**
+A: Developers can start writing rules immediately using natural language, and the DSL syntax is intuitive. Understanding the engine's optimization strategies (pruning, chaining) takes a few days of practice. **Most teams are fully productive within a week.**
+**Q: What if I have questions or need help?**
+A: Join our **[Discord community](https://discord.gg/fNRTTVFT)** for real-time help, check **[GitHub Discussions](https://github.com/ApiLogicServer/ApiLogicServer-src/discussions)**, or browse the **[comprehensive documentation](https://apilogicserver.github.io/Docs/)**.
+**[→ More FAQs in detailed article](https://medium.com/@valjhuber/declarative-genai-the-architecture-behind-enterprise-vibe-automation-1b8a4fe4fbd7#faqs)**
+---
 ## 🏗️ Architecture
 ```
@@ -302,11 +354,11 @@ python behave_logic_report.py
 ---
-## 🎬 Video Overview (4 min)
+## 🎬 Video Overview (8 min)
 See how **Microservice Automation** creates and runs a microservice - a multi-page app and an API:
-[![GenAI Automation](https://raw.githubusercontent.com/ApiLogicServer/Docs/main/docs/images/sample-ai/copilot/genai-automation-video.png)](https://www.youtube.com/watch?v=7I33Fa9Ulos "Microservice Automation")
+[![GenAI Automation](https://raw.githubusercontent.com/ApiLogicServer/Docs/main/docs/images/sample-ai/copilot/genai-automation-video.png)](https://www.youtube.com/watch?v=Z4_NJIm5rFs&t=323s "Microservice Automation")
 ---
@@ -485,6 +537,25 @@ Built on the shoulders of giants:
 ---
+## 📝 In-Depth Articles
+These Medium articles provide comprehensive context on architecture, use cases, and the reasoning behind API Logic Server:
+| Article | Topic | Key Insights |
+|---------|-------|--------------|
+| **[Welcome to GenAI-Logic](https://medium.com/@valjhuber/welcome-to-genai-logic-a610ba14bd72)** | Vision & Overview | Big picture: Does GenAI deliver business agility? Start here for context. |
+| **[Declarative GenAI Architecture](https://medium.com/@valjhuber/declarative-genai-the-architecture-behind-enterprise-vibe-automation-1b8a4fe4fbd7)** | Technical Deep Dive | NL → DSL → Engines pattern, FrankenCode problem, **includes FAQ section** |
+| **[Declarative Logic: Living in a Procedural World](https://medium.com/@valjhuber/declarative-logic-living-in-a-procedural-world-6c5b20552c6b)** | Architecture Philosophy | How declarative rules work in Python, the paradox resolved |
+| **[Living With Logic in the Enterprise](https://medium.com/@valjhuber/living-with-logic-7e202782d0c5)** | Production Patterns | Debugging, testing, performance, customization in real deployments |
+| **[Business User / IT Collaboration](https://medium.com/@valjhuber/declarative-genai-business-user-it-collaboration-c5547776ff7d)** | Team Dynamics | How logic acts as a contract between business and IT |
+| **[Vibe an MCP Server](https://medium.com/@valjhuber/vibe-an-mcp-server-declarative-genai-logic-dec16719c004)** | MCP Integration | Creating MCP-enabled services with natural language |
+| **[Probabilistic and Deterministic Logic](https://medium.com/@valjhuber/probabilistic-and-deterministic-logic-9a38f98d24a8)** | AI + Rules | Engineering reliability into agentic systems (AI at runtime + rules) |
+| **[Enterprise Vibe Automation](https://medium.com/@valjhuber/enterprise-vibe-automation-b40c8f750a1d)** | GenAI Workflows | Full-stack automation from prompts |
+**These articles represent significant research and real-world experience** - they address common questions, architectural decisions, and lessons learned from 40+ years of declarative technology evolution.
+---
 ## 📞 Connect
 - **🏠 Home:** [genai-logic.com](https://www.genai-logic.com)

{apilogicserver-15.2.0 → apilogicserver-15.2.3}/README.md RENAMED Viewed

@@ -4,7 +4,7 @@
 [![Latest Version](https://img.shields.io/pypi/v/apilogicserver.svg)](https://pypi.python.org/pypi/apilogicserver/)
 [![Supported Python versions](https://img.shields.io/pypi/pyversions/apilogicserver.svg)](https://pypi.python.org/pypi/apilogicserver/)
-**Transform 30-40 years of backend development requests into 3-4 days** with GenAI-powered microservice automation.
+**Create instant microservices from your database or natural language prompt** - working API + Admin App + Logic in 5 seconds, with 40X code reduction through declarative rules.
 Create **instant microservices** (MCP-enabled API + Admin App + Business Logic) from your database or a natural language prompt:
@@ -42,7 +42,7 @@ python api_logic_server_run.py
 - 🔐 **Security** - Row-level authorization, JWT authentication
 - 🐳 **Docker-ready** - Pre-configured containers for deployment
-**[📖 4-minute video demo](https://www.youtube.com/watch?v=7I33Fa9Ulos)** | **[📚 Full Documentation](https://apilogicserver.github.io/Docs/)** | **[🏠 Home](https://www.genai-logic.com)**
+**[📖 8-minute video demo](https://www.youtube.com/watch?v=Z4_NJIm5rFs&t=323s)** | **[📚 Full Documentation](https://apilogicserver.github.io/Docs/)** | **[🏠 Home](https://www.genai-logic.com)**
 ---
@@ -65,16 +65,68 @@ python api_logic_server_run.py
 ---
-## 💡 Use Cases
+## 💡 When to Use API Logic Server
-- **🔌 Application Integration** - Instant APIs for legacy databases
-- **⚡ Rapid Prototyping** - Working backend in minutes, not weeks
+### ✅ Ideal Use Cases
+API Logic Server excels at **data-centric business applications** where the complexity is in multi-table calculations, constraints, and derivations:
+- **🔌 Application Integration** - Instant APIs for legacy databases (modernization without rewrite)
+- **⚡ Rapid Prototyping** - Working backend in minutes for validation
 - **🤖 GenAI Backends** - Natural language → working microservice
 - **🏢 Backoffice Apps** - Admin dashboards for data maintenance
 - **🔗 Microservices** - Decompose monoliths with instant services
+- **📊 Business Rule Automation** - Complex calculations, cascading updates, constraint checking
+- **🔄 CRUD-Heavy Applications** - Order management, inventory, customer systems
+- **🏛️ Legacy Modernization** - MCP-enable existing databases, create modern API layer while legacy apps continue running
+**Sweet Spot:** Applications where business logic complexity >> UI complexity
+### ⚠️ Not Recommended For
+API Logic Server is optimized for data-centric business logic, but **less suited** for:
+- **Real-time streaming systems** - Use Kafka/Flink for high-throughput event processing
+- **Complex UI/UX interactions** - Works great as the backend, but not a UI framework
+- **Machine learning pipelines** - Use TensorFlow/PyTorch for ML workflows
+- **Low-level system programming** - Traditional languages better suited
+- **Document/content management** - Use specialized CMS platforms
+- **Simple static websites** - Overkill for basic content delivery
+**For these scenarios, traditional approaches are more appropriate.** API Logic Server can still serve as the backend for hybrid architectures.
 ---
+## ❓ Frequently Asked Questions
+**Q: How is this different from low-code platforms (Retool, OutSystems, Hasura)?**
+A: Unlike pure low-code platforms, API Logic Server generates **standard Python projects you own, extend and deploy**. Screen creation is by vibe tools rather than screen painting. Unlike API generators, it includes sophisticated multi-table logic automation (40X code reduction). **[Read detailed comparison →](https://medium.com/@valjhuber/declarative-genai-the-architecture-behind-enterprise-vibe-automation-1b8a4fe4fbd7)**
+**Q: Isn't this just vendor lock-in?**
+A: It's **free and open source**. The declarative rules sit on top of standard (readable, version-controlled) Python — you can always drop down to procedural code. If you ever need to migrate away, you can either keep using the rules engine (it's just a library) or replace declarative rules with equivalent procedural code using standard SQLAlchemy events.
+**Q: Can I customize the generated app?**
+A: **Absolutely.** You can override the UI, extend APIs, and plug in your own logic — using standard Python, SQLAlchemy, and any Vibe tool. The generated project is a starting point, not a black box. **[See customization patterns →](https://apilogicserver.github.io/Docs/Logic/)**
+**Q: What happens when logic doesn't fit the declarative model?**
+A: The declarative engine handles **over 95%** of typical business logic (calculations, validations, cascading updates). For complex workflows, state machines, or external integrations, you write standard Python event handlers that coexist with declarative rules. The engine calls your code at the right time — no conflict, full extensibility.
+**Q: How long does it take developers to become productive?**
+A: Developers can start writing rules immediately using natural language, and the DSL syntax is intuitive. Understanding the engine's optimization strategies (pruning, chaining) takes a few days of practice. **Most teams are fully productive within a week.**
+**Q: What if I have questions or need help?**
+A: Join our **[Discord community](https://discord.gg/fNRTTVFT)** for real-time help, check **[GitHub Discussions](https://github.com/ApiLogicServer/ApiLogicServer-src/discussions)**, or browse the **[comprehensive documentation](https://apilogicserver.github.io/Docs/)**.
+**[→ More FAQs in detailed article](https://medium.com/@valjhuber/declarative-genai-the-architecture-behind-enterprise-vibe-automation-1b8a4fe4fbd7#faqs)**
+---
 ## 🏗️ Architecture
 ```
@@ -223,11 +275,11 @@ python behave_logic_report.py
 ---
-## 🎬 Video Overview (4 min)
+## 🎬 Video Overview (8 min)
 See how **Microservice Automation** creates and runs a microservice - a multi-page app and an API:
-[![GenAI Automation](https://raw.githubusercontent.com/ApiLogicServer/Docs/main/docs/images/sample-ai/copilot/genai-automation-video.png)](https://www.youtube.com/watch?v=7I33Fa9Ulos "Microservice Automation")
+[![GenAI Automation](https://raw.githubusercontent.com/ApiLogicServer/Docs/main/docs/images/sample-ai/copilot/genai-automation-video.png)](https://www.youtube.com/watch?v=Z4_NJIm5rFs&t=323s "Microservice Automation")
 ---
@@ -406,6 +458,25 @@ Built on the shoulders of giants:
 ---
+## 📝 In-Depth Articles
+These Medium articles provide comprehensive context on architecture, use cases, and the reasoning behind API Logic Server:
+| Article | Topic | Key Insights |
+|---------|-------|--------------|
+| **[Welcome to GenAI-Logic](https://medium.com/@valjhuber/welcome-to-genai-logic-a610ba14bd72)** | Vision & Overview | Big picture: Does GenAI deliver business agility? Start here for context. |
+| **[Declarative GenAI Architecture](https://medium.com/@valjhuber/declarative-genai-the-architecture-behind-enterprise-vibe-automation-1b8a4fe4fbd7)** | Technical Deep Dive | NL → DSL → Engines pattern, FrankenCode problem, **includes FAQ section** |
+| **[Declarative Logic: Living in a Procedural World](https://medium.com/@valjhuber/declarative-logic-living-in-a-procedural-world-6c5b20552c6b)** | Architecture Philosophy | How declarative rules work in Python, the paradox resolved |
+| **[Living With Logic in the Enterprise](https://medium.com/@valjhuber/living-with-logic-7e202782d0c5)** | Production Patterns | Debugging, testing, performance, customization in real deployments |
+| **[Business User / IT Collaboration](https://medium.com/@valjhuber/declarative-genai-business-user-it-collaboration-c5547776ff7d)** | Team Dynamics | How logic acts as a contract between business and IT |
+| **[Vibe an MCP Server](https://medium.com/@valjhuber/vibe-an-mcp-server-declarative-genai-logic-dec16719c004)** | MCP Integration | Creating MCP-enabled services with natural language |
+| **[Probabilistic and Deterministic Logic](https://medium.com/@valjhuber/probabilistic-and-deterministic-logic-9a38f98d24a8)** | AI + Rules | Engineering reliability into agentic systems (AI at runtime + rules) |
+| **[Enterprise Vibe Automation](https://medium.com/@valjhuber/enterprise-vibe-automation-b40c8f750a1d)** | GenAI Workflows | Full-stack automation from prompts |
+**These articles represent significant research and real-world experience** - they address common questions, architectural decisions, and lessons learned from 40+ years of declarative technology evolution.
+---
 ## 📞 Connect
 - **🏠 Home:** [genai-logic.com](https://www.genai-logic.com)

{apilogicserver-15.2.0 → apilogicserver-15.2.3}/api_logic_server_cli/api_logic_server.py RENAMED Viewed

@@ -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.02.00"  # last public release: 15.01.03
+__version__ = "15.02.03"  # last public release: 15.02.00
 recent_changes = \
     f'\n\nRecent Changes:\n' +\
-    "\t10/21/2025 - 15.02.00: Copilot test creation from rules and custom APIs \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"\
     "\t09/27/2025 - 15.01.05: Error reporting for bad test data rebuild [101], Minor fix to ensure react-app cards have links \n"\
     "\t08/17/2025 - 15.01.03: LogicBan 01.30, with fix for copy_children[19] \n"\

{apilogicserver-15.2.0/api_logic_server_cli/prototypes/manager/samples/basic_demo_sample → apilogicserver-15.2.3/api_logic_server_cli/prototypes/base}/.github/.copilot-instructions.md RENAMED Viewed

@@ -44,6 +44,28 @@ 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.
+### 📚 Main Services Available in This Project
+This GenAI-Logic project provides 13 main customization services:
+1. **Run Project** - F5 debug or `python api_logic_server_run.py`
+2. **Adding Business Logic** - Declarative rules in `logic/declare_logic.py`
+3. **Discovery Systems** - Auto-load logic and APIs from discovery folders
+4. **Automated Testing** - Behave tests with BLT (Business Logic Traceability) reports
+5. **Adding MCP** - Model Context Protocol client integration
+6. **Configuring Admin UI** - Edit `ui/admin/admin.yaml`
+7. **Create React Apps** - Custom UIs with `genai-logic genai-add-app`
+8. **Security - RBAC** - Role-based access control with `als add-auth`
+9. **Custom API Endpoints** - Add routes in `api/customize_api.py`
+10. **B2B Integration APIs** - Complex endpoints with Row Dict Mappers
+11. **Customize Models** - Add tables, attributes, derived fields
+12. **Adding Events** - Row events for Kafka, webhooks, integrations
+13. **Critical Patterns** - React components, null-safe constraints, test repeatability
+Each service is detailed below with examples and best practices.
+---
 ### 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.

{apilogicserver-15.2.0 → apilogicserver-15.2.3}/api_logic_server_cli/prototypes/base/docs/training/testing.md RENAMED Viewed

@@ -25,6 +25,9 @@ Step 5.  SUGGEST how to run tests (DO NOT run automatically)
 **CRITICAL PRE-TEST CHECKLIST:**
 - [ ] Step 1c completed? (Custom APIs discovered)
+- [ ] **Database values verified?** (Rule #10: Run SQL to check actual prices/flags)
+  - [ ] `sqlite3 db.sqlite "SELECT name, unit_price, carbon_neutral FROM product;"`
+  - [ ] Don't assume product attributes - verify BEFORE writing expectations!
 - [ ] **Step ordering verified?** (Most specific → Most general)
   - [ ] @when patterns: carbon neutral > multi-item > single-item
   - [ ] @given patterns: multi-item > single-item
@@ -470,19 +473,28 @@ Rule.sum(derive=Customer.balance, as_sum_of=Order.amount_total,
 ```python
 # ALWAYS check actual product prices/flags before writing test expectations!
-# Check prices:
-# sqlite3 db.sqlite "SELECT name, unit_price, carbon_neutral FROM Product;"
+# Check prices AND flags:
+# sqlite3 db.sqlite "SELECT name, unit_price, carbon_neutral FROM product;"
-# Widget=90, Gadget=150, Green=109
+# Results:
+# 1|Gadget|150|1        ← carbon_neutral = 1 (TRUE)
+# 2|Widget|90|          ← carbon_neutral = NULL (not carbon neutral!)
+# 3|Thingamajig|5075|
+# 4|Doodad|110|
+# 5|Green|109|1         ← carbon_neutral = 1 (TRUE)
-# ❌ WRONG - Assumed Widget=$100
-# Expected: 10 * 100 = 1000
+# ❌ WRONG - Assumed Widget is carbon neutral
+# Scenario: Carbon Neutral Discount
+#   When B2B order placed with 10 carbon neutral Widget
+#   Then balance should be 810  # Expected 10 * 90 * 0.9 = 810
+# FAILS: Widget is NOT carbon neutral → no discount → balance = 900
-# ✅ CORRECT - Verified Widget=$90
-# Expected: 10 * 90 = 900
+# ✅ CORRECT - Verified Gadget IS carbon neutral (flag = 1)
+# Scenario: Carbon Neutral Discount
+#   When B2B order placed with 10 carbon neutral Gadget
+#   Then balance should be 1350  # Correct: 10 * 150 * 0.9 = 1350
-# For carbon neutral discount (10% off when qty >= 10):
-# Expected: 10 * 90 * 0.9 = 810
+# CRITICAL: Don't assume product attributes - VERIFY with SQL first!
 ```
 ### Rule #11: Step Definitions Must Match Feature Files ⚠️ NEW

ApiLogicServer 15.2.0__tar.gz → 15.2.3__tar.gz

ApiLogicServer 15.2.0tar.gz → 15.2.3tar.gz