repo-manager/interfaces/workload-projection-transport-v1.yaml
tegwick 890f3b05b5 feat(handoffs): publish owner task interfaces
Assistant: codex
Assistant-Model: gpt-5.6-sol
Assistant-Session: 01a023c0-a0a3-7c03-b395-5a0d2757214d
2026-08-22 14:15:48 +02:00

47 lines
1.9 KiB
YAML

apiVersion: helixforge.repo-manager/v1
kind: OwnerTaskInterface
metadata:
id: helixforge.workloads.projection-transport.v1
title: Transport the authoritative workload projection
source:
repo: repo-manager
workplan_task: RMGR-WP-0010-T04
target:
repo: hub-core
owner_agent: hub-core
suggested_work_record: owner-selected hub-core projection workplan task
approval:
dispositions: [approved, amended, rejected]
record_in: hub-core file-backed workplan task or decision
task:
title: Transport the Repo Manager workload projection
priority: medium
objective: >-
Add a hub-core projection port for Repo Manager workload records without
transferring semantic authority or exposing Repo Manager persistence.
inputs:
- ref: repo-manager/docs/workload-reference-contract_v1.md
authority: repo-manager
- ref: repo-manager/src/repo_manager/workloads.py
authority: repo-manager
deliverables:
- >-
Ingest normalized workload records keyed by rapp_id and
workload_identity.name, with optional deployable membership.
- >-
Retain source repository, declaration path, source Git revision, and a
canonical UTC observation timestamp.
- Expose read-only cross-repository query through the existing projection port.
- Make the projection rebuildable from authoritative declarations.
constraints:
- hub-core transports and queries the projection but does not own workload semantics.
- Do not expose or depend on Repo Manager private persistence models.
- Do not infer workload identity from repository names or paths.
acceptance:
- A nine-declaration Repo Manager fixture can be ingested and queried by exact reference.
- Deleting and rebuilding the projection from source yields equivalent records.
- Unknown references remain unknown and are not repaired by aliases or path parsing.
- All observation timestamps are canonical UTC.
verification:
- make test
- make conformance