init repo

Author: JqRrt

.gitignore

@@ -0,0 +1,82 @@
+# Compiled class file
+*.class
+
+# Log file
+*.log
+
+# BlueJ files
+*.ctxt
+
+# Mobile Tools for Java (J2ME)
+.mtj.tmp/
+
+# Package Files #
+*.jar
+*.war
+*.nar
+*.ear
+*.zip
+*.tar.gz
+*.rar
+
+# virtual machine crash logs
+hs_err_pid*
+replay_pid*
+
+# Maven
+target/
+pom.xml.tag
+pom.xml.releaseBackup
+pom.xml.versionsBackup
+pom.xml.next
+release.properties
+dependency-reduced-pom.xml
+buildNumber.properties
+.mvn/timing.properties
+.mvn/wrapper/maven-wrapper.jar
+
+# Gradle
+.gradle
+build/
+!gradle/wrapper/gradle-wrapper.jar
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+# IntelliJ IDEA
+.idea/
+*.iws
+*.iml
+*.ipr
+out/
+!**/src/main/**/out/
+!**/src/test/**/out/
+
+# Eclipse
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+bin/
+!**/src/main/**/bin/
+!**/src/test/**/bin/
+
+# NetBeans
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+
+# VS Code
+.vscode/
+
+# Mac
+.DS_Store
+
+# Windows
+Thumbs.db
+
+

CHANGELOG.md

@@ -0,0 +1,50 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0-SNAPSHOT] - 2025-11-11
+
+### Added
+
+- Initial CozeLoop Java SDK release
+- Core SDK module (`cozeloop-core`) with trace reporting and prompt management
+- Spring Boot starter module (`cozeloop-spring-boot-starter`) for seamless integration
+- Trace reporting functionality built on OpenTelemetry SDK
+- Prompt management with caching and formatting support
+- Support for Jinja template engine in prompts
+- AOP annotation `@CozeTrace` for declarative tracing
+- OAuth JWT and PAT (Personal Access Token) authentication
+- Example code demonstrating SDK usage (`examples/` directory)
+  - Initialization examples (PAT, OAuth JWT, error handling)
+  - Trace examples (simple, parent-child, trace with prompt)
+  - Prompt examples (prompt hub, Jinja templates)
+- Comprehensive documentation and README files
+  - English and Chinese (简体中文) README files
+  - CONTRIBUTING.md guide
+  - LICENSE file (MIT License)
+  - Examples README with detailed usage instructions
+- Maven multi-module project structure
+- Checkstyle configuration for code quality
+
+### Changed
+
+- **Trace Export**: Improved `CozeLoopSpanExporter` to export spans in batches of 25 to remote server
+  - Spans are now automatically split into batches of 25 before sending to CozeLoop platform
+  - Enhanced error handling: individual batch failures don't prevent other batches from being exported
+  - Improved logging with batch-level statistics and detailed error reporting
+  - Better resilience and observability for trace export operations
+
+### Features
+
+- **Trace Reporting**: Automatic batch reporting of traces to CozeLoop platform
+  - Multi-level batching: OpenTelemetry BatchSpanProcessor + custom 25-span batches
+  - Robust error handling with per-batch failure isolation
+  - Comprehensive logging for monitoring and debugging
+- **Prompt Management**: Pull, cache, and format prompts from the platform
+- **Spring Boot Integration**: Auto-configuration and AOP support
+- **Thread-Safe**: All core components are thread-safe
+- **Java 8+ Compatible**: Wide compatibility with Java 8 and above
+

CONTRIBUTING.md

@@ -0,0 +1,45 @@
+# How to contribute
+
+## Set Up Environment
+Make sure you have Java installed (version 8 or higher, Java 11+ recommended) and Maven 3.6+.
+
+## Dependencies Management
+We use Maven for dependency management.
+Install dependencies:
+```bash
+mvn clean install
+```
+
+## Build
+To build the project, run:
+```bash
+mvn clean install
+```
+
+## Code Style
+We use Checkstyle for code style checking. The configuration file is `checkstyle.xml` in the root directory.
+
+To check code style:
+```bash
+mvn checkstyle:check
+```
+
+## Running Tests
+To run all tests:
+```bash
+mvn test
+```
+
+## Project Structure
+- `cozeloop-core/` - Core SDK module
+- `cozeloop-spring-boot-starter/` - Spring Boot integration module
+- `examples/` - Example code demonstrating SDK usage
+
+## Submitting Changes
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Ensure all tests pass
+5. Ensure code style checks pass
+6. Submit a pull request
+

LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Bytedance Ltd. and/or its affiliates
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+