MjvddZddlmZddlmZmZddlmZddlm Z m Z m Z Gdde eZ Gdd e eZGd d e eZed GddZed GddZed GddZe Gdde Zed GddZgdZy)adStable contracts for the local mySecondBrain26 knowledge plane. Document bytes, extracted text, and model-generated summaries are deliberately different kinds of data. These contracts keep provenance, trust and sensitivity attached to each item so a future retriever cannot treat document content as an instruction or silently send it to a remote model. ) annotations) dataclassfield)Enum)AnyProtocolruntime_checkablec eZdZdZdZdZdZdZy) DocumentTrustzBHow the source entered the library; never an execution permission. untrustedexternalreviewedtrustedN)__name__ __module__ __qualname____doc__ UNTRUSTEDEXTERNALREVIEWEDTRUSTEDL/home/oem/CyberBrain26-unified/src/cyberbrain26/knowledge_plane/contracts.pyr r sLIHHGrr c eZdZdZdZdZdZdZy) SensitivityzDConservative data-handling label for a document and its derivatives.publicpersonal sensitive restrictedN)rrrrPUBLICPERSONAL SENSITIVE RESTRICTEDrrrrrsN FHIJrrc$eZdZdZdZdZdZdZdZy)DocumentStatuszrrrr3r3,sHPNO(11E=1*33K3Hd$T:Hn:rr3cLeZdZUdZded<ded<ded<eeZd ed <y ) DocumentRegistrationa+Metadata needed to register one immutable document version. ``content`` is used only to calculate the local integrity digest. This contract does not persist or transmit bytes; an origin-store adapter will be introduced separately and must have its own retention and backup policy. r3sourcebytescontentr4 media_typer;r=r>N)rrrrr?rr@r>rrrrBrB8s(  NO$T:Hn:rrBceZdZUdZded<ded<ded<ded<ded<ded <d ed <d ed <ded<ded<ded<dZded<dZded<dZded<y)KnowledgeDocumentzCPersisted metadata for an idempotently registered document version.r4 document_idr5r6content_sha256rFr r7rr8r&statusr=r>float created_at updated_atg valid_fromvalid_to superseded_byN)rrrrr?rOrPrRrrrrHrHGsbMNOO  JHeM3rrHc eZdZdZddZddZy)KnowledgeRepositoryzBRepository boundary for document metadata, independent of indexes.cy)z3Return a document and whether this call created it.Nr)self registrations rregisterzKnowledgeRepository.register` rcy)z+Return a document by its stable identifier.Nr)rVrIs rgetzKnowledgeRepository.getdrYrN)rWrBreturnztuple[KnowledgeDocument, bool])rIr4r\zKnowledgeDocument | None)rrrrrXr[rrrrTrT\sL  rrTceZdZUdZded<ded<ded<eeZded <eeZded <ee Z d ed <eeZ ded <y)KG1NodeuPInstance Resource Graph node — Jurassic OiO-pattern business ontology element.r4idtyper3rCr;r=business_semanticsdomain_constraintszlist[dict[str, Any]]evidencer>N) rrrrr?rr@rarblistrcr>rrrr^r^isTZ G I ).t)DD).t)DD%*4%@H"@$T:Hn:rr^)rBr&r r^rHrTr3rN)r __future__r dataclassesrrenumrtypingrrr r4r rr&r3rBrHrTr^__all__rrrrjs#(33C#tS$ $;;; $ ; ; ; $(  (     $ ; ; ; r