Sync from local-mgr (gold v17.01.03)

Author: valhuber

.devcontainer/create_codespaces_mgr.py

@@ -255,11 +255,11 @@ def main():
     readme = readme.lstrip("\n")
     print("  ✅ Front matter and style block stripped")
 
-    # Inject Codespaces + browser notes right after the outer "First Time Here?" details
-    # summary (idempotent). Match on the stable "<details>\n<summary>⚡ ...</summary>" prefix —
-    # the text after the lightning bolt is gold-source copy (org_git/Docs) and changes
-    # independently of this script.
-    summary_re = re.compile(r"<details>\n<summary>⚡[^<]*</summary>")
+    # Inject Codespaces + browser notes inside the first "see it work" collapsible
+    # section (idempotent). Match on the lightning-bolt-prefixed <summary> — the
+    # exact wording after ⚡ is gold-source copy (org_git/Docs) and changes
+    # independently of this script, so anchor on the emoji prefix, not the wording.
+    summary_re = re.compile(r"<summary>⚡[^<]*</summary>")
     if "Use Chrome or Edge" not in readme:
         cs_note = (
             "\n&nbsp;\n\n"
@@ -270,32 +270,14 @@ def main():
         match = summary_re.search(readme)
         if not match:
             raise SystemExit(
-                "ERROR: no '<details>\\n<summary>⚡ ...</summary>' line found in README.md — "
+                "ERROR: no '<summary>⚡...</summary>' line found in README.md — "
                 "update this script's summary_re pattern to match the current heading."
             )
         readme = readme[:match.end()] + cs_note + readme[match.end():]
         print("  ✅ Codespaces + browser notes injected")
     else:
         print("  (notes already present, skipped)")
 
-    # Codespaces-only: open item 1's details block by default — reviewer feedback that
-    # devs skim code, not prose, and the first prompt-as-code-block should be visible
-    # without a click on a first-time, one-shot visit. Local README keeps it collapsed
-    # (every-day use, would be noisy). Scoped to item 1 only — items 2-6 stay collapsed,
-    # preserving the agenda/outline feel of the numbered list.
-    item1_re = re.compile(r"<details markdown>\n<summary>[^<]*?1\.[^<]*</summary>")
-    readme, n = item1_re.subn(
-        lambda m: m.group(0).replace("<details markdown>", "<details markdown open>", 1),
-        readme,
-        count=1,
-    )
-    if n == 0:
-        raise SystemExit(
-            "ERROR: could not find item 1's <details markdown> block to open by default — "
-            "update this script's item1_re pattern to match the current heading."
-        )
-    print("  ✅ Item 1 details block set to open by default (Codespaces-only)")
-
     readme_path.write_text(readme)
 
     # .vscode/settings.json — global interpreter (Manager root)

README.md

@@ -1,3 +1,27 @@
+<!--
+title: Welcome - see end for instructions to hide this
+Description: Instant mcp-enabled microservices, standard projects, declarative business logic
+Source: docs/Manager-readme
+version info: 17.00.12 (06/18/2026)
+do_process_code_block_titles: True
+Used: Manager Readme (via copy_md())
+demo_customs: Customs-readme
+demo_customs_surtax: Customs-readme-surtax
+demo_kafka: Sample-Integration
+demo_allo: Sample_Allo_Dept_GL_readme
+demo_ai_rules: Sample-ai-rules
+demo_mcp_send: Sample-Basic-Demo-MCP-Send-Email
+demo_eai: Sample-Basic-EAI
+demo_vibe: Sample-Basic-Demo-Vibe
+demo_copilot_mcp_discovery: Sample-ai-mcp
+basic_demo: Sample-Basic-Demo
+codespaces_patch: |
+  create_codespaces_mgr.py injects a Codespaces-only browser note immediately after
+  the "## 🚀 First Time Here?" heading (sentinel: do not rename that heading without
+  updating the matching logic in create_codespaces_mgr.py). The note warns Safari users to
+  switch to Chrome/Edge. This avoids forking the README for Codespaces.
+-->
+
 # Welcome to GenAI-Logic
 
 One prompt — or your existing database — builds a working API and Admin App, then you declare business logic in **5 readable rules instead of 200 lines of AI-generated code** to enforce it.
@@ -43,10 +67,10 @@ Please load `.github/.copilot-instructions.md`.
 You're already running in GitHub Codespaces — a cloud VS Code environment in your browser. Nothing to install. (Use Chrome or Edge — Safari has known compatibility issues with VS Code in the browser.)
 
 
-<br>
+&nbsp;
 
-<details markdown open>
-<summary>&emsp;&emsp;1. Create — API, Admin App and business logic from a prompt - existing db</summary>
+<details markdown>
+<summary>&emsp;&emsp;1. Create — API, Admin App and business logic from a prompt (existing db)</summary>
 
 <br>Say this to your AI assistant (allow 2-3 mins):
 
@@ -67,16 +91,13 @@ Use case: App Integration
 ```
 
 <details markdown>
-<summary>Or, create with a new database</summary>
+<summary>Starting from a new database instead?</summary>
 
-<br>The prompt above starts from an *existing* database — the common real-world case (1t does not need to be sqlite).   You could create the same system with a *new* database, using a file-based prompt:
+&nbsp;
 
-```
-Create basic_demo from samples/prompts/genai_demo.prompt
-```
-</details>
+The prompt above starts from an existing database — the common real-world case, and much faster (no schema design step). You *could* have AI design a new database from scratch instead — drop the `from samples/dbs/basic_demo.sqlite` clause from the first line above (allow 8-10 mins).
 
-&nbsp;
+</details>
 
 Most code generators produce code you then have to own. This one produces *models* — executable, maintainable:
 
@@ -432,7 +453,6 @@ Verify it's operating properly:
 
 Explore [genai_demo_iteration_discount](system/genai/examples/genai_demo/genai_demo_iteration_discount).  It's an iteration of basic_demo (see system/genai/examples/genai_demo/genai_demo_iteration_discount/002_create_db_models.prompt).  This will add carbon_neutral to the data model, and update the logic to provide the discount:
 
-**Iterate Business Logic:**
 **Iterate Business Logic:**
 ```bash title='Iterate Business Logic'
 # Iterate with data model and logic
@@ -444,7 +464,6 @@ genai-logic genai --project-name='genai_demo_with_discount' --using=system/genai
 
 You can perform **model iterations:** add new columns/tables, while keeping the prior model intact.  First, we create a project with no logic, perhaps just to see the screens (this step is optional, provided just to illustrate that iterations create new projects from existing ones):
 
-**Iterate Without Logic:**
 **Iterate Without Logic:**
 ```bash title='Iterate Without Logic'
 # Step 1 - create without logic
@@ -454,7 +473,6 @@ genai-logic genai --project-name='genai_demo_no_logic' --using=system/genai/exam
 
 Then, we would create another prompt in the docs directory with our model changes. We've already created these for you in `system/genai/examples/genai_demo/genai_demo_iteration` - we use that to alter the data model (see `system/genai/examples/genai_demo/genai_demo_iteration/004_iteration_renames_logic.prompt`):
 
-**Iterate With Logic:**
 **Iterate With Logic:**
 ```bash title='Iterate With Logic'
 # Iterate with data model and logic
@@ -474,7 +492,6 @@ Explore [genai_demo_iteration](system/genai/examples/genai_demo/genai_demo_itera
 
 <br>You can declare rules using dot notation, or more informally:
 
-**Informal Logic (no dot notation):**
 **Informal Logic (no dot notation):**
 ```bash title="Informal Logic (no dot notation)"
 genai-logic genai --using=system/genai/examples/genai_demo/genai_demo_informal.prompt --project-name=genai_demo_informal
@@ -489,7 +506,6 @@ genai-logic genai --using=system/genai/examples/genai_demo/genai_demo_informal.p
 
 <br>You can add new columns/tables, while keeping the prior model intact:
 
-**Multi-Rule Logic:**
 **Multi-Rule Logic:**
 ```bash title="Multi-Rule Logic"
 genai-logic genai --using=system/genai/examples/emp_depts/emp_dept.prompt
@@ -503,14 +519,12 @@ genai-logic genai --using=system/genai/examples/emp_depts/emp_dept.prompt
 
 <br>You can create a project, and ask GenAI for logic suggestions:
 
-**1. Create Project, without Rules:**
 **1. Create Project, without Rules:**
 ```bash title='1. Create Project, without Rules'
 # 1. Create Project, without Rules
 genai-logic genai --project-name='genai_demo_no_logic' --using=system/genai/examples/genai_demo/genai_demo_no_logic.prompt
 ```
 
-**2. Request Rule Suggestions:**
 **2. Request Rule Suggestions:**
 ```bash title="2. Request Rule Suggestions"
 # 2. Request Rule Suggestions
@@ -523,7 +537,6 @@ You can review the [resultant logic suggestions](genai_demo_no_logic/docs/logic_
  * See and edit: `docs/logic_suggestions/002_logic_suggestions.prompt` (used in step 3, below)
     * This corresponds to the Logic Editor - Logic View in the WebGenAI web app
 
-**3. See the rules for the logic:**
 **3. See the rules for the logic:**
 ```bash title="3. See the rules for the logic"
 # 3. See the rule code for the logic
@@ -545,7 +558,6 @@ The [logic suggestions directory](genai_demo_no_logic/docs/logic_suggestions) no
 When you are ready to proceed:
 1. Execute the following to create a *new project* (iteration), with suggested logic:
 
-**4. Create a new project with the Rule Suggestions:**
 **4. Create a new project with the Rule Suggestions:**
 ```bash title="4. Create a new project with the Rule Suggestions"
 # 4. Create a new project with the Rule Suggestions
@@ -583,7 +595,6 @@ The `genai-utils --fixup` fixes such project issues by updating the Data Model a
 
 After starting the [Manager](https://apilogicserver.github.io/Docs/Manager): 
 
-**0. Create Project Requiring Fixup:**
 **0. Create Project Requiring Fixup:**
 ```bash title="0. Create Project Requiring Fixup"
 # 0. Create a project requiring fixup
@@ -602,7 +613,6 @@ Missing Attrs (try genai-logic genai-utils --fixup): ['Customer.balance: constra
 
 To Fix it:
 **1. Run FixUp to add missing attributes to the fixup response data model:**
-**1. Run FixUp to add missing attributes to the fixup response data model:**
 ```bash title="1. Run FixUp to add missing attributes to the fixup response data model"
 # 1. Run FixUp to add missing attributes to the data model
 cd genai_demo_fixup_required
@@ -611,7 +621,6 @@ genai-logic genai-utils --fixup
 
 Finally, use the created [fixup files](genai_demo_fixup_required/docs/fixup/) to rebuild the project:
 **2. Rebuild the project from the fixup response data model:**
-**2. Rebuild the project from the fixup response data model:**
 ```bash title="2. Rebuild the project from the fixup response data model"
 # 2. Rebuild the project from the fixup response data model
 cd ../
@@ -683,7 +692,6 @@ genai-logic genai-utils --rebuild-test-data
 
 <br>You can add new columns/tables, while keeping the prior model intact:
 
-**Iterate:**
 **Iterate:**
 ```bash title="Iterate"
 # create project without creating a file...
@@ -828,7 +836,6 @@ Please see [this doc](https://apilogicserver.github.io/Docs/Sample-AI-ChatGPT/)
 <br>This demo creates and customizes a project, starting from a database:
 
 
-**Quick Basic Demo:**
 **Quick Basic Demo:**
 ```bash title="Quick Basic Demo"
 
@@ -858,7 +865,6 @@ genai-logic rebuild-from-database --db_url=sqlite:///database/db.sqlite
 
 <br>This demo creates and customizes a project, starting from a prompt:
 
-**Quick GenAI Demo:**
 **Quick GenAI Demo:**
 ```bash title="Quick GenAI Demo"
 

samples/nw_sample/api_logic_server_run.py

@@ -32,8 +32,8 @@
 #
 ###############################################################################
 
-api_logic_server__version = '17.01.02'
-api_logic_server_created__on = 'June 21, 2026 20:49:49'
+api_logic_server__version = '17.01.03'
+api_logic_server_created__on = 'June 23, 2026 16:31:54'
 api_logic_server__host = 'localhost'
 api_logic_server__port = '5656'
 
@@ -148,7 +148,7 @@
 AdminLoader.admin_events(flask_app = flask_app, args = args, validation_error = ValidationError)
 
 if __name__ == "__main__":
-    msg = f'API Logic Project loaded (not WSGI), version: 17.01.02\n'
+    msg = f'API Logic Project loaded (not WSGI), version: 17.01.03\n'
     msg += f'.. startup message: {start_up_message}\n'
     if server_setup.is_docker():
         msg += f' (running from docker container at flask_host: {args.flask_host} - may require refresh)\n'
@@ -181,7 +181,7 @@
 
     flask_app.run(host=args.flask_host, threaded=True, port=args.port)
 else:
-    msg = f'API Logic Project Loaded (WSGI), version 17.01.02\n'
+    msg = f'API Logic Project Loaded (WSGI), version 17.01.03\n'
     msg += f'.. startup message: {start_up_message}\n'
 
     if server_setup.is_docker():

samples/nw_sample/database/alembic.ini

@@ -54,7 +54,7 @@ version_path_separator = os  # Use os.pathsep. Default configuration used for ne
 # output_encoding = utf-8
 
 # sqlalchemy.url = driver://user:pass@localhost/dbname -- set by ApiLogicServer 
-sqlalchemy.url = sqlite:////Users/kat/dev/genai-logic/ApiLogicServer-dev/build_and_test/genai-logic/samples/nw_sample/database/db.sqlite
+sqlalchemy.url = sqlite:////Users/val/dev/ApiLogicServer/ApiLogicServer-dev/build_and_test/genai-logic/samples/nw_sample/database/db.sqlite
 
 [post_write_hooks]
 # post_write_hooks defines scripts or Python functions that are run

samples/nw_sample/database/database_discovery/authentication_models.py

@@ -15,8 +15,8 @@
 # Alter this file per your database maintenance policy
 #    See https://apilogicserver.github.io/Docs/Project-Rebuild/#rebuilding
 #
-# Created:  June 21, 2026 20:49:49
-# Database: sqlite:////Users/kat/dev/genai-logic/ApiLogicServer-dev/build_and_test/genai-logic/samples/nw_sample/database/authentication_db.sqlite
+# Created:  June 23, 2026 16:31:54
+# Database: sqlite:////Users/val/dev/ApiLogicServer/ApiLogicServer-dev/build_and_test/genai-logic/samples/nw_sample/database/authentication_db.sqlite
 # Dialect:  sqlite
 #
 # mypy: ignore-errors

samples/nw_sample/database/models.py

@@ -10,8 +10,8 @@
 # Alter this file per your database maintenance policy
 #    See https://apilogicserver.github.io/Docs/Project-Rebuild/#rebuilding
 #
-# Created:  June 21, 2026 20:49:49
-# Database: sqlite:////Users/kat/dev/genai-logic/ApiLogicServer-dev/build_and_test/genai-logic/samples/nw_sample/database/db.sqlite
+# Created:  June 23, 2026 16:31:54
+# Database: sqlite:////Users/val/dev/ApiLogicServer/ApiLogicServer-dev/build_and_test/genai-logic/samples/nw_sample/database/db.sqlite
 # Dialect:  sqlite
 #
 # mypy: ignore-errors

samples/nw_sample/devops/python-anywhere/python_anywhere_wsgi.py

@@ -104,7 +104,7 @@ def application(environ, start_response):
 ## "git clone git@github.com/myusername/myproject.git"
 ## ...or uploaded files to the directory "myproject", then you should
 ## specify "/home/ApiLogicServer/myproject"
-path = '/Users/kat/dev/genai-logic/ApiLogicServer-dev/build_and_test/genai-logic/samples/nw_sample'  # updated in creation process
+path = '/Users/val/dev/ApiLogicServer/ApiLogicServer-dev/build_and_test/genai-logic/samples/nw_sample'  # updated in creation process
 if path not in sys.path:
     sys.path.append(path)
 #

samples/nw_sample/docs/db.dbml

@@ -193,7 +193,7 @@ Table Supplier {
     Ref: EmployeeTerritory.(EmployeeId) > Employee.(Id)
     Ref: EmployeeTerritory.(TerritoryId) > Territory.(Id)
     Ref: Order.(CloneFromOrder) > Order.(Id)
-    Ref: Order.(City, Country) > Location.(country, country)
+    Ref: Order.(Country, City) > Location.(country, country)
     Ref: Order.(CustomerId) > Customer.(Id)
     Ref: Order.(EmployeeId) > Employee.(Id)
     Ref: OrderDetail.(OrderId) > Order.(Id)

samples/nw_sample/ui/admin/authentication_admin.yaml

@@ -1,5 +1,5 @@
 about:
-  date: June 21, 2026 20:49:49
+  date: June 23, 2026 16:31:54
   recent_changes: works with modified safrs-react-admin
   version: 0.0.0
 api_root: '{http_type}://{swagger_host}:{port}/{api}'

samples/nw_sample_nocust/.obsidian/app.json

@@ -0,0 +1 @@
+{}