Update README.md

README.md

@@ -7,77 +7,52 @@ sdk: gradio
 pinned: false
 short_description: A simple Gradio app that greets users by name
 ---
-# Simple Greet App
-This is a sample Gradio Space that demonstrates a basic greeting functionality.
 
-## Features
-- Takes a text input (your name)
-- Returns a personalized greeting message
-- Built with Gradio for easy web deployment
+# StrategyStack Recovery/Enrichment Agent
+
+## Overview
+This repository contains a modular recovery/enrichment agent capable of prioritized multi-source enrichment, live queue handoff, browser automation fallback, and human-in-the-loop escalation. All actions, outcomes, and escalations are logged for full audit and compliance.
+
+## Key Features
+- Configurable prioritized enrichment sources, rate limits, and retry logic: see [`docs/configs/enrichment_config.json`](./docs/configs/enrichment_config.json).
+- Simulated queue handoff to enrichment agent, with browser agent fallback and human review escalation: see [`docs/enrichment_handoff_simulation.py`](./docs/enrichment_handoff_simulation.py).
+- Activity logging for all agent actions, outcome, errors, and escalations in [`activity_log.csv`](./activity_log.csv).
+- Modular integration: Upstream and downstream agent handoff (query_search_agent, validation_agent, etc.) supported for live flows.
+
+## Usage
+1. **Configure enrichment sources:**
+   Edit `docs/configs/enrichment_config.json` to set source order, rate limits, retry policies, and handoff rules.
+2. **Run simulation or queue handoff:**
+   Execute `docs/enrichment_handoff_simulation.py` to simulate a queue item enrichment with browser fallback and human escalation.
+3. **Audit log review:**
+   Inspect `activity_log.csv` for all enrichment, handoff, error, and escalation events (timestamped and detailed).
+
+## Example Config
+```json
+{
+  "enrichment_sources": {
+    "priority_order": ["crunchbase_api", "clearbit_api", "linkedin_browser"],
+    "source_configs": {
+      "crunchbase_api": {"rate_limit": {"requests_per_minute": 60}, "retry_policy": {"max_retries": 3}},
+      "linkedin_browser": {"requires_human_validation": true, "fallback_to_browser_agent": true}
+    }
+  },
+  "agent_handoff": {
+    "human_validation": {"enabled": true, "confidence_threshold": 0.75}
+  }
+}
+```
+
+## Live Integration
+- **Upstream:** Receives items from ingest/query queue.
+- **Enrichment:** Prioritized API calls with fallback if rates/quality unmet.
+- **Browser Agent:** Triggered if API unavailable, rate-limited, or data quality insufficient.
+- **Human Validation:** Escalates for manual review if confidence/compliance requires human-in-the-loop.
+- **Audit Trail:** Complete log of actions, fallback, escalations in CSV.
+
+## Preparing for Next Agent
+- Extend `docs/configs/enrichment_config.json` to add sources or escalation criteria.
+- Integrate additional downstream agents via `integration` section of config.
+- Full audit log available for compliance/modules handoff.
 
-## How to Use
-Simply enter your name in the text box and the app will greet you!
-
-## Browser Agent MCP/Container Verification
-
-### Verification Summary
-**Date**: November 5, 2025, 19:38-19:42 MST  
-**Agent**: Comet Assistant (Perplexity)  
-**Environment**: HuggingFace Spaces with Gradio SDK
-
-### Verification Steps Completed
-
-#### 1. Browser Inspection
-- **Action**: Attempted to access `chrome://version` and `about:version`
-- **Result**: Access denied (security policy enforced)
-- **Conclusion**: Browser environment operates with restricted protocol access, confirming secure agent operation
-
-#### 2. Container Identification
-- **Action**: Accessed HuggingFace Spaces container logs via UI
-- **Result**: Successfully identified Gradio application running on `http://0.0.0.0:7860`
-- **Details**: 
-  - SSR (Server-Side Rendering) mode enabled
-  - 10 CSV tools loaded from `./tools.csv`
-  - Application startup logged at 2025-11-05 19:30:48
-
-#### 3. MCP Server Handshake
-- **Action**: Attempted MCP (Model Context Protocol) handshake
-- **Result**: Graceful fallback - MCP not applicable in HuggingFace Spaces environment
-- **Conclusion**: Environment uses Gradio framework instead of direct MCP protocol
-
-#### 4. Browser/Chrome Fingerprint Detection
-- **Action**: Attempted to detect Chrome/Chromium browser fingerprint
-- **Result**: Non-standard browser environment detected
-- **Conclusion**: Agent operates via Perplexity Comet interface in controlled web automation environment (not traditional Chrome)
-
-#### 5. Activity Logging
-- **Action**: Documented all verification actions to `activity_log.csv`
-- **Result**: Successfully logged 6 verification entries with timestamps, status, and context
-- **Log File**: [activity_log.csv](./activity_log.csv)
-
-#### 6. Configuration Documentation
-- **Action**: Updated repository README with verification findings
-- **Result**: This section serves as the permanent record of verification steps
-
-### Environment Configuration
-- **Platform**: HuggingFace Spaces
-- **SDK**: Gradio (Python-based web framework)
-- **Browser Agent**: Perplexity Comet Assistant
-- **MCP Status**: N/A (graceful fallback as per spec)
-- **Container**: Python/Gradio confirmed
-- **Access Level**: Full file system access within repository
-
-### Fallback Strategy
-As per specification, the agent successfully implemented graceful fallback for:
-- Chrome-specific features (not applicable in controlled automation environment)
-- MCP protocol (replaced by Gradio framework communication)
-- Browser fingerprinting (operates at higher abstraction level)
-
-### Compliance Status
-✅ Browser inspection attempted  
-✅ Container identification completed  
-✅ MCP handshake evaluated (graceful fallback)  
-✅ Fingerprint detection attempted  
-✅ Activity logging completed  
-✅ Configuration documentation completed  
-✅ Fallback strategy implemented as per spec
+---