Topic Taxonomy v1¶
Source schema: doc/schemas/topic-taxonomy.v1.schema.json
Signed, versioned taxonomy material used by Corpus topic resolution and topic-scoped service-offer indexing. The taxonomy is protocol mechanics, not federation-local preference text.
Governing Basis¶
Project Lineage¶
Fields¶
| Field | Required | Shape | Description |
|---|---|---|---|
schema/v |
yes |
const: 1 |
|
taxonomy/id |
yes |
string | |
federation/id |
yes |
string | |
version |
yes |
string | |
versioning/scheme |
yes |
enum: calver, semver, sequence |
|
digest |
yes |
ref: #/$defs/sha256_digest |
|
issuer/nym |
yes |
string | |
issuer/public-key-ref |
no |
string | |
valid/from |
yes |
string | |
valid/until |
yes |
string | Exclusive validity upper bound. Runtime trust verification rejects the taxonomy when now >= valid/until. |
supersedes |
no |
ref: #/$defs/sha256_digest |
|
supersession/proof |
no |
ref: #/$defs/signature |
|
extension/policy |
no |
object | |
nodes |
yes |
array | |
signature |
yes |
ref: #/$defs/signature |
|
extensions |
no |
ref: #/$defs/extensions |
Definitions¶
| Definition | Shape | Description |
|---|---|---|
sha256_digest |
string | |
topic_term |
string | |
topic_node |
object | |
signature |
object | |
extensions |
object | |
| ## Field Semantics |
schema/v¶
- Required:
yes - Shape: const:
1
taxonomy/id¶
- Required:
yes - Shape: string
federation/id¶
- Required:
yes - Shape: string
version¶
- Required:
yes - Shape: string
versioning/scheme¶
- Required:
yes - Shape: enum:
calver,semver,sequence
digest¶
- Required:
yes - Shape: ref:
#/$defs/sha256_digest
issuer/nym¶
- Required:
yes - Shape: string
issuer/public-key-ref¶
- Required:
no - Shape: string
valid/from¶
- Required:
yes - Shape: string
valid/until¶
- Required:
yes - Shape: string
Exclusive validity upper bound. Runtime trust verification rejects the taxonomy when now >= valid/until.
supersedes¶
- Required:
no - Shape: ref:
#/$defs/sha256_digest
supersession/proof¶
- Required:
no - Shape: ref:
#/$defs/signature
extension/policy¶
- Required:
no - Shape: object
nodes¶
- Required:
yes - Shape: array
signature¶
- Required:
yes - Shape: ref:
#/$defs/signature
extensions¶
- Required:
no - Shape: ref:
#/$defs/extensions
Definition Semantics¶
$defs.sha256_digest¶
- Shape: string
$defs.topic_term¶
- Shape: string
$defs.topic_node¶
- Shape: object
$defs.signature¶
- Shape: object
$defs.extensions¶
- Shape: object