the-custodian/workplans/CUST-WP-0065-reclassify-repos-and-guidance-docs-to-the-new-sector-domain.md
codex 2462abf61d
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 1s
workplans: record classification projection repair
2026-08-23 11:34:56 +02:00

6.6 KiB
Raw Blame History

id type title domain repo status owner created updated quality_dor quality_dor_at quality_dor_by quality_dor_note state_hub_workstream_id
CUST-WP-0065 workplan Reclassify repos and guidance docs to the new sector domain scheme infotech the-custodian active codex 2026-08-23 2026-08-23 DoR-Ok 2026-08-23 codex The live registry baseline, canonical vocabulary, source-of-truth boundary, owner dependencies, non-mechanical classification risk, and acceptance checks are explicit. e2702474-b276-4e15-8337-41bfa344c89c

Reclassify repos and guidance docs to the new sector domain scheme

Goal

Complete the transition from legacy project/estate labels to the canonical sector-domain vocabulary without mechanically rewriting project identities or silently assigning ambiguous repos. Populate the authoritative repository projection, update Custodian guidance, and route repo-owned classification changes to their owners.

Promoted from intake 019f81e6-2a31-7bee-b50a-8e9ca67267b7 — origin: "intake:019f81e6-2a31-7bee-b50a-8e9ca67267b7"

Establish the live baseline and migration semantics

id: CUST-WP-0065-T01
status: done
priority: high

Count active repositories with complete and incomplete classification projection, distinguish missing source files from missing ingestion, and define how legacy project names relate to sector domains. Do not treat a project name as a one-to-one market classification.

Done (2026-08-23): docs/repo-classification-sector-migration-baseline-2026-08-23.md records the live 117-repository baseline: 38 active records have no projected category, comprising 14 missing source files and 24 present-but-unprojected files. It also fixes the migration rule: legacy names remain project/estate identity; sector values describe intended users and require repo-owner review when the answer is ambiguous.

Publish canonical migration guidance

id: CUST-WP-0065-T02
status: done
priority: medium

Review the baseline semantics into the active Repo Classification Standard and agent-facing guidance. Replace only obsolete domain-field instructions; keep historical project names and canon references intact. Add a validation example that rejects legacy names in repo_classification.domain while allowing them as project/topic identity.

Done (2026-08-23): the active Repo Classification Standard now explicitly separates legacy project/estate identities from sector-domain metadata and links the governed migration baseline. The contribution convention and all four contribution templates now show current sector values. The classification validator self-test proves custodian is rejected as a classification domain; project names remain valid outside that field.

Repair source records and authoritative projection

id: CUST-WP-0065-T03
status: progress
priority: high

Route the 14 missing .repo-classification.yaml files to repository owners and have Repo Manager/State Hub diagnose the 24 files that exist locally but remain null in the registry. Classification judgments stay with repo owners; the Custodian coordinates vocabulary and acceptance. Require schema validation and normal registrar/reconcile paths rather than direct database edits.

Started (2026-08-23): Repo Manager received the 24-repo projection defect and config-atlas sentinel proof in message a5e685c9; binky-control received the first missing-source owner handoff in message 15d8f2df. The remaining missing-source repos stay in the baseline for governed owner routing.

Implementation checkpoint (2026-08-23): all 24 committed source files now project through the State Hub API; the active-fleet projection improved from 79/117 to 103/117 classified repos. Twenty-one updated through the standard registration command. Three server-error cases (rail-knative, rapp-qonto, and rapp-sbom-nexus) were recovered with classification-only PATCHes, then used to expose and verify a State Hub registration defect. State Hub revision 57c3e08 now keeps classification updates separate from Git identity fields, honors domain_slug changes, and normalizes multi-root histories to one fingerprint; focused regression tests and all three live repros pass.

Every remaining missing-source repo has an owner handoff with a suggested starting point and an explicit requirement to review, validate, commit, and report its revision: agent-harness (b5718a78), binect-chrome (cfe4baa6), binect-js (3a8358b7), binky-control (18dc8758), clay-borg (98726021), direkt-vermittlung-de (f177403a), polycode-sim (b3247d7b), railiance-telemetry (bf2e2fea), ralph-workplan (186be39c), rein-aharness (c02a26b9), rein-openweights (24d9e895), tele-mcp (76e3d0dc), testdrive-jsui (cbefc9a0), and timeline-svg (d350d2c6). T03 remains in progress because those classification judgments must land in their owning repositories; they are not safe Custodian-side mechanical edits.

Verify fleet convergence and close

id: CUST-WP-0065-T04
status: progress
priority: medium

Re-run the active-repository baseline. Close when every active repo either has a valid projected classification or a governed exclusion, current agent guidance uses sector domains, and no project identity was destroyed by the migration. Record any genuine owner decision as a live residual before finishing.

Started (2026-08-23): the post-repair fleet check reports 121 registered, 117 active, 103 classified, and 14 active null-category records. The null set exactly matches the 14 governed owner handoffs; no present source file remains unprojected. Project names and repository identities were not rewritten.

Indexing note

The workplan is indexed as e2702474-b276-4e15-8337-41bfa344c89c, but the primary registrar rejected task UUID assignment under correlation 57bb4daf-7386-4115-8ffb-37218892d482. Its repository-wide identity audit correctly fails closed on grandfathered workplan ids and bare T01–T09 collisions in older Custodian files. No task ids were invented or database rows patched. Repo Manager received the compatibility evidence in message 76f1c416; file task states remain authoritative until a governed registrar path can bind them.

Acceptance

  • Live missing-classification baseline is reproducible and split by cause
  • Legacy project identity is distinguished from sector-domain metadata
  • Canonical and agent-facing migration guidance is current
  • Missing source classifications are owner-reviewed and validated
  • Present source classifications project into State Hub
  • Active fleet has zero unexplained null category projections