UID9622 · waterWang · Jul 24, 2026
diff --git a/adapters/java/LICENSE b/adapters/java/LICENSE
diff --git a/adapters/java/README.md b/adapters/java/README.md
@@ -0,0 +1,174 @@
+1|# LongHun Standard Adapter — Java / Kotlin
+2|
+3|> DNA: `#LongHun⚡️BingWu·GuiWei·JiaZi·ZiShi·䷾JiJi-ADAPTER-JAVA-v1.0.0`
+4|> Author: LongHun Core · UID9622 · 龍芯北辰
+5|> License: [CC BY-NC-SA 4.0](LICENSE)
+6|> Java Version: 8+ (JDK 1.8 compatible)
+7|
+8|**Open the standard. Guard the engine.**
+9|
+10|This is the Java/Kotlin implementation of the LongHun Standard Adapter.
+11|It wraps JSON payloads with DNA traceability codes and seven-factor behavioral audit metadata,
+12|following the [AI Traceability and Audit Protocol v1.0](../docs/AI-Traceability-Audit-Protocol-v1.0.md).
+13|
+14|## Features
+15|
+16|- ✅ **DNA Traceability (v∞ format)** — SHA-256 anchored, stem-branch + I Ching hexagram codes
+17|- ✅ **Seven-Factor Behavioral Audit** — P, F, T, E, C, R, A, X, Y, Z signature
+18|- ✅ **Behavior Pattern Classification** — 5 patterns (StableDisciplined, DefensiveDefaulter, etc.)
+19|- ✅ **Three-Color Audit** — 🟢 Green, 🟡 Yellow, 🔴 Red
+20|- ✅ **Bilingual Labels** — Chinese + English behavior labels
+21|- ✅ **Full Validation** — DNA regex, audit structure, signature values, UID consistency
+22|- ✅ **Kotlin-Friendly** — Null-safety annotations (`@Nonnull`, `@Nullable`), immutable data classes
+23|- ✅ **72+ JUnit 5 Tests** — Comprehensive coverage
+24|- ✅ **Java 8 Compatible** — Works with JDK 1.8+
+25|
+26|## Maven
+27|
+28|Add this dependency to your `pom.xml`:
+29|
+30|```xml
+31|<dependency>
+32|    <groupId>cn.uid9622.longhun</groupId>
+33|    <artifactId>lh-standard-adapter</artifactId>
+34|    <version>1.0.0</version>
+35|</dependency>
+36|```
+37|
+38|## Java Usage
+39|
+40|### Basic Wrapping
+41|
+42|```java
+43|import cn.uid9622.longhun.LongHunAdapter;
+44|import cn.uid9622.longhun.ValidationResult;
+45|import com.fasterxml.jackson.databind.node.ObjectNode;
+46|
+47|LongHunAdapter adapter = new LongHunAdapter("9622", "HM-9622-001");
+48|
+49|// Wrap any JSON-serializable data
+50|ObjectNode result = adapter.wrap(
+51|    Map.of("code", "print('hello')"),
+52|    "code",
+53|    "P04-Luban"
+54|);
+55|
+56|// Access the DNA traceability code
+57|String dna = result.get("dna").asText();
+58|// → "#LongHun⚡️BingWu·GuiWei·JiaZi·WeiShi·䷾JiJi-ADAPTER-CODE-WRAP-V1.0-a3f8c1d9"
+59|
+60|// Access the audit metadata
+61|String pattern = result.get("audit").get("behavior_pattern").asText();
+62|// → "MODE-StableDisciplined"
+63|
+64|// Validate the wrapped payload
+65|ValidationResult validation = adapter.validate(result);
+66|if (validation.isValid()) {
+67|    System.out.println("✅ Valid: " + validation.getSummary());
+68|}
+69|```
+70|
+71|### Getting Schemas
+72|
+73|```java
+74|Map<String, Object> schemas = adapter.getSchemas();
+75|Map<String, Object> dnaSchema = (Map<String, Object>) schemas.get("dna_schema");
+76|Map<String, Object> auditSchema = (Map<String, Object>) schemas.get("audit_schema");
+77|```
+78|
+79|### Customizing Action and Version
+80|
+81|```java
+82|ObjectNode result = adapter.wrap(data, "deploy", "P14-Lvmeng", "DEPLOY", "v2.0");
+83|```
+84|
+85|## Kotlin Usage
+86|
+87|```kotlin
+88|import cn.uid9622.longhun.LongHunAdapter
+89|
+90|val adapter = LongHunAdapter("9622", "HM-9622-001")
+91|val result = adapter.wrap(mapOf("code" to "print('hello')"), "code", "P04-Luban")
+92|val validation = adapter.validate(result)
+93|
+94|println(result["dna"])          // DNA traceability code
+95|println(result["audit"]["behavior_pattern"])  // Behavior pattern
+96|println(validation.summary)     // Validation summary
+97|```
+98|
+99|## Building
+100|
+101|```bash
+102|cd adapters/java
+103|mvn clean package
+104|```
+105|
+106|## Running Tests
+107|
+108|```bash
+109|cd adapters/java
+110|mvn test
+111|```
+112|
+113|## API Reference
+114|
+115|### `LongHunAdapter`
+116|
+117|| Method | Returns | Description |
+118||--------|---------|-------------|
+119|| `LongHunAdapter(String uid, String device)` | — | Constructor with default locale |
+120|| `LongHunAdapter(String uid, String device, String locale)` | — | Constructor with custom timezone |
+121|| `wrap(Object data, String taskType, String persona)` | `ObjectNode` | Wrap payload with DNA + audit |
+122|| `wrap(Object data, String taskType, String persona, String action, String version)` | `ObjectNode` | Wrap with custom action/version |
+123|| `validate(ObjectNode wrapped)` | `ValidationResult` | Validate wrapped payload |
+124|| `getSchemas()` | `Map<String, Object>` | Get JSON Schema definitions |
+125|
+126|### `ValidationResult`
+127|
+128|| Method | Returns | Description |
+129||--------|---------|-------------|
+130|| `isValid()` | `boolean` | Whether validation passed |
+131|| `getErrors()` | `List<String>` | Validation error messages |
+132|| `getWarnings()` | `List<String>` | Validation warning messages |
+133|| `getSummary()` | `String` | Human-readable summary |
+134|
+135|## Project Structure
+136|
+137|```
+138|adapters/java/
+139|├── pom.xml
+140|├── LICENSE
+141|├── README.md
+142|└── src/
+143|    ├── main/java/cn/uid9622/longhun/
+144|    │   ├── LongHunAdapter.java    # Main adapter class
+145|    │   ├── DNAGenerator.java      # DNA traceability code generation
+146|    │   ├── AuditWrapper.java      # Seven-factor audit wrapping
+147|    │   ├── Validator.java         # Payload validation
+148|    │   ├── ValidationResult.java  # Immutable validation result
+149|    │   └── Schemas.java           # JSON Schema definitions
+150|    └── test/java/cn/uid9622/longhun/
+151|        ├── LongHunAdapterTest.java
+152|        ├── DNAGeneratorTest.java
+153|        ├── AuditWrapperTest.java
+154|        └── ValidatorTest.java
+155|```
+156|
+157|## License
+158|
+159|This project is licensed under [CC BY-NC-SA 4.0](LICENSE) — Attribution-NonCommercial-ShareAlike 4.0 International.
+160|
+161|## Cross-Validation
+162|
+163|The Java implementation is cross-validated against the Python reference implementation
+164|at `lh_standard_adapter/`. All tests produce identical output structure and validation logic.
+165|
+166|## DNA
+167|
+168|```
+169|#LongHun⚡️BingWu·GuiWei·JiaZi·ZiShi·䷾JiJi-ADAPTER-JAVA-v1.0.0
+170|```
+171|
+172|---
+173|
+174|*Open the standard. Guard the engine.*
diff --git a/adapters/java/pom.xml b/adapters/java/pom.xml
@@ -0,0 +1,112 @@
+1|<?xml version="1.0" encoding="UTF-8"?>
+2|<project xmlns="http://maven.apache.org/POM/4.0.0"
+3|         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+4|         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+5|    <modelVersion>4.0.0</modelVersion>
+6|
+7|    <groupId>cn.uid9622.longhun</groupId>
+8|    <artifactId>lh-standard-adapter</artifactId>
+9|    <version>1.0.0</version>
+10|    <packaging>jar</packaging>
+11|
+12|    <name>LongHun Standard Adapter</name>
+13|    <description>Java/Kotlin implementation of the LongHun standard adapter – wrap JSON payloads with DNA traceability and seven-factor behavioral audit metadata.</description>
+14|    <url>https://github.com/UID9622/lh-standard-adapter</url>
+15|
+16|    <licenses>
+17|        <license>
+18|            <name>CC BY-NC-SA 4.0</name>
+19|            <url>https://creativecommons.org/licenses/by-nc-sa/4.0/</url>
+20|        </license>
+21|    </licenses>
+22|
+23|    <developers>
+24|        <developer>
+25|            <name>LongHun Core · UID9622 · 龍芯北辰</name>
+26|            <email>core@uid9622.cn</email>
+27|        </developer>
+28|    </developers>
+29|
+30|    <properties>
+31|        <maven.compiler.source>1.8</maven.compiler.source>
+32|        <maven.compiler.target>1.8</maven.compiler.target>
+33|        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+34|        <jackson.version>2.15.3</jackson.version>
+35|        <junit.version>5.10.0</junit.version>
+36|    </properties>
+37|
+38|    <dependencies>
+39|        <!-- Jackson for JSON processing -->
+40|        <dependency>
+41|            <groupId>com.fasterxml.jackson.core</groupId>
+42|            <artifactId>jackson-databind</artifactId>
+43|            <version>${jackson.version}</version>
+44|        </dependency>
+45|        <dependency>
+46|            <groupId>com.fasterxml.jackson.core</groupId>
+47|            <artifactId>jackson-core</artifactId>
+48|            <version>${jackson.version}</version>
+49|        </dependency>
+50|        <dependency>
+51|            <groupId>com.fasterxml.jackson.core</groupId>
+52|            <artifactId>jackson-annotations</artifactId>
+53|            <version>${jackson.version}</version>
+54|        </dependency>
+55|
+56|        <!-- JUnit 5 for testing -->
+57|        <dependency>
+58|            <groupId>org.junit.jupiter</groupId>
+59|            <artifactId>junit-jupiter</artifactId>
+60|            <version>${junit.version}</version>
+61|            <scope>test</scope>
+62|        </dependency>
+63|
+64|        <!-- Null-safety annotations for Kotlin-friendly API -->
+65|        <dependency>
+66|            <groupId>com.google.code.findbugs</groupId>
+67|            <artifactId>jsr305</artifactId>
+68|            <version>3.0.2</version>
+69|            <optional>true</optional>
+70|        </dependency>
+71|    </dependencies>
+72|
+73|    <build>
+74|        <plugins>
+75|            <plugin>
+76|                <groupId>org.apache.maven.plugins</groupId>
+77|                <artifactId>maven-compiler-plugin</artifactId>
+78|                <version>3.11.0</version>
+79|                <configuration>
+80|                    <source>1.8</source>
+81|                    <target>1.8</target>
+82|                    <encoding>UTF-8</encoding>
+83|                </configuration>
+84|            </plugin>
+85|            <plugin>
+86|                <groupId>org.apache.maven.plugins</groupId>
+87|                <artifactId>maven-surefire-plugin</artifactId>
+88|                <version>3.2.3</version>
+89|                <configuration>
+90|                    <includes>
+91|                        <include>**/*Test.java</include>
+92|                    </includes>
+93|                </configuration>
+94|            </plugin>
+95|            <plugin>
+96|                <groupId>org.apache.maven.plugins</groupId>
+97|                <artifactId>maven-javadoc-plugin</artifactId>
+98|                <version>3.6.0</version>
+99|                <configuration>
+100|                    <source>1.8</source>
+101|                    <encoding>UTF-8</encoding>
+102|                    <doclint>none</doclint>
+103|                </configuration>
+104|            </plugin>
+105|            <plugin>
+106|                <groupId>org.apache.maven.plugins</groupId>
+107|                <artifactId>maven-source-plugin</artifactId>
+108|                <version>3.3.0</version>
+109|            </plugin>
+110|        </plugins>
+111|    </build>
+112|</project>