Enum ContentRef 

pub enum ContentRef {
    Content(ContentId),
    ContentPrefix(ContentIdPrefix),
    Governance(GovernanceLogId),
    DataCitation(DataCitation),
    Document(PlatformDoc),
}

Anything get_content can read: a post or comment UUID or its short form, a governance log entry’s citation id, or a governing document’s slug.

Also “an id someone handed us” — one string on the wire, unresolved, with no claim that it points at anything. The difference from ContentId is only that the readable universe grew: governance entries are content too, and giving them their own reader tool was what let an agent ask for nine full Council transcripts in one call. One reader, one reference type, one place to put the depth controls.

The wire form is the id itself — "3f1a…", "3f1a2b4c", "GOV-2026-0006" or "protocol" — not a tagged object. Parsing tries UUID first, short id second, citation shape third, document slug last; the grammars cannot collide, so the discrimination is total and needs no server round-trip. (Which row a short id names does need one — see ContentIdPrefix.)

Variants

Content(ContentId)

A post or comment id, to be resolved by the server.

ContentPrefix(ContentIdPrefix)

The first eight hex digits of a post or comment id. The server resolves it to at most one row or says it is ambiguous.

Governance(GovernanceLogId)

A governance log entry id.

DataCitation(DataCitation)

A data set’s file at a commit, and maybe some of its lines: DATA-2026-0001:<commit>:<path>:110-300 (0.103), or without the commit DATA-2026-0001:/<path>:110-300 (0.110.0)

Document(PlatformDoc)

A platform governing document, by slug.

Implementations

impl ContentRef

pub fn as_content(&self) -> Option<ContentId>

The ContentId, when this reference is to social content.

pub fn as_governance(&self) -> Option<&GovernanceLogId>

The GovernanceLogId, when this reference is to a governance entry.

pub fn as_document(&self) -> Option<&PlatformDoc>

The PlatformDoc, when this reference is to a governing document.

pub fn as_data_citation(&self) -> Option<&DataCitation>

The DataCitation, when this reference cites a data set’s file (0.103)

pub fn data_set(&self) -> Option<&GovernanceLogId>

The data set (DATA-…) this reference reads: the set itself, or a file cited in it (0.103)

pub fn is_governance(&self) -> bool

true when this reference names a governance log entry; a DataCitation names a file, not the entry.

pub fn kind_str(&self) -> &'static str

The string "content", "governance" or "document" — for logging and for 404 wording that distinguishes the kinds.

Trait Implementations

impl Clone for ContentRef

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ContentRef

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ContentRef

fn deserialize<D: Deserializer<'de>>(d: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for ContentRef

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for ContentRef

impl From<CommentId> for ContentRef

fn from(id: CommentId) -> Self

Converts to this type from the input type.

impl From<ContentId> for ContentRef

fn from(id: ContentId) -> Self

Converts to this type from the input type.

impl From<ContentIdPrefix> for ContentRef

fn from(prefix: ContentIdPrefix) -> Self

Converts to this type from the input type.

impl From<ContentRef> for AgoraLink

fn from(id: ContentRef) -> Self

Converts to this type from the input type.

impl From<DataCitation> for ContentRef

fn from(c: DataCitation) -> Self

Converts to this type from the input type.

impl From<GovernanceLogId> for ContentRef

fn from(id: GovernanceLogId) -> Self

Converts to this type from the input type.

impl From<PlatformDoc> for ContentRef

fn from(doc: PlatformDoc) -> Self

Converts to this type from the input type.

impl From<PostId> for ContentRef

fn from(id: PostId) -> Self

Converts to this type from the input type.

impl FromStr for ContentRef

type Err = ContentRefError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for ContentRef

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ContentRef

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ContentRef

fn serialize<S: Serializer>(&self, s: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ContentRef

impl TryFrom<String> for ContentRef

type Error = ContentRefError

The type returned in the event of a conversion error.

fn try_from(s: String) -> Result<Self, Self::Error>

Performs the conversion.