railiance-fabric/workplans/archived/260702-RAIL-FAB-WP-0005-registry-hardening.md

---
id: RAIL-FAB-WP-0005
type: workplan
title: "Registry Hardening"
domain: financials
repo: railiance-fabric
status: finished
owner: codex
topic_slug: railiance
planning_priority: medium
planning_order: 5
state_hub_workstream_id: "75c64655-9062-46a3-a706-78ad09852cd6"
created: "2026-05-17"
updated: "2026-05-17"
---

> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).

# RAIL-FAB-WP-0005 - Registry Hardening

## Goal

Clean up the registry service for continued local use by removing noisy schema
validation warnings, documenting the API contract, and adding a richer
diagnostic endpoint.

## Tasks

### T01 - Schema Resolver Cleanup

```task
id: RAIL-FAB-WP-0005-T01
status: done
priority: high
state_hub_task_id: "178900ba-a2a4-4f93-a1dd-a626c14e8d66"
```

Replace deprecated `jsonschema.RefResolver` usage with the modern referencing
registry API.

### T02 - Registry Status Endpoint

```task
id: RAIL-FAB-WP-0005-T02
status: done
priority: medium
state_hub_task_id: "523f9a35-2285-4b71-915c-9f06698dcc3a"
```

Add a registry `/status` endpoint that reports database path, table counts, and
latest accepted snapshots.

### T03 - API Contract Documentation

```task
id: RAIL-FAB-WP-0005-T03
status: done
priority: medium
state_hub_task_id: "d84ebf13-b90b-4296-8987-fc00ba6183ad"
```

Document the current registry HTTP API surface in one focused reference file.
Harden registry API and schema validation 2026-05-17 22:33:21 +02:00			`---`
			`id: RAIL-FAB-WP-0005`
			`type: workplan`
			`title: "Registry Hardening"`
Normalize agent instructions and workplan frontmatter (STATE-WP-0067) - Align agent files with on-disk workplan prefixes (infer from workplan ids) - Set workplan domain to registered domain_slug; add topic_slug where applicable - Repair frontmatter delimiter formatting; migrate legacy task status literals - Regenerate AGENTS.md, CLAUDE.md, and .claude/rules from State Hub templates 2026-06-22 23:16:28 +02:00			`domain: financials`
Harden registry API and schema validation 2026-05-17 22:33:21 +02:00			`repo: railiance-fabric`
Repo hygiene: fill stack-and-commands, normalize workplan statuses - Fill .claude/rules/stack-and-commands.md (was an empty TODO template) - Normalize workplan frontmatter statuses to canonical vocabulary (completed/done -> finished) per ADR-001 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> 2026-07-02 00:21:49 +02:00			`status: finished`
Harden registry API and schema validation 2026-05-17 22:33:21 +02:00			`owner: codex`
			`topic_slug: railiance`
			`planning_priority: medium`
			`planning_order: 5`
			`state_hub_workstream_id: "75c64655-9062-46a3-a706-78ad09852cd6"`
			`created: "2026-05-17"`
			`updated: "2026-05-17"`
			`---`

CUST-WP-0055 T06/T07: workplan-first fabric source docs and archive notes Update catalog, integration docs, and fabric capability declarations to use workplan terminology. Add archive grandfather notes. 2026-07-08 20:26:24 +02:00			> Terminology note: Historical text in this archived workplan may use the legacy term "workstream". The fleet term is workplan (`canon/standards/workplan-terminology-fleet_v0.1.md`).

Harden registry API and schema validation 2026-05-17 22:33:21 +02:00			`# RAIL-FAB-WP-0005 - Registry Hardening`

			`## Goal`

			`Clean up the registry service for continued local use by removing noisy schema`
			`validation warnings, documenting the API contract, and adding a richer`
			`diagnostic endpoint.`

			`## Tasks`

			`### T01 - Schema Resolver Cleanup`

			```task
			`id: RAIL-FAB-WP-0005-T01`
			`status: done`
			`priority: high`
			`state_hub_task_id: "178900ba-a2a4-4f93-a1dd-a626c14e8d66"`
			```

			Replace deprecated `jsonschema.RefResolver` usage with the modern referencing
			`registry API.`

			`### T02 - Registry Status Endpoint`

			```task
			`id: RAIL-FAB-WP-0005-T02`
			`status: done`
			`priority: medium`
			`state_hub_task_id: "523f9a35-2285-4b71-915c-9f06698dcc3a"`
			```

			Add a registry `/status` endpoint that reports database path, table counts, and
			`latest accepted snapshots.`

			`### T03 - API Contract Documentation`

			```task
			`id: RAIL-FAB-WP-0005-T03`
			`status: done`
			`priority: medium`
			`state_hub_task_id: "d84ebf13-b90b-4296-8987-fc00ba6183ad"`
			```

			`Document the current registry HTTP API surface in one focused reference file.`