Update README.md

Author: AndrewClements84

README.md

@@ -25,12 +25,11 @@ PromptStream.AI enables developers to **compose**, **validate**, **generate**, a
 ### ⚙️ Key Features
 - 🧩 **Token-aware prompt builder** with variable interpolation (`{{variable}}` syntax)
 - ✅ **Validation engine** for token limits, structure, and completeness
-- 🔢 **Integrated token counting** via `ITokenFlowProvider`
+- 💬 **Shared Core Models** from Flow.AI.Core (`PromptTemplate`, `PromptInstance`, `PromptMessage`, `PromptResponse`)
 - 🧠 **Context manager** with replay, merge, summarization, and JSON persistence
-- 💬 **Assistant reply tracking** and multi-turn chat history
 - 💾 **Persistent context storage** (`ToJson` / `LoadFromJson`)
 - 🧮 **Token budgeting tools** (`EstimateTokenUsage`, `TrimToTokenBudget`)
-- ⚡ **CLI utility (`PromptStream.AI.CLI`)** for building, validating, and generating prompts
+- ⚡ **CLI utility (`PromptStream.AI.CLI`)** for building, validating, analyzing, and generating prompts
 - 🔌 Seamless integration with **TokenFlow.AI** for model-aware tokenization
 
 ---
@@ -43,8 +42,8 @@ dotnet add package PromptStream.AI
 
 Requires:
 - .NET 8.0 or higher  
-- Flow.AI.Core  
-- (optional) TokenFlow.AI for model-specific token counting  
+- Flow.AI.Core v0.2.0+  
+- (optional) TokenFlow.AI for advanced token metrics  
 
 ---
 
@@ -53,30 +52,33 @@ Requires:
 ```csharp
 using System;
 using System.Collections.Generic;
+using Flow.AI.Core.Models;
+using Flow.AI.Core.Interfaces;
 using TokenFlow.AI.Integration;
-using PromptStream.AI.Models;
 using PromptStream.AI.Services;
 
-// Create a token provider (TokenFlow.AI adapter)
-var tokenProvider = new TokenFlowProvider("gpt-4o-mini");
+// Initialize the service with token tracking
+var tokenProvider = new BasicTokenFlowProvider();
+var modelClient = new TokenFlowModelClient("gpt-4o-mini");
+var context = new PromptContextManager();
 
-// Initialize PromptStream service (with context-aware memory)
-var service = new PromptStreamService(tokenProvider);
+var service = new PromptStreamService(tokenProvider, context, modelClient);
 
-// Define a prompt template
+// Define a shared Core template
 var template = new PromptTemplate
 {
     Id = "summarize-v1",
     Template = "Summarize the following:\n\n{{input}}\n\nBe concise.",
     RequiredVariables = new() { "input" }
 };
 
-// Build and validate
+// Variables to inject
 var variables = new Dictionary<string, string>
 {
     ["input"] = "Flow.AI enables composable AI workflows for .NET developers."
 };
 
+// Build and validate
 var (instance, validation) = service.BuildAndValidate(template, variables);
 
 if (validation.IsValid)
@@ -89,15 +91,15 @@ else
     Console.WriteLine($"❌ Invalid: {string.Join(", ", validation.Errors)}");
 }
 
-// Add an assistant reply for multi-turn context
-service.AddAssistantReply("Sure! Here's a short summary...");
+// Add a user message to the context
+context.AddMessage(new PromptMessage { Role = "user", Content = instance.RenderedText });
 ```
 
 ---
 
 ### 💻 CLI Usage (`PromptStream.AI.CLI`)
 
-PromptStream.AI now includes a lightweight **command-line interface** for developers to build, validate, and generate prompts directly from the terminal.
+PromptStream.AI includes a full command-line interface for developers to build, validate, analyze, and generate prompts directly from the terminal.
 
 #### 🧩 Build a prompt
 ```bash
@@ -119,67 +121,27 @@ dotnet run --project src/PromptStream.AI.CLI/PromptStream.AI.CLI.csproj -- gener
 dotnet run --project src/PromptStream.AI.CLI/PromptStream.AI.CLI.csproj -- context --load context.json --summarize
 ```
 
+#### 📊 Analyze prompt usage
+```bash
+dotnet run --project src/PromptStream.AI.CLI/PromptStream.AI.CLI.csproj -- analyze --template "Summarize {{topic}}" --var topic="AI" --model gpt-4o-mini
+```
+
 **Available commands:**
 | Command | Description |
 |----------|--------------|
 | `build` | Render a prompt with variable substitution |
 | `validate` | Validate prompt completeness and token limits |
 | `generate` | Build, validate, and produce a model-like response |
 | `context` | Load, save, summarize, or clear conversation context |
+| `analyze` | Estimate token usage and cost for prompts |
 
 ---
 
-### 🧩 Namespace Overview
-
-| Namespace | Description |
-|------------|-------------|
-| `PromptStream.AI.Models` | Core prompt, validation, and message models |
-| `PromptStream.AI.Builders` | Responsible for rendering prompt templates |
-| `PromptStream.AI.Validation` | Handles validation, token limits, and structure |
-| `PromptStream.AI.Services` | High-level orchestrator combining build, validate, and context |
-| `PromptStream.AI.Context` | Manages conversational memory and context tracking |
-| `PromptStream.AI.Extensions` | Utility helpers for interpolation and cleanup |
-| `PromptStream.AI.CLI` | Developer command-line interface for building and testing prompts |
-
----
-
-### 🧪 Testing & Coverage
-
-```bash
-dotnet test --collect:"XPlat Code Coverage"
-```
-
-All core logic is tested using **xUnit** and **coverlet**, with full integration into **Codecov** for continuous coverage tracking.
-
----
-
-### 🗺️ Roadmap
-
-| Feature | Status |
-|----------|---------|
-| Core Models (`PromptTemplate`, `PromptInstance`, `PromptValidationResult`) | ✅ |
-| PromptBuilder & Validator | ✅ |
-| Context Manager & Message Tracking | ✅ |
-| Context Enhancements (merge, summarize, token budgeting, JSON persistence) | ✅ |
-| PromptStreamService orchestration layer | ✅ |
-| Assistant reply integration | ✅ |
-| CLI tool for build, validate, generate, context | ✅ |
-| Token cost estimator (TokenFlow.AI integration) | 🔄 Planned |
-| OpenAI-style function call validation | 🔄 Planned |
-| Visual prompt editor in Flow.AI Studio | 🔄 Planned |
-
----
-
-### 🤝 Contributing
-Contributions are welcome!  
-If you’d like to extend functionality or improve coverage, please fork the repo and submit a pull request.
-
-See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
-
----
+### 🌟 Supporting the Project
 
-### 📜 License
-This project is licensed under the **MIT License** — see the [LICENSE](LICENSE) file for details.
+If you find **PromptStream.AI** helpful, please consider  
+⭐ **starring the repository** and ☕ [**supporting my work**](https://buymeacoffee.com/andrewclements84).  
+Your support helps keep the Flow.AI ecosystem growing.
 
 ---