Merge pull request #23 from Jalen-Stephens/14-service-implement-analyzeservice-metadata-scraping-and-response

Author: Sulayb28

.DS_Store

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

.gitignore

@@ -497,6 +497,104 @@ Assisted in drafting a unit test suite for the `UserService` to validate identit
 
 ---
 
+
+
+### Commit / Ticket Reference
+
+* **Commit:** `feat(c2pa): c2pa tool successfully downloaded (pom.xml updated) only functional on macOS(refs #14)`
+* **Ticket:** `#14 — Service: Implement AnalyzeService core logic (Iteration 1)`
+* **Date:** October 21, 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**
+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(c2pa): c2pa tool successfully downloaded (pom.xml updated) only functional on macOS(refs #14)`
+* **Ticket:** `#14 — Service: Implement AnalyzeService core logic (Iteration 1)`
+* **Date:** October 21, 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**
+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)`

citations.md

@@ -21,6 +21,14 @@
 	<properties>
 		<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>
 	</properties>
 
 	<dependencyManagement>
@@ -81,6 +89,12 @@
 			<groupId>org.springframework.boot</groupId>
 			<artifactId>spring-boot-starter-test</artifactId>
 			<scope>test</scope>
+			<exclusions>
+				<exclusion>
+					<groupId>org.mockito</groupId>
+					<artifactId>mockito-core</artifactId>
+				</exclusion>				
+			</exclusions>
 		</dependency>
 
 		<!-- API tests (optional but nice for iteration 1) -->
@@ -135,6 +149,33 @@
 			<version>4.12.0</version>
 			<scope>test</scope>
 		</dependency>
+		<!-- Metadata Extractor library -->
+		<dependency>
+  			<groupId>com.drewnoakes</groupId>
+  			<artifactId>metadata-extractor</artifactId>
+ 			<version>2.18.0</version>
+		</dependency>
+	
+		<dependency>
+  			<groupId>com.fasterxml.jackson.core</groupId>
+  			<artifactId>jackson-databind</artifactId>
+  			<version>2.17.1</version>
+		</dependency>
+
+		<!-- Mockito core (re-added with specific version) -->
+		<dependency>
+    		<groupId>org.mockito</groupId>
+			<artifactId>mockito-core</artifactId>
+			<scope>test</scope>
+		</dependency>
+
+		<dependency>
+    		<groupId>org.mockito</groupId>
+   			<artifactId>mockito-inline</artifactId>
+    		<version>5.2.0</version> <!-- Use the latest version -->
+   			<scope>test</scope>
+		</dependency>
+
 	</dependencies>
 
 	<build>
@@ -146,6 +187,7 @@
 			</extension>
 		</extensions>
 		<finalName>${project.artifactId}-${project.version}</finalName>
+
 		<plugins>
 			<!-- Spring Boot (single declaration) -->
 			<plugin>

pom.xml

@@ -0,0 +1,74 @@
+package dev.coms4156.project.metadetect.c2pa;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import java.util.Iterator;
+import java.util.Map;
+
+/** Parses C2PA manifest JSON into structured data. */
+
+public final class C2paJsonParser {
+  private static final ObjectMapper objectMapper = new ObjectMapper();
+
+  private C2paJsonParser() {}
+
+  /**
+   * Parses the C2PA manifest JSON string into a structured Map.
+   *
+   * @param jsonString The C2PA manifest JSON string.
+   * @return A Map representing the parsed manifest.
+   * @throws Exception if parsing fails.
+   * 
+   */
+    
+  public static Map<String, Object> parseManifestJson(String jsonString) throws Exception {
+    try {
+      JsonNode root = objectMapper.readTree(jsonString);
+
+      JsonNode manifests = root.get("manifests");
+      if (manifests != null && manifests.isArray() && manifests.size() > 0) {
+        JsonNode firstManifest = manifests.get(0);
+        return parseJsonNode(firstManifest);
+      } else {
+        throw new Exception("No manifests found in C2PA JSON");
+      }
+    } catch (Exception ignore) {
+      throw new Exception("Failed to parse C2PA JSON", ignore);
+    }
+  }
+
+  private static Map<String, Object> parseJsonNode(JsonNode node) {
+    Map<String, Object> result = new java.util.LinkedHashMap<>();
+
+    Iterator<Map.Entry<String, JsonNode>> fields = node.fields();
+    while (fields.hasNext()) {
+      Map.Entry<String, JsonNode> entry = fields.next();
+      String key = entry.getKey();
+      JsonNode valueNode = entry.getValue();
+      Object value;
+
+      if (valueNode.isObject()) {
+        value = parseJsonNode(valueNode);
+      } else if (valueNode.isArray()) {
+        java.util.List<Object> list = new java.util.ArrayList<>();
+        for (JsonNode arrayItem : valueNode) {
+          if (arrayItem.isObject()) {
+            list.add(parseJsonNode(arrayItem));
+          } else if (arrayItem.isArray()) {
+            // Nested arrays are not expected in C2PA manifests; handle as needed
+            list.add(arrayItem.toString());
+          } else if (arrayItem.isValueNode()) {
+            list.add(arrayItem.asText());
+          }
+        }
+        value = list;
+      } else if (valueNode.isValueNode()) {
+        value = valueNode.asText();
+      } else {
+        value = null; // or handle other types as needed
+      }
+      result.put(key, value);
+    } 
+    return result;
+  }
+}

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

@@ -0,0 +1,64 @@
+package dev.coms4156.project.metadetect.c2pa;
+
+import java.io.File;
+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.*/
+public class C2paToolInvoker {
+    
+  private final String c2paToolPath;
+
+  public C2paToolInvoker(String c2paToolPath) {
+    this.c2paToolPath = c2paToolPath;
+  }
+   
+  /**
+   *  Executes the C2PA tool to extract the manifest from the given image file.
+  *
+  * @param imageFile The image file to analyze.
+  * @return JSON string of the C2PA manifest.
+  * @throws IOException if the tool fails or the file is invalid.
+  *
+  */
+  public String extractManifest(File imageFile) throws IOException {
+    // Create a temporary file for the output
+
+    
+
+    // Command to invoke the C2PA tool
+    ProcessBuilder processBuilder = new ProcessBuilder(
+        c2paToolPath,
+        imageFile.getAbsolutePath(),
+        "-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();
+
+    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
+    } catch (InterruptedException e) {
+      throw new IOException("C2PA tool execution was interrupted", e);
+    }
+  }
+}

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

@@ -0,0 +1,26 @@
+package dev.coms4156.project.metadetect.config;
+
+import dev.coms4156.project.metadetect.c2pa.C2paToolInvoker;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+/** Configuation class to provide constants to other processes. */
+
+@Configuration
+public class AppConfig {
+
+  /**
+  * Creates a C2paToolInvoker bean with the specified tool path.
+  * This method initializes the C2paToolInvoker with the path to the C2PA tool binary.
+  * The tool is used to extract metadata and manifests from image files.
+  *
+  * @return a C2paToolInvoker instance configured with the tool path.
+  */
+
+  @Bean
+  public C2paToolInvoker c2paToolInvoker() {
+    // Path to the C2PA tool binary
+    String c2paToolPath = "tools/c2patool/c2patool";
+    return new C2paToolInvoker(c2paToolPath);
+  }
+}