QjZT%SrSSKJr SSKrSSKrSSKrSSKrSSKrSSKJ r J r SSK J r SSK Jr \ "\5R!5R"Sr\S- r\S - r\S - r\S - r\S - r\S - r\S- r\S- r\S- r\S- r0rS\S'S6Sjr\"SSS5 \"SSS5 \"SSS5 \"SSS 5 \"S!S"S#5 \"S$S%S&5 \"S'S(S)5 \"S*S+S,5 S7S-jr S8S.jr!S9S/jr"S:S0jr#S;S1jr$SS4jr'\(S5:Xa\RR"\'"55 gg)?aAudit public API -> user documentation coverage for Nexamas UI. The compiled assembly inventory is the type/member authority. This audit verifies that all consumer-visible CLR types have: 1. an assembly-derived API reference entry; and 2. contextual user-facing documentation outside the generated batch tables. It also reconciles source classification and V1 approval manifests and writes the Phase 4 coverage matrix/summary used by the documentation gate. ) annotationsN)Counter defaultdict)Path)unquotez5docs/_inventory/assembly-api/public-api-assembly.jsonz2docs/_inventory/user-documentation-audit-scope.csvz9eng/tests/Nexamas.UI.PublicApiClassificationBaseline.jsonz1eng/tests/Nexamas.UI.ApprovedV1PublicSurface.jsonz3eng/tests/Nexamas.UI.PublicSurfaceTypeBaseline.jsonz5docs/_inventory/public-api-documentation-coverage.csvz4docs/_inventory/public-api-documentation-coverage.mdz9docs/_inventory/phase4-code-to-documentation-summary.jsonz;docs/_inventory/phase4-code-to-documentation-gap-ledger.csvzcb[R"S[R"U5-S-5$)Nz(?->)WDWW v~  {$ { }}[!!$ }}Y! }}X$-- "="= T" }}Y  }}X  }}W( }}]##}'<. }}Wv!6!6! rcXUS:XagUS:XagUS:XagUS:XagUS :Xag US :Xag g )NStablez+V1 API reference + contextual user guidanceAdvancedz.Advanced API reference + owner-scoped guidanceEvidencez7Evidence API reference + explicit non-beginner boundaryPreviewz1Preview API reference + parent/ownership boundaryCompatz9Compatibility API reference + preferred replacement routeGeneratedDelegatez/Owner event reference + exact handler signaturez)API reference + contextual classification)categoryroles rdocumentation_levelrCsH8<:?:H9B8J&&@ 6rc|URS5(agURS5(agURS5(agURS5(dURS5(ag URS 5(ag URS 5(dURS 5(dUS;agg)Nzdocs/reference/api/ apiReferencezdocs/reference/curatedReferencez docs/recipes/recipezdocs/examples/zsamples/examplez docs/product/productz docs/core/z docs/user/> README.md docs/index.mddocs/README.mddocs/customer-guide.mddocs/developer-guide.mddocs/reference-guide.mddocs/company-adoption-guide.mdguide otherUser) startswith)rels r path_grouprUs ~~+,, ~~'((! ~~o&& ~~&''3>>*+E+E ~~o&& ~~l##s~~l'C'CsOH rcz[5n[[5nURSSS9R 5Hn[ R "SU5nU(dM#URS5n[ R"SSU5n[ R"SS U5nURS S5R5R5n[ R"S SU[ RS 9n[ R"S SU5nX&nX&==S- ss'U(aUSU3nURU5 GM U$)Nutf-8ignorererrorsz^#{1,6}\s+(.+?)\s*#*\s*$z<[^>]+>z\[([^\]]+)\]\([^)]*\)z\1`z[^\w\- ])flagsz\s+-)setrint read_text splitlinesrmatchgroupsubreplacestriplowerUNICODEadd)ranchors duplicateslinemtextslugns rheading_anchorsrssG(3C(8JALLN HH0$ 7 wwqzvvj"d+vv.t<||C$**,224vvk2t2::>vvfc4(  A V1QC=D DO Nrc @Sn/n0n[R"S5nUGHnURSSS9nURU5GHnUR 5nU(aUR S5(aM3UR S5(aUR S5(aUS S nURS 5upn U(a[UR5S5OS nU(dUOURU- R5n US - nU R5(d4UR[UR[ 55US S.5 GMU (dGMU R#5(dGM3U R$R'5S:XdGMTUR)U [+U 55n [U 5R 5R'5n X;dGMUR[UR[ 55USS.5 GM GM X4$)Nrz(?r[#r\zmissing target)sourcetargetreasonz.mdzmissing anchor)rr rbfindallrhrSr6 partitionrr parentresolveexistsappendstr relative_toROOTis_filesuffixri setdefaultrs)pathscheckedrZ anchor_cachelink_resrcrpraw target_text_fragmentrzrlfrags rcheck_markdown_linksrsGF)+Ljj78G}}gh}???4(C))+C#..)KLL~~c""s||C'8'8!Bi'*}}S'9 $KH=H'+"3"3"5a"89bK +S#**{2J1S1S1UF qLG==?? S__T-B)Cs^nopxFNN,,1D1D1F%1O&11&/&:QRx(..0668&MMS1F-GSVbr"st#)( ?rc^7^:^;^<[[5n[[5n[[5n[[5n[ R SS9n[[R"U55nSSS5 WVs/sHofSS:XdM [US- PM nnUVs/sH7oR5(aM[UR[55PM9 n nUVs/sHoR5(dMUPM nn0n [[5n UHCn U R[5R5n U [!U 5R#U 5 ME U R%5HupSR'SU55X'M! USVs0sHnUS US US 4U_M nnUS Vs1sHnUS US US 4iM nnUS Vs0sHnUS US US 4U_M nn/mS<.5 M( SSS5 [SU5un-n.[TR5(a[[T5OS?SS@/SA.n/U/R)SB5S :waU/R)SC/5O/n0[WSDT<55n1[WSET<55n2[WSFT<55n3[1SGT<55n4[1SHT<55n5[XRZ"[DR]55R_5Ra5n6SISJU(d%U(dU(dU (dU.(d U0(dS OSKUSLU6[-U5[-U5U SM.[-US5USN[1SOT<55[1SPT<55[c[7U1R%555[c[7U2R%555SQ.[1SRT<55[1SST<55U5U4[c[7U3R%555[-U5ST.[-[N5[1U<4SUj[N55[NV7^7s/sH!m7[eU74SVjT<5S5S:XdMT7PM# sn7SW.UUSX.U-U.SY.U//SZQS[. n8[fRi[jRl"U8S\S]S^9S-SSS:9 S_S9S`S9SaUSLSb3Sc[-US5Sb3SdU8SeSfSb3SgU8SeShSb3Si[-U5Sb3SjU6Sb3S9SkS9SlSmSnSoS9SpS9SqSr/n9[7U15H4m:U9R#SsT:StU1T:Su[1U:4SvjT<55Sw35 M6 U9S9SxS9Sy[-[N5Sz[-U8S{S|5S}3S9S~S9SS9SU5Sb3SU4Sb3S9SS9SS9/- n9U(a;U9SS/- n9UH-nU9R#SsUSSUSStUS&SuUS'Sw3 5 M/ OU9R#S5 U9S9SS9S[-U5Sb3S[-U5Sb3S[-U5Sb3SU-Sb3S[-U.5Sb3SU/R)SS5Sb3S[-U/R)SC/55Sb3S9SS9SU8SBS3/- n9[nRiSR'U95S-SSS:9 [q[jRl"U8SB[-T<5U8SeSfU8SeSh[-U5[-U5[-U5U-[-U.5S. S\S95 U8SBS :XaS$S$!,(df  G N==fs snfs snfs snfs snfs snfs snfs snnfs sn f!,(df  GN=f!,(df  GNN=fs sn7f)NrrscopezPrimary user auditr c3@# UHoRSSS9v M g7f)rWrXrYN)rb).0ps r main..s _Y^TUgh!OY^sclassifications namespacerr$approvedPublicTypes publicTypestypesr%r& declaringTypez0Nexamas.UI.Application.MASApplicationWindowInputr?rA UnclassifiedfullNamer:z!Stable type missing V1 approval: zNon-stable type V1-approved: rErc3.># UH nTUv M g7fr r@)rgcountss rrrs>~!F1I~srWrXrYPASSGAP v1ApprovedrBrequiredDocumentation memberCountapiReferenceMentionscontextualMentionscuratedReferenceMentionsrF guideMentionsrQproductMentionsrIrecipeMentionsrGexampleMentionsrHotherUserMentionsrRz; )apiReferencePaths contextPathsstatuscVUSR5USR5US4$)Nrrr$)ri)xs rmain..1s*a n&:&:&OQRSYQZ%[r)keywr\)rnewline) fieldnames)type phase3StatertargetDocumentation phase4Statez6Full API table only; no contextual user-facing mentionzContextual coverage PASSNOT_RUNz1Phase 4 supporting-contract verifier was not run.)r assertionsfailuresrrc3*# UH oSv M g7f)rANr@rrs rrrKsC] m]c3*# UH oSv M g7f)rBNr@rs rrrLs;]F)]rc3*# UH oSv M g7f)rNr@rs rrrMs?AhKrc3b# UH%n[US5[US5-S:v M' g7f)rrrNrars rrrNs4&wivdes1-=+>'?#aHYFZB['[^_'_ivs-/c3D# UHn[US5S:v M g7f)rrNrrs rrrOs#&eWdRSs1-G+H'IA'MWd z(Nexamas.UI.DocumentationAudit.Phase4/1.0z,Code-to-documentation reverse coverage auditFAIL publicApiHash)classifiedMarkdownFilesprimaryUserDocumentationFilesmissingPrimaryScopeFilestotalPublicTypeCountc30# UH oSS:Hv M g7f)rAr?Nr@rs rrr`s2oan\]Z=DW3Wanc30# UH oSS:Hv M g7f)rtrueNr@rs rrras(ZMq<F)BMr)consumerVisibleClrTypesexplicitSourceDeclaredTypescompilerGeneratedEventDelegatesv1ApprovedStableTypescategoryCounts roleCountsc3D# UHn[US5S:v M g7f)rrNrrs rrrfs$7rdq_`A>TR# UHoTVs1sHo"SiM sn;v M gs snf7f)rNr@)rrr coverage_rowss rrros+"qZpRV}+M}!fI}+M#MZp+Ms ,',c3T># UHoST:XdM [US5v M g7f)rrNr)rrrs rrrrs.b}!RXPY]aPa5Q3455}s (()typesPreviouslyApiTableOnlytypesReconciledremainingPreviouslyApiTableOnly)classificationErrorsv1ApprovalErrors)localMarkdownLinksCheckedrZ)zxPhase 4 proves reverse type-level documentation coverage and classification, not runtime behavior for every prose claim.aRecipe/example mentions are reported as an adoption metric; supporting enums, event args, DTOs, generated delegates, preview snapshots, evidence types, and compatibility types are intentionally documented with their owning surface rather than requiring standalone recipes.zoPhase 5 must compile and run documentation examples in a clean Windows/.NET Framework 4.8 consumer environment.) schemaphaserassemblyPublicApiHashcoverageMatrixSha256r publicSurfacecoveragephase4Reconciliation governancelinkssupportingContractVerificationremainingBoundariesrF)indent ensure_asciiz## Public API Documentation CoveragezThis matrix is the Phase 4 reverse audit: every consumer-visible type exported by the compiled `Nexamas.UI.dll` is checked against the assembly-derived API tables and against contextual user documentation outside those generated tables.z- Assembly public API hash: `r]z- Consumer-visible CLR types: `z&- Types with API reference coverage: `rrz-- Types with contextual user documentation: `rz- Remaining coverage gaps: `z- Coverage matrix SHA-256: `z## Coverage policyzJ- Every public CLR type must appear in the assembly-derived API reference.zS- Every type must also have contextual guidance outside the generated batch tables.z- Supporting enums, event records, options/results, snapshots, generated delegates, evidence types, and compatibility types may be documented with their owning surface instead of receiving a standalone recipe.zd- Stable types require V1 approval; non-stable categories must not be silently promoted to V1Stable.z## Category resultz$| Category | Types | Coverage gaps |z|---|---:|---:|z| `z` | z | c3P># UHoST:H=(a USS:gv M g7f)rArrNr@)rrcats rrrs=ADvCpq:PSASAkXYZbXcekXkAkvCs#&z |z## Phase 4 reconciliationzPhase 3 found `z` types that appeared only in the full API tables. Phase 4 assigned all of them to an owning user-facing reference and reduced that gap to `rrz`.zThe detailed action ledger is [`phase4-code-to-documentation-gap-ledger.csv`](phase4-code-to-documentation-gap-ledger.csv). The complete 302-row matrix is [`public-api-documentation-coverage.csv`](public-api-documentation-coverage.csv).z## Adoption-depth metricz0- Types mentioned in a curated reference page: `z6- Types mentioned in at least one recipe or example: `zRecipe/example coverage is not a type-by-type gate: many public types are supporting contracts consumed through a parent control. Phase 5 validates the executable examples themselves.z## Remaining gapsz5| Type | Category | API mentions | Context mentions |z|---|---|---:|---:|z` | `zlNone. All 302 consumer-visible CLR types have both API-reference and contextual user-documentation coverage.z## Governance and link checksz'- Unclassified explicit public types: `z - V1 approval/category errors: `z(- Primary user Markdown files checked: `z!- Local Markdown links checked: `z- Link/anchor errors: `z#- Supporting-contract assertions: `rz+- Supporting-contract assertion failures: `z ## Acceptancez**um** — reverse public-type documentation coverage is closed when all counts above remain at zero gaps/errors.) rrapiReferenceCoveredcontextCoveredgapsrr linksChecked linkErrors)rr[)9r ASSEMBLY_APICLASSIFICATION V1_APPROVALSOURCE_BASELINE SCOPE_CSVrlistcsv DictReaderrrrrras_posixrUritemsjoinr5r"lenr|sumsearchrbsortedr`r8rirCsortkeysOUT_CSV DictWriter writeheader writerows OUT_LEDGERr writerowrSUPPORT_VERIFYrhashlibsha256 read_bytes hexdigestupperdictnext OUT_SUMMARY write_textrdumpsOUT_MDprint)=apiclassificationapprovalsource_baseliner scope_rowsr primary_pathsrmissing_scope_filestexts grouped_pathsrrTrerr class_mapapproved source_maprclassification_errorsapproval_errorsr7r generatedcrAis_v1patrp api_countrcontext_groups context_count context_files api_filesrBrrowrrfieldsrzr link_count link_errorssupporting_verificationsupporting_errorscategory_counts role_counts status_countstypes_with_recipe_or_exampletypes_with_curated_reference matrix_sharsummarylinesrrrs= ` @@@rmainrMs( L !C~.N%H0O  -#..+,  ./9`z!wZK_=_%TAfI%zM`=J]]RZRZR\33q}}T23]] -< 1Q M<E2=d2CMt$--/jo&--d3&++- yy _Y^ __ .ESSdDefDeq!K.!F)QvY7:DeIf@HI^@_`@_1;6AfI6@_H`ETUbEcdEc1[>1V9ai8!;EcJd "MD')!#O \~qy!F)4fI+Sj0ASaeeOF\aSGS MM# *3&1!J-R`QY ! ( (: 7x x   " "%Fq}o#V W x E  " "%B1Z=/#R SAfI&CH;;=Q=KE4%S[[.//=QJJ~q1 %+CVqN/B!VC>~>>  #E")::akk78kLMM!((t)<)E)E)GH*$s=12  "">26Azz!++wx+HII  t!4!=!=!?@73y>* {$q=]Q->E *  ;  AfI  AfI    #e***,   D  $%84%H  1]+  #I  !-  ' 3Eq(I  VZZ3  vzz)Q7  fjj15 vzz)Q7! " K!;# $"&9!5 IIm4) , S! V  KK qt[\mA&++-.J cK < NN1 4 ]3 = {B ?1X NN1 0 12D3D9NFF JJW '-9  3 @3=AJ ;I;P;P;R;Ri71;n:oYH_GbGbckGlpvGv/33JC|~C]CCO;];;K???M#&&wiv&w#w #&&eWd&e#e  2 2 45??AGGIJ<?!%)>/Uhlw|M&TZ!$_!5 *'*:-0-?(; (+3w<'8+:;Q+R/22oan2o/o%((ZM(Z%Z"6/*?*?*A#BCvk&7&7&9:;  587rdq7r4r477pbo7p4p)E/K  (;(;(=!>?%(Y  ,//E+F""qZp"qq!70!7b}bdefjkk!70! %: / *4! +B Y1Gd4::gaeLtS^eost .  w 'O(<'=Q? )#c'l*;) 01DEk1l0mmno 7 8KLr8s7ttuv &s4yk3 &zl!4  T] \n  .- E0o& s3%tOC$8#9SADvCAD>D=EEGH I'  # #4567CDGHOPfHghIHJDKCLLN O  w " :;W:XXYZ @A]@^^_`  B  !E$  IK`aaA LL3q}oU1Z=/aH^F_E``cdefzd{c||~ A  D E  ' 1#6K2L1MQO *3+?*@B 23}3E2FaH +Jp  p * n9% o47 p__main__)r rrrrrreturnNone)rrrOr!)rrrOzre.Pattern[str])r7r!rOr)rArrBrrOr)rTrrOr)rrrOzset[str])rz list[Path]rOztuple[int, list[dict]])rOra)*__doc__ __future__rr rrrsys collectionsrrpathlibr urllib.parser__file__rparentsrrrrrrrr&r#rrr __annotations__rrr"r8rCrUrsrrM__name__exitr@rrr\s #  ,  H~''*MM G G SSHH NN H H F FPP Q Q VV57276 N2A   49V  P7d   .BZ  "Pn  5N  q/o  V-c T@ 7 &*8{3| zHHTVr