Blind-Auditor-MCP

Instructions

Implementation Reference

• src/main.py:138-186 (handler)

  The core handler function for the 'submit_draft' tool. It is registered via the @mcp.tool() decorator. This function processes submitted code drafts, updates session state, checks retry limits, generates audit prompts with rules, and handles limit exceeded cases by producing detailed reports.

  @mcp.tool()
  def submit_draft(code: str, language: str = "python") -> str:
      """Submit a code draft for audit."""
      print(f"DEBUG: submit_draft called with code length={len(code)}", file=sys.stderr)
      session.current_code = code
      session.status = "AUDITING"
      
      max_retries = rules_loader.get_max_retries()
      
      # CHANGED: Generate detailed report instead of auto-approving
      if session.retry_count >= max_retries:
          session.status = "LIMIT_EXCEEDED"
          return _generate_detailed_report(session.audit_history, code, language, max_retries)
      
      rules_formatted = rules_loader.format_rules_for_prompt()
      
      return f"""🛑 **[SYSTEM INTERVENTION: CONTEXT ISOLATION MODE]**
  
  **STOP GENERATING**. Do not output the code yet.
  
  You are now entering the **Blind Audit Phase**.
  
  **Rulebook:**
  {rules_formatted}
  
  **Candidate Code:**
  ```{language}
  {code}
  ```
  
  **Instructions:**
  1. **Analyze Step-by-Step (CoT)**:
     - First, list all violations found.
     - Classify each violation by severity (CRITICAL, WARNING, PREFERENCE).
     - Calculate the deduction for each violation.
  
  2. **Scoring Rubric (Strict Enforcement)**:
     - **Start Score**: 100
     - **CRITICAL Violation**: -50 points each (Immediate FAIL)
     - **WARNING Violation**: -15 points each
     - **PREFERENCE Violation**: -5 points each
     - **Maximum Deduction**: 100 points (Minimum Score: 0)
  
  3. **Final Decision**:
     - Call `submit_audit_result` with your findings.
     - **CRITICAL**: If score is < 80, you MUST set passed=False.
     - The system will enforce `score >= 80` to pass.
  """

• src/main.py:138-138 (registration)

  The @mcp.tool() decorator registers the 'submit_draft' function as an MCP tool.

  @mcp.tool()

• src/main.py:139-139 (schema)

  The function signature defines the input schema (code: str, language: str='python') and output (str), along with the tool description.

  def submit_draft(code: str, language: str = "python") -> str: