docs: final copy edits and clarifications

- Remove interview-specific language from README
- Use real UUID examples instead of <uuid> placeholders
- Clarify Promptfoo testing setup instructions
- Update package.json description to be more generic
- Add helpful comments about token/sessionId in promptfoo config
- Make response examples more realistic

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: mldangelo

README.md

@@ -1,6 +1,6 @@
 # RedScan Lite
 
-A simple chat API server for testing with Promptfoo - perfect for SE interviews.
+A simple chat API server designed for testing with Promptfoo.
 
 ## Getting Started
 
@@ -50,7 +50,7 @@ cd redscan-lite
    npm start
    ```
 
-   The server will run at http://localhost:8080
+   The server runs on http://localhost:8080
 
 4. **Optional: Enable AI responses**
    ```bash
@@ -68,15 +68,15 @@ The API requires authentication. Here's the complete flow:
 curl -X POST http://localhost:8080/auth
 ```
 
-Response: `{ "token": "<uuid>", "ttl": 300 }`
+Response: `{ "token": "550e8400-e29b-41d4-a716-446655440001", "ttl": 300 }`
 
 ### 2. Create a session
 
 ```bash
 curl -X POST http://localhost:8080/session
 ```
 
-Response: `{ "sessionId": "<uuid>" }`
+Response: `{ "sessionId": "660e8400-e29b-41d4-a716-446655440002" }`
 
 ### 3. Send messages
 
@@ -90,14 +90,16 @@ curl -X POST http://localhost:8080/chat \
 
 Response: `{ "message": "<response>", "usage": { "prompt_tokens": 10, "completion_tokens": 15, "total_tokens": 25 } }`
 
-Note: If no session ID is provided, one will be created and returned in the `x-session-id` response header.
+**Note:** If no session ID is provided, one will be created and returned in the `x-session-id` response header.
 
 ## Testing with Promptfoo
 
-Run Promptfoo evaluation:
+The included `promptfooconfig.yaml` is set up to test the API. You'll need to:
+
+1. Get auth token and session ID from the API (see above)
+2. Update the config file with your values, or
+3. Use the echo provider for testing without the API
 
 ```bash
 promptfoo eval
 ```
-
-See `promptfooconfig.yaml` for configuration details.

package.json

@@ -1,7 +1,7 @@
 {
   "name": "redscan-lite",
   "version": "1.0.0",
-  "description": "Target app for Promptfoo SE interviews",
+  "description": "Simple chat API server for testing with Promptfoo",
   "main": "index.js",
   "scripts": {
     "start": "node index.js"

promptfooconfig.yaml

@@ -3,10 +3,11 @@ description: RedScan Lite API Testing
 prompts:
   - "{{prompt}}"
 providers:
-  # Use this echo provider to test without needing authentication
+  # Use the echo provider to test without needing authentication:
   # - id: echo
 
-  # Main provider - requires running the server locally
+  # Main provider - requires the server running on localhost:8080
+  # Before running: Replace {{token}} and {{sessionId}} with actual values from the API
   - id: http
     label: redscan-lite-api
     config: