+ lHjzaR6t30tRt^RIt^RIt^RIt^RIt^RIHtHt^RI H t ^RI H t ^RI HtHtHtHtHt^RIHt^RIHt]P0!R4tR R R R /tR tRRlt] !RRR7t]^kRRltRRltRRlt RRlt!]"PG/]$PKRR4C]$PKRR4C4t&RR lt'R!R"lt(R#R$lt)R%R&lt*R'R(lt+R)t,R*R+lt-R,R-lt.R.R/lt/R0R1lt0R2R3lt1!R4R54t2R#)7u!MemoryStore — bounded, file-backed curated memory (MEMORY.md / USER.md). Entries are joined by ``ENTRY_DELIMITER``; budgets are in chars (model-independent). Module state that tests monkeypatch (``get_memory_dir``, ``fcntl``/``msvcrt``) stays in ``tools.memory_tool`` and is read lazily.N)contextmanagersuppress) ContextVarPath)AnyDictListOptionalTuple)atomic_write_text)first_threat_messageztools.memory_toolmemoryzMEMORY (your personal notes)userzUSER PROFILE (who the user is)u § cFV^8dQhR\R\\,/#)contentreturnstrr )formats"%?@* * , ,rcRV^8dQhR\R\\\3,/#rr8r)rr(rr)rs"rrr?s&ggTgd38ngrc6\RVP R2R4#)zNExisting-but-unreadable file: saving from an assumed-empty view would wipe it.r;u=: the file exists on disk but could not be read right now (temporarily locked by another program, a permission change, invalid/corrupt text encoding, or a filesystem error). Treating an unreadable file as empty and saving would wipe existing memory, so the write is refused. Nothing was changed — retry in a moment. read_failed)r/r?r8s&r_read_failed_errorrF?s/  TYYK(V WYf  ggru"`‘’‚‛“”„‟'u‐‑‒–—―−-c0V^8dQhR\R\/#rtextrr2)rs"rrrNsRRsRsRrcRP\V4PRR4P\4P 44#)a2Quote/dash/whitespace-folded form for tolerant old_text matching. Models re-emit an entry with straight quotes for curly ones, '-' for an em dash, unwrapped lines, or a newline over-escaped to a literal backslash-n, and a byte-exact substring test then reports "No entry matched" for an unambiguous target. z\n)joinrreplace translate _MATCH_FOLDsplitrKs&r_normalize_for_matchrTNs8 88CI%%eS1;;KHNNP QQrchV^8dQhR\\,R\R\\,/#rentriesold_textr)listrint)rs"rrrVs.SSS SSST#YSrcl\V4UUu.uFwr#W9gK VNK upp;p'dV#\V4p\;QJdRV4F 'gK RM RM !RV44'g.#\V4UUu.uFwr#V\V49gKVNK upp#uuppiuuppi)zSIndices of entries containing *old_text*: byte-exact first, else typography-folded.c3@"TFqP4xK R#5iN)isalnum).0cs& r %_substring_matches..[s+Fqyy{{FTF) enumeraterTany)rWrXieexactneedles&& r_substring_matchesrjVs(1C1tqX]1CCuC !( +F 3+F+333+F+ + + #G, R,$!:Nq:Q0QAA, RR D Ss B*B*B0 B0cV^8dQhR\\,R\R\\\,\ 3,/#rV)rYrtupler rZbool)rs"rrr`s4 4 4S 4S 4U8C=RVCV=W 4rc \V4UUu.uFwr#W18XgK VNK pppT;'g \W4p\VUu0uF q V,kK up4^8dR#V'd V^,R3#RR3#uuppiuupi)u``(index, ambiguous)`` for entries matching *old_text*. A whole-entry EXACT match (``old_text == entry``) takes absolute priority — substring matches are only considered when no entry equals *old_text*, so a short entry stays addressable even when its full text is contained inside a longer sibling entry (remove('test') vs '...tests pass...'). Exact-duplicate matches are safe (first wins); distinct matches → ``(None, True)``.NF)NT)rdrjlen)rWrXrfrgrhmatchess&& r_find_unique_matchrq`s%W- ?-41QQ-E ?<<)'.__annotate__rs55S5S5rc^\\P!RVP444#)z\w+)r-refindalllowerrSs&r_words_no_match_error.._wordsrs2::fdjjl344rc3|<"TF1wr\SS!V4,4\S4, V3xK3 R#5ir])ro)r_rfrgr{wordss& rra"_no_match_error..us1]J\$!c%&)+,s5z91=J\s9<c(V^,)V^,3#)r5)ps&r!_no_match_error..vsAaD5!A$-r)key:NNg333333?§uR old_text must come from ONE entry ('§' separates entries); use one op per entry.zNo entry matched 'z'.z Retry the z6 with old_text copied verbatim from the intended entryz (closest_entries below)..no_matchclosest_entries)sortedrdr/) rWrXrsr.scoredscorerfclosesthintr{r~s &&&, @@r_no_match_errorrns5 8 E af])T[J\]ln/1F*0*E*he zwzz*GEx a%' &xj4& D6J,-OV0K\_abl P5<'1" PIN PPFs B) B)c<V^8dQhR\R\R\/#)r new_totallimitr)rZr)rs"rrrs&kk3kskskrc,RVR RVR RW, R R2#)zwould put memory at ,/z chars: free at least  charsr5)rrs&&r _over_limitrs* !)Aaay8NyO`abNcci jjrzeTo drop text inside an entry, patch a longer span that contains it; 'remove' deletes the whole entry.c<V^8dQhR\R\R\/#)rrXcountrrrZ)rs"rrrs&GGSGGGrcRV RV R2#)rGz ' appears zm times in the matched entry, and patch edits one span. Include more surrounding text so old_text occurs once.r5)rXrs&&r_repeated_span_messagers!zE7+E FGrc<V^8dQhR\R\R\/#)rrKspanrr)rs"rrrs&SSCSsSsSrc aa\VV3Rl\\S4\S4, ^,444#)zXOccurrences of *span* in *text*, overlapping ones included: '00' occurs twice in '1000'.c3H<"TFpSPSV4xK R#5ir]) startswith)r_rfrrKs& rra$_span_occurrences..s!R1QAttQ''1Qs")sumrangero)rKrsffr_span_occurrencesrs+ Rs4y3t97Lq7P1QR RRrc V^8dQhR\R\R\R\\\,\\3,/#)rentryrXnew_textr)rrlr )rs"rrrs:   s c eHSMSVX[D[>\ rc\W4;p^8dR\W4R3#VPW^4pW@8Xd RRV RV R2R3#\V4;p'dRVR3#VRR 3#) a``(patched entry, "", "none")``, or ``(None, error, failure class)`` when the span occurs more than once in the entry, the edit changes nothing, or the patched entry fails the threat scan. Single and batch patches both go through here, so they share one rule.N ambiguouszPatch is a no-op: 'z' -> 'z' leaves the entry unchanged. invalid_args scan_blockedrnone)rrrOr)rrXrrpatched scan_errors&&& r _patch_entryrs#533q8+Hlt#V3R?lR@lt$RQV3RAlRBllt%V3RClRDlt&] V3RElRFl4t'] V3RGlRHl4t(] V3RIlRJl4t)] V3RKlRLl4t*V3RMlRNlt+ROt,Vt-R #)R MemoryStorezBounded curated memory with file persistence; one instance per AIAgent. ``_system_prompt_snapshot`` is frozen at load time (prefix-cache stable); ``memory_entries`` / ``user_entries`` are live state persisted to disk.memory_enabledTuser_profile_enabledc2<V^8dQhRS[RS[RS[RS[/#)rmemory_char_limituser_char_limitrr)rZrm)r __classdict__s"rrMemoryStore.__annotate__s+))#)s)!%)DH)rc~.Vn.VnWuVnVnW4uVnVnRRRR/Vn^VnR#)rrrN)memory_entries user_entriesrrrr_system_prompt_snapshot_consolidation_failures)selfrrrrs&&&$$r__init__MemoryStore.__init__sK)+')7H4 49G6T68@"fb7Q$'($rc&<V^8dQhRS[RS[/#rtargetr)rrm)rrs"rrrsVVSVTVrc@VR8Xd VP#VP#r)rrrrs&&rtarget_enabledMemoryStore.target_enableds ,2f,._sanitizesBGPUP`P`alPmPm'X>swH NNJHVZV_V_`hVi j  *NtyyYaObNcdUUbckUlTmn/0 1rmkdir_under_hermes_homez%s exceeds its char limit on load: %d/%d chars. Entries stay loaded; further additions are blocked until it is back under the limit.N)rr)tools.threat_patternsr _path_forhermes_constantsrparentrYr(fromkeys _read_file _set_entries _char_count _char_limitrrr? _render_blockr) rrrr8rrWrrrgrs & @rload_from_diskMemoryStore.load_from_disks ; 1)F>>&)D @ #DKK 04==)>?@G   f .))&11?O?OPV?W6WeX a#yy%8483E3EfpwNxpwklyYZ\e\eOfpwNx3yD ( ( 0)OysD c <V^8dQhRS[/#)rr8r)rrs"rrrs'!'!'!rc # aaa "^RIHpVPVPuoo VP VP R,4p^RIHpV!VP4Sf S fRxR#\P\P,p\\R4'dV\P,p\P!W$R4p\\R4'd\P!VR4\P !VRR R 7oS;_uu_4R TTT 3R llpT!R 4Rx\'\(4;_uu_4T!R4RRR4RRR4R# \"d\P$!T4hi;i +'giL@;i \'\(4;_uu_4T!R4RRR4i +'gii;i;i +'giR#;i5i)zcExclusive lock on a separate .lock file so the memory file itself can still be atomically replaced. memory_toolz.lockrN O_NOFOLLOWifchmodzr+utf-8encodingc$V^8dQhR\/#)runlock)rm)rs"rr,MemoryStore._file_lock..__annotate__s b bt brc<S'd3SPSV'd SPM SP4R#SP^4SP SP 4V'd SP M SP^4R#)rN)flockLOCK_UNLOCK_EXseeklockingfilenoLK_UNLCKLK_LOCK)rfcntlfdmsvcrts&r_flock&MemoryStore._file_lock.._flocksNKKVEMMOGGAJNN299;6v~~_`arFT)toolsrr r  with_suffixsuffixrrrosO_RDWRO_CREAThasattrropenrfdopen ExceptioncloserOSError) r8_mt lock_pathrflagsraw_fdrr r r s & @@@r _file_lockMemoryStore._file_locks\ - 3:: v$$T[[7%:; < 0 01 =V^   BJJ& 2| $ $ R]] "E51  r8$$ &%(64':BR b b 5M !g&&4L'R  HHV   '&Xg&&4L'&&&RRsCG?AE2 G?'G+<F+G+ F G+( G?2#FG? F( #G++G( G G( G% G((G++ G< 6 G?c&<V^8dQhRS[RS[/#r)rr)rrs"rrr+s__#_$_rcZ^RIHpVP4VR8Xd R, #R, #)rrrr4z MEMORY.md)rrget_memory_dir)rrs& rrMemoryStore._path_for*s)%))+FfNPWXrc&<V^8dQhRS[RS[/#rr)rrs"rrr5sDD#D#Drc\\\PVPV444#r])roENTRY_DELIMITERrNr)rs&&rrMemoryStore._char_count5s#?''(9(9&(ABCCrc&<V^8dQhRS[RS[/#rr)rrs"rrr8sTT#T#Trc@VR8Xd VP#VP#r)rrrs&&rrMemoryStore._char_limit8s '-'7t##ST=S=SSrc&<V^8dQhRS[RS[/#rr2)rrs"rrr;sLLSLSLrcPVPV4R RVPV4R 2#)rr)rrrs&&r_usageMemoryStore._usage;s/""6*1-Qt/?/?/G.JKKrc,<V^8dQhRS[RS[RS[/#)rrcurrentrr)rrs"rrr>s'pppspsprcVPV4pV^8d#\^d\W#, ^d,44M^ RVR RVR R2#)ru% — rrr)rminrZ)rrr;rs&&& r _usage_pctMemoryStore._usage_pct>sS  (M(/: XY YTV XY Yr skip_driftFcB<V^8dQhRS[RS[RS[S[S[3,/#)rrrKr)rrmr(r)rrs"rrrRs2MMcM$M4PSUXPX>Mrc  jVPV4pVPV4;_uu_4VPV4wrVV'g\V4uuRRR4#V'dRMVP W4pVP V\ \PVPV4444V'd\WG4uuRRR4#V!VPV4VPV44p\V\4'd VuuRRR4#TP W^,4^RIHp V !VP 4VP#WH^,4\%V4^8d V^,M/p VP&!W^,3/V BuuRRR4# +'giR#;i)u)Lock, re-read from disk, run ``mutate(entries, limit)`` -> ``(new_entries, message)`` or an error dict, then persist and return the success response. The reload aborts on an existing-but-unreadable file (even append-only ``add`` rewrites the whole file) and, unless *skip_drift*, on external drift (flushing would discard un-roundtrippable content). Drift check and parse use the SAME raw snapshot — a failed second read used to count as "no drift". The closure may return a third value, a dict merged into the success payload (``_error``'s ``**extra`` convention) — e.g. the full text a replace overwrote (#117952). ANY dict the closure returns is passed through verbatim and nothing is persisted: error dicts, or the success payload of a read-only closure (``resolve_entry``, ``resolve_batch_entries``).Nr)rr _read_raw_checkedrF_detect_external_driftrrYr(r_parse_entriesr@r)r isinstancerrr _write_filero_success_response) rrmutaterKr8rawread_okbakresultr extra_fieldss &&&$ r_mutateMemoryStore._mutateRsD~~f% __T " "11$7LC)$/# "%$$*E*Ef*RC   fd4==9L9LS9Q+R&S T#D.# "D--f5t7G7G7OPF&$''# "   fQi 0 @ #DKK 0   T!9 -(+F a6!9RL))&)L|L## " " "s%&F!F!$A"F!>F!A._addys'!--f6bcc?''7)(;<=E 4 4Wy5H IJ 11& !1!1&!9! ,,S,C,3,&sm,7;CH~,rc DaaaaaVVVVV3RlpSPSV4#)z:Locked find-and-splice inside the matched entry (#124582).ct<S PVS RS 4p\V\4'dV#W,p\VS S 4wrEpVf \ WV4#VRVV.,W^,R,p\ \ PV44pW8dS PS RVR RVR R24#VRRVRV/3#) rtNzPatch would put memory at rru chars. Shorten the new text, or 'remove' other stale or less important entries to make room (see current_entries below), then retry — all in this turn.zEntry patched.patched_entry_beforepatched_entry_after) _locaterQr(rr/ror1rNrE)rWridxbeforeafterr%r&rrrrrXrrs&& r_apply"MemoryStore._patch.._applys,,w'=IC#t$$ \F,88,T )EM}g55dsmug-a0AAGO009:I 11&01 QuQiHTUWW,&0Eu/NN NrrZ)rrrXrrrsfffff rrsMemoryStore._patchs" N N"||FF++rc X<V^8dQhRS[RS[RS[S[,RS[S[S[3,/#)rrrXrrri)rrs"rrrs@IISICI IY]^acf^fYgIrc VP4'g \RR4#VPWP4RV4#)z/Remove the entry containing old_text substring.rkrlN)rcr/rm)rrrXrs&&&&rremoveMemoryStore.removes8~~57IJ Jzz&.."2D-HHrc R<V^8dQhRS[S[,RS[RS[RS[S[,/#)rrWrXrsr)rYrr )rrs"rrrs4tCyCsS[\_S`rc  |Ve'\W4pVeV#\\V4R4#\W4wrVV'dX\RV R2R\ W4Uu.uF1pW,R,\ W,4^P8dRMR,NK3 upR7#VfVP \WW1R 74#V#uupi) a Index of the entry *old_text* selects, or the error dict the edit returns. A write staged for approval carries the FULL entry it was reviewed against (*matched_entry*): only that exact entry qualifies, so replay never hits a newer entry that still contains old_text. stale_entryzMultiple entries matched 'z'. Be more specific.r:NPNz...r)rp)rC)rr/rrqrjrorr)rrWrXrsrr|rrfs&&&&& rr{MemoryStore._locates  $7C/3 iv6J=6Y[h/i i+G> 6xj@TUWb,>w,Q#S,Qq$+:c?s7:QS?SeY[#\#\,Q#ST T ;..wRV/pq q #Ss7B9 c H<V^8dQhRS[RS[RS[RS[S[S[3,/#)rrrXrsrr')rrs"rrrs2??C?3?c?d3PS8n?rc >aaaVVV3RlpSPWRR7#)z``{"success": True, "matched_entry": }`` for the entry *old_text* selects now, read under the lock, or the error the direct edit would return.c<SPVSP4S4p\V\4'dV#RRRW,/#)r*Tr)r{rcrQr()rWrr|rXrrss&& r_resolve+MemoryStore.resolve_entry.._resolves@,,w(8$?C$S$//3 eiX_Xd5e erTrbr)rrrXrsrsf&ff r resolve_entryMemoryStore.resolve_entrys f||F|>>rc n<V^8dQhRS[RS[RS[S[,RS[S[,RS[S[S[3,/#rgri)rrs"rrrsB,,C,3,Xc],%c],6:38n,rc DaaaaaVVVVV3RlpSPSV4#)zWLocked replace (``new_content`` set) or remove (None) of the entry matching *old_text*.cx<SPTSS'dRMRS4p\V\4'dV#VRVSf.MS.,W^,R,pSfVRRW,/3#\\P V44pWA8d SP S R\WA4 R24#VRRW,/3#) rOrNzEntry removed. removed_entryz Replacement u. Shorten the new content, or retry as ONE 'operations' batch with this replace plus removes/shortenings of other stale entries (see current_entries below) — the limit is checked only on the batch result.zEntry replaced.replaced_entry)r{rQr(ror1rNrEr) rWrr|replacedrrrhrXrrs && rr!MemoryStore._edit.._applys,,w{)PXZghC#t$$ t}k.A }UX_fg`g`hXiiH"!1OW\3RRRO00:;I 11&";y#@"ABefhh.1A7<0PP Prr)rrrXrhrrsfffff rrmMemoryStore._edits" Q Q||FF++rc<V^8dQhRS[S[,RS[RS[RS[RS[RS[S[,RS[S[S[,S[S[S[S[,3,/#)rworkingactrrXposrr)rYrr rlr)rrs"rrrsd-7-7c-7-7s-7c-7X[-7'/}-7@EhsmUXZ]_ghk_lFl@m-7rc VR8Xd+V'g V R2RRR3#W 9dVPV4R#VR9d V R2RR R3#VP4'g V R 2RR R3#VR8XdV'g V R 2RRR3#VR8Xd&VP4'gV R \ 2RRR3#Ve%\W4pVfV R\ V4 2RRR3#MR\ W4wrgV'd V RV R2RRR3#Vf.\ WV4pV RVR, 2VPR4RR3#W,p VR8wdVR8XdV.M.WV^,%RV RR3#\WV4wrp V f V RV 2RV R3#V .WV^,%RV RV 3#)uApply one batch op to *working*; return ``(error message, previous content, failure class, patched entry)`` — on a zero-match error the second value is that op's ``closest_entries`` instead, and the fourth is the entry a patch produced (None for every other op). Previous content is captured before each replace/remove, under the store lock. It is published only after the entire batch has been validated and persisted. A staged op's *matched_entry* selects exactly that entry, as in ``_locate``. rdz: content is required.Nr^rrOrtz,: unknown action. Use add, patch, or remove.rz: old_text is required.rlu: content is required — set this operation object's own 'content' to the COMPLETE new entry (or use action='remove' to delete).uk: content is required — set this operation object's own 'content' to the new text for the old_text span. : rz: 'z8' matched multiple distinct entries -- be more specific.rr+rr)NNrN)rOrrt) appendrcrrrrrqrgetr) rrrrXrrr|rmissprevious_contentrr%r&s &&&&&& r_apply_batch_opMemoryStore._apply_batch_ops% %<45t=NPTTT%w'+ + 4 4UFG~_cc c~~U12D:LdR R ) GeDEGKM^`de e '>'--//e33B2CEGKM^`de e  $7C{b!5m!D EFm]aaa0BNC%s8*,degk#T++{&w#>bg0$((;L2Mz[___"< '>03y0@G9bGa )647 7*67GSZ*['- ?U"WI&mTA A 'yC!G%vw66rch<V^8dQhRS[RS[S[S[S[3,,RS[S[S[3,/#rr operationsrrrYr(r)rrs"rrrs:<<#<4S#X3G.B?Ct?CX\]`be]eXf?Crcaaaaa ^RIHpV!SSS4;p'dV#S'g \RR4#SUu.uFqf;'g/NK upo \S 4FowrvVP R4R 9;'d,VP R4;'d\ VR,4pV'gKV\RV^, RV 2R4u# VVV VV3R lp SP SV S'*R 7#uupi) r)_memory_target_errorzoperations list is empty.ractionr Operation rrc <\V4p.p/p\S4EF wrVVPR4pVPR4;'gVPR4;'gRVPR4;'gRrVR8wd VP4V P4rSP Y'YRV^, RT;'gR R 2VPR 44wrrV 'dSP SWV R 7u#VP V 4V fKWV^,&EK V'd;V'g3SPS4PpSP SR V R 2R4#\\PV44pW8d-SP SR\S4 R\W4 R2R4#S'gRRRV/#///ppp\\SV4^4F?wpwrkV fKRVRVRV/PVPR44pVfK:V VV&KA V'dRV/M/pV'd VVR&VVR&V'dVVR&VR\S4 R2V3#)rrrrrXrtrz (unknown)r)rzRefusing to empty u: this batch would remove every entry from a previously non-empty store. Keep at least one entry — merge overlapping entries into a shorter one instead of removing the last one. To delete the final entry deliberately, use single remove() calls. would_emptyz Applying all z operations z^ more. Add removes or shortening patches of other stale entries to the same batch, then retry.rBr*Tmatched_entriesrOrreplaced_entriespatched_entriespatched_entries_afterremoved_entrieszApplied z operation(s).)rYrdrrcrrIrrr?ror1rNrzip)rWrrmatchedproducedrfoprrrXmsgrr&r~labelrrremovedr result_mapreplaced_fieldsrropsrrs&& rr"MemoryStore._batch.._apply6s7mGGH"3ffX&$&FF9$5$Q$Q 9K$Q$QrSUSYSYZdSeSkSkik'>(/ 9IX>B>R>R'z!a%3K[K[R[J\\]5^FF?+?-;}..vs[k.ll/0$&+QUO(wv.33**6(0KLO\ ]] O009:I **6#C O#4LYA^@_`jk!##!4):GDD*,RwgH-6s37H!-L))B#/"+XwSZ![!_!_`b`f`fgo`p!qJ!-(8 1 .M AI18rdrO)tools.memory_toolrr/rdrrrZ) rrrrr target_errorrrfrrrs fffd @rrMemoryStore._batch)s:/fjI I< I 5~F F",-*BxxRx*-s^EA)-??}}BFF9DU}}Znoqr{o|Z}Jz 1q5'J<@.QQ$ 1 X1 Xd||FF6z|BBs.s C0C0c6<V^8dQhRS[RS[S[,/#rr)rrs"rrrjs#DDsDx}Drc NVPPVR4;'gR#)u}Frozen load-time snapshot (NOT live state — mid-session writes don't touch it, preserving the prefix cache); None if empty.rN)rrrs&&rformat_for_system_prompt$MemoryStore.format_for_system_promptjs%++//;CCtCrcP<V^8dQhRS[RS[R,RS[S[S[3,/#)rrr%Nrr')rrs"rrros8 V V VcDj VUYZ]_bZbUc Vrc ^VnRRRRRVRVPWPV44R\VP V44/V'dRV/M/CVCRR /C#) uTERMINAL and WITHOUT the entries list: echoing entries invites the model to "find more to fix" and re-issue the same ops. A successful write resets the per-turn failure budget. ``**extra`` mirrors ``_error``'s convention — e.g. the full text a replace overwrote (#117952), deliberately visible despite the no-entries rule: silent data loss is the failure this field exists to prevent.r*TrrrD entry_countr%noteu:Write saved. This update is complete — do not repeat it.)rr>rror))rrr%r.s&&&,rrSMemoryStore._success_responseos()$4x1A1A&1IJs4#4#4V#<=VZa9gBVgiVVT V Vrc<<V^8dQhRS[RS[S[,RS[/#)rrrWrr')rrs"rrr~s+]]C]$s)]]rc  V'gR#\PV4RrC\VR8XdRMR,pV RV RVPV\ V44 RV RV 2 #)zHSystem prompt block: header + usage indicator + entries ("" when empty).rrr z [z] u══════════════════════════════════════════════)r1rNMEMORY_BLOCK_HEADERSr>ro)rrrWrseptitles&&& rrMemoryStore._render_block~sc&++G4j$v/?VXNbr$//&#g,"G!HC5PRSZR[\\rc<<V^8dQhRS[RS[S[S[3,/#rB)rrlrrm)rrs"rrrs$sDy)9rc VP4'gR#VPRR7R3# \\3dRu#i;i)z``(raw, read_ok)``; ``read_ok`` is False ONLY when the file EXISTS but can't be read. Decoding stays STRICT (``errors="replace"`` would hand callers a lossy view a save then persists); ``utf-8-sig`` strips a Notepad BOM off the first entry.Tz utf-8-sigr)rT)rF)exists read_textrUnicodeDecodeErrorrEs&rrNMemoryStore._read_raw_checkedsL {{}}O >>;>7= =+,   s.AAc6<V^8dQhRS[RS[S[,/#)rrUrr')rrs"rrrs#QQCQDIQrc vRVP\44Uu.uFq'gK VNK up#uupi)uRStripped, non-empty entries; splits on the FULL delimiter so a bare "§" survives.c3@"TFqP4xK R#5ir])rc)r_xs& rra-MemoryStore._parse_entries..sJ/I!GGII/Irc)rRr1)rUrgs& rrPMemoryStore._parse_entriess1Ksyy/IJPJaaJPPPs 66c6<V^8dQhRS[RS[S[,/#rBrrYr)rrs"rrrs#RRR$s)Rrc `\P\PV4^,4#)zEntries of a memory file ([] on any error). Read-only callers only; mutation paths use ``_read_raw_checked`` so they can refuse to overwrite an unreadable file.)rrPrNrEs&rrMemoryStore._read_files%))+*G*G*Ma*PQQrc6<V^8dQhRS[RS[S[,/#)rr8rWr)rrs"rrrs#KK$KcKrc \V\PV4RR7R# \dp\ RT RT 24hRp?ii;i)zAtomic temp-file + rename: readers never see a truncated file. Callers hold ``_file_lock`` (via ``_mutate``): a bare write from an earlier snapshot drops concurrent entries (#119668).z.mem_) tmp_prefixzFailed to write memory file rN)r r1rNr RuntimeError)r8rWrgs&& rrRMemoryStore._write_filesJ  K dO$8$8$Ag V K!=dV2aSIJ J Ks!% AAAc<<V^8dQhRS[RS[RS[S[,/#)rrrUrr)rrs"rrrs&Ssx}rc \\\VPV44^R7VP V48:dR#VP V4pVP VPR\\P!44 2,4pVPVRR7\T4# \d\T4R,u#i;i)u``.bak.`` snapshot path if *raw* shows external drift, else None. The one signal is an entry over the whole-file limit: no tool-written entry can be, so it is free-form text appended without delimiters, and replacing that "entry" would discard it. Layout differences (blank lines around ``§``, empty entries, padding) are NOT drift: parsing only strips whitespace, so the flush loses nothing but whitespace, and refusing there blocked every replace/remove on a hand-formatted file for good (#107270).r"Nz.bak.rru+ (BACKUP FAILED — file unchanged on disk)) maxmaprorPrrrrrZtime write_textrr)rrrUr8r9s&&& rrO"MemoryStore._detect_external_drifts s3++C011 =AQAQRXAY Y~~f%##DKKE#diik:J9K2L$LM Q   g  68} Qx=#PP P QsB22CC)rrrrrrrr)ii_r]).__name__ __module__ __qualname____firstlineno____doc__rrrrrr staticmethodrr rr)rrrr8r>rErIrZrdrOrtrsrr{rrmrrrrrrSrrNrPrrRrO__static_attributes____classdictcell__)rs@rrrsO,-()(,)KO))VV))77" zD'!'!R__NNYYDDTTLLpprr Y YMMM>;;. P P K K,,,II "??,,&-7-7-7^<<==?C?CBDD V V]]"QQRR KKrrcVV^8dQh/^\9d\\,;R&#)rr,)__conditional_annotations__rr)rs"rrrs%00FUTz#TG0r)4rrloggingrrxr contextlibrr contextvarsrpathlibrtypingrrr r r utilsr rr r getLoggerrrr1rr,r/r6r@rFr maketransr(rrQrTrjrqrrrrrrrrrrr)rs@rrs0  /"33#O   . /  ,f6VX:",,BG!T T9 9 ,gmmat}}-bdgha#}}-Y[^_ab RS 4P"k zG S N 3MMr