Relationship Class v1¶
Source schema: doc/schemas/relationship-class.v1.schema.json
Operator-defined local relationship class definition. A class is policy metadata and never authority by itself.
Governing Basis¶
doc/project/40-proposals/065-local-relationship-layer.mddoc/project/60-solutions/032-local-relationship-layer/032-local-relationship-layer.md
Project Lineage¶
Requirements¶
doc/project/50-requirements/requirements-006-node-networking-mvp.mddoc/project/50-requirements/requirements-010-middleware-executor.mddoc/project/50-requirements/requirements-011-dator-arca-contracts.mddoc/project/50-requirements/requirements-014-resource-opinions.md
Stories¶
doc/project/30-stories/story-001-swarm-node-onboarding.mddoc/project/30-stories/story-004-pod-client-onboarding.mddoc/project/30-stories/story-005-whisper-rumor-intake.mddoc/project/30-stories/story-006-buyer-node-components.mddoc/project/30-stories/story-006-voluntary-swarm-exchange.mddoc/project/30-stories/story-007-settlement-capable-node.mddoc/project/30-stories/story-008-cool-site-comment.md
Fields¶
| Field | Required | Shape | Description |
|---|---|---|---|
schema |
yes |
const: relationship-class.v1 |
|
schema/v |
yes |
const: 1 |
|
class/id |
yes |
ref: #/$defs/class_id |
|
class/state |
yes |
enum: active, archived |
|
display/label |
yes |
string | |
description |
no |
string | |
default/status |
yes |
enum: active, pending-outgoing, pending-incoming, blocked, revoked |
|
grant-policy/default-allowlist |
no |
array | Capabilities host policy may consider for members. This is not an automatic grant. |
grant-policy/suggested-defaults |
no |
array | Suggested capabilities requiring explicit operator confirmation. |
grant-allowlist |
no |
array | |
verification/required |
no |
array | |
privacy/profile |
yes |
enum: sealed-only, operator-visible-summary, public-aggregate |
|
retention/profile-ref |
no |
string | |
policy/refs |
no |
array |
Definitions¶
| Definition | Shape | Description |
|---|---|---|
class_id |
string | |
capability_id |
string | |
| ## Field Semantics |
schema¶
- Required:
yes - Shape: const:
relationship-class.v1
schema/v¶
- Required:
yes - Shape: const:
1
class/id¶
- Required:
yes - Shape: ref:
#/$defs/class_id
class/state¶
- Required:
yes - Shape: enum:
active,archived
display/label¶
- Required:
yes - Shape: string
description¶
- Required:
no - Shape: string
default/status¶
- Required:
yes - Shape: enum:
active,pending-outgoing,pending-incoming,blocked,revoked
grant-policy/default-allowlist¶
- Required:
no - Shape: array
Capabilities host policy may consider for members. This is not an automatic grant.
grant-policy/suggested-defaults¶
- Required:
no - Shape: array
Suggested capabilities requiring explicit operator confirmation.
grant-allowlist¶
- Required:
no - Shape: array
verification/required¶
- Required:
no - Shape: array
privacy/profile¶
- Required:
yes - Shape: enum:
sealed-only,operator-visible-summary,public-aggregate
retention/profile-ref¶
- Required:
no - Shape: string
policy/refs¶
- Required:
no - Shape: array
Definition Semantics¶
$defs.class_id¶
- Shape: string
$defs.capability_id¶
- Shape: string