[JAVA-01] Establish supported Java baseline, build, coordinates, and code generation

[jaavid]

Background

CoreLink is one product across multiple implementation repositories. This work is owned by sdk-java under EPIC-05.

Problem

The repository does not yet provide a supported, reproducible and acceptance-tested way to establish supported Java baseline, build, coordinates, and code generation.

Goal

Establish supported Java baseline, build, coordinates, and code generation, aligned with tagged contracts and the shared CoreLink release train.

Parent

• Primary Product Epic: EPIC-05
• Backlog ID: JAVA-01

Scope

• Deliver the title outcome inside sdk-java.
• Reconcile contract version, authentication, tenancy, error, compatibility, packaging and documentation behavior where applicable.
• Retain evidence for the Beta gate.

Out of Scope

• Hand-written divergence from the normative contracts.
• Unsupported production claims before an artifact and conformance evidence exist.
• A separate repository roadmap.

Acceptance Criteria

• The outcome is reproducible from documented inputs and tagged dependencies.
• Expected, error, retry/recovery and compatibility behavior is verified.
• Authentication, tenant context and sensitive-data handling are safe where applicable.
• Installable artifacts or explicit scaffold status are documented accurately.
• Examples and documentation are versioned and runnable.
• Conformance evidence is linked to the parent Epic.

Technical Notes

Generated artifacts must identify immutable contract provenance. Security-sensitive tools use least privilege, explicit consent, audit and safe token handling. Package channels must distinguish prerelease from stable.

Dependencies

• Prerequisite completed: API-01 established the contract lifecycle baseline.
• Active blocker: API-05 must provide the parity/conformance gate and tagged-contract release path this task depends on.
• Blocks: supported Java SDK generation/release evidence and EPIC-05 SDK alignment.
• Cross-repository: Link concrete contract, SDK, documentation and release Issues; do not duplicate implementation.
• Current dependency state: See the CoreLink Product organization Project.

Planning Metadata

• Type: Technical Task
• Priority: P1
• Product milestone: Beta
• Domains: sdk, devex
• Area: package
• Complexity: M
• Created in status: Triage
• Current status and DRI: See the CoreLink Product organization Project.
• Intended repository labels: type:technical-task

Definition of Done

• Acceptance criteria demonstrated.
• Tests/conformance and required evidence pass.
• Contracts are updated or confirmed unaffected.
• Security and tenancy boundaries are reviewed.
• Packaging, provenance and rollback are verified.
• Documentation and release notes are updated.
• Pull request(s) are merged and linked.