logic suggestions

Author: valhuber

docs/IDE-Import-WebGenAI.md

@@ -72,8 +72,11 @@ Imports are performed from with the dev project, using the `import-genai` CLI co
 cd system/genai/examples/genai_demo/wg_dev_merge/dev_demo_no_logic_fixed
 als genai-utils --import-genai --using=../wg_demo_no_logic_fixed
 ```
+Observe:
+1. The [data model](system/genai/examples/genai_demo/wg_dev_merge/dev_demo_no_logic_fixed/database) contains `Customer.balance` and `Product.carbon_neutral`
+2. The test data has been updated to include these attributes, with proper values
 
-That will leave things in this state:
+In this example, `als genai-utils --import-genai ...` will leave things in this state:
 
 ![genai-process](images/sample-ai/genai/genai-process-merged-models.png)
 

docs/WebGenAI-CLI.md

@@ -264,7 +264,60 @@ Notes:
 
 ### Logic Suggestions
 
-Coming Soon.
+You can ask GenAI to suggest logic for your system.  This can help you learn about rules, and can inspire your own imagination about required logic.
+
+It's AI, so or course you will want to review the suggestions carefully.
+
+Explore suggestions using the [Manager](Manger.md){:target="_blank" rel="noopener"}:
+
+
+```bash title='1. Create Project, without Rules'
+# 1. Create Project, without Rules
+als genai --project-name='genai_demo_no_logic' --using=system/genai/examples/genai_demo/genai_demo_no_logic.prompt
+```
+
+```bash title="2. Request Rule Suggestions"
+# 2. Request Rule Suggestions
+cd genai_demo_no_logic
+als genai-logic --suggest
+```
+
+You can review the resultant logic suggestions in the `genai_demo_no_logic` project:
+
+ * See and edit: `docs/logic_suggestions/002_logic_suggestions.prompt` (used in step 3, below)
+    * This corresponds to the WebGenAI Logic Editor - Logic View in the WebGenAI web app
+
+```bash title="3. See the rules for the logic"
+# 3. See the rule code for the logic
+als genai-logic --suggest --logic='*'
+```
+
+Important notes about suggestions and generated code:
+* `--suggest --logic='*'` is intended to enable you to identify logic that does not translate into proper code
+* The example above was pretty good, but sometimes the results are downright silly:
+    * Just run suggest again, or
+    * Repair `docs/logic_suggestions/002_logic_suggestions.prompt`
+
+Also...
+* It is not advised to paste the code into `logic/declare_logic.py`
+    * The suggested logic may result in new data model attributes
+    * These are created automatically by running `als genai` (next step)
+
+The [logic suggestions directory](genai_demo_no_logic/docs/logic_suggestions) now contains the prompts to create a new project with the suggested logic.  
+When you are ready to proceed:
+1. Execute the following to create a *new project* (iteration), with suggested logic:
+
+```bash title="4. Create a new project with the Rule Suggestions"
+# 4. Create a new project with the Rule Suggestions
+cd ..  # important - back to manager root dir
+als genai --project-name='genai_demo_with_logic' --using=genai_demo_no_logic/docs/logic_suggestions
+```
+
+Observe:
+1. The created project has the rule suggestions in `logic/declare_logic.py`
+2. A revised Data Model in `database/models.py` that includes attributes introduced by the logic suggestions
+3. Revised test database, initialized to reflect the derivations in the suggested logic
+