reorg of materials and docs

Author: jcodella

README.md

@@ -47,7 +47,12 @@ agent_memory_toolkit/          Python library — sync API
     processing.py              AsyncProcessingClient (internal)
 azure_functions/               Durable Functions — orchestrator, activities, HTTP trigger
   prompts/                     LLM system prompts — summarize, facts, user_summary + update variants
-Samples/                       Demo notebooks + sample scripts
+Samples/                       Categorized notebooks, quickstarts, processing examples, advanced flows, and scenarios
+  Notebooks/                   Demo notebooks
+  Quickstarts/                 Minimal local and Cosmos DB examples
+  Processing/                  Focused processing examples
+  Advanced/                    Advanced lifecycle and search examples
+  Scenarios/                   End-to-end scenario examples
 Docs/                          Documentation — concepts, local testing, Azure deployment
 tests/                         Unit + integration tests (pytest)
 ```
@@ -146,6 +151,14 @@ summary = memory.get_user_summary(user_id="user-001")
 
 ---
 
+## Deploy Azure Resources
+
+The [`infra/`](infra/) folder contains the Bicep templates and Azure Developer CLI (`azd`) configuration for provisioning the toolkit's Azure resources end-to-end. It deploys Cosmos DB for NoSQL, AI Foundry model deployments, managed identity and RBAC assignments, and the Azure Function app used for Durable Functions processing.
+
+For deployment prerequisites, configuration options, bring-your-own-resource settings, and cleanup commands, see the [infra README](infra/README.md).
+
+---
+
 ## Azure Resources
 
 | Resource | Purpose |

Samples/advanced_memory_lifecycle.py …es/Advanced/advanced_memory_lifecycle.pySamples/advanced_memory_lifecycle.py renamed to Samples/Advanced/advanced_memory_lifecycle.py Samples/advanced_memory_lifecycle.py renamed to Samples/Advanced/advanced_memory_lifecycle.py

@@ -19,7 +19,7 @@
     "8. **Tagging, salience & deduplication** – tag mutation, salience filter, `reconcile()`\n",
     "9. **Automatic processing (Change Feed)** – optional Azure Function for background processing\n",
     "\n",
-    "> 💡 **Tip:** the synchronous `CosmosMemoryClient` accepts an optional `processor=` kwarg (defaults to `InProcessProcessor`). Pass `DurableFunctionProcessor()` to delegate summarization to the sibling Azure Function app — see `Samples/scenario_remote_processor.py`.\n"
+    "> 💡 **Tip:** the synchronous `CosmosMemoryClient` accepts an optional `processor=` kwarg (defaults to `InProcessProcessor`). Pass `DurableFunctionProcessor()` to delegate summarization to the sibling Azure Function app — see `Samples/Scenarios/scenario_remote_processor.py`.\n"
    ]
   },
   {
@@ -34,7 +34,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 1,
+   "execution_count": null,
    "id": "843cc6f6",
    "metadata": {
     "ExecuteTime": {
@@ -65,43 +65,22 @@
    ],
    "source": [
     "import os, json\n",
-    "\n",
     "from dotenv import load_dotenv\n",
-    "\n",
     "from azure.identity import DefaultAzureCredential\n",
     "\n",
-    "\n",
-    "\n",
     "# Add parent directory to path so we can import the package easily\n",
-    "\n",
     "import sys\n",
-    "\n",
     "sys.path.insert(0, os.path.abspath(\"..\"))\n",
-    "\n",
-    "\n",
-    "\n",
     "from agent_memory_toolkit import CosmosMemoryClient\n",
-    "\n",
-    "\n",
-    "\n",
     "# Load environment variables from .env in the repo root\n",
     "\n",
     "load_dotenv(os.path.join(\"..\", \".env\"))\n",
-    "\n",
-    "\n",
-    "\n",
     "print(\"COSMOS_DB_ENDPOINT:\", os.getenv(\"COSMOS_DB_ENDPOINT\"))\n",
-    "\n",
     "print(\"COSMOS_DB_DATABASE:\", os.getenv(\"COSMOS_DB_DATABASE\"))\n",
-    "\n",
     "print(\"COSMOS_DB_CONTAINER:\", os.getenv(\"COSMOS_DB_CONTAINER\"))\n",
-    "\n",
     "print(\"COSMOS_DB_COUNTERS_CONTAINER:\", os.getenv(\"COSMOS_DB_COUNTERS_CONTAINER\", \"counter\"))\n",
-    "\n",
     "print(\"COSMOS_DB_LEASE_CONTAINER:\", os.getenv(\"COSMOS_DB_LEASE_CONTAINER\", \"leases\"))\n",
-    "\n",
     "print(\"COSMOS_DB_THROUGHPUT_MODE:\", os.getenv(\"COSMOS_DB_THROUGHPUT_MODE\", \"serverless\"))\n",
-    "\n",
     "print(\"COSMOS_DB_AUTOSCALE_MAX_RU:\", os.getenv(\"COSMOS_DB_AUTOSCALE_MAX_RU\", \"1000\"))"
    ]
   },