Files

tegwick a52b77a0e7 feat(registry): complete ATLAS-WP-0002 T04 (canon mapping) + T01 (surface schema)

T04: add docs/canon-mapping.md mapping config-atlas concepts to InfoTechCanon
(itc-gov/data/devsecops/land/org/access/sec/tag) and sibling repos with
consume/reference/align/own ownership, plus gaps, validation hooks, and
extension candidates. Resolves the (planned) refs in PRD and ecosystem-boundaries.

T01: add schemas/surface-entry.schema.json (Draft 2020-12, additionalProperties
false to forbid inline values/secrets), docs/configuration-surface-schema.md
(fields, kind taxonomy, L0-L9 ordering, explicit merge rules), a validating seed
entry (surface.infotech.state-hub.api-config), and expand registry/README.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-26 22:47:40 +02:00

1.8 KiB

Raw Blame History

id, name, kind, summary, owner, status, scope, mutability, security_class, schema, sources, relations, evidence

name

kind

summary

owner

status

scope

mutability

security_class

schema

sources

relations

evidence

surface.infotech.state-hub.api-config

State Hub API configuration

app-config

Runtime configuration for the Custodian State Hub API (bind host/port, database URL, environment mode).

custodian

active

allowed_layers

default_layer

product-default

company

environment

installation

company

startup-time

operational

type	validator
object	~/state-hub/config/schema.json

repo	path	role
state-hub	Makefile	product-default

repo	path	role
state-hub	.env.example	company-baseline

consumed_by

overrides

depends_on_secret

related_to

service.state-hub-api

state-hub/database-url

surface.infotech.ops-bridge.tunnel-config

last_seen	discovery_method	change_log_ref
2026-06-26	manual	ATLAS-WP-0002-T01

State Hub API configuration

The Custodian State Hub API (http://127.0.0.1:8000) reads its runtime configuration at startup: bind host/port, database connection, and environment mode. This surface maps that configuration — it does not duplicate the values.

Source of truth: the state-hub repo (make api / .env); the database URL is a secret reference (depends_on_secret), never stored here.
Precedence: product defaults in the Makefile, overridden by a company/env .env, optionally per-installation. Startup-time mutability — changes require an API restart (make api).
Consumers: the State Hub API service; related to the ops-bridge tunnel config that exposes it to remote machines.

This is a seed example proving the surface-entry schema (../../docs/configuration-surface-schema.md). The broader Phase 1 seed is ATLAS-WP-0002-T03.

1.8 KiB Raw Blame History

State Hub API configuration

1.8 KiB

Raw Blame History