"""Shard context — identity and governance state from shell registration."""

from dataclasses import dataclass, field
import uuid


@dataclass
class ShardContext:
    """Context returned by ShellApp.register().

    Holds all identity and governance information for this shard instance.
    """

    shard_name: str
    shard_id: str = field(default_factory=lambda: str(uuid.uuid4()))
    shard_did: str = ""
    svid: str = ""
    accord_hash: str = ""
    ffc_did: str = ""
    is_governed: bool = False
    language: str = "python"
    version: str = "0.0.0"

    @property
    def actor_did(self) -> str:
        """The DID for events from this shard."""
        return self.shard_did or f"did:web:local:shard:{self.shard_name}"