repo-manager/docs/repository-classification-contract_v1.0.md
tegwick 35e86d7b85 feat: advance repository records and provenance
Assistant: codex
Assistant-Model: gpt-5.6-sol
Assistant-Session: 01a023c0-a0a3-7c03-b395-5a0d2757214d
2026-08-21 22:07:48 +02:00

34 lines
1.4 KiB
Markdown

---
id: RMGR-CONTRACT-CLASSIFICATION-0001
type: contract
title: "Repository classification receiving contract"
version: "1.0"
status: active
created: "2026-08-21"
updated: "2026-08-21"
workplan_task: RMGR-WP-0008-T06
canon_source: the-custodian/canon/standards/repo-classification-standard_v1.0.md
---
# Repository classification receiving contract v1.0
Repo Manager reads `.repo-classification.yaml` as repository authority and
validates it against version 1.0 of the Custodian's Repo Classification
Standard. It publishes the validated value in repository snapshots; downstream
topic or domain services consume that projection and do not replace the file.
The required scalar fields are `category` and `domain`. Optional list fields
are `secondary_domains`, `capability_tags`, `business_stake`, and
`business_mechanics`. Controlled values and the tag syntax are in the companion
machine-readable contract.
Invalid classifications fail observation with field-specific errors. Repo
Manager does not coerce unknown values, infer the primary domain from technical
tags, or write classification during observation. A canon vocabulary change
requires a new contract version and implementation update; the canon remains
the source of meaning.
Boundary with hub-core: Repo Manager owns file validation and the repository
projection. Hub-core may aggregate those projections into topics and fleet
navigation, but does not become classification authority.