[API-02] Expand public v1 contracts for Assets, bindings, telemetry, location, and alerts

[jaavid]

Background

CoreLink is managed as one product across multiple implementation repositories. This work is the executable feature owned by api-contracts under EPIC-04.

Problem

The current repository state does not yet provide verified, release-ready evidence to expand public v1 contracts for Assets, bindings, telemetry, location, and alerts.

Goal

Expand public v1 contracts for Assets, bindings, telemetry, location, and alerts with observable acceptance evidence and no divergence from the product-level contract.

Parent

• Primary Product Epic: EPIC-04
• Backlog ID: API-02

Scope

• Deliver the outcome stated in the title within the api-contracts implementation boundary.
• Reconcile affected contracts, tests, documentation, security, tenancy, observability, migration and release behavior.
• Retain acceptance evidence suitable for the Developer Platform product gate.

Out of Scope

• Creating a separate repository roadmap.
• Expanding into adjacent product domains without an accepted Product Epic or decision record.
• Claiming completion based only on code merge when operational or customer validation is required.

Acceptance Criteria

• The stated outcome is implemented or documented at the correct repository boundary.
• Expected, failure and recovery paths are covered by repeatable checks or retained evidence.
• Tenant isolation, authorization and sensitive-data behavior are reviewed where applicable.
• Public/internal contract and compatibility impacts are reconciled.
• Documentation, observability, migration/rollback and release notes are updated where applicable.
• Evidence is attached or linked and the parent Epic exit criteria are measurably advanced.

Technical Notes

Preserve canonical identifiers, provider-neutral public behavior, idempotency and backward compatibility. Prefer the existing modular-monolith boundary unless measured scale, security isolation or ownership requires extraction.

Dependencies

• Blocked by: API-01, PLAT-04
• Blocks: To be resolved during refinement.
• Cross-repository work: Link concrete Issues during refinement; do not duplicate their implementation here.

Planning Metadata

• Type: Feature
• Priority: P0
• Product milestone: Developer Platform
• Domains: api, telemetry
• Area: contract
• Complexity: L
• Initial status: Triage
• DRI: Unassigned
• Intended labels: type:feature, priority:p0, domain:api, domain:telemetry, area:contract

Definition of Done

• Acceptance criteria demonstrated.
• Required tests and evidence pass.
• Contracts are updated or confirmed unaffected.
• Security and tenant boundaries are reviewed.
• Migration and rollback paths are verified where applicable.
• Observability and runbooks are updated where applicable.
• Documentation and release notes are updated.
• Pull request(s) are merged and linked.

[jaavid]

Dependency clarification

Platform PR #167 (e9996b8) published the closure checklist. API-02 remains blocked on PLAT-04 canonical telemetry/position/latest-state/history behavior; once that contract is frozen, API-02 can add the public asset/binding/telemetry/location/alert surfaces and runtime parity evidence.