docs: rewrite user-facing documentation with screenshots (#11)

compliance-agent/src/pipeline/orchestrator.rs

@@ -684,30 +684,36 @@ impl PipelineOrchestrator {
 
         let mut created = 0u32;
         for finding in actionable {
-            // Check if an issue already exists for this fingerprint
-            match tracker
-                .find_existing_issue(owner, tracker_repo_name, &finding.fingerprint)
-                .await
-            {
-                Ok(Some(existing)) => {
-                    tracing::debug!(
-                        "[{repo_id}] Issue already exists for {}: {}",
-                        finding.fingerprint,
-                        existing.external_url
-                    );
-                    continue;
-                }
-                Ok(None) => {}
-                Err(e) => {
-                    tracing::warn!("[{repo_id}] Failed to search for existing issue: {e}");
-                    // Continue and try to create anyway
-                }
-            }
-
             let title = format!(
                 "[{}] {}: {}",
                 finding.severity, finding.scanner, finding.title
             );
+
+            // Check if an issue already exists by fingerprint first, then by title
+            let mut found_existing = false;
+            for search_term in [&finding.fingerprint, &title] {
+                match tracker
+                    .find_existing_issue(owner, tracker_repo_name, search_term)
+                    .await
+                {
+                    Ok(Some(existing)) => {
+                        tracing::debug!(
+                            "[{repo_id}] Issue already exists for '{}': {}",
+                            search_term,
+                            existing.external_url
+                        );
+                        found_existing = true;
+                        break;
+                    }
+                    Ok(None) => {}
+                    Err(e) => {
+                        tracing::warn!("[{repo_id}] Failed to search for existing issue: {e}");
+                    }
+                }
+            }
+            if found_existing {
+                continue;
+            }
             let body = format_issue_body(finding);
             let labels = vec![
                 format!("severity:{}", finding.severity),