# Start API server
python api.py

# Launch GUI application
python gui.py

# Install Claude Code CLI (required)
curl -sSf https://claude.ai/install.sh | sh

# Verify installation
claude --version

# Install Python 3.11+
python3 --version

# Clone repository
git clone https://github.com/your-org/DocAutomate.git
cd DocAutomate

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Configure environment
cp .env.example .env
# Edit .env with your settings

# Development mode
python api.py

# Production mode with Uvicorn
uvicorn api:app --host 0.0.0.0 --port 8000 --workers 4

# API available at: http://localhost:8000
# Interactive docs: http://localhost:8000/docs

# Start the native GUI application
python gui.py

# Upload a document for processing
curl -X POST "http://localhost:8000/documents/upload" \
  -H "Content-Type: multipart/form-data" \
  -F "[email protected]" \
  -F "auto_process=true"

# Response
{
  "document_id": "doc_a1b2c3d4",
  "filename": "document.pdf",
  "status": "processing",
  "message": "Document uploaded and queued for Claude Code processing",
  "extracted_actions": null
}

# Get all documents
curl "http://localhost:8000/documents"

# Filter by status
curl "http://localhost:8000/documents?status=processed"

# Response
[
  {
    "document_id": "doc_a1b2c3d4",
    "filename": "document.pdf",
    "status": "processed",
    "ingested_at": "2024-09-25T10:30:00Z",
    "content_type": "application/pdf",
    "size": 1024000,
    "claude_agent": "technical-writer",
    "quality_score": 0.92,
    "workflow_runs": ["run_123", "run_456"],
    "extracted_actions": [
      {
        "action_type": "review",
        "description": "Technical review required"
      }
    ]
  }
]

# Get specific document details
curl "http://localhost:8000/documents/doc_a1b2c3d4"

# Response
{
  "document_id": "doc_a1b2c3d4",
  "filename": "document.pdf",
  "status": "processed",
  "ingested_at": "2024-09-25T10:30:00Z",
  "content_type": "application/pdf",
  "size": 1024000,
  "claude_analysis": {
    "primary_agent": "technical-writer",
    "quality_score": 0.92,
    "issues_found": [
      {
        "type": "clarity",
        "severity": "medium",
        "description": "Section 3.2 needs clarification",
        "location": {"section": "3.2", "lines": [45, 60]}
      }
    ],
    "recommendations": [
      "Add concrete examples to section 3.2",
      "Include error handling documentation"
    ]
  },
  "workflow_runs": ["run_123"],
  "extracted_actions": []
}

# Extract actions from a document
curl -X POST "http://localhost:8000/documents/doc_a1b2c3d4/extract" \
  -H "Content-Type: application/json" \
  -d '{
    "extraction_config": {
      "action_types": ["review", "signature", "approval"],
      "confidence_threshold": 0.8
    }
  }'

# Response
{
  "document_id": "doc_a1b2c3d4",
  "extracted_actions": [
    {
      "action_id": "act_001",
      "action_type": "signature",
      "description": "CEO signature required",
      "confidence": 0.95,
      "location": "page 5",
      "deadline": "2024-10-01"
    },
    {
      "action_id": "act_002",
      "action_type": "review",
      "description": "Legal review needed",
      "confidence": 0.88,
      "assigned_to": "legal_team"
    }
  ],
  "extraction_method": "claude_code",
  "agent_used": "requirements-analyst"
}

# Perform parallel multi-agent analysis
curl -X POST "http://localhost:8000/documents/doc_a1b2c3d4/analyze" \
  -H "Content-Type: application/json" \
  -d '{
    "agents": ["technical-writer", "security-engineer", "quality-engineer"],
    "parallel": true,
    "claude_config": {
      "superclaude_modes": ["--delegate", "--parallel"],
      "quality_threshold": 0.85
    }
  }'

# Response
{
  "document_id": "doc_a1b2c3d4",
  "analysis": {
    "technical-writer": {
      "success": true,
      "confidence": 0.9,
      "claude_command": "--delegate technical-writer",
      "findings": {
        "clarity_score": 0.78,
        "completeness": 0.85,
        "issues": ["Missing examples in section 3", "Unclear terminology"]
      }
    },
    "security-engineer": {
      "success": true,
      "confidence": 0.88,
      "claude_command": "--delegate security-engineer",
      "findings": {
        "security_score": 0.92,
        "vulnerabilities": [],
        "recommendations": ["Add authentication flow diagram"]
      }
    },
    "quality-engineer": {
      "success": true,
      "confidence": 0.91,
      "claude_command": "--delegate quality-engineer",
      "findings": {
        "quality_score": 0.86,
        "test_coverage": "incomplete",
        "missing_tests": ["edge cases", "error scenarios"]
      }
    }
  },
  "processing_time": 0.12,
  "parallel_execution": true
}

# Synthesize multi-agent analysis with consensus
curl -X POST "http://localhost:8000/documents/doc_a1b2c3d4/synthesize" \
  -H "Content-Type: application/json" \
  -d '{
    "analysis_data": {
      "technical-writer": {...},
      "security-engineer": {...},
      "quality-engineer": {...}
    },
    "consensus_config": {
      "models": ["gpt-5", "claude-opus-4.1", "gpt-4.1"],
      "agreement_threshold": 0.85
    }
  }'

# Response
{
  "document_id": "doc_a1b2c3d4",
  "synthesis": {
    "overall_quality_score": 0.85,
    "critical_issues": [
      {
        "issue": "Missing authentication documentation",
        "severity": "high",
        "agreed_by": ["gpt-5", "claude-opus-4.1", "gpt-4.1"]
      }
    ],
    "recommendations": [
      {
        "recommendation": "Add code examples",
        "priority": "high",
        "impact": 0.15
      }
    ],
    "consensus": {
      "agreement_score": 0.92,
      "models_used": ["gpt-5", "claude-opus-4.1", "gpt-4.1"],
      "claude_command": "--zen consensus"
    }
  }
}

# Generate remediated document
curl -X POST "http://localhost:8000/documents/doc_a1b2c3d4/remediate" \
  -H "Content-Type: application/json" \
  -d '{
    "issues": [
      {
        "id": "clarity_section_3_2",
        "type": "clarity",
        "severity": "medium",
        "description": "Section 3.2 needs concrete examples"
      }
    ],
    "claude_config": {
      "agent": "technical-writer",
      "quality_target": 0.92,
      "max_iterations": 3
    }
  }'

# Response
{
  "document_id": "doc_a1b2c3d4",
  "remediation": {
    "success": true,
    "remediated_path": "/docs/generated/doc_a1b2c3d4/remediated_document.md",
    "issues_resolved": ["clarity_section_3_2"],
    "quality_improvement": {
      "before": 0.78,
      "after": 0.92,
      "improvement": "+18%"
    },
    "changes_made": [
      "Added 3 concrete examples to section 3.2",
      "Clarified technical terminology",
      "Enhanced code snippets with context"
    ],
    "claude_command": "--delegate technical-writer --loop"
  }
}

# Validate document against quality standards
curl -X POST "http://localhost:8000/documents/doc_a1b2c3d4/validate" \
  -H "Content-Type: application/json" \
  -d '{
    "validation_config": {
      "standards": ["ISO-9001", "technical-writing-best-practices"],
      "minimum_score": 0.85
    },
    "claude_config": {
      "models": ["gpt-5", "claude-opus-4.1"],
      "validation_type": "comprehensive"
    }
  }'

# Response
{
  "document_id": "doc_a1b2c3d4",
  "validation": {
    "overall_valid": true,
    "quality_score": 0.88,
    "standards_compliance": {
      "ISO-9001": "compliant",
      "technical-writing-best-practices": "mostly_compliant"
    },
    "validation_details": {
      "completeness": 0.90,
      "accuracy": 0.92,
      "clarity": 0.84,
      "compliance": 0.86
    },
    "recommendations": [
      "Minor improvements needed in clarity section"
    ],
    "claude_command": "--zen-review --thinkdeep"
  }
}

# Get all available workflows
curl "http://localhost:8000/workflows"

# Response
{
  "workflows": [
    {
      "name": "document_review",
      "description": "Multi-stage document review process",
      "version": "1.0.0",
      "steps": 5,
      "average_duration": "5 minutes"
    },
    {
      "name": "legal_compliance",
      "description": "Legal compliance verification workflow",
      "version": "2.0.0",
      "steps": 8,
      "average_duration": "10 minutes"
    },
    {
      "name": "invoice_processing",
      "description": "Extract and process invoice data",
      "version": "1.2.0",
      "steps": 4,
      "average_duration": "3 minutes"
    }
  ],
  "total": 3
}

# Get specific workflow configuration
curl "http://localhost:8000/workflows/document_review"

# Response
{
  "name": "document_review",
  "description": "Multi-stage document review process",
  "version": "1.0.0",
  "steps": [
    {
      "step_id": "classify",
      "name": "Document Classification",
      "agent": "general-purpose",
      "description": "Classify document type and structure"
    },
    {
      "step_id": "analyze",
      "name": "Multi-Agent Analysis",
      "agents": ["technical-writer", "quality-engineer"],
      "parallel": true
    },
    {
      "step_id": "synthesize",
      "name": "Synthesis",
      "agent": "system-architect"
    },
    {
      "step_id": "validate",
      "name": "Quality Validation",
      "agent": "quality-engineer"
    },
    {
      "step_id": "report",
      "name": "Generate Report",
      "agent": "technical-writer"
    }
  ],
  "parameters": [
    {
      "name": "quality_threshold",
      "type": "float",
      "default": 0.85,
      "required": false
    },
    {
      "name": "document_id",
      "type": "string",
      "required": true
    }
  ]
}

# Execute a workflow on a document
curl -X POST "http://localhost:8000/workflows/execute" \
  -H "Content-Type: application/json" \
  -d '{
    "document_id": "doc_a1b2c3d4",
    "workflow_name": "document_review",
    "parameters": {
      "quality_threshold": 0.9,
      "enable_remediation": true
    },
    "auto_execute": true
  }'

# Response
{
  "run_id": "run_xyz789",
  "workflow_name": "document_review",
  "document_id": "doc_a1b2c3d4",
  "status": "running",
  "message": "Workflow execution started successfully",
  "estimated_completion": "2024-09-25T10:35:00Z"
}

# Get all workflow runs
curl "http://localhost:8000/workflows/runs"

# Filter by status
curl "http://localhost:8000/workflows/runs?status=completed"

# Filter by document
curl "http://localhost:8000/workflows/runs?document_id=doc_a1b2c3d4"

# Response
[
  {
    "run_id": "run_xyz789",
    "workflow_name": "document_review",
    "document_id": "doc_a1b2c3d4",
    "status": "completed",
    "started_at": "2024-09-25T10:30:00Z",
    "completed_at": "2024-09-25T10:34:30Z",
    "duration": "4m 30s",
    "result": "success"
  },
  {
    "run_id": "run_abc456",
    "workflow_name": "legal_compliance",
    "document_id": "doc_x9y8z7",
    "status": "running",
    "started_at": "2024-09-25T10:32:00Z",
    "current_step": "validation",
    "progress": 0.75
  }
]

# Get specific workflow run details
curl "http://localhost:8000/workflows/runs/run_xyz789"

# Response
{
  "run_id": "run_xyz789",
  "workflow_name": "document_review",
  "document_id": "doc_a1b2c3d4",
  "status": "completed",
  "started_at": "2024-09-25T10:30:00Z",
  "completed_at": "2024-09-25T10:34:30Z",
  "duration": "4m 30s",
  "steps_completed": [
    {
      "step_id": "classify",
      "status": "completed",
      "duration": "30s",
      "result": {"document_type": "technical_spec"}
    },
    {
      "step_id": "analyze",
      "status": "completed",
      "duration": "2m",
      "result": {"quality_score": 0.85}
    },
    {
      "step_id": "synthesize",
      "status": "completed",
      "duration": "1m",
      "result": {"issues_found": 3}
    },
    {
      "step_id": "validate",
      "status": "completed",
      "duration": "45s",
      "result": {"validation_passed": true}
    },
    {
      "step_id": "report",
      "status": "completed",
      "duration": "15s",
      "result": {"report_path": "/reports/run_xyz789.pdf"}
    }
  ],
  "final_result": {
    "success": true,
    "quality_score": 0.88,
    "report_generated": true,
    "report_path": "/reports/run_xyz789.pdf"
  }
}

# Execute complete document processing orchestration
curl -X POST "http://localhost:8000/orchestrate/workflow" \
  -H "Content-Type: application/json" \
  -d '{
    "document_id": "doc_a1b2c3d4",
    "workflow_type": "full",
    "claude_config": {
      "superclaude_modes": ["--delegate", "--task-manage", "--thinkdeep"],
      "agents": ["technical-writer", "security-engineer", "quality-engineer"],
      "models": ["gpt-5", "claude-opus-4.1"],
      "quality_threshold": 0.9,
      "max_iterations": 3
    }
  }'

# Response
{
  "orchestration_id": "orch_12345678",
  "document_id": "doc_a1b2c3d4",
  "status": "processing",
  "message": "Full orchestration workflow initiated",
  "workflow_type": "full",
  "estimated_completion": "2024-09-25T10:40:00Z",
  "claude_workflow": {
    "commands_queued": [
      "--delegate --parallel 'Multi-agent analysis'",
      "--zen consensus 'Validate findings'",
      "--delegate technical-writer 'Remediate issues'",
      "--zen-review 'Final validation'"
    ],
    "agents_assigned": ["technical-writer", "security-engineer", "quality-engineer"],
    "models_configured": ["gpt-5", "claude-opus-4.1"]
  }
}

# Get orchestration run status
curl "http://localhost:8000/orchestrate/runs/orch_12345678"

# Response
{
  "orchestration_id": "orch_12345678",
  "document_id": "doc_a1b2c3d4",
  "status": "running",
  "current_step": "remediation",
  "steps_completed": ["analysis", "consensus"],
  "message": "Generating remediated document",
  "progress": {
    "percentage": 0.75,
    "current_step": 3,
    "total_steps": 4
  },
  "intermediate_results": {
    "analysis": {
      "quality_score": 0.82,
      "issues_found": 5
    },
    "consensus": {
      "agreement_score": 0.91,
      "critical_issues": 2
    }
  },
  "estimated_remaining": "2 minutes"
}

# Compress a folder to zip
curl -X POST "http://localhost:8000/documents/compress-folder" \
  -H "Content-Type: application/json" \
  -d '{
    "folder_path": "/path/to/folder",
    "output_name": "archive.zip",
    "include_patterns": ["*.pdf", "*.docx"],
    "exclude_patterns": ["temp/*"]
  }'

# Response
{
  "success": true,
  "archive_path": "/path/to/archive.zip",
  "files_included": 25,
  "total_size": "15MB",
  "compression_ratio": 0.65
}

# Convert Word document to PDF
curl -X POST "http://localhost:8000/documents/convert/docx-to-pdf" \
  -H "Content-Type: multipart/form-data" \
  -F "[email protected]"

# Response
{
  "success": true,
  "pdf_path": "/converted/document.pdf",
  "original_file": "document.docx",
  "conversion_time": "2.3s",
  "file_size": {
    "original": "2.5MB",
    "converted": "1.8MB"
  }
}

# Convert multiple documents
curl -X POST "http://localhost:8000/documents/convert/batch" \
  -H "Content-Type: application/json" \
  -d '{
    "document_ids": ["doc_001", "doc_002", "doc_003"],
    "target_format": "pdf",
    "parallel": true
  }'

# Response
{
  "batch_id": "batch_123",
  "total_documents": 3,
  "successful": 3,
  "failed": 0,
  "results": [
    {
      "document_id": "doc_001",
      "status": "success",
      "output_path": "/converted/doc_001.pdf"
    },
    {
      "document_id": "doc_002",
      "status": "success",
      "output_path": "/converted/doc_002.pdf"
    },
    {
      "document_id": "doc_003",
      "status": "success",
      "output_path": "/converted/doc_003.pdf"
    }
  ],
  "processing_time": "5.2s"
}

# Get API information
curl "http://localhost:8000/"

# Response
{
  "name": "DocAutomate API",
  "version": "2.0.0",
  "description": "Enterprise Document Processing via Claude Code Delegation",
  "documentation": "http://localhost:8000/docs",
  "health": "http://localhost:8000/health",
  "features": [
    "Universal document processing",
    "Pure Claude Code delegation",
    "Multi-agent orchestration",
    "DSL-driven configuration",
    "Multi-model consensus validation",
    "Desktop GUI application"
  ]
}

# Get system health status
curl "http://localhost:8000/health"

# Response
{
  "status": "healthy",
  "timestamp": "2024-09-25T10:35:00Z",
  "components": {
    "api": {
      "status": "operational",
      "response_time_ms": 5
    },
    "dsl_engine": {
      "status": "operational",
      "configurations_loaded": 3,
      "version": "1.0.0"
    },
    "claude_cli": {
      "status": "operational",
      "version": "1.2.3",
      "path": "/usr/local/bin/claude",
      "superclaude_framework": "enabled"
    },
    "agent_registry": {
      "status": "operational",
      "registered_agents": 12,
      "active_agents": ["technical-writer", "security-engineer", "quality-engineer"]
    },
    "mcp_servers": {
      "status": "operational",
      "available": ["zen", "sequential", "magic", "playwright", "deepwiki"],
      "active": ["zen", "sequential"]
    },
    "workflow_engine": {
      "status": "operational",
      "workflows_loaded": 8,
      "active_runs": 2
    }
  },
  "claude_integration": {
    "models_available": ["gpt-5", "claude-opus-4.1", "gpt-4.1"],
    "default_model": "gpt-5",
    "consensus_enabled": true,
    "parallel_processing": true
  },
  "system_metrics": {
    "uptime": "4d 3h 25m",
    "documents_processed": 1547,
    "average_processing_time": "3.2 minutes",
    "success_rate": 0.98
  }
}

# Available modes and their usage
--brainstorm      # Collaborative discovery for requirements
--task-manage     # Multi-step operation orchestration
--delegate        # Intelligent agent routing
--parallel        # Concurrent multi-agent execution
--thinkdeep       # Deep analysis with GPT-5 (50K tokens)
--zen-review      # Production-grade validation
--consensus       # Multi-model agreement
--safe-mode       # Maximum safety for sensitive data
--loop            # Iterative improvement until threshold
--uc              # Ultra-compressed output mode

# Check installation
which claude
claude --version

# Reinstall if needed
curl -sSf https://claude.ai/install.sh | sh
export PATH="/root/.local/bin:$PATH"

# Ensure API is running
curl http://localhost:8000/health

# Check Claude CLI
python -c "from claude_cli import ClaudeCLI; c = ClaudeCLI(); print(c.check_claude())"

# Verify GUI can import modules
python -c "import tkinter; import httpx; print('Dependencies OK')"

# Clone repository
git clone https://github.com/your-org/DocAutomate.git
cd DocAutomate

# Setup development environment
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# Run tests
pytest tests/ -v --cov=docautomate

# Test GUI
python gui.py