Merge pull request #27 from Jalen-Stephens/24-service-implement-c2pa-tool-to-automatically-download-via-pomxml-for-all-operating-systems

[c2pa] Implementation of C2PA across all platforms

Author: Jalen-Stephens

.gitignore

@@ -35,9 +35,4 @@ build/
 ### Enviroment Variables ###
 .env
 env.local.sh
-
-### C2PA and Tools ###
-/tools/
-
-
 env.pooler.sh

README.md

@@ -135,4 +135,9 @@ This section includes notes on tools and technologies used in building this proj
   * JUnit tests get run automatically as part of the CI pipeline.
 * JaCoCo
   * We use JaCoCo for generating code coverage reports.
-  * Originally we were planning on using Cobertura, however Cobertura does not support our version of Java.
+  * Originally we were planning on using Cobertura, however Cobertura does not support our version of Java.
+* c2patool
+  * We use the open-source c2patool to scrape manifest metadata for determining the usage of AI in generating an image.
+  * Coalition for Content Provenance and Authenticity (C2PA). *c2patool (Version 0.23.4)*.  
+  * Content Authenticity Initiative, Adobe Systems, 2024.  
+  * Available at: https://github.com/contentauth/c2pa-rs

citations.md

@@ -563,38 +563,6 @@ The AI helped ensure that the **C2PAtool binary** (used for AI-image authenticit
 
 ---
 
-### **Purpose of AI Assistance**
-Assistance was used to **debug and configure Maven build behavior** for the `AnalyzeService` Spring Boot service.  
-The AI helped ensure that the **C2PAtool binary** (used for AI-image authenticity verification) is correctly downloaded, unpacked, and persisted across build phases so it remains executable both locally and in deployment.  
-
----
-
-### **Prompts / Interaction Summary**
-- Asked why `mvn package` wasn’t producing the `tools/c2patool` binary.  
-- Requested possible solutions to `pom.xml` configuration using `download-maven-plugin` and `maven-antrun-plugin`.  
-- Troubleshot successive build errors (e.g. "file is directory", missing binary). 
-- Asked how to keep the binary after packaging and why Maven was deleting it.  
-- Requested an explanation of the final working solution and how to preserve the executable between builds.  
-
----
-
-### **Resulting Artifacts**
-- **Edited File:** `pom.xml`  
-  - Added `download-maven-plugin` section to fetch `c2patool-v0.9.12-universal-apple-darwin.zip`.  
-  - Added `maven-antrun-plugin` section to unzip, copy, chmod, and retain the binary.  
-- **New Directory:** `tools/` (containing executable `c2patool`)  
-- **Build Artifact:** Verified Maven package with `tools/c2patool` present and executable.  
-
----
-
-### **Verification**
-- Ran `mvn clean package` to confirm the binary appears at `./tools/c2patool`.  
-- Executed `./tools/c2patool --version` to verify the file runs successfully.  
-- Rebuilt the Spring Boot JAR to ensure the `tools/` directory remains intact after packaging.  
-- Manually inspected Maven logs and filesystem to confirm that no cleanup phase deletes the binary.  
-
----
-
 ### **Commit / Ticket Reference**
 
 * **Commit:** `feat(auth): add Supabase auth proxy + /auth endpoints + JWKS resource server config (refs #7)`
@@ -1050,4 +1018,64 @@ Helped implement the controller logic integrating with the `ImageService`, updat
 
 > Portions of this commit or configuration were generated with assistance from OpenAI ChatGPT (GPT-5) on October 22, 2025. All AI-generated content was reviewed, verified, and finalized by the development team.
 
----
+---
+
+### **Commit / Ticket Reference**
+
+* **Commit:** `test(c2pa): add unit tests for C2paToolInvoker to validate tool invocation and error handling`
+* **Ticket:** `#24 — Ensure c2patool Functionality Across All Systems and Build Unit Tests for C2paToolInvoker`
+* **Date:** October 22, 2025
+* **Team Member:** Isaac Schmidt
+
+---
+
+### **AI Tool Information**
+
+* **Tool Used:** OpenAI ChatGPT (GPT-5)
+* **Access Method:** ChatGPT Web (.edu academic access)
+* **Configuration:** Default model settings
+* **Cost:** $0 (no paid API calls)
+
+---
+
+### **Purpose of AI Assistance**
+
+The AI assisted in designing and implementing unit tests for the `C2paToolInvoker` class. These tests validate the correct invocation of the `c2patool` binary, handle various error scenarios, and ensure proper exception handling. The AI also provided guidance on creating temporary files for testing and structuring the test cases to cover success and failure paths.
+
+---
+
+### **Prompts / Interaction Summary**
+
+* Asked for a unit test suite for `C2paToolInvoker` to validate tool invocation.
+* Requested test cases for scenarios like:
+  - Successful manifest extraction.
+  - Non-existent image file.
+  - Invalid file format.
+  - Missing `c2patool` binary.
+* Asked for a commit message and citation entry for the tests.
+
+---
+
+### **Resulting Artifacts**
+
+* **File Created:** `src/test/java/dev/coms4156/project/metadetect/c2pa/C2paToolInvokerUnitTest.java`
+  - `testExtractManifestSuccess`: Validates successful manifest extraction from a mock image file.
+  - `testExtractManifestFileNotFound`: Tests behavior when the image file does not exist.
+  - `testExtractManifestInvalidFile`: Tests behavior when the file is not a valid image.
+  - `testExtractManifestToolNotFound`: Tests behavior when the `c2patool` binary is missing.
+  - Helper method `createTempInvalidFile`: Creates a temporary invalid file for testing.
+
+---
+
+### **Verification**
+
+* Ran `mvn clean test` to confirm all tests pass successfully.
+* Verified that temporary files are created and cleaned up correctly during tests.
+* Confirmed that the `c2patool` binary is invoked correctly for valid test cases.
+* Manually reviewed test output to ensure proper exception messages are logged for failure cases.
+
+---
+
+### **Attribution Statement**
+
+> Portions of this test suite were generated with assistance from OpenAI ChatGPT (GPT-5) on October 22, 2025. All AI-generated content was reviewed, verified, and finalized by the development team.

pom.xml

@@ -22,13 +22,10 @@
 		<java.version>17</java.version>
 		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 
-		<!-- C2PA tool download configuration (macOS universal ZIP) -->
-    	<c2pa.version>v0.23.4</c2pa.version>
-    	<c2pa.url>https://github.com/contentauth/c2pa-rs/releases/download/c2patool-{c2pa.version}/c2patool-{c2pa.version}-universal-apple-darwin.zip</c2pa.url>
-   		<c2pa.unpack.dir>${project.basedir}/tools</c2pa.unpack.dir>
-    	<c2pa.unpack.archive>${c2pa.unpack.dir}/c2patool.zip</c2pa.unpack.archive>
-    	<!-- Folder name created by the ZIP for v0.23.4 (contains the binary named "c2patool") -->
-    	<c2pa.unzipped.folder>c2patool-${c2pa.version}-universal-apple-darwin</c2pa.unzipped.folder>
+       <!-- C2PA tool download configuration -->
+        <c2pa.version>v0.23.4</c2pa.version>
+        <c2pa.unpack.dir>${project.basedir}/tools/c2patool</c2pa.unpack.dir>
+        <c2pa.unpack.archive>${c2pa.unpack.dir}/c2patool.zip</c2pa.unpack.archive>
 	</properties>
 
 	<dependencyManagement>
@@ -187,7 +184,9 @@
 			</extension>
 		</extensions>
 		<finalName>${project.artifactId}-${project.version}</finalName>
-
+		<pluginManagement>
+			
+		
 		<plugins>
 			<!-- Spring Boot (single declaration) -->
 			<plugin>
@@ -279,5 +278,6 @@
 				</executions>
 			</plugin>
 		</plugins>
+		</pluginManagement>
 	</build>
 </project>

src/main/java/dev/coms4156/project/metadetect/c2pa/C2paJsonParser.java

@@ -1,13 +1,11 @@
 package dev.coms4156.project.metadetect.c2pa;
 
 import java.io.File;
+import java.io.FileWriter;
 import java.io.IOException;
 import java.io.InputStream;
-import java.io.InterruptedIOException;
 import java.nio.charset.StandardCharsets;
-import java.nio.file.Files;
 import java.util.Scanner;
-import java.util.concurrent.TimeUnit;
 
 
 /** Invokes the C2PA command-line tool to extract manifests from images.*/
@@ -39,26 +37,41 @@ public String extractManifest(File imageFile) throws IOException {
         "-d"
     );
 
-    System.out.println("C2PA Tool Path: " + c2paToolPath);
-    System.out.println("Image File Path: " + imageFile.getAbsolutePath());
-    System.out.println("Executing command: " + String.join(" ", processBuilder.command()));
-
-    // Print the command for debugging
-    System.out.println("Executing command: " + String.join(" ", processBuilder.command()));
-
     // Start the process
     Process process = processBuilder.start();
-
+    String output;
+    String returnString;
     try {
       // Wait for the process to complete
       int exitCode = process.waitFor();
       if (exitCode != 0) {
         throw new IOException("C2PA tool failed with exit code " + exitCode);
       }
+      
       // Read the output file and return its contents as a string
-      return " "; // placeholder
+      try (InputStream is = process.getInputStream();
+           Scanner scanner = new Scanner(is, StandardCharsets.UTF_8.name())) {
+        output = scanner.useDelimiter("\\A").next();
+        
+        returnString = output;
+
+      } catch (Exception e) {
+        throw new IOException("Failed to read C2PA tool output", e);
+      }
+
     } catch (InterruptedException e) {
       throw new IOException("C2PA tool execution was interrupted", e);
     }
+    
+    try (FileWriter file = new FileWriter("output.json")) {
+      file.write(output);
+      file.flush();
+      
+      return returnString;
+
+    } catch (IOException e) {
+      throw new IOException("Failed to write output to file", e);
+    }
+
   }
 }

