From 095342c72ab6f02c72dd5d40e869dcba536bc5c1 Mon Sep 17 00:00:00 2001 From: codex Date: Wed, 14 Oct 2026 06:42:09 +0200 Subject: [PATCH] docs(reuse): establish reviewed NetKingdom security capabilities Assistant: codex Assistant-Model: gpt-6-astra Assistant-Session: 01a137ca-5c77-7a71-b9ae-23ad9b0b5684 --- .../capability.railiance.fabric-graph.md | 112 +++++++++--------- registry/indexes/capabilities.yaml | 19 +-- 2 files changed, 69 insertions(+), 62 deletions(-) diff --git a/registry/capabilities/capability.railiance.fabric-graph.md b/registry/capabilities/capability.railiance.fabric-graph.md index 798f15a..c858fd1 100644 --- a/registry/capabilities/capability.railiance.fabric-graph.md +++ b/registry/capabilities/capability.railiance.fabric-graph.md @@ -1,9 +1,7 @@ --- id: capability.railiance.fabric-graph -name: Railiance Fabric Ecosystem Graph -summary: 'Models the durable infrastructure-responsibility graph of the Railiance netkingdom: schemas, - discovery tools, registry services, graph queries, and State Hub export contracts for services, machines, - repos, deployables, endpoints, ownership, dependencies, and bindings.' +name: Infrastructure ownership and dependency graph +summary: Schemas, validation, graph queries and State Hub exports. owner: railiance-fabric status: draft domain: financials @@ -12,20 +10,25 @@ tags: - graph - ownership - discovery +- security +- netkingdom +- framework-reuse maturity: discovery: current: D3 target: D5 confidence: medium rationale: README and SCOPE.md document the ecosystem graph model bounded by financial/operational - accountability (who pays, who is accountable), with king/lord/tenant ownership concepts referenced - in docs/FabricDiscoveryAndUpdate.md. + accountability (who pays, who is accountable), with king/lord/tenant ownership + concepts referenced in docs/FabricDiscoveryAndUpdate.md. availability: - current: A1 + current: A2 target: A3 confidence: medium - rationale: Python package (`railiance-fabric`) providing a declaration loader and validator; consumed - as a library, no hosted service documented yet. + rationale: 'Source interface assessed 2026-10-14: Schemas, validation, graph queries + and State Hub exports. Availability describes the delivery form, not production + acceptance. Graph assertions need current owner evidence; not an enforcement + registry.' external_evidence: completeness: level: C1 @@ -41,36 +44,40 @@ external_evidence: confidence: low basis: consumer_quality_signals known_reliability_risks: - - discovery/rebuild/update-loop architecture documented as still evolving per docs/FabricDiscoveryAndUpdate.md + - discovery/rebuild/update-loop architecture documented as still evolving per + docs/FabricDiscoveryAndUpdate.md discovery: - intent: Let repos declare services, capabilities, interfaces, dependencies, and bindings in source-controlled - files, and model the resulting durable infrastructure-responsibility graph across the Railiance ecosystem. + intent: Schemas, validation, graph queries and State Hub exports includes: - - ecosystem graph schema and declaration loader/validator - - State Hub export contracts for the graph + - Schemas, validation, graph queries and State Hub exports excludes: - - actual infrastructure provisioning (see railiance-infra, railiance-cluster) + - Graph assertions need current owner evidence; not an enforcement registry assumptions: [] - use_cases: [] + use_cases: + - 'U09: Maintainer observes posture, prioritizes findings, coordinates work and + verifies outcomes' + - 'U13: Platform owner deploys and rolls back a workload with explicit substrate + and custody bindings' + - 'U14: Framework adopter validates and reuses selected contracts, tools and reference + compositions' research_memos: [] availability: - current_level: A1 + current_level: A2 target_level: A3 current_artifacts: - - Python package (`railiance-fabric`) + - SCOPE.md target_artifacts: [] consumption_modes: - - library import - - cli (validation) + - CLI + - source relations: depends_on: [] supports: [] - related_to: [] + related_to: + - capability.security.iam-tooling-suite evidence: documentation: - - README.md - SCOPE.md - - docs/FabricDiscoveryAndUpdate.md tests: - tests/ consumer_feedback: [] @@ -78,45 +85,44 @@ evidence: incidents: [] consumer_guidance: recommended_for: - - Railiance repos wanting to declare their place in the ecosystem ownership/dependency graph + - Maintainer observes posture, prioritizes findings, coordinates work and verifies + outcomes + - Platform owner deploys and rolls back a workload with explicit substrate and custody + bindings + - Framework adopter validates and reuses selected contracts, tools and reference + compositions not_recommended_for: - - needs for actual infrastructure provisioning (see railiance-infra/-cluster) + - Graph assertions need current owner evidence; not an enforcement registry known_limitations: - - discovery/rebuild/update-loop architecture still evolving -promotion_history: [] + - Graph assertions need current owner evidence; not an enforcement registry + - 2026-10-14 architecture review estimates operational maturity separately; a registry + entry does not authorize execution or establish deployment. +promotion_history: +- date: '2026-10-14' + dimension: availability + from: A1 + to: A2 + rationale: Interface-form reassessment from current owner sources; no completeness/reliability + promotion. + author: codex --- -# Railiance Fabric Ecosystem Graph +# Infrastructure ownership and dependency graph -## Overview +Schemas, validation, graph queries and State Hub exports. -`railiance-fabric` models the durable infrastructure-responsibility graph of the Railiance netkingdom — who pays for infrastructure, who is accountable for it, and which durable interfaces create value across boundaries — via schemas, a declaration loader/validator, and State Hub export contracts. +## Reuse boundary -## Assessment notes +Graph assertions need current owner evidence; not an enforcement registry. -### Discovery +## Supported use cases -README and SCOPE.md document the ecosystem graph model bounded by financial/operational accountability (who pays, who is accountable), with king/lord/tenant ownership concepts referenced in docs/FabricDiscoveryAndUpdate.md. +- U09: Maintainer observes posture, prioritizes findings, coordinates work and verifies outcomes +- U13: Platform owner deploys and rolls back a workload with explicit substrate and custody bindings +- U14: Framework adopter validates and reuses selected contracts, tools and reference compositions -### Availability +## Evidence and integration -Python package (`railiance-fabric`) providing a declaration loader and validator; consumed as a library, no hosted service documented yet. +- [SCOPE.md](../../SCOPE.md) -### Completeness - -First-pass honest assessment from the REUSE-WP-0017 coverage campaign -(reuse-surface). No external consumer feedback exists yet; levels reflect -scope-vs-intent documentation quality, not internal code quality. - -### Reliability - -No production consumer telemetry exists yet; reliability level is -intentionally conservative pending REUSE-WP-0019 reuse-telemetry evidence. - -## Promotion checklist - -- [x] ID follows `capability..` pattern -- [x] Maturity enums match `specs/CapabilityMaturityStandard.md` -- [x] `external_evidence` is populated separately from `maturity` -- [ ] Relations reference valid capability IDs (none yet) -- [x] Index entry added in `registry/indexes/capabilities.yaml` +Assessment: CUST-WP-0081, 2026-10-14. Relations identify interfaces to compose; they do not certify native integration. Existing external evidence levels are retained where present. New entries use conservative C1/R0 until consumer assessment exists. diff --git a/registry/indexes/capabilities.yaml b/registry/indexes/capabilities.yaml index b87197e..b7e9b3a 100644 --- a/registry/indexes/capabilities.yaml +++ b/registry/indexes/capabilities.yaml @@ -1,22 +1,23 @@ version: 1 -updated: '2026-07-06' +updated: '2026-10-14' domain: helix_forge capabilities: - id: capability.railiance.fabric-graph - name: Railiance Fabric Ecosystem Graph - summary: 'Models the durable infrastructure-responsibility graph of the Railiance netkingdom: schemas, - discovery tools, registry services, graph queries, and State Hub export contracts for services, machines, - repos, deployables, endpoints, ownership, dependencies, and bindings.' - vector: D3 / A1 / C1 / R0 + name: Infrastructure ownership and dependency graph + summary: Schemas, validation, graph queries and State Hub exports. domain: financials status: draft owner: railiance-fabric - path: registry/capabilities/capability.railiance.fabric-graph.md tags: - railiance - graph - ownership - discovery + - security + - netkingdom + - framework-reuse + vector: D3 / A2 / C1 / R0 + path: registry/capabilities/capability.railiance.fabric-graph.md consumption_modes: - - library import - - cli (validation) + - CLI + - source