176 lines
24 KiB
Plaintext
176 lines
24 KiB
Plaintext
 
|
Ë
|
|||
|
|
›ñ‡j®H ã óx — d Z ddlmZ ddlZddlZddlZddlZddlmZ ddl Z dZ e › d�Z
|
|||
|
|
dZd Zd
|
|||
|
|
Zg d ¢Zd Zd
|
|||
|
|
ZeedfZdZej- dd« dz Zd d„Zd d„Zd!d„Zd"d„Zd"d„Z d#d„Z d$d„Z d"d„Z d%d„Z d&d „Z!d&d „Z"e#d k( r ej e"« « yy# e
|
|||
|
|
$ r ej d« Y Œ”w xY w)'uF pruefe_upstream_drift.py — Byte-Vergleich gegen die gepinnte Baseline.
|
|||
|
|
|
|||
|
|
Schützt die übernommenen Framework-Dateien vor stillem Umschreiben
|
|||
|
|
(Entscheidung 8 im Design 2026-08-11, Frage von sorb: „wird die
|
|||
|
|
AGENTS.md ggf. durch Agenten umgeschrieben?"). Die Baseline liegt unter
|
|||
|
|
docs/sources/upstream/neckbeard-v0.3.1/ (siehe HERKUNFT.md dort); ein
|
|||
|
|
Framework-Upgrade aktualisiert Baseline und Arbeitskopie im selben,
|
|||
|
|
bewussten Commit.
|
|||
|
|
|
|||
|
|
Prüfungen (Fehler, Exit 1):
|
|||
|
|
1. byte-identische Paare laut PAARE
|
|||
|
|
2. AGENTS.md beginnt byte-identisch mit der Baseline-AGENTS.md und
|
|||
|
|
trägt direkt danach die Marke des Projektabschnitts
|
|||
|
|
3. **Vollständigkeit:** jede Datei der Baseline ist genau einer Klasse
|
|||
|
|
zugeordnet — byte-identisch, AGENTS-Präfix, erklärt erweitert
|
|||
|
|
(ADR-0024) oder bewusst nicht übernommen. Eine vendorierte Datei,
|
|||
|
|
die in keiner Liste steht, wird von nichts verglichen und fällt
|
|||
|
|
sonst durchs Raster.
|
|||
|
|
4. **Abgleich beim Upgrade:** hat upstream zwischen der vorigen und der
|
|||
|
|
aktuellen Baseline eine erklärt-erweiterte Datei angefasst, muss die
|
|||
|
|
ABGLEICH.tsv der aktuellen Baseline sie quittieren — eine Zeile
|
|||
|
|
`<datei> <vorige-baseline> <was nachgezogen wurde>`.
|
|||
|
|
|
|||
|
|
Zu 4, weil es die ungewöhnlichste ist: Die erweiterten Dateien werden
|
|||
|
|
absichtlich nicht byte-verglichen (ADR-0024), also meldet auch nichts,
|
|||
|
|
wenn upstream sie ändert. Beim Upgrade v0.1.1 → v0.3.1 waren zwei von
|
|||
|
|
drei betroffen, und gemeldet hat es nichts — sichtbar wurde es nur, weil
|
|||
|
|
jemand daran dachte. Diese Prüfung kann nicht beurteilen, ob richtig
|
|||
|
|
nachgezogen wurde; sie kann sagen, **dass** etwas nachzuziehen war. Der
|
|||
|
|
Fehler ist Vergessen, nicht Falschmachen (FRAMEWORK-BEFUNDE, FB-12).
|
|||
|
|
|
|||
|
|
⚠� Die Quittung steht bewusst in einer eigenen Datei und nicht in der
|
|||
|
|
Prosa der HERKUNFT.md: Der erste Entwurf suchte den Dateinamen irgendwo im
|
|||
|
|
Text — und der steht dort *immer*, in der Inventartabelle. Die Prüfung war
|
|||
|
|
damit nicht streng, sondern wirkungslos, und ihr eigener Selbsttest hat es
|
|||
|
|
verdeckt, weil sein Fixture eine leere Notiz war. Eine Zusicherung deckt
|
|||
|
|
den Fall jetzt ab.
|
|||
|
|
|
|||
|
|
Fehlt eine Baseline-Datei, ist das ein Fehler, kein Skip
|
|||
|
|
(Stillstandsprüfungs-Regel: eine Prüfung ohne Gegenseite ist ungeprüft).
|
|||
|
|
|
|||
|
|
Usage: python scripts/pruefe_upstream_drift.py [repo-root]
|
|||
|
|
python scripts/pruefe_upstream_drift.py --selbsttest
|
|||
|
|
é )Ú annotationsN)ÚPathz;pruefe_upstream_drift.py braucht PyYAML: pip install pyyamlzdocs/sources/upstreamz/neckbeard-v0.3.1z<!-- projektabschnitt -->z HERKUNFT.mdz ABGLEICH.tsv)
|
|||
|
|
)ú CLAUDE.mdr )ú WORKFLOW.mdr )zdocs/adr/template.mdztemplates/adr-template.md)zdocs/design/template.mdz templates/design-template.md)zdocs/aar/template.mdztemplates/aar-template.md)zdocs/issues/template.mdztemplates/issue-template.md)zdocs/ledger/template.mdz templates/ledger-template.md)zdocs/verdict/template.mdz templates/verdict-template.md)úscripts/check_harvest.pyr )úscripts/judge.pyr )ú schema.yamlzscripts/validate.pyzscripts/gen_status.py)zscripts/check_locked.pyú AGENTS.mdz¦link_fields: [related, judged]
|
|||
|
|
types:
|
|||
|
|
wiki-page:
|
|||
|
|
required: [type, area]
|
|||
|
|
fields:
|
|||
|
|
status: { enum: [open, harvested] }
|
|||
|
|
harvested_in: { kind: str }
|
|||
|
|
z{ enum: [open, harvested] }z%{ enum: [open, harvested, declined] }z$ eigener_typ:
|
|||
|
|
required: [type]
|
|||
|
|
c óJ ‡ — t ˆ fd„‰ j d« D « « S )Nc 3 ót •K — | ]/ }|j « sŒt |j ‰« « –— Œ1 y w©N)Úis_fileÚstrÚ relative_to)Ú.0ÚpÚbases €úR/Users/thore/.claude/jobs/9aaf0185/tmp/management/scripts/pruefe_upstream_drift.pyÚ <genexpr>z#baseline_dateien.<locals>.<genexpr>s s( øè ø€ ÐS±O¨qÀqÇyÁyÅ{”#�a—m‘m DÓ)×*±Oùs ƒ8™ 8Ú*)ÚsortedÚrglob)r s `r Úbaseline_dateienr r s ø€ Ü ÓS°D·J±J¸s´OÓSÓ SÐSó c óV — t d„ t j d| « D « « xs dS )Nc 3 ó2 K — | ] }t |« –— Œ y wr
|
|||
|
|
)Úint)r Úts r r z%version_schluessel.<locals>.<genexpr>w s è ø€ Ð:Ñ!9˜A”�Q—Ñ!9ùs ‚z\d+)r )ÚtupleÚreÚfindall)Únames r Úversion_schluesselr# v s# € Ü Ñ:¤§¡¨F°DÔ!9Ó:Ó :Ò B¸dÐBr c ó~ — | t z }|j « sg S t d„ |j « D « d„ ¬« S )z Alle Baselines, aelteste zuerst.c 3 óB K — | ] }|j « sŒ|–— Œ y wr
|
|||
|
|
)Úis_dir)r r s r r z baselines.<locals>.<genexpr> s è ø€ ÐBÑ 3˜°q·x±xµz”1Ñ 3ùs ‚ ˜ c ó, — t | j « S r
|
|||
|
|
)r# r" )r s r Ú<lambda>zbaselines.<locals>.<lambda>€ s € Ô 2°1·6±6Ô :r )Úkey)ÚUPSTREAMr& r Úiterdir)ÚrootÚ verzeichniss r Ú baselinesr. z s= € àœ‘/€KØ × Ñ Ô Øˆ Ü ÑB˜k× 1Ñ 1Ô 3ÓBÙ:ô <ð <r c
|
|||
|
|
óX — t D ]¡ \ }}| |z ||z }}|j « s |j dt › d|› �« Œ<|j « s|j d|› �« Œa|j « |j « k7 sŒƒ|j d|› dt › d|› d�« Œ£ y )NúBaseline fehlt: Ú/zArbeitskopie fehlt: zDRIFT: z weicht von z ab)ÚPAAREr ÚappendÚBASELINEÚ
|
|||
|
|
read_bytes)r, r ÚfehlerÚarbeitÚoriginalÚaÚbs r Ú pruefe_paarer; ƒ s— € ß !ш�Ø�f‰}˜d X™oˆ1ˆØ�y‰yŒ{Ø �M‰MÐ ,¬X¨J°a¸°zÐBÕ CØ—‘”Ø �M‰MÐ 0°°Ð9Õ :Ø
|
|||
|
|
�\‰\‹^˜qŸ|™|›~Ó
|
|||
|
|
-Ø �M‰M˜G F 8¨<¼°zÀÀ8À*ÈCÐPÕ Qñ "r c óØ — | dz |dz }}|j « s|j dt › d�« y |j « s|j d« y |j « }|j « }|j |« s|j d« y |t |« d j
|
|||
|
|
dd« }t |j « dd vr|j d
|
|||
|
|
t › d �« y y ) Nr
|
|||
|
|
r0 z
|
|||
|
|
/AGENTS.mdz Arbeitskopie fehlt: AGENTS.mduQ DRIFT: AGENTS.md — Upstream-Teil ist nicht mehr byte-identisch mit der Baselineúutf-8Úreplacer é zAGENTS.md: Marke 'z%' fehlt direkt nach dem Upstream-Teil) r r3 r4 r5 Ú
|
|||
|
|
startswithÚlenÚdecodeÚMARKEÚ
|
|||
|
|
splitlines)r, r r6 ÚagentsÚ agents_baseÚupstreamr7 Úrests r Ú
|
|||
|
|
pruefe_agentsrI Ž sç € Ø Ñ,¨d°[Ñ.@ˆK€FØ × Ñ Ô Ø�
|
|||
|
|
‰
|
|||
|
|
Ð(¬¨
|
|||
|
|
°*Ð=Ô>ØØ �>‰>Ô Ø�
|
|||
|
|
‰
|
|||
|
|
Ð5Ô6ØØ×%Ñ%Ó'€HØ
|
|||
|
|
×
|
|||
|
|
Ñ
|
|||
|
|
Ó
|
|||
|
|
€FØ × Ñ ˜XÔ &Ø�
|
|||
|
|
‰
|
|||
|
|
ð 8ô 9àØ ”#�h“-�.Ð !× (Ñ (¨°)Ó <€DÜ �D—O‘OÓ% a¨Ð*Ñ*Ø�
|
|||
|
|
‰
|
|||
|
|
Ð*¬5¨'ð 2&ð &õ 'ð +r c óˆ — t D ��ch c] \ }}|’Œ c}}t t « z t t « z t t « z }t | « D ]# }||vsŒ|j
|
|||
|
|
dt › d|› d�« Œ% t t z D ]2 }| |z j « rŒ|j
|
|||
|
|
dt › d|› d�« Œ4 yc c}}w )z4Jede vendorierte Datei gehoert in genau eine Klasse.zUNZUGEORDNET: r1 u� ist vendoriert, steht aber in keiner Liste — es vergleicht sie nichts. Nach PAARE, ERWEITERT oder NICHT_UEBERNOMMEN eintragen.r0 z$ (deklariert, aber nicht vendoriert)N) r2 ÚsetÚ ERWEITERTÚNICHT_UEBERNOMMENÚ
|
|||
|
|
SONDERFALLr r3 r4 r )r r6 Ú_ÚoÚ
|
|||
|
|
zugeordnetÚdateis r Úpruefe_vollstaendigkeitrS ¢ s¿ € å %Ô&¡™˜˜1’! Ò&¬¬Y« Ñ7¼#Ô>OÓ:PÑPÜ
|
|||
|
|
|
|||
|
|
Œj‹/ñ€Jä! $Ö'ˆØ ˜
|
|||
|
|
Ò "Ø �M‰MØ ¤
|
|||
|
|
¨!¨E¨7ð 3>ð ?õ
|
|||
|
|
@ð (ô Ô .Ô.ˆØ�u‘ ×%Ñ%Õ'Ø �M‰MÐ ,¬X¨J°a¸°wð ?3ð 4õ
|
|||
|
|
5ñ /ùó 's Š B>c ó> — t | « }t |« dk ry|d |d }}|j t t « j k7 r:|j dt t « j › d|j › d�« yg }t D ]` }||z ||z }}|j « r|j « sŒ.|j « |j « k7 sŒP|j |« Œb |sy|t z } | j « s2|j |j › dt › d t |« › d
|
|||
|
|
�« yt « }
|
|||
|
|
| j d d ¬
|
|||
|
|
« j « D ]c } | j « r | j « j d« rŒ3|
|
|||
|
|
j! | j# d« d j « « Œe |D ]J }||
|
|||
|
|
vsŒ|j d|› d|j › d|j › d|j › dt › d� « ŒL y)zJHat upstream eine erweiterte Datei angefasst, muss HERKUNFT.md sie nennen.é NéþÿÿÿéÿÿÿÿzBASELINE zeigt auf z", neuester vendorierter Stand ist u — welcher gilt?r1 z fehlt, upstream hat aber uC erweiterte Datei(en) angefasst — ungeprueft ist nicht bestanden.r= r> )ÚencodingÚerrorsÚ#Ú r zABGLEICH: upstream hat z
|
|||
|
|
zwischen z und z geaendert, z4 quittiert sie nicht. Nachziehen und dort eintragen.)r. rA r" r r4 r3 rL r r5 ÚABGLEICHrK Ú read_textrD ÚstripÚlstripr@ ÚaddÚsplit) r, r6 ô ständeÚvorherÚjetztÚ geaendertrR ÚaltÚneuÚquittungÚ quittiertÚzeiles r Úpruefe_abgleichrk ² sì € 䘋o€GÜ
|
|||
|
|
ˆ7ƒ|�aÒØؘB‘K ¨¡ˆE€FØ ‡z�z”Tœ(“^×(Ñ(Ò(Ø�
|
|||
|
|
‰
|
|||
|
|
Ð+¬D´«N×,?Ñ,?Ð+@ð A0Ø05·
|
|||
|
|
±
|
|||
|
|
¨|Ð;MðOô PàØ€I߈ؘE‘> 5¨5¡=ˆSˆØ�{‰{Œ} C§K¡K¤MØ Ø �>‰>Ó ˜sŸ~™~Ó /Ó /Ø × Ñ ˜UÕ #ð ñ Øà”xÑ €HØ × Ñ Ô Ø�
|
|||
|
|
‰
|
|||
|
|
Ø�z‰zˆl˜!œH˜:Ð%?Ü�9‹~Ð ð #ð
|
|||
|
|
$ô %ð Ü“€IØ×#Ñ#¨W¸YÐ#ÓG×RÑRÖTˆØ�{‰{Œ} § ¡ £× 9Ñ 9¸#Ô >Ø Ø�
|
|||
|
|
‰
|
|||
|
|
�e—k‘k $Ó'¨Ñ*×0Ñ0Ó2Õ3ð Uó ˆØ ˜ Ò !Ø �M‰MØ)¨%¨°
|
|||
|
|
¸6¿;¹;¸-ÀuØ—:‘:�,˜l¨5¯:©:¨,°a¼°zð B<ð=õ
|
|||
|
|
>ñ r c óz — | dz |dz }}|j « r|j « s|j d« y t j |j d¬« « xs i }t j |j d¬« « xs i }t |t « rt |t « s|j d« yd D ]o }t |j |« xs g « t |j |« xs g « z
|
|||
|
|
} | sŒC|j d
|
|||
|
|
|› d t | « › d |j › �« Œq |j d
|
|||
|
|
« xs i j « D �]Ÿ \ }
|
|||
|
|
} |j d
|
|||
|
|
« xs i j |
|
|||
|
|
« } | €#|j d|
|
|||
|
|
› d|j › d�« ŒPdD ]„ }
|
|||
|
|
| j |
|
|||
|
|
« xs |
|
|||
|
|
dk7 rg ni }| j |
|
|||
|
|
« xs |
|
|||
|
|
dk7 rg ni }t |« t |« z
|
|||
|
|
} | sŒU|j d
|
|||
|
|
|
|
|||
|
|
› d|
|
|||
|
|
› d t | « › d |j › �« Œ† | j d« xs i j « D ]¡ \ }}|xs i j d« }| j d« xs i j |« xs i j d« }|sŒU|€ŒXt |« t |« z
|
|||
|
|
} | sŒr|j d
|
|||
|
|
|
|
|||
|
|
› d|› dt | « › d |j › �« Œ£ �Œ¢ y# t j
|
|||
|
|
$ r*}|j dt
|
|||
|
|
|« dd › �« Y d}~yd}~ww xY w)u" Deckt unsere schema.yaml noch alles ab, was die Baseline fuehrt?
|
|||
|
|
|
|||
|
|
⚠� Anlass: Beim Upgrade auf v0.3.1 wurde der Handabgleich quittiert —
|
|||
|
|
wahrheitsgemaess — und verlor trotzdem zwei Felder (wiki-page.status,
|
|||
|
|
wiki-page.harvested_in). Die Quittungspflicht aus ADR-0024 fragt, OB
|
|||
|
|
nachgezogen wurde, nicht OB VOLLSTAENDIG. Sie wurde in der Annahme
|
|||
|
|
gebaut, der Fehler sei Vergessen und nicht Falschmachen; dieselbe
|
|||
|
|
Aufgabe hat das an ihrem ersten Tag widerlegt.
|
|||
|
|
|
|||
|
|
Diese Pruefung schliesst die Luecke nur fuer schema.yaml, weil YAML
|
|||
|
|
strukturell vergleichbar ist. Fuer die beiden Python-Dateien gibt es
|
|||
|
|
keine Entsprechung — das bleibt offen und ist als Muster notiert.
|
|||
|
|
|
|||
|
|
Erlaubt ist Hinzufuegen (wir erweitern erklaert, ADR-0024), verboten
|
|||
|
|
ist Verlieren.
|
|||
|
|
r z/schema.yaml fehlt in Arbeitskopie oder BaselineNr= ©rX zschema.yaml nicht lesbar: éP zAschema.yaml ist keine YAML-Abbildung (Arbeitskopie oder Baseline))Ú link_fieldsÚvendoredz
|
|||
|
|
schema.yaml: z
|
|||
|
|
verliert z gegenueber Útypeszschema.yaml: Typ 'z' aus z fehlt)ÚfieldsÚrequiredÚrulesrr Ú.Úenumz Enum verliert )r r3 ÚyamlÚ safe_loadr] Ú YAMLErrorr Ú
|
|||
|
|
isinstanceÚdictrK Úgetr r" Úitems)r, r r6 Ú
|
|||
|
|
eigen_pfadÚ
|
|||
|
|
basis_pfadÚeigenÚbasisÚexÚ
|
|||
|
|
schluesselÚfehltÚtypÚspecÚeigenerÚteilÚhierÚdortÚfeldÚregelÚwerteÚunsers r Úpruefe_schema_deckungr� Ú s € ð" " MÑ 1°4¸-Ñ3G�
|
|||
|
|
€JØ × Ñ Ô Z×%7Ñ%7Ô%9Ø�
|
|||
|
|
‰
|
|||
|
|
ÐGÔHØðÜ—‘˜z× 3Ñ 3¸WÐ 3Ó EÓFÒLÈ"ˆÜ—‘˜z× 3Ñ 3¸WÐ 3Ó EÓFÒLÈ"ˆô �eœTÔ "¬*°U¼DÔ*AØ�
|
|||
|
|
‰
|
|||
|
|
ð 5ô 6àã1ˆ
|
|||
|
|
Ü�E—I‘I˜jÓ)Ò/¨RÓ0´3°u·y±yÀÓ7LÒ7RÐPRÓ3SÑSˆÚ Ø �M‰M˜M¨*¨ °ZÄÀuÃ
|
|||
|
|
¸ð O(Ø(,¯ © {ð4õ
|
|||
|
|
5ð 2ð —i‘i Ó(Ò.¨B×5Ñ5×7‰ ˆˆTØ—9‘9˜WÓ%Ò+¨×0Ñ0°Ó5ˆØ ˆ?Ø �M‰MÐ .¨s¨e°6¸$¿)¹)¸ÀFÐKÔ LØ Û3ˆDØ—;‘;˜tÓ$ÒH¨t°xÒ/?©ÀRˆDØ—8‘8˜D“>ÒE¨D°HÒ,<¡bÀ"ˆDܘ“I¤ D£ Ñ)ˆEÚØ—
|
|||
|
|
‘
|
|||
|
|
|
|||
|
|
¨c¨U°!°D°6¸Ü!'¨£ ¨|¸D¿I¹I¸;ð Hõ Ið 4ð !ŸH™H XÓ .Ò 4°"×;Ñ;Ö=‰KˆD�%Ø’[˜b×%Ñ% fÓ-ˆEØ —k‘k (Ó+Ò1¨r×6Ñ6°tÓ<ÒBÀ×GÑGÈÓOˆEÚ˜Ñ*ܘE›
|
|||
|
|
¤S¨£ZÑ/�ÚØ—M‘M M°#°°a¸°v¸_Ü%+¨E£] O°<ÀÇ Á ¸{ð#Lõ Mò
|
|||
|
|
>ñ 8øô! �>‰>ò Ø�
|
|||
|
|
‰
|
|||
|
|
Ð2´3°r³7¸3¸B°<°.ÐAÔBÜûðús ¾AK= Ë=L:Ì L5Ì5L:c óš — | t z }g }t | ||« t | ||« t ||« t | |« t | ||« |S r
|
|||
|
|
)r4 r; rI rS rk r� )r, r r6 s r Úpruefer‘ sM € Ø ”(‰?€DØ€FÜ��t˜VÔ$Ü�$˜˜fÔ%ܘD &Ô)Ü�D˜&Ô!ܘ$ fÔ-Ø €Mr c
|
|||
|
|
óŠ
|
|||
|
|
‡
|
|||
|
|
‡— dg cŠ
|
|||
|
|
Šd8ˆ
|