railiance-apps/workplans/archived/260702-RAPPS-WP-0010-inter-hub-production-trigger-hardening.md

---
id: RAPPS-WP-0010
type: workplan
title: "Inter-Hub production trigger hardening"
domain: financials
repo: railiance-apps
status: finished
owner: codex
topic_slug: railiance
created: "2026-06-15"
updated: "2026-06-15"
state_hub_workstream_id: "cf16e32c-c584-5147-b02f-9d4f81bdfb9f"
---

> **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`).

# Inter-Hub production trigger hardening

## Goal

Turn the local Inter-Hub deploy surface into a safe production trigger for
Railiance01. The trigger must refuse missing images before Helm, use the
current Inter-Hub v2 API smoke contract, and expose a manual workflow path that
has the same gates as an attended local operator deploy.

## Add OCI Image Preflight

```task
id: RAPPS-WP-0010-T01
status: done
priority: high
state_hub_task_id: "445d134f-f3db-5f23-adcc-5a11f4f990e9"
```

Add a reusable image manifest preflight for
`gitea.coulomb.social/coulomb/inter-hub:<tag>` and wire production deploys to
fail before Helm when the requested tag is absent or inaccessible.

## Split Baseline Render From Production Dry-Run

```task
id: RAPPS-WP-0010-T02
status: done
priority: high
state_hub_task_id: "cd05ad19-70c9-5e97-8627-515b7b43de07"
```

Keep a baseline render target for chart validation with checked-in values, but
make production-facing Inter-Hub dry-runs require an explicit
`INTER_HUB_IMAGE_TAG`.

## Update Inter-Hub Smoke Contract

```task
id: RAPPS-WP-0010-T03
status: done
priority: high
state_hub_task_id: "6f0a6f89-32e3-5489-8801-6e554d8e27d3"
```

Update `inter-hub-smoke` to match the current public-read/authenticated-write
contract: `/api/v2/hubs` returns public discovery, protected resources reject
anonymous access, and OpenAPI is served from `/api/v2/openapi.json`.

## Add Manual Production Deploy Workflow

```task
id: RAPPS-WP-0010-T04
status: done
priority: high
state_hub_task_id: "ef8be640-c9c9-5984-a298-b8d3cfca5bef"
```

Add a `workflow_dispatch` Gitea Actions workflow that requires an immutable
image tag and confirmation text, verifies the image manifest, runs Helm
server-side dry-run, deploys, shows status, and runs smoke checks.

## Update Runbook And Closure Evidence

```task
id: RAPPS-WP-0010-T05
status: done
priority: medium
state_hub_task_id: "d38e52f8-195a-5df5-963b-e21a3a5c9e91"
```

Document the local and workflow production paths, failure classification for a
missing image tag, current smoke expectations, and validation evidence for the
implemented deploy surface.