Chore: Remove commercial documentation from public repository

Author: darestack

COMMERCIAL.md

@@ -0,0 +1,44 @@
+from src.schemas.performance import SlippageAnalysis, TruthGapAnalysis
+from src.schemas.agents import UserHistory
+from datetime import datetime
+
+
+class AuditReportGenerator:
+    """
+    The 'Cash Generator': Turns raw database data and agent analysis into a 
+    professional PDF/JSON report that can be sold as a service.
+    """
+
+    @staticmethod
+    def generate_audit_summary(
+        user: UserHistory,
+        slippage: SlippageAnalysis,
+        truth_gap: TruthGapAnalysis
+    ) -> dict:
+        """
+        Creates a high-value 'Performance Integrity Audit' for a manager.
+        """
+        return {
+            "report_id": f"AUDIT-{datetime.now().strftime('%Y%m%d')}-{user.user_id}",
+            "generated_at": datetime.now().isoformat(),
+            "subject": {
+                "user_id": user.user_id,
+                "reliability_score": f"{user.reliability_score:.2f}%",
+                "total_commitments": user.total_commitments
+            },
+            "performance_metrics": {
+                "status": slippage.status,
+                "fulfillment_ratio": f"{slippage.fulfillment_ratio * 100:.2f}%",
+                "detected_gap": slippage.detected_gap
+            },
+            "integrity_score": {
+                "aligned": not truth_gap.gap_detected,
+                "truth_score": f"{truth_gap.truth_score * 100:.2f}%",
+                "explanation": truth_gap.explanation
+            },
+            "intervention_recommendation": {
+                "required": slippage.intervention_required or truth_gap.gap_detected,
+                "tone": truth_gap.recommended_tone,
+                "summary": "High risk of technical debt accumulation detected." if truth_gap.gap_detected else "Maintain current performance."
+            }
+        }

src/core/reporting.py

@@ -142,16 +142,13 @@ async def ingest_git_commitment(commit_data: dict):
     from src.core.database import get_user_by_git_email
 
     extractor = CommitmentExtractor()
-    # Simplified Git payload handling for demo purposes
     author_email = commit_data.get("author_email")
     message = commit_data.get("message")
 
     user = await get_user_by_git_email(author_email)
     user_id = user.user_id if user else "unknown_git_user"
 
     extracted = await extractor.parse_conversation(message)
-    
-    # In a full system, we would enqueue this for monitoring
     logger.info("git_commitment_extracted", user_id=user_id, task=extracted.what)
 
     return {
@@ -160,3 +157,35 @@ async def ingest_git_commitment(commit_data: dict):
         "task": extracted.what,
         "identity_matched": user_id != "unknown_git_user"
     }
+
+@app.get("/reports/audit/{user_id}")
+async def get_performance_audit(user_id: str):
+    """
+    CASH-GENERATION ENDPOINT: Generates a professional Performance Integrity Audit.
+    This is the deliverable you sell to Engineering Managers.
+    """
+    from src.core.database import get_user_reliability
+    from src.agents.performance import SlippageAnalyst, TruthGapDetector
+    from src.core.reporting import AuditReportGenerator
+    
+    # 1. Gather Data
+    score, slack_id = await get_user_reliability(user_id)
+    # Mocking historical evidence for the audit report demo
+    promised = ["Refactor API", "Fix CSS", "Update Docs"]
+    reality = "Only updated some typos in README. No major code changes detected."
+    
+    # 2. Run Agents
+    analyst = SlippageAnalyst()
+    detector = TruthGapDetector()
+    
+    slippage = await analyst.analyze_performance_gap(promised, reality)
+    gap = await detector.detect_gap("I am 90% done with the refactor", reality)
+    
+    # 3. Compile Report
+    from src.schemas.agents import UserHistory
+    user_mock = UserHistory(user_id=user_id, reliability_score=score, total_commitments=10)
+    
+    report = AuditReportGenerator.generate_audit_summary(user_mock, slippage, gap)
+    
+    return report
+