119 lines
5.3 KiB
Python
119 lines
5.3 KiB
Python
#!/usr/bin/env python3
|
||
"""
|
||
link_briefs.py — verlinkt jedes Phase-/Screen-Ticket mit seinem Designer-Brief.
|
||
|
||
Stellt den Designer-Brief (`.planning/designer-briefs/PXX-*.md`) als ERSTEN Doku-Link
|
||
in die Ticket-Beschreibung (vor die bestehenden ROADMAP-/Spec-Links). Idempotent
|
||
(Working-ID-Match; setzt nichts doppelt). Default = DRY-RUN, --apply = scharf.
|
||
|
||
Mapping: Working-ID → Phasen-Nr.
|
||
- R-Pxx / AK-Pxx / VR-Pxx / VA-Pxx → P{xx} (automatisch)
|
||
- D-* / VD-* → manuelles Mapping (siehe DMAP)
|
||
- mehrdeutige D-*/VD-* (mehrere Phasen) → übersprungen + gemeldet
|
||
"""
|
||
import json, os, re, sys, glob, time, urllib.request, urllib.error
|
||
APPLY = "--apply" in sys.argv
|
||
TOK = {}
|
||
for line in open(os.path.expanduser("~/.cli-tokens/plane")):
|
||
line = line.strip()
|
||
if "=" in line and not line.startswith("#"):
|
||
k, v = line.split("=", 1); TOK[k.strip()] = v.strip()
|
||
BASE = TOK["PLANE_BASE_URL"].rstrip("/"); WS = TOK["PLANE_WORKSPACE"]; KEY = TOK["PLANE_API_KEY"]
|
||
PID = "35d0d968-8ab3-40cc-97b8-b81d917dc5df"
|
||
API = f"{BASE}/api/v1/workspaces/{WS}/projects/{PID}"
|
||
GITEA = "https://git.tool-ctrl.de/toolctrl-labs/HiveGrid-Cloud/src/branch/main"
|
||
BRIEFDIR = ".planning/designer-briefs"
|
||
|
||
def req(method, path, body=None):
|
||
url = path if path.startswith("http") else API + path
|
||
st, d = 0, {}
|
||
for _ in range(8):
|
||
r = urllib.request.Request(url, data=(json.dumps(body).encode() if body is not None else None), method=method)
|
||
r.add_header("X-API-Key", KEY); r.add_header("Content-Type", "application/json")
|
||
try:
|
||
with urllib.request.urlopen(r, timeout=30) as resp:
|
||
raw = resp.read().decode(); st, d = resp.status, (json.loads(raw) if raw else {})
|
||
except urllib.error.HTTPError as e:
|
||
st, d = e.code, {"_error": e.read().decode()[:300]}
|
||
if st == 429: time.sleep(25); continue
|
||
if APPLY and method != "GET": time.sleep(0.4)
|
||
return st, d
|
||
return st, d
|
||
def get_all(path):
|
||
out, c = [], None
|
||
while True:
|
||
st, d = req("GET", path + (("?per_page=100&cursor=" + c) if c else "?per_page=100"))
|
||
if st >= 400: break
|
||
if isinstance(d, list): out += d; break
|
||
out += d.get("results", [])
|
||
if d.get("next_page_results") and d.get("next_cursor"): c = d["next_cursor"]
|
||
else: break
|
||
return out
|
||
|
||
# P-Nr -> Brief-Dateiname (aus dem Verzeichnis)
|
||
PBRIEF = {}
|
||
for p in glob.glob(f"{BRIEFDIR}/P*.md"):
|
||
m = re.match(r"P(\d{2})-", os.path.basename(p))
|
||
if m: PBRIEF[int(m.group(1))] = os.path.basename(p)
|
||
|
||
# D-*/VD-* manuelles Mapping (nur EINDEUTIGE; mehrdeutige bewusst weggelassen)
|
||
DMAP = {
|
||
"D-D0a": 1, "D-D0b": 1, "D-CRM": 6, "D-KANBAN": 8, "D-FORM": 16, "D-KAMP": 14,
|
||
"D-HR": 17, "D-ADMIN": 19, "D-PLAN": 9, "D-ABN": 9, "D-CHAT": 15, "D-DASH": 11,
|
||
"D-BOOK": 16, "D-FLOW": 12,
|
||
"VD-2": 26, "VD-3": 27, "VD-4": 29,
|
||
}
|
||
# bewusst übersprungen (mehrere Phasen): D-WEB, D-REST, D-POLISH, VD-1, VD-5, VD-6
|
||
SKIP_AMBIG = {"D-WEB", "D-REST", "D-POLISH", "VD-1", "VD-5", "VD-6"}
|
||
|
||
def phase_of(wid):
|
||
if wid in DMAP: return DMAP[wid]
|
||
m = re.match(r"(?:R|AK|VR|VA)-P(\d+)", wid)
|
||
if m: return int(m.group(1))
|
||
return None
|
||
|
||
print(f"=== link_briefs.py — {'APPLY' if APPLY else 'DRY-RUN'} ===")
|
||
print(f"Briefe gefunden: {len(PBRIEF)} (P{min(PBRIEF)}–P{max(PBRIEF)})\n")
|
||
issues = get_all("/issues/")
|
||
linked = skipped_nobrief = skipped_ambig = already = nodoku = 0
|
||
ambig_list = []
|
||
for i in sorted(issues, key=lambda x: x["sequence_id"]):
|
||
if " · " not in i["name"]: continue
|
||
wid = i["name"].split(" · ")[0]
|
||
if wid in SKIP_AMBIG:
|
||
skipped_ambig += 1; ambig_list.append(wid); continue
|
||
ph = phase_of(wid)
|
||
if ph is None: continue # Externals/Vertrieb/Website/Noah
|
||
brief = PBRIEF.get(ph)
|
||
if not brief:
|
||
skipped_nobrief += 1
|
||
print(f" ?? {wid}: kein Brief für P{ph} (v2-deferred Phase wie P10/P18?)")
|
||
continue
|
||
html = i.get("description_html") or ""
|
||
if f"designer-briefs/{brief}" in html:
|
||
already += 1; continue
|
||
url = f"{GITEA}/{BRIEFDIR}/{brief}"
|
||
linkhtml = (f'<a target="_blank" class="text-accent-secondary underline underline-offset-[3px] '
|
||
f'hover:text-accent-primary transition-colors cursor-pointer" href="{url}" '
|
||
f'rel="noopener noreferrer">🎨 Designer-Brief P{ph:02d}</a>')
|
||
# Marker matcht <b>...</b> (sync-Skript-Format) UND <strong>...</strong> (Plane-Editor-normalisiert)
|
||
m = re.search(r'📚 Doku</(?:b|strong)><br\s*/?>', html)
|
||
if m:
|
||
br = "<br>" if "<br>" in m.group(0) else "<br/>"
|
||
pos = m.end()
|
||
new = html[:pos] + linkhtml + br + html[pos:]
|
||
else:
|
||
nodoku += 1
|
||
print(f" ⚠ {wid}: kein '📚 Doku'-Block — übersprungen")
|
||
continue
|
||
print(f" + {wid:9} → {brief}")
|
||
linked += 1
|
||
if APPLY:
|
||
st, d = req("PATCH", f"/issues/{i['id']}/", {"description_html": new})
|
||
if st >= 400: print(" PATCH FAIL:", st, d)
|
||
|
||
print(f"\n=== {'verlinkt' if APPLY else 'würde verlinken'}: {linked} · bereits: {already} · "
|
||
f"mehrdeutig übersprungen: {skipped_ambig} {sorted(set(ambig_list))} · "
|
||
f"kein Brief: {skipped_nobrief} · kein Doku-Block: {nodoku} ===")
|
||
if not APPLY: print("Dry-Run — nichts geschrieben. Mit --apply scharf schalten.")
|