fixup and rebuild-test-data

Author: valhuber

.vscode/Docs.code-workspace

@@ -5,7 +5,7 @@
 		}
 	],
 	"settings": {
-		"workbench.colorTheme": "Colored Theme (Green malachite)",
-		"workbench.preferredLightColorTheme": "Colored Theme (Green malachite)"
+		"workbench.colorTheme": "Blue Light Theme",
+		"workbench.preferredLightColorTheme": "Blue Light Theme"
 	}
 }

docs/IDE-Fixup-Attrs.md

@@ -0,0 +1,46 @@
+!!! pied-piper ":bulb: TL;DR - Fixup Missing Attributes"
+
+    When adding rules, such as using suggestions, you may introduce new attributes.
+    If these are missing, you will see exceptions when you start your project.
+    
+    The `genai-utils` fixes such project issues by updating the Data Model and Test Data:
+
+    1. Collects the latest model, rules, and test data from the project. 
+    2. Calls ChatGPT (or similar) to resolve missing columns or data in the project.
+    3. Saves the fixup request/response under a 'fixup' folder.
+    4. You then use this to create a new project
+
+## Using Fixup
+
+### Setup
+After starting the [Manager](Manager.md){:target="_blank" rel="noopener"}: 
+
+```bash title="0. Create Project Requiring Fixup"
+# 0. Create a project requiring fixup
+als genai --using=genai_demo.prompt --repaired-response=system/genai/examples/genai_demo/genai_demo_fixup_required.json --project-name=genai_demo_fixup_required
+```
+
+If you run this project, you will observe that it fails with:
+```bash
+Logic Bank Activation Error -- see https://apilogicserver.github.io/Docs/WebGenAI-CLI/#recovery-options
+Invalid Rules:  [AttributeError("type object 'Customer' has no attribute 'balance'")]
+Missing Attrs (try als genai-utils --fixup): ['Customer.balance: constraint']
+```
+ 
+
+### Fixup
+To Fix it:
+```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
+als genai-utils --fixup
+```
+
+Finally, rebuild the project:
+```bash title="2. Rebuild the project from the fixup response data model"
+# 2. Rebuild the project from the fixup response data model
+cd ../
+als genai --using=genai_demo.prompt --repaired-response=genai_demo_fixup_required/docs/fixup/response_fixup.json
+```
+    
+ 

docs/IDE-Import-WebGenAI.md

@@ -0,0 +1,7 @@
+!!! pied-piper ":bulb: TL;DR - Import WebGenAI Project"
+
+    You can import WegGenAI projects, merging their data models and rules into a dev project.
+
+    Under construction, coming soon.
+    
+ 

docs/IDE-Rebuild-Test-Data.md

@@ -0,0 +1,17 @@
+!!! pied-piper ":bulb: TL;DR - Rebuild Test Data"
+
+    Proper rule operation requires existing data be correct - see [Data ModelD esign](Data-Model-Design){:target="_blank" rel="noopener"}.
+
+    ChatGPT sometimes fails to properly compute the tests data.  You can rebuild your test data to match the derivation rules by using `genai-utils --rebuild-test-data`.
+
+
+Fixes project issues by rebuilding the database to conform to the derivation rules:
+
+1. Create genai_demo: `als genai --using=system/genai/examples/genai_demo/genai_demo.prompt --project-name=genai_demo`
+2. Rebuild:
+```
+cd genai_demo
+als genai-utils --rebuild-test-data
+```
+    
+ 

mkdocs.yml

@@ -90,7 +90,11 @@ nav:
   - 5. Application Integration:
     - "Sample Integration": Sample-Integration.md
     - "Integration Mapping": Integration-Map.md
-  - "Customize Using Your IDE": IDE-Customize.md
+  - IDE - Customize, Manage:
+    - "Customize Using Your IDE": IDE-Customize.md
+    - "Fixup - missing attributes": IDE-Fixup-Attrs.md
+    - "Import / Merge WebGenai": IDE-Import-WebGenAI.md
+    - "Rebuild Test Data": IDE-Rebuild-Test-Data.md
   - Database:
     - "Connection Examples, Debug": Database-Connectivity.md
     - "Database Diagram": Database-Diagram.md