IiwSrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK J r J r SSK J r \R"S5rSrSrSrS rS rS r"S S 5rg)a&Document manager for loading, editing, and versioning server documents. Supports a shared/independent directory split for pull-only sync infrastructure: - ``shared/`` contains canonical documents tracked in the git repository. - ``independent/`` contains server-specific documents (gitignored). Three contribution modes (configured via ``config.toml``): - **manual**: changes stay uncommitted; admin exports a ZIP. - **auto_commit** (default): server auto-commits after each save. - **auto_pr**: auto-commit + admin can create a PR via ``gh`` CLI. N)datetimetimezone)Pathzplaypalace.documentsshared independentmanual auto_commitauto_prc<\rSrSrSr\4S\S\4SjjrS\ 4Sjr SXS jr S \S \SS4S jr S \S\ 4SjrS\S\\ 4SjrS\ \S-\ 44SjrS\S-S\S\\ 4SjrS\S\ S-4SjrS\S\ 4SjrS\S\S-4SjrS\S\S\S-4SjrS\S\S\S\S\4 Sjr\4S\S\\S\S\S\S \S\4SjjrS\S\S\S\4SjrS\S\S \S\4S!jrS\S\\S\4S"jrS\S\S\S\S\4 S#jrS$S%.S\S\S&\S\4S'jjrS\S\4S(jr S)\S*\S\S\4S+jr!S)\S\4S,jr"S)\S*\S\S\4S-jr#S)\S.\S\4S/jr$S)\S\4S0jr%\&S\S\4S1j5r'S\S\S2\S\S-4S3jr(S\S\S2\SS4S4jr)S\S\S\S-4S5jr*S\S\ \\44S6jr+SYS7\ SS4S8jjr,SZS\S\S\S9\S:\SS4 S;jjr-S\\ 4S<jr.S=\\ SS4S>jr/S\\ 4S?jr0S\S\S\S:\S\1\\44 S@jr2S\\4SAjr3SB\S\\4SCjr4SB\S\\4SDjr5S\ 4SEjr6S\\ 4SFjr7S\S\4SGjr8SH\S\ 4SIjr9S\1\\44SJjr:SXSKjr;S\1\\44SLjr\&S\S\4SOj5r?S\SP\S\S\4SQjr@S\S\S-4SRjrAS\S\S-4SSjrBSXSTjrCS\SS4SUjrDS\S\SS4SVjrESWrFg)[DocumentManager%aManages document metadata, content, edit locks, and version history. Documents live in a directory tree split into ``shared/`` (git-tracked) and ``independent/`` (server-local) subdirectories. Each subfolder is a document containing locale-specific ``.md`` files and a ``_metadata.json``. The ``contribution_mode`` controls how edits to shared documents are tracked and exported. See module docstring for the three modes. documents_dircontribution_modecXlUS- UlUS- UlUS- UlX l0Ul0Ul0Ul0Ulg)Nrrz_attribution.json) _dir _shared_dir_independent_dir_attribution_pathr _categories _documents_scopes _edit_locks)selfrrs D !D   $ $ &   T--|< T224EF4??##=>zz$$S))zz66##ejj0D;;== CJD 2r?r@rArBrr.r/r0r_generate_default_metadata_save_document_metadata)rrLrMrI doc_meta_pathr9s rr4DocumentManager._load_scope_dirys!! I--/0E<<>>zz$$S))!$44M',LL $##%%-w?126))A,DOOEJJ/@?/3.M.Me.T +,,UZZ81@?s ).D)) D9 folderc[R"[R5R 5nUR R SS5R5n0n/n[URS55H(nURnURU5 UUSS.XG'M* U(dURS5 UUSS.US'UVs0sHoU_M n n/SU US.$s snf)zglobstemappend) rrSr_rcr^ locale_codesmd_file locale_codecoder]s rrO*DocumentManager._generate_default_metadatasll8<<(224 ##C-335 fkk&12G!,,K    ,%($G 3    %%(GDM +77,$+,7!   8s C!localec/nURR5H\up4URS05nURU5=(d URS5=(d UnURX6S.5 M^ UR SS9 U$)zgReturn categories sorted by sort order with display names. Each entry has keys ``slug`` and ``name``. rArZ)slugrAc(USR5$)NrAlower)cs r0DocumentManager.get_categories..s!F)//"3rkey)ritemsr1rfsort)rrlresultrnrGnamesdisplays rget_categoriesDocumentManager.get_categoriessy **002JDHHVR(Eii'B599T?BdG MM49 :3  3 4 rc[UR5SS.nURR5HInURS/5nU(d US==S- ss'UHnURUS5S-X'M MK U$)zReturn document counts per category in a single pass. Keys are category slugs, plus ``None`` for all documents and ``""`` for uncategorized. r)Nr*r)r7rvaluesr1)rcountsmetacatsrns rget_category_document_counts,DocumentManager.get_category_document_countssv 034??/C(KOO**,D88L"-Dr a %zz$2Q6  -  r category_slugc /nURR5HupEURS/5nUcOUS:Xa U(aM*OX;aM2URS05nURU5=(d URS5=(d UnURSS5n URS05RU 05n URUUU RSS5U RSS5S .5 M U(aUR U5OS n U S :XaUR S S S9 U$U S:XaUR SS S9 U$UR SS9 U$)aReturn documents in a category. Args: category_slug: Category slug to filter by. ``None`` returns all documents, ``""`` returns uncategorized documents. locale: Locale for display title resolution. Returns a list of dicts with ``folder_name`` and ``title``. r*rr]rZr\r^rWrX) folder_namercrWmodified alphabetical date_createdc US$)NrWds rrs;DocumentManager.get_documents_in_category..sq|rT)rvreverse date_modifiedc US$)Nrrrs rrsrsq}rc(USR5$)Nrcrprs rrsrsqz'7'7'9rru)rrwr1rfget_category_sortrx) rrrlresultsrrrr]rcsourceloc_info sort_methods rget_documents_in_category)DocumentManager.get_documents_in_categorys]!%!6!6!8 K88L"-D$"$!,XXh+FJJv&I&**T*:IkEXXot4Fxx 2.2262>H NN#."'||Ir: ( -@" E  !"92@Md,,];R` . ( LL3TL B  O + LL4dL C LL9L :rrc8URRU5$)z6Return the full metadata dict for a document, or None.)rr1rrs rget_document_metadata%DocumentManager.get_document_metadatas"";//rcvURRU5nUcg[URS055$)z,Return the number of locales for a document.rr^)rr1r7)rrrs rget_document_locale_count)DocumentManager.get_document_locale_counts4"";/ <488Ir*++rc8URRU5$)z@Return the scope of a document (shared or independent), or None.)rr1rs rget_document_scope"DocumentManager.get_document_scopes|| ,,rcXR;agURU5nUcgX2S3- nUR5(dgURSS9$)z4Read a document's ``.md`` file for the given locale.N.mdr'r()r _document_dirr- read_text)rrrldoc_dirmd_paths rget_document_content$DocumentManager.get_document_content sY oo -$$[1 ?hcN*~~  ' 22rcontenteditor_usernamecXR;agURU5nUcgXRS3- nUR5(aURX5 UR USS9 URUnUR S05n[ R"[R5R5n X(;aXUS'OU U SS.X'URU5 URXU5 g) a Write document content, back up the previous version, and release lock. For shared documents, the change is also recorded in the pending changeset so it can be exported and submitted upstream. Returns ``True`` on success, ``False`` if the document doesn't exist. Frr'r(r^rXTrV) rrr-_backup_version write_text setdefaultrr_rr`rarPrelease_edit_lock) rrrlrrrrrr^r_s rsave_document_content%DocumentManager.save_document_contents oo -$$[1 ?hcN* >>     57W5{+//)R0ll8<<(224  36FO/ 0%(GO $$[1 {ODrr*rccXR;agU[:Xa URO URnXq- nUR SSS9 [ R "[R5R5n UUX40UU U SS.0S.n XRU'X`RU'URU5 XS3- n U RUSS9 g) aCreate a new document folder with initial content. Args: folder_name: The slug/folder name for the document. categories: List of category slugs. locale: The initial locale code. title: The display title for the initial locale. content: The markdown content for the initial locale. scope: Either ``SCOPE_SHARED`` or ``SCOPE_INDEPENDENT``. Returns ``False`` if a document with that folder name already exists. FTr!rVr[rr'r() rr5rrr+rr_rr`rarrPr) rrr*rlrcrrMrLrr_rrs rcreate_documentDocumentManager.create_documentKs* // )(-(=D$$4CXCX ) dT 2ll8<<(224$#o"),"  (, $$) [! $$[1hcN*7W5rcURRU5nUcgURS05nX5U'URU5 g)a Update the title for a locale in document metadata. Titles are stored separately from locale entries, so setting a title for a locale that has no translation yet does not create a locale entry. Returns ``True`` on success, ``False`` if the document is not found. Fr]T)rr1rrP)rrrlrcrr]s rset_document_title"DocumentManager.set_document_title}sH"";/ <2.v $$[1rrYcURRU5nUcgURS05nX%;agX5US'URU5 g)zUpdate the public flag for a locale in document metadata. Returns ``True`` on success, ``False`` if document or locale not found. Fr^rYTrr1rP)rrrlrYrr^s rset_document_visibility'DocumentManager.set_document_visibilitysV "";/ <((9b)  $*! $$[1rclURRU5nUcgX#S'URU5 g)ziReplace the category list for a document. Returns ``True`` on success, ``False`` if document not found. Fr*Tr)rrr*rs rset_document_categories'DocumentManager.set_document_categoriess9 "";/ <'\ $$[1rcURRU5nUcgURS05nX&;agURU5nUcg[R "[ R5R5nUUSS.Xb'URS05n X9U'XrS3- n U RUSS9 URU5 g) zCreate a new locale entry (private by default) and write the .md file. Returns ``False`` if the document doesn't exist or the locale already exists. Fr^rVr]rr'r(T) rr1rrrr_rr`rarrP) rrrlrcrrr^rr_r]rs radd_document_translation(DocumentManager.add_document_translations"";/ <//)R0  $$[1 ?ll8<<(224!$  2.vhcN*7W5 $$[1rT) remove_titlerc\URRU5nUcgURS5U:XagURS05nX%;agURU5nUcgXR U(a"URS05RUS5 XbS3- nUR 5(aUR 5 US- nUR 5(a+UR US35Hn U R 5 M URU5 URRX4S5 g ) a Delete a locale entry, its .md file, and history backups. When *remove_title* is ``False`` the title for the locale is kept in metadata so it can be reused if the translation is re-added later. Returns ``False`` if the locale is the source locale or doesn't exist. NFr\r^r]r_history_*.mdT) rr1rpopr-unlinkrdrPr) rrrlrrr^rr history_dirbackups rremove_document_translation+DocumentManager.remove_document_translations"";/ < 88O $ .((9b)  $$[1 ? O  HHXr " & &vt 4hcN* >>   NN  *     %**fXU+;< = $$[1 k2D9rcXXR;agURU5nUb+UR5(a[R"U5 URU UR U UR Vs/sHo3SU:XdM UPM nnUHnUR U M gs snf)zfRemove a document folder from disk and from memory. Returns ``False`` if the document doesn't exist. FrT)rrr-rCrmtreerr)rrrrvstales rdelete_documentDocumentManager.delete_documents oo -$$[1  7>>#3#3 MM' " OOK ( LL % $ 0 0J 0Fk4I 0JC  %Ks 8 B'B'rnrAcjXR;agSX20S.URU'UR5 g)zFCreate a new category. Returns ``False`` if the slug already exists. Fr)rxrAT)rr2)rrnrArls rcreate_categoryDocumentManager.create_categorys> ## #"N"    "rcXR;agURU UR5 URR5H@up#UR S/5nX;dMUR U5 UR U5 MB g)zfDelete a category and remove it from all documents. Returns ``False`` if the category doesn't exist. Fr*T)rr2rrwr1removerP)rrnrrrs rdelete_categoryDocumentManager.delete_categorys{ '' '   T "   "!%!6!6!8 K88L"-D| D!,,[9 "9 rcURRU5nUcgX$RS05U'UR5 g)zoUpdate the display name for a category in a specific locale. Returns ``False`` if the category doesn't exist. FrAT)rr1rr2)rrnrArlcats rrename_categoryDocumentManager.rename_category sD ""4( ;-1vr"6*   "rrcjURRU5nUcgX#S'UR5 g)zYUpdate the sort method for a category. Returns ``False`` if the category doesn't exist. FrxT)rr1r2)rrnrrs rset_category_sort!DocumentManager.set_category_sort,s8 ""4( ;!F    "rcdURRU5nUcgURSS5$)zCReturn the sort method for a category (default ``"alphabetical"``).rrx)rr1)rrnrs rr!DocumentManager.get_category_sort8s1""4( ;!wwv~..rcH[R"SU5nURSS5RS5nUR 5n[ R "SSU5n[ R "SSU5n[ R "SSU5nURS5nU$) zConvert a document title to a folder-name slug. Lowercases, replaces whitespace/hyphens with underscores, strips non-ASCII and special characters, and collapses runs of underscores. NFKDasciiignorez[\s\-]+r=z[^\w]rz_+) unicodedata normalizeencodedecoderqresubstrip)rcrns rslugifyDocumentManager.slugify?s$$VU3{{7H-44W=zz|vvj#t,vvhD)vveS$'zz# rusernamecUR5 X4nURRU5nU(aUSU:waUS$U[R"5S.URU'g)zcAttempt to acquire an edit lock. Returns ``None`` on success, or the locking username on failure. user)r timestampN)cleanup_stale_locksrr1timerrrlrrvexistings racquire_edit_lock!DocumentManager.acquire_edit_lockSsf   "###'', (H4F# #)1 Lrc~X4nURRU5nU(aUSU:XaURU ggg)z+Release an edit lock if held by *username*.rN)rr1rs rr!DocumentManager.release_edit_lock`sD###'', (H4  %58rcvUR5 URRX45nU(aUS$S$)z2Return the username holding the lock, or ``None``.rN)rrr1)rrrllocks rget_edit_lock_holder$DocumentManager.get_edit_lock_holdergs8   "##[$9:#tF|--rcUR5 URR5VVVs0sHuup#nX!:XdMX4S_M snnn$s snnnf)zEReturn ``{locale: username}`` for every active lock on *folder_name*.r)rrrw)rrdocrlrs rget_document_lock_holders)DocumentManager.get_document_lock_holdersmsZ   "(,'7'7'='='? '?# t! !FL '?   s A Atimeout_secondsc[R"5nURR5VVs/sHup4X$S- U:dMUPM nnnUHnURU M gs snnf)z*Remove locks older than *timeout_seconds*.rN)rrrw)rrr_rvrrs rr#DocumentManager.cleanup_stale_locksvsoiik"--335 5 +&&8 5  C  %  s A(A( change_typemessagec UR5nURUUUUU[R"[R 5R 5S.5 URU5 g)zAppend an entry to the attribution log. Only used in manual mode. The log records which in-app user made each edit so the export ZIP can include proper credit. )rrleditorr r rN)_load_attribution_logrfrr_rr`ra_save_attribution_log)rrrlrr r entriess r_log_attribution DocumentManager._log_attributions[,,.* )*"%\\(,,7AAC    ""7+rcURR5(aK[URSSS9n[R"U5nSSS5 [ W[ 5(aU$/$!,(df  N'=f)z2Load the attribution log, or return an empty list.r&r'r(N)rr-r.r/r0 isinstancelist)rr9datas rr%DocumentManager._load_attribution_logs_  ! ! ( ( * *d,,cGDyy|E$%%  EDs A-- A;rc[URSSS9n[R"XSSS9 SSS5 g!,(df  g=f)z"Write the attribution log to disk.wr'r(Findent ensure_asciiN)r.rr/dump)rrr9s rr%DocumentManager._save_attribution_logs3 $((# @A IIg ?A @ @s 6 Ac"UR5$)z+Return the current attribution log entries.)rrs rget_attribution_log#DocumentManager.get_attribution_logs))++rcUR[:XagUR5nUcgURU5nUcSSUS34$[ UR 5R UR 555n[R"SSS U/[ U5S S S S 9nURS :wa=URR5=(d Sn [RSU 5 SU 4$UR5(dSUSU3nUS3n [R"SSSUSU /[ U5S S S S 9n U RS :wayU RR5=(d Sn SU R5;d'SU R =(d SR5;ag[RSU 5 SU 4$g![a gf=f)zStage and commit changes for a shared document. Runs ``git add`` on the document's files, then ``git commit`` with the given message and ``--author`` set to the in-app user. Returns ``(success, error_message)``. )Fz'Auto-commit is disabled in manual mode.FzNot inside a git repository.Fz Document 'z ' not found.)Fz1Document directory is outside the git repository.gitadd--T cwdcapture_outputtexttimeoutrUnknown git error.zgit add failed: %szUpdate /z commitz-mz--authorznothing to commitr)Trzgit commit failed: %s)r MODE_MANUAL_find_git_rootrrEresolve relative_to ValueError subprocessrun returncodestderrrrFerrorrqstdout) rrrlrr  repo_rootrrel_dir add_resultr<author commit_results rcommit_changesDocumentManager.commit_changess  ! ![ 0C'')  8$$[1 ?J{m<@@ @ N'//+77 8I8I8KLMG  ^^ E4 )I    A %%%++-E1EE II*E 2%< }} }AfX6G#$$9:"xgF  I    # #q (!((..0H4HE"ekkm37J$$*eg8 II-u 5%< W NM Ns6G GGcUR5nUc/$UR[:XaURU5$UR U5$)zReturn pending changes for shared documents. In manual mode, returns file paths that differ from HEAD (uncommitted working-tree changes). In auto modes, returns commit subject lines ahead of ``origin/main``. )r4rr3_get_uncommitted_changes_get_commits_ahead)rr>s rget_pending_changes#DocumentManager.get_pending_changessM'')  I  ! ![ 000; ;&&y11rr>c2[URR5RUR555n/n[ R "SSSSSU/[U5SSSS9nURS :Xa>URS URR5R555 [ R "SS S S SU/[U5SSSS9nURS :XaPURR5R5H$nU(dM XS;dMURU5 M& U$![a /s$f=f![[ R4a /s$f=f![[ R4a U$f=f)z9Return file paths with uncommitted changes under shared/.r'diff --name-onlyHEADr)Tr*r+rc36# UHo(dM Uv M g7fNr).0lines r ;DocumentManager._get_uncommitted_changes..&s%GT4DD%Gs  ls-files--others--exclude-standard)rErr5r6r7r8r9r:extendr=r splitlinesFileNotFoundErrorTimeoutExpiredrf)rr> rel_sharedchangedryrQs rrF(DocumentManager._get_uncommitted_changess   ((*66y7H7H7JKJ   ^^ vtZH N# F  A%%+]]%8%8%:%E%E%G ^^: 4*  N# F  A%"MM//1<<>Dt 3t,? S I $":#<#<= I (":#<#<=   sDAEA5E;A'E8&E8-E8 EEE54E58FFc>[R"/SQ[U5SSSS9nURS:XaAURR 5R 5Vs/sH o3(dM UPM sn$/$s snf![[R4a /$f=f)z1Return commit subject lines ahead of origin/main.)r'logz --onelinezorigin/main..HEADTr*r+r) r8r9rEr:r=rrXrYrZ)rr>ryrQs rrG"DocumentManager._get_commits_aheadBs ^^ N# F  A%%+]]%8%8%:%E%E%G%GT4D%G&  ":#<#<=    s*AA> A9-A93A>9A>>BBc4[UR55$)z6Return the number of pending changes or commits ahead.)r7rHr"s rget_pending_change_count(DocumentManager.get_pending_change_countWs4++-..rcUR5nUc/$[URR5R UR555R SS5n/n[R"SSSSSU/[U5S S S S 9nURS :Xa@URR5R5Vs/sH oU(dM UPM nn/n[R"SS SSSU/[U5S S S S 9nURS :Xa@URR5R5Vs/sH oU(dM UPM nnUVs1sHowR SS5iM nn0n X6-Hn U R SS5n U RUS-5(dM0U [!U5S-Sn U R#S5n U (dM[U S n[!U 5S:aU SOSnU R%USSSS.5nX;aS US'UR'S5(aS US'MUS:XdMS US'M /nU R)5HunnURU- nUR+5(dSnOGUS(aUS(d US(dSnO&US(a US(aSnOUS(aSnOSnUR-UUS.5 M U$![ a /s$f=fs snf![[R4a /s$f=fs snf![[R4a GNf=fs snf)zReturn shared documents with uncommitted changes and descriptions. Each entry is a dict with ``folder_name`` and ``change_tag`` keys. ``change_tag`` is one of: ``"absent"``, ``"present"``, ``"content"``, ``"metadata"``, or ``"content_and_metadata"``. N\r1r'rKrLrMr)Tr*r+rrTrUrVrrF)rmetadatanewrgrrr%rfabsentpresentcontent_and_metadata)r change_tag)r4rErr5r6rbr7r8r9r:r=rrXrYrZrBr7splitrendswithrwr-rf)rr>r[modified_pathsryluntracked_pathsp untracked_set folder_infopath normalizedrestpartsrfilenamerGrrtags r get_uncommitted_shared_documents0DocumentManager.get_uncommitted_shared_documents[s_'')  I   ((*66y7H7H7JKgdC  %' ^^ vtZH N# F  A%%}}224??A"A!QAA"&( ^^: 4*  N# F  A%%}}224??A#A!QAA # 8GG!4- G35 "4DdC0J((c)9::c*o123DJJsOE(K#&u:>uQxrH))E%PD*"U   ''"&Y--#'Z '5*!!,!2!2!4 K&&4G>>##eT)_T*=MiT*%5,j!  NN;cJ K"5e I "":#<#<= I $#":#<#<=   HsnAK&*A!K= K8K8K=$A!L$ LLL$M& K54K58K==LLL$$MMcUR5nUcgURU- nUR5(d[UR 5R UR 555n[R"SSSSU/[U5SSSS9nURS :wa/[RS XRR55 gg![ a gf=f) zDiscard uncommitted changes for a specific shared document. Restores the document's directory to match HEAD. Returns ``True`` on success. Fr'checkoutrMr)Tr*r+rz$Failed to discard changes for %s: %s)r4rr-rEr5r6r7r8r9r:rFr<r;r)rrr>rrel_pathrys rdiscard_document_changes(DocumentManager.discard_document_changess '')  ""[0~~  !--i.?.?.ABH  Jh 7I      ! II<!==#6#6#8 :  s6C C$#C$ output_pathc 8URUR5=(d [55nU(dgUR5nUcgURR SSS9 Sn[ R "US[ R5nUHnX6- nUR5(dMUR5(dM5[UR5RURR555nURXx5 US- nM UR!5n UR#S[$R&"SU 0S S S 95 SSS5 US:XaUR)SS 9 U$![a UnNf=f!,(df  N7=f) a"Package uncommitted shared document changes into a ZIP. Only used in manual mode. The ZIP mirrors the ``shared/`` directory structure with only the changed files, plus an ``attribution.json`` built from the attribution log. Returns the number of files included, or 0 if nothing changed. rNTr!rrzattribution.jsonchangesrFr) missing_ok)rFr4rparentr+zipfileZipFile ZIP_DEFLATEDr-is_filerEr5r6rr7writerwritestrr/dumpsr) rr changed_pathsr>includedzfr~abs_path archive_path attributions rexport_pending_changes&DocumentManager.export_pending_changesst55    ! +TV '')     = __[#w/C/C D)$/??$$)9)9););0'*$,,.:: $ 1 1 3( HHX4MH*446K KK"  ,!& !E2 q=   $  /%&0'/ 0E Ds8F 0F AE9AF 9 FF FF  Fc XUR5nUcgURU5nU(dg[R"[R 5R S5nSU3n[R"SSSU/[U5SSS S 9nURS :wa%S URR5=(d S 4$[R"SSSSU/[U5SSSS 9nURS :waG[R"/SQ[U5SS S9 S URR5=(d S4$S[U5S3nSnUS- nUH nUSUS3- nM [R"SSSSUSUS S!/ [U5SSS"S 9n[R"/SQ[U5SS S9 URS :wa'URR5=(d S#n S U 4$URR5n SU 4$![a g$[R a g%f=f)&zCreate a pull request from local commits via ``gh`` CLI. Only used in auto_pr mode. Creates a branch from the current commits ahead of ``origin/main``, pushes it, and opens a PR. Returns ``(success, pr_url_or_error)``. r&)Fz(No commits to include in a pull request.z %Y%m%d-%H%M%Sz documents/r'r}z-bTr*r+rFzFailed to create branch.pushz-uorigin<)r'r}main)r,r-r/zFailed to push branch.zDocument updates (z commits)z9Automated document contribution from PlayPalace server. z ## Commits z-  ghprcreatez--titlez--bodyz--baserzFailed to create pull request.)Fz.Git or gh CLI is not installed or not in PATH.)FzOperation timed out.)r4rGrr_rr`strftimer8r9rEr:r;rr7r=rYrZ) rr>commitsrbranchryrcbodyrQr<pr_urls rcreate_pull_request#DocumentManager.create_pull_requests>'')  8)))4DLL.77H i[)D 1^^ D&1 N# F  A%fmm113Q7QQQ ^^h7 N# F  A%/I#'  fmm113O7OOO)Wi@EPD N "D"TF" %  ^^$udf   N# F NN+ N#    A% ++-Q1Qe|#]]((*F<   KJ(( 10 1s-'AHAB*H)H H)H)(H)cUR[:Xa;URR5(aURR 5 ggg)zjClear the attribution log (manual mode only). In auto modes this is a no-op since git log is the record. N)rr3rr-rr"s rclear_pending_changes%DocumentManager.clear_pending_changesrsA  ! ![ 0T5K5K5R5R5T5T  " " ) ) +6U 0rc UR5nUcgUR[:wau[R"/SQ[ U5SSSS9nUR S:wa@URR5=(d Sn[RSU5 S S U34$GO)URR5RUR55n[R"/S Q[ U5SSSS9nUR S:wa@URR5=(d Sn[RS U5 S S U34$[R"SSSS[ U5/[ U5SSSS9nUR S:wa@URR5=(d Sn[RSU5 S S U34$[UR5nUR!5 [UR5nSUS3n X:wa U SUS3- n [R#U 5 SU 4$![$a g[R&a gf=f)aSync shared documents from the remote repository. In auto modes, uses ``git pull --rebase`` to preserve local commits on top of upstream changes. In manual mode, fetches and checks out ``origin/main`` (overwriting local edits). Returns a ``(success, message)`` tuple. r&)r'pullz--rebasez --autostashrrTrr+rr0zDocument sync pull failed: %sFz Sync failed: )r'fetchrzDocument sync fetch failed: %szFetch failed: r'r}z origin/mainr)rz!Document sync checkout failed: %szSynced shared documents. z documents loaded.z (was ))Fz$Git is not installed or not in PATH.)FzSync timed out.)r4rr3r8r9rEr:r;rrFr<rr5r6r7rr0rGrYrZ) rr>ryr<r~rr} old_count new_countmsgs rsync_shared_documents%DocumentManager.sync_shared_documents~s9'')  8; ,%%4 $PI#' $$)"MM//1I5IEII=uE M%"999*  ++335AA%%'#.I#' ##q(!LL..0H4HEII>F N5'":::%>>J tS]KI#' &&!+$OO113K7KEIIA5I M%"999DOO,I IIKDOO,I-i[8JKC% {!,, HHSM9   A@(( ,+ ,s-BH/B+H/ A>H/A&H// I;IIc[R"/SQ[UR5SSSS9nURS:Xa#[ UR R55$g![[R4a gf=f)z7Find the git repository root, or None if not in a repo.)r'z rev-parsez--show-toplevelTrr+rN) r8r9rErr:rr=rrYrZ)rrys rr4DocumentManager._find_git_roots ^^7 N# F  A%FMM//122&":#<#<=   sAA$$BBcXR;agURRU5[:wagURU- nUR U- nUR 5(a[RSU5 g[R"[U5[U55 [URU'[RSU5 g)zyMove a document from independent to shared scope. Returns ``False`` if the document doesn't exist or is already shared. Fz.Cannot promote '%s': already exists in shared/z!Promoted document '%s' to shared.T)rrr1r6rrr-rFrHrCrDrEr5rG)rrsrcrJs rpromote_to_shared!DocumentManager.promote_to_shareds oo - <<  K (,= =##k1+- ;;== KK@  CHc$i($0 [! 4kBrch[R"URS55R5$)z+Compute a SHA-256 hash of document content.r')hashlibsha256r hexdigest)rs r content_hashDocumentManager.content_hashs%~~gnnW56@@BBr shared_slugcURRU5nUcgURRU5[:wagUR X#5nUcgUUUR U5S.US'UR U5 g)a7Set the ``based_on`` field for an independent document. Records which shared document and content hash this independent document was derived from, so the system can detect when the upstream version changes. Returns ``False`` if the document or shared source doesn't exist, or the document is not independent. F)rnrlrbased_onT)rr1rr6rrrP)rrrrlrshared_contents r set_based_onDocumentManager.set_based_ons"";/ < <<  K (,= =22;G  ! --n= Z $$[1rcDURRU5nUcgURS5nUcgURS5nURSS5nURS5nU(aU(dgURXE5nUcgURU5nX:g$)aCheck if an independent document's upstream source has changed. Returns ``True`` if the shared source content has changed since the ``based_on`` hash was recorded, ``False`` if unchanged, or ``None`` if the document has no ``based_on`` field or the shared source no longer exists. NrrnrlrZr)rr1rr) rrrrrrl stored_hashr current_hashs rcheck_based_on_stale$DocumentManager.check_based_on_stales"";/ <88J'  ll6* h-ll>2 +22;G  !((8 **rcURRU5nU[:XaURU- $U[:XaUR U- $g)z.ls!&&rrur)rr-r+rr_rr`rrCcopy2r>rdr7_MAX_HISTORY_PER_LOCALErr) rrrlrrrr backup_namebackupsoldests rrDocumentManager._backup_versionYs$$[1 ? hcN*~~  * 4(LL.778HI )C0  WK78   xu- .  'l44[[^F MMO'l44r) rrrrrrrrr)rN)i)r)G__name__ __module__ __qualname____firstlineno____doc__MODE_AUTO_COMMITrrErintr0r,r4dictrOrr|rrrrrrboolrr6rrrrrrrrrrrr staticmethodrrrrrrrrrr#tuplerCrHrFrGrbrzrrrrrr4rrrrrr2rPr__static_attributes__rrrr r %sFV $d $s $$c$B299c9d9(! ! $! N S T$Z  d3:s?.C +sTz+3+SWX\S]+Z000,S,S,-c-cDj- 3 3S 3S4Z 3 --- -  -  -l'00I0 0  0  00 0dc3st 3  T VZ  3 DI RV (+47BE F" '''  '  'R34$ C s C D CD" C s C D  c   /c/c/ s s  & S #  QTW[Q[ &S&#&&QU&..S.S4Z.  S T#s(^  &3 &$ &* ,,, ,  ,  , ,4tDz@T$Z@D@ ,T$Z,GGG G  G tSy  GZ 2T#Y 2/$/49/bDT#Y*/#/a$t*aF!C!D!N2$232hW1U49%5W1r,H,uT3Y'7H,Tt (ST8CcCcCC   @++t +:Y =3 =4 =3rr )rrr/loggingrrCr8rrrrrpathlibr getLoggerrFrr5r6r3r MODE_AUTO_PRr rrrrsk    ' ./ !   KKr