src/main/java/dev/coms4156/project/metadetect/c2pa/C2paToolInvoker.java

@@ -12,7 +12,6 @@
 import org.springframework.security.oauth2.jose.jws.MacAlgorithm;
 import org.springframework.security.oauth2.jwt.Jwt;
 import org.springframework.security.oauth2.jwt.JwtDecoder;
-import org.springframework.security.oauth2.jwt.JwtException;
 import org.springframework.security.oauth2.jwt.JwtValidators;
 import org.springframework.security.oauth2.jwt.NimbusJwtDecoder;
 import org.springframework.security.web.SecurityFilterChain;

src/main/java/dev/coms4156/project/metadetect/config/SecurityConfig.java

@@ -3,12 +3,6 @@
 import dev.coms4156.project.metadetect.c2pa.C2paToolInvoker;
 import java.io.File;
 import java.io.IOException;
-import java.io.InputStream;
-import java.util.ArrayList;
-import java.util.Collection;
-import java.util.LinkedHashMap;
-import java.util.List;
-import java.util.Map;
 import org.springframework.stereotype.Service;
 import org.springframework.web.multipart.MultipartFile;
 

src/main/java/dev/coms4156/project/metadetect/service/AnalyzeService.java

@@ -1,6 +1,5 @@
 package dev.coms4156.project.metadetect.service;
 
-import org.springframework.http.HttpStatus;
 import org.springframework.http.HttpStatusCode;
 import org.springframework.http.MediaType;
 import org.springframework.http.ResponseEntity;