cayu.knowledge.maintenance_governance

Public Cayu API. Definitions are grouped by their public source module, and definitions from private implementation modules appear on their package’s page; adding a symbol does not move existing links. The import shown at each entry is a supported public namespace. Read the Python API overview and install the required extra.

`decide_knowledge_maintenance_governance`

from cayu import decide_knowledge_maintenance_governance

Return exact maintenance authority or fail closed before persistence.

async decide_knowledge_maintenance_governance(request: KnowledgeMaintenanceGovernanceRequest, *, config: KnowledgeGovernanceConfig, policy: KnowledgeMaintenanceGovernancePolicy | None=None) -> KnowledgeMaintenanceGovernanceAuthority

Release source · Runtime guarantees · Capability guides

`KnowledgeMaintenanceGovernanceAuthority`

from cayu import KnowledgeMaintenanceGovernanceAuthority

Validated request/decision pair accepted by the persistence boundary.

Bases: _GovernanceModel.

Fields and attributes

Defaults below are source expressions; Field(...) includes schema/validation settings and default_factory creates a fresh value. Inherited declarations are included. Constructor behavior follows the model or dataclass shown in the bases/decorators.

Name	Type	Default
`schema_version`	`Literal[1]`	`1`
`request`	`KnowledgeMaintenanceGovernanceRequest`	`required`
`decision`	`KnowledgeMaintenanceGovernanceDecision`	`required`

validate_schema_version (method)

KnowledgeMaintenanceGovernanceAuthority.validate_schema_version(value: object) -> object

copy_models (method)

KnowledgeMaintenanceGovernanceAuthority.copy_models(value: object) -> object

validate_binding (method)

KnowledgeMaintenanceGovernanceAuthority.validate_binding() -> KnowledgeMaintenanceGovernanceAuthority

Release source · Runtime guarantees · Capability guides

`KnowledgeMaintenanceGovernanceDecision`

from cayu import KnowledgeMaintenanceGovernanceDecision

Exact application-policy decision over one request.

Bases: _GovernanceModel.

Fields and attributes

Name	Type	Default
`schema_version`	`Literal[1]`	`1`
`request_sha256`	`str`	`required`
`disposition`	`KnowledgeMaintenanceGovernanceDisposition`	`required`
`policy_identity`	`str`	`required`
`policy_version`	`str`	`required`
`code`	`str`	`required`
`annotations`	`dict[str, Any]`	`Field(default_factory=dict)`

validate_schema_version (method)

KnowledgeMaintenanceGovernanceDecision.validate_schema_version(value: object) -> object

validate_request_sha256 (method)

KnowledgeMaintenanceGovernanceDecision.validate_request_sha256(value: str) -> str

validate_identity (method)

KnowledgeMaintenanceGovernanceDecision.validate_identity(value: str, info) -> str

copy_annotations (method)

KnowledgeMaintenanceGovernanceDecision.copy_annotations(value: object) -> dict[str, Any]

fingerprint (property)

KnowledgeMaintenanceGovernanceDecision.fingerprint() -> str

Release source · Runtime guarantees · Capability guides

`KnowledgeMaintenanceGovernanceDisposition`

from cayu import KnowledgeMaintenanceGovernanceDisposition

Application-policy disposition for one evaluated proposal.

Bases: StrEnum.

Fields and attributes

Name	Type	Default
`APPROVE`	`class attribute`	`'approve'`
`ROUTE_TO_REVIEW`	`class attribute`	`'route_to_review'`
`REJECT`	`class attribute`	`'reject'`

Release source · Runtime guarantees · Capability guides

`KnowledgeMaintenanceGovernancePolicy`

from cayu import KnowledgeMaintenanceGovernancePolicy

Application authority for one copied, bounded maintenance request.

Bases: Protocol.

decide_maintenance (method)

async KnowledgeMaintenanceGovernancePolicy.decide_maintenance(request: KnowledgeMaintenanceGovernanceRequest) -> KnowledgeMaintenanceGovernanceDecision

Release source · Runtime guarantees · Capability guides

`KnowledgeMaintenanceGovernancePolicyError`

from cayu import KnowledgeMaintenanceGovernancePolicyError

A maintenance policy failed closed before any store mutation.

Bases: RuntimeError.

init (method)

KnowledgeMaintenanceGovernancePolicyError.__init__(code: str) -> None

Release source · Runtime guarantees · Capability guides

`KnowledgeMaintenanceGovernanceReceipt`

from cayu import KnowledgeMaintenanceGovernanceReceipt

Store-authored evidence for one exact maintenance authority outcome.

Bases: _GovernanceModel.

Fields and attributes

Name	Type	Default
`schema_version`	`Literal[1]`	`1`
`operation_id`	`str`	`required`
`proposal_id`	`str`	`required`
`proposal_fingerprint`	`str`	`required`
`authority`	`KnowledgeMaintenanceGovernanceAuthority`	`required`
`maintenance_receipt`	`KnowledgeMaintenanceDecisionReceipt \| None`	`None`
`committed_at`	`datetime`	`required`
`replayed`	`bool`	`False`

validate_schema_version (method)

KnowledgeMaintenanceGovernanceReceipt.validate_schema_version(value: object) -> object

validate_identity (method)

KnowledgeMaintenanceGovernanceReceipt.validate_identity(value: str, info) -> str

validate_proposal_fingerprint (method)

KnowledgeMaintenanceGovernanceReceipt.validate_proposal_fingerprint(value: str) -> str

copy_nested_models (method)

KnowledgeMaintenanceGovernanceReceipt.copy_nested_models(value: object) -> object

validate_committed_at (method)

KnowledgeMaintenanceGovernanceReceipt.validate_committed_at(value: datetime) -> datetime

validate_replayed (method)

KnowledgeMaintenanceGovernanceReceipt.validate_replayed(value: object) -> bool

validate_outcome (method)

KnowledgeMaintenanceGovernanceReceipt.validate_outcome() -> KnowledgeMaintenanceGovernanceReceipt

Release source · Runtime guarantees · Capability guides

`KnowledgeMaintenanceGovernanceRequest`

from cayu import KnowledgeMaintenanceGovernanceRequest

Copied bounded material presented to one maintenance policy.

Bases: _GovernanceModel.

Fields and attributes

Name	Type	Default
`schema_version`	`Literal[1]`	`1`
`operation_id`	`str`	`required`
`mode`	`KnowledgeGovernanceMode`	`required`
`proposal`	`KnowledgeMaintenanceProposal`	`required`
`publication_operation_id`	`str`	`required`
`publication_request_sha256`	`str`	`required`
`accepted_plan_fingerprint`	`str`	`required`
`routing_request_fingerprint`	`str`	`required`
`routing_result_fingerprint`	`str`	`required`
`routing_configuration_fingerprint`	`str`	`required`
`planning_configuration_fingerprint`	`str`	`required`
`plan_fingerprint`	`str`	`required`
`evaluation_fingerprint`	`str`	`required`
`planner_identity`	`str`	`required`
`planner_version`	`str`	`required`
`evaluator_identity`	`str`	`required`
`evaluator_version`	`str`	`required`
`access_scope`	`KnowledgeAccessScope`	`required`
`forbidden_authority_identities`	`tuple[str, ...]`	`required`

validate_schema_version (method)

KnowledgeMaintenanceGovernanceRequest.validate_schema_version(value: object) -> object

validate_identity (method)

KnowledgeMaintenanceGovernanceRequest.validate_identity(value: str, info) -> str

validate_sha256 (method)

KnowledgeMaintenanceGovernanceRequest.validate_sha256(value: str, info) -> str

copy_proposal (method)

KnowledgeMaintenanceGovernanceRequest.copy_proposal(value: object) -> object

copy_access_scope (method)

KnowledgeMaintenanceGovernanceRequest.copy_access_scope(value: object) -> object

copy_forbidden_identities (method)

KnowledgeMaintenanceGovernanceRequest.copy_forbidden_identities(value: object) -> tuple[str, ...]

validate_bindings (method)

KnowledgeMaintenanceGovernanceRequest.validate_bindings() -> KnowledgeMaintenanceGovernanceRequest

fingerprint (property)

KnowledgeMaintenanceGovernanceRequest.fingerprint() -> str

access_scope_sha256 (property)

KnowledgeMaintenanceGovernanceRequest.access_scope_sha256() -> str

Release source · Runtime guarantees · Capability guides

`KnowledgeMaintenanceGovernor`

from cayu import KnowledgeMaintenanceGovernor

Explicit high-level operation over persisted evaluated proposals.

init (method)

KnowledgeMaintenanceGovernor.__init__(store: KnowledgeStore, *, config: KnowledgeGovernanceConfig, policy: KnowledgeMaintenanceGovernancePolicy | None=None) -> None

govern (method)

async KnowledgeMaintenanceGovernor.govern(*, operation_id: str, proposal_id: str, access_scope: KnowledgeAccessScope | None=None) -> KnowledgeMaintenanceGovernanceReceipt

Govern one exact persisted proposal and return durable attribution.

Release source · Runtime guarantees · Capability guides

`load_knowledge_maintenance_governance_receipt`

from cayu import load_knowledge_maintenance_governance_receipt

Load route or terminal governance attribution without invoking a policy.

async load_knowledge_maintenance_governance_receipt(store: KnowledgeStore, *, operation_id: str, access_scope: KnowledgeAccessScope | None=None) -> KnowledgeMaintenanceGovernanceReceipt | None

Release source · Runtime guarantees · Capability guides

`MAX_KNOWLEDGE_MAINTENANCE_GOVERNANCE_ANNOTATION_BYTES`

from cayu import MAX_KNOWLEDGE_MAINTENANCE_GOVERNANCE_ANNOTATION_BYTES

MAX_KNOWLEDGE_MAINTENANCE_GOVERNANCE_ANNOTATION_BYTES = 4096

Release source · Runtime guarantees · Capability guides

`MAX_KNOWLEDGE_MAINTENANCE_GOVERNANCE_RECEIPT_BYTES`

from cayu import MAX_KNOWLEDGE_MAINTENANCE_GOVERNANCE_RECEIPT_BYTES

MAX_KNOWLEDGE_MAINTENANCE_GOVERNANCE_RECEIPT_BYTES = 640000

Release source · Runtime guarantees · Capability guides

`MAX_KNOWLEDGE_MAINTENANCE_GOVERNANCE_REQUEST_BYTES`

from cayu import MAX_KNOWLEDGE_MAINTENANCE_GOVERNANCE_REQUEST_BYTES

MAX_KNOWLEDGE_MAINTENANCE_GOVERNANCE_REQUEST_BYTES = 512000

Release source · Runtime guarantees · Capability guides

`prepare_knowledge_maintenance_governance_request`

from cayu import prepare_knowledge_maintenance_governance_request

Build the exact bounded policy input from a persisted accepted proposal.

prepare_knowledge_maintenance_governance_request(publication: KnowledgeMaintenanceProposalPublication, *, operation_id: str, mode: KnowledgeGovernanceMode) -> KnowledgeMaintenanceGovernanceRequest

Release source · Runtime guarantees · Capability guides