#!/usr/bin/env python3 """Generate client-update-flow as-is module.svg via fireworks-tech-graph rules.""" import os W, H = 1280, 720 NW, NH = 180, 56 CLW = 220 L = [] def emit(s): L.append(s) emit('' % (W, H)) emit(' ') emit(' ') emit(' ') emit(' ') emit(' ') emit(' ' % (W, H)) emit(' as-is · module · harness-toolkit 客户端同步链路') # Panel containers TK_X, TK_Y, TK_W, TK_H = 40, 70, 560, 620 emit(' ' % (TK_X, TK_Y, TK_W, TK_H)) emit(' harness-rd-toolkit (source)' % (TK_X+12, TK_Y+22)) CL_X, CL_Y, CL_W, CL_H = 700, 70, 540, 620 emit(' ' % (CL_X, CL_Y, CL_W, CL_H)) emit(' 客户端项目 (targetDir)' % (CL_X+12, CL_Y+22)) # Node positions (snap x to 120-ish grid, y to 80-ish) cli_x, cli_y = 80, 130 ver_x, ver_y = 80, 280 ini_x, ini_y = 340, 130 upd_x, upd_y = 340, 280 claude_x, claude_y = 760, 130 set_x, set_y = 760, 220 ctx_x, ctx_y = 760, 310 cfg_x, cfg_y = 760, 400 stamp_x, stamp_y = 760, 490 stamp_w, stamp_h = 220, 80 finding_x, finding_y = 80, 500 finding_w, finding_h = 460, 170 def R(x,y,w,h): return (x+w, y+h//2) def LE(x,y,w,h): return (x, y+h//2) def T(x,y,w,h): return (x+w//2, y) def B(x,y,w,h): return (x+w//2, y+h) # ===== EDGES FIRST ===== sx,sy = R(cli_x,cli_y,NW,NH); ex,ey = LE(ini_x,ini_y,NW,NH) emit(' ' % (sx,sy,ex,ey)) emit(' init' % ((sx+ex)//2-12, sy-8)) sx,sy = R(cli_x,cli_y+20,NW,NH); ex,ey = LE(upd_x,upd_y,NW,NH) mx = (sx+ex)//2 emit(' ' % (sx,sy,mx,sy,mx,ey,ex,ey)) emit(' update' % (mx+8, (sy+ey)//2)) sx,sy = B(cli_x,cli_y,NW,NH); ex,ey = T(ver_x,ver_y,NW,NH) emit(' ' % (sx,sy,ex,ey)) emit(' version' % (sx+8, (sy+ey)//2)) sx,sy = T(upd_x,upd_y,NW,NH); ex,ey = B(ini_x,ini_y,NW,NH) emit(' ' % (sx,sy,ex,ey)) emit(' 复用 init 符号' % (sx+8, (sy+ey)//2)) # update -> cfg (hash sync) green-ish main sx,sy = R(upd_x,upd_y,NW,NH); ex,ey = LE(cfg_x,cfg_y,CLW,NH) mx = (sx+ex)//2 emit(' ' % (sx,sy,mx,sy,mx,ey,ex,ey)) emit(' hash 同步' % (mx+8, sy-6)) # update -> settings.* (union merge, dashed soft) sx,sy = R(upd_x,upd_y+15,NW,NH); ex,ey = LE(set_x,set_y,CLW,NH) mx = (sx+ex)//2 emit(' ' % (sx,sy,mx,sy,mx,ey,ex,ey)) emit(' 字段 union merge' % (mx+8, sy+18)) # update -> CLAUDE.md (red dashed, "完全不管") sx,sy = R(upd_x,upd_y-15,NW,NH); ex,ey = LE(claude_x,claude_y,CLW,NH) mx = (sx+ex)//2 emit(' ' % (sx,sy,mx,sy,mx,ey,ex,ey)) emit(' 完全不管 (不对称守护)' % (mx+8, ey-6)) # update -> CONTEXT.md (hash sync) sx,sy = R(upd_x,upd_y+30,NW,NH); ex,ey = LE(ctx_x,ctx_y,CLW,NH) mx = (sx+ex)//2 emit(' ' % (sx,sy,mx,sy,mx,ey,ex,ey)) emit(' hash 同步' % (mx+8, ey+18)) # update -> stamp (red, "不读 / 不写", orthogonal down-right) mx_upd = upd_x + NW//2 sy = upd_y + NH mx_stamp = stamp_x + stamp_w//2 ey = stamp_y GY = (sy + ey) // 2 emit(' ' % (mx_upd, sy, mx_upd, GY, mx_stamp, GY, mx_stamp, ey)) emit(' 不读 / 不写' % ((mx_upd+mx_stamp)//2, GY-6)) # ===== NODES ===== def node(x, y, w, h, fill, stroke, label, sub=None, label_fill='#0f172a', sub_fill='#475569', stroke_w=1.6, dash=None): d = ' stroke-dasharray="%s"' % dash if dash else '' emit(' ' % (x, y, w, h, fill, stroke, stroke_w, d)) cy = y + h//2 if sub: emit(' %s' % (x+w//2, cy-4, label_fill, label)) emit(' %s' % (x+w//2, cy+12, sub_fill, sub)) else: emit(' %s' % (x+w//2, cy+5, label_fill, label)) node(cli_x, cli_y, NW, NH, '#e3f2fd', '#1976d2', 'cli.ts', 'command dispatch') node(ver_x, ver_y, NW, NH, '#e3f2fd', '#1976d2', 'version.ts', 'VERSION 常量 only') node(ini_x, ini_y, NW, NH, '#e3f2fd', '#1976d2', 'commands/init.ts', 'scaffoldDir / install*') node(upd_x, upd_y, NW, NH, '#e3f2fd', '#1976d2', 'commands/update.ts', 'runUpdate / syncOneFile') node(claude_x, claude_y, CLW, NH, '#fff3e0', '#f57c00', 'CLAUDE.md', 'sentinel(init) ; update 不接') node(set_x, set_y, CLW, NH, '#fff3e0', '#f57c00', '.claude/settings.json', 'hooks 字段 union merge') node(ctx_x, ctx_y, CLW, NH, '#fff3e0', '#f57c00', 'CONTEXT.md', 'hash 不同 -> skipped-conflict') node(cfg_x, cfg_y, CLW, NH, '#fff3e0', '#f57c00', 'pipeline*.yaml / gates / skills', 'hash 同步, 冲突 skipped') # stamp gap node emit(' ' % (stamp_x, stamp_y, stamp_w, stamp_h)) emit(' (缺失) 客户端无版本戳记' % (stamp_x+stamp_w//2, stamp_y+24)) emit(' 无 .harness-toolkit-version 文件' % (stamp_x+stamp_w//2, stamp_y+42)) emit(' update 无法判断"该不该提示"' % (stamp_x+stamp_w//2, stamp_y+58)) # findings callout emit(' ' % (finding_x, finding_y, finding_w, finding_h)) emit(' 三处与需求冲突的现状缺口' % (finding_x+12, finding_y+24)) emit(' 1. 无版本提示路径 (更新提示维度空白)' % (finding_x+12, finding_y+50)) emit(' 2. --force 直接整文件覆盖用户修改' % (finding_x+12, finding_y+74)) emit(' 3. dest 缺失 -> 无条件 created, 删除被恢复' % (finding_x+12, finding_y+98)) emit(' 违反"未获认可, 不允许修改或删除客户' % (finding_x+12, finding_y+122)) emit(' 已做的配置" 硬约束' % (finding_x+12, finding_y+140)) # legend LG_Y = H - 56 emit(' ' % LG_Y) emit(' Legend:' % (LG_Y+26)) emit(' ' % (LG_Y+14)) emit(' toolkit 模块' % (LG_Y+26)) emit(' ' % (LG_Y+14)) emit(' 客户端配置面' % (LG_Y+26)) emit(' ' % (LG_Y+14)) emit(' 与需求冲突/缺口 (红色虚线)' % (LG_Y+26)) emit(' ' % (LG_Y+22, LG_Y+22)) emit(' 主同步路径' % (LG_Y+26)) emit(' ' % (LG_Y+22, LG_Y+22)) emit(' 软引用 / 字段合并' % (LG_Y+26)) emit('') p = 'docs/4plus1/delta/client-update-flow/as-is/rendered/module.svg' with open(p, 'w', encoding='utf-8') as f: f.write('\n'.join(L)) print('written lines=%d size=%d' % (len(L), os.path.getsize(p)))