@litfamily/litgrok 1.0.33 → 1.0.35

package/.grok/skills/lit-diagram-drawer/scripts/visual-quality.mjs

@@ -1,344 +0,0 @@
-import { sourceMetrics } from './diagram-metrics.mjs';
-
-const MAX_EDGE_LABEL_ANCHOR_DISTANCE=24;
-const BOUNDARY_EDGE_PADDING=4;
-const BOUNDARY_EDGE_MIN_OVERLAP=12;
-const ARROWHEAD_CANVAS_FLOOR=12/1080;
-const ARROWHEAD_STROKE_MULTIPLE=5;
-const ARROWHEAD_TARGET_TOLERANCE=2;
-
-const decode=(s)=>s.replaceAll('&amp;','&').replaceAll('&lt;','<').replaceAll('&gt;','>').replaceAll('&quot;','"').replaceAll('&apos;',"'").replaceAll('&#39;',"'");
-const attributes=(s)=>Object.fromEntries([...s.matchAll(/([\w:-]+)\s*=\s*(?:"([^"]*)"|'([^']*)')/g)].map((m)=>[m[1],decode(m[2]??m[3]??'')]));
-const clean=(s)=>decode(s.replace(/<[^>]*>/g,' ').replace(/\s+/g,' ').trim());
-const widthOf=(text,size)=>[...text].reduce((n,c)=>n+(/\s/.test(c)?.28:/[\u1100-\u11ff\u3130-\u318f\uac00-\ud7af]/.test(c)?.98:/[ilI.,:;!|]/.test(c)?.32:/[MW@#%]/.test(c)?.82:.56),0)*size;
-const contamination=[
-  /\blitfamily\b/i, /\b(?:generator|generated by|template|prototype)\b/i,
-  /\bsource\s*:/i, /\bnotes?\s*:/i, /\bstatic\s+first\b/i,
-  /\baccessible\s+labels\b/i, /\bone\s+accent\b/i, /\bfocal\b/i,
-  /\b(?:light|dark|full)\s*[·|/]\s*static\b/i, /\bdesign\s+rules?\b/i,
-  /^\s*show\b/i,
-];
-
-function visibleSvgText(svg){
-  return [...svg.matchAll(/<text\b([^>]*)>([\s\S]*?)<\/text>/gi)].map((m)=>{
-    const a=attributes(m[1]),label=clean(m[2]),size=Number(a['font-size']||16),textAnchor=a['text-anchor']||'start',anchor={x:Number(a.x||0),y:Number(a.y||0)},w=widthOf(label,size),x=anchor.x-(textAnchor==='middle'?w/2:textAnchor==='end'?w:0),y=anchor.y-size*.82;
-    return {label,size,role:a['data-role']||'',nodeId:a['data-node-id']||'',anchor,edgeFor:a['data-edge-for']||'',boundaryFor:a['data-boundary-for']||a['data-group-for']||'',x,y,w,h:size*1.22};
-  }).filter((t)=>t.label);
-}
-function svgContent(source){return [...source.matchAll(/<svg\b[^>]*>[\s\S]*?<\/svg>/gi)].map((m)=>m[0]).join('\n');}
-function parseRoutes(svg){
-  const routes=[];
-  for(const m of svg.matchAll(/<(line|path)\b([^>]*)>/gi)){
-    const a=attributes(m[2]); if(!a['data-from']||!a['data-to'])continue;
-    let segments=[];
-    if(m[1].toLowerCase()==='line'){
-      const v=['x1','y1','x2','y2'].map((k)=>Number(a[k])); if(v.every(Number.isFinite))segments=[[v[0],v[1],v[2],v[3]]];
-    }else if(a.d){
-      const parts=a.d.match(/[a-zA-Z]|[-+]?(?:\d*\.\d+|\d+\.?\d*)(?:e[-+]?\d+)?/gi)||[];let i=0,cmd='',x=0,y=0,px=0,py=0;
-      while(i<parts.length){if(/^[a-z]$/i.test(parts[i]))cmd=parts[i++];if(!cmd)break;const rel=cmd===cmd.toLowerCase(),up=cmd.toUpperCase();
-        if(up==='M'||up==='L'){if(i+1>=parts.length||/^[a-z]$/i.test(parts[i])){cmd='';continue;}const nx=Number(parts[i++])+(rel?x:0),ny=Number(parts[i++])+(rel?y:0);if(up==='L')segments.push([x,y,nx,ny]);x=nx;y=ny;}
-        else if(up==='H'){if(i>=parts.length||/^[a-z]$/i.test(parts[i])){cmd='';continue;}const nx=Number(parts[i++])+(rel?x:0);segments.push([x,y,nx,y]);x=nx;}
-        else if(up==='V'){if(i>=parts.length||/^[a-z]$/i.test(parts[i])){cmd='';continue;}const ny=Number(parts[i++])+(rel?y:0);segments.push([x,y,x,ny]);y=ny;}
-        else if(up==='C'){if(i+5>=parts.length||/^[a-z]$/i.test(parts[i])){cmd='';continue;}const p=(n)=>[Number(parts[n])+(rel?x:0),Number(parts[n+1])+(rel?y:0)],start=[x,y],c1=p(i),c2=p(i+2),end=p(i+4);i+=6;let previous=start;for(let step=1;step<=16;step++){const t=step/16,u=1-t,next=[u*u*u*start[0]+3*u*u*t*c1[0]+3*u*t*t*c2[0]+t*t*t*end[0],u*u*u*start[1]+3*u*u*t*c1[1]+3*u*t*t*c2[1]+t*t*t*end[1]];segments.push([previous[0],previous[1],next[0],next[1]]);previous=next;}x=end[0];y=end[1];}
-        else {cmd='';while(i<parts.length&&!/^[a-z]$/i.test(parts[i]))i++;}
-      }
-    }
-    if(segments.length)routes.push({from:a['data-from'],to:a['data-to'],label:a['data-label']||'',segments,markerStart:a['marker-start']||'',markerEnd:a['marker-end']||'',strokeWidth:Number(a['stroke-width']||1)});
-  }
-  return routes;
-}
-function rectangles(svg){
-  const nodes=[];
-  for(const m of svg.matchAll(/<rect\b([^>]*)\/?\s*>/gi)){
-    const a=attributes(m[1]);if(!a['data-node-id'])continue;
-    const box={id:a['data-node-id'],fill:a.fill||'',type:a['data-node-type']||'',outcomes:(a['data-outcomes']||'').split('|').map((value)=>value.trim()).filter(Boolean),x:Number(a.x||0),y:Number(a.y||0),w:Number(a.width||0),h:Number(a.height||0)};
-    if(box.w>0&&box.h>0)nodes.push(box);
-  }
-  return nodes;
-}
-function segmentHitsBox(s,b,pad=0){
-  const [x1,y1,x2,y2]=s,loX=Math.min(x1,x2),hiX=Math.max(x1,x2),loY=Math.min(y1,y2),hiY=Math.max(y1,y2),left=b.x-pad,right=b.x+b.w+pad,top=b.y-pad,bottom=b.y+b.h+pad;
-  if(x1===x2)return x1>=left&&x1<=right&&hiY>=top&&loY<=bottom;
-  if(y1===y2)return y1>=top&&y1<=bottom&&hiX>=left&&loX<=right;
-  const steps=24;for(let i=0;i<=steps;i++){const t=i/steps,x=x1+(x2-x1)*t,y=y1+(y2-y1)*t;if(x>=left&&x<=right&&y>=top&&y<=bottom)return true;}return false;
-}
-function segmentHitsText(s,t,pad=1){
-  const b={x:t.x-pad,y:t.y-pad,w:t.w+pad*2,h:t.h+pad*2};return segmentHitsBox(s,b,0);
-}
-function textOverlapsNode(text,node,pad=1){return text.x<node.x+node.w+pad&&text.x+text.w>node.x-pad&&text.y<node.y+node.h+pad&&text.y+text.h>node.y-pad;}
-function gap(a,b){const dx=Math.max(0,a.x-(b.x+b.w),b.x-(a.x+a.w)),dy=Math.max(0,a.y-(b.y+b.h),b.y-(a.y+a.h));return Math.hypot(dx,dy);}
-
-const OFFICE_LIMITS={groupRatio:2,accentFamiliesHigh:6,hueBand:20,latinShare:.8,titleShare:.6,inset:4};
-function officeQuality(svg,nodes,texts,outlines){
-  const issues=[];
-  if(outlines.length>=2){
-    const group=(n)=>outlines.find((o)=>n.x+n.w/2>=o.x&&n.x+n.w/2<=o.x+o.w&&n.y+n.h/2>=o.y&&n.y+n.h/2<=o.y+o.h)?.id||'none';
-    const intra=[],inter=[];
-    for(let i=0;i<nodes.length;i++)for(let j=i+1;j<nodes.length;j++)(group(nodes[i])===group(nodes[j])?intra:inter).push(gap(nodes[i],nodes[j]));
-    if(intra.length&&inter.length&&Math.min(...inter)<OFFICE_LIMITS.groupRatio*Math.max(...intra))issues.push('OF-201 CLUSTER_GAP_RATIO inter='+Math.min(...inter).toFixed(1)+' intra='+Math.max(...intra).toFixed(1));
-  }
-  const hues=[];
-  for(const n of nodes){const m=n.fill.match(/^#([\da-f]{6})$/i);if(!m)continue;const rgb=[0,2,4].map((i)=>parseInt(m[1].slice(i,i+2),16)/255),max=Math.max(...rgb),min=Math.min(...rgb),d=max-min,light=(max+min)/2,sat=d===0?0:d/(1-Math.abs(2*light-1));if(sat<.12||light<.12||light>.93)continue;let h=0;if(d){const k=rgb.indexOf(max);h=60*((k===0?(rgb[1]-rgb[2])/d:k===1?(rgb[2]-rgb[0])/d+2:(rgb[0]-rgb[1])/d+4)+6)%360;}if(!hues.some((v)=>Math.min(Math.abs(v-h),360-Math.abs(v-h))<=OFFICE_LIMITS.hueBand))hues.push(h);}
-  if(hues.length>=OFFICE_LIMITS.accentFamiliesHigh)issues.push('OF-202 ACCENT_COUNT '+hues.length+' HIGH; keep three to five families, each tied to a named role');
-  for(const t of texts){
-    const letters=[...t.label].filter((c)=>/[A-Za-z0-9]/.test(c)).length,share=letters/Math.max(1,t.label.length);
-    if(share>=OFFICE_LIMITS.latinShare&&t.label!==t.label.toUpperCase()){const all=t.label.split(/\s+/),words=all.filter((w)=>/^[A-Za-z]{4,}$/.test(w)),caps=words.filter((w)=>/^[A-Z][a-z]+$/.test(w));if(caps.length>=2&&caps.length/Math.max(1,words.length)>OFFICE_LIMITS.titleShare&&all.some((w)=>/^(Of|And|The|To|For|In)$/.test(w)))issues.push('OF-203 LABEL_CASE '+t.label);}
-    const box=t.nodeId?nodes.find((n)=>n.id===t.nodeId):t.boundaryFor?outlines.find((o)=>o.id===t.boundaryFor):null;
-    if(box&&t.w>box.w-2*OFFICE_LIMITS.inset)issues.push('OF-204 LABEL_OVERFLOW '+t.label+' width='+t.w.toFixed(1)+' box='+box.w);
-  }
-  return issues;
-}
-
-function boundaryOutlines(svg){
-  const outlines=[];
-  const add=(a)=>{
-    const markers=['data-trust-boundary','data-boundary','data-boundary-name','data-group-boundary','data-group-name','data-group-label','data-group-id'];
-    const classMarker=/\b(?:boundary|group)(?:[-_][\w-]+)?\b/i.test(a.class||'');
-    if(!markers.some((key)=>Object.hasOwn(a,key))&&!classMarker)return;
-    const labels=[a['data-trust-boundary'],a['data-boundary-name'],a['data-group-boundary'],a['data-group-name'],a['data-group-label']].filter((value)=>value&&value!=='true');
-    const x=Number(a.x||0),y=Number(a.y||0),w=Number(a.width||0),h=Number(a.height||0);
-    if(w>0&&h>0)outlines.push({id:a['data-group-id']||a.id||labels[0]||'outline',labels,x,y,w,h,strokeWidth:Number(a['stroke-width']||1)});
-  };
-  for(const match of svg.matchAll(/<rect\b([^>]*)\/?\s*>/gi))add(attributes(match[1]));
-  for(const match of svg.matchAll(/<g\b([^>]*)>([\s\S]*?)<\/g>/gi)){
-    const group=attributes(match[1]);
-    if(!['data-trust-boundary','data-boundary','data-boundary-name','data-group-boundary','data-group-name','data-group-label','data-group-id'].some((key)=>Object.hasOwn(group,key)))continue;
-    const rect=match[2].match(/<rect\b([^>]*)\/?\s*>/i);
-    if(rect)add({...attributes(rect[1]),...group});
-  }
-  return outlines;
-}
-
-function pointSegmentDistance(point,segment){
-  const [x1,y1,x2,y2]=segment,dx=x2-x1,dy=y2-y1,length=dx*dx+dy*dy;
-  const t=length?Math.max(0,Math.min(1,((point.x-x1)*dx+(point.y-y1)*dy)/length)):0;
-  return Math.hypot(point.x-(x1+t*dx),point.y-(y1+t*dy));
-}
-function routeDistance(point,route){return Math.min(...route.segments.map((segment)=>pointSegmentDistance(point,segment)));}
-function isBoundaryLabel(text,outlines){return text.role==='boundary'||text.boundaryFor||outlines.some((outline)=>outline.labels.includes(text.label)||outline.id===text.boundaryFor);}
-function outlineEdges(outline){return [[outline.x,outline.y,outline.x+outline.w,outline.y],[outline.x+outline.w,outline.y,outline.x+outline.w,outline.y+outline.h],[outline.x+outline.w,outline.y+outline.h,outline.x,outline.y+outline.h],[outline.x,outline.y+outline.h,outline.x,outline.y]];}
-function textHitsOutline(text,outline){return outlineEdges(outline).some((edge)=>segmentHitsText(edge,text,outline.strokeWidth/2+.5));}
-function segmentAlongOutline(segment,outline){
-  const [x1,y1,x2,y2]=segment,loX=Math.min(x1,x2),hiX=Math.max(x1,x2),loY=Math.min(y1,y2),hiY=Math.max(y1,y2),right=outline.x+outline.w,bottom=outline.y+outline.h;
-  if(Math.abs(y1-y2)<=1){const overlap=Math.min(hiX,right)-Math.max(loX,outline.x);return overlap>BOUNDARY_EDGE_MIN_OVERLAP&&(Math.abs(y1-outline.y)<=BOUNDARY_EDGE_PADDING||Math.abs(y1-bottom)<=BOUNDARY_EDGE_PADDING);}
-  if(Math.abs(x1-x2)<=1){const overlap=Math.min(hiY,bottom)-Math.max(loY,outline.y);return overlap>BOUNDARY_EDGE_MIN_OVERLAP&&(Math.abs(x1-outline.x)<=BOUNDARY_EDGE_PADDING||Math.abs(x1-right)<=BOUNDARY_EDGE_PADDING);}
-  return false;
-}
-function markerPathPoints(d){
-  const parts=d.match(/[a-zA-Z]|[-+]?(?:\d*\.\d+|\d+\.?\d*)(?:e[-+]?\d+)?/gi)||[],points=[];let i=0,cmd='',x=0,y=0;
-  while(i<parts.length){if(/^[a-z]$/i.test(parts[i]))cmd=parts[i++];if(!cmd)break;const upper=cmd.toUpperCase(),relative=cmd===cmd.toLowerCase();
-    if(upper==='M'||upper==='L'){if(i+1>=parts.length||/^[a-z]$/i.test(parts[i]))break;let nx=Number(parts[i++]),ny=Number(parts[i++]);if(relative){nx+=x;ny+=y;}x=nx;y=ny;points.push([x,y]);}
-    else if(upper==='H'){if(i>=parts.length||/^[a-z]$/i.test(parts[i]))break;x=Number(parts[i++])+(relative?x:0);points.push([x,y]);}
-    else if(upper==='V'){if(i>=parts.length||/^[a-z]$/i.test(parts[i]))break;y=Number(parts[i++])+(relative?y:0);points.push([x,y]);}
-    else if(upper==='Z')cmd='';
-    else {while(i<parts.length&&!/^[a-z]$/i.test(parts[i]))i++;cmd='';}
-  }
-  return points;
-}
-function markerDefinitions(svg){
-  const markers=new Map();
-  for(const match of svg.matchAll(/<marker\b([^>]*)>([\s\S]*?)<\/marker>/gi)){
-    const a=attributes(match[1]),id=a.id;if(!id)continue;
-    const points=[];
-    for(const shape of match[2].matchAll(/<(path|polygon)\b([^>]*)>/gi)){
-      const attrsForShape=attributes(shape[2]);
-      if(shape[1].toLowerCase()==='polygon'){
-        const values=(attrsForShape.points||'').match(/[-+]?(?:\d*\.\d+|\d+\.?\d*)(?:e[-+]?\d+)?/gi)||[];
-        for(let i=0;i+1<values.length;i+=2)points.push([Number(values[i]),Number(values[i+1])]);
-      }else if(attrsForShape.d){
-        points.push(...markerPathPoints(attrsForShape.d));
-      }
-    }
-    markers.set(id,{refX:Number(a.refX||0),refY:Number(a.refY||0),units:a.markerUnits||'strokeWidth',width:Number(a.markerWidth||0),height:Number(a.markerHeight||0),points,closed:/\bz\b/i.test(match[2])||/<polygon\b/i.test(match[2])});
-  }
-  return markers;
-}
-function markerOverlapsTarget(route,target,markers){
-  const match=route.markerEnd.match(/url\(\s*["']?#([^\s)'"`]+)["']?\s*\)/i),marker=match&&markers.get(match[1]),segment=route.segments.at(-1);
-  if(!segment)return false;
-  const [x1,y1,x2,y2]=segment,length=Math.hypot(x2-x1,y2-y1)||1,ux=(x2-x1)/length,uy=(y2-y1)/length,nx=-uy,ny=ux;
-  if(!marker?.points.length){const reach=route.strokeWidth;return segmentHitsBox([x2+ux*reach,y2+uy*reach,x2+ux*reach,y2+uy*reach],target,-1);}
-  const scale=marker.units==='userSpaceOnUse'?1:route.strokeWidth;
-  const points=marker.points.map(([x,y])=>[x2+ux*(x-marker.refX)*scale+nx*(y-marker.refY)*scale,y2+uy*(x-marker.refX)*scale+ny*(y-marker.refY)*scale]);
-  if(points.some(([x,y])=>x>target.x+1&&x<target.x+target.w-1&&y>target.y+1&&y<target.y+target.h-1))return true;
-  const segments=points.slice(1).map((point,index)=>[points[index][0],points[index][1],point[0],point[1]]);
-  if(marker.closed&&points.length>2)segments.push([points.at(-1)[0],points.at(-1)[1],points[0][0],points[0][1]]);
-  return segments.some((line)=>segmentHitsBox(line,target,-1));
-}
-function markerFor(route,edge,markers){
-  const value=edge==='end'?route.markerEnd:route.markerStart,match=value.match(/url\(\s*["']?#([^\s)'"`]+)["']?\s*\)/i);
-  return match?markers.get(match[1]):null;
-}
-function markerScale(marker,route){return marker.units==='userSpaceOnUse'?1:route.strokeWidth;}
-function markerHeadLength(marker){
-  if(!marker?.points.length)return 0;
-  const xs=marker.points.map(([x])=>x);
-  return Math.max(...xs)-Math.min(...xs);
-}
-function markerTip(route,marker,edge){
-  const segment=edge==='end'?route.segments.at(-1):route.segments[0];
-  if(!segment)return null;
-  const [x1,y1,x2,y2]=segment,dx=x2-x1,dy=y2-y1,length=Math.hypot(dx,dy)||1,ux=dx/length,uy=dy/length;
-  const anchor=edge==='end'?[x2,y2]:[x1,y1],direction=edge==='end'?1:-1;
-  const forward=marker?.points.length?Math.max(...marker.points.map(([x])=>direction*(x-marker.refX)))*markerScale(marker,route):0;
-  return [anchor[0]+direction*ux*forward,anchor[1]+direction*uy*forward];
-}
-function distanceToBoxBoundary(point,box){
-  const [x,y]=point,candidates=[];
-  if(y>=box.y-ARROWHEAD_TARGET_TOLERANCE&&y<=box.y+box.h+ARROWHEAD_TARGET_TOLERANCE)candidates.push(Math.abs(x-box.x),Math.abs(x-(box.x+box.w)));
-  if(x>=box.x-ARROWHEAD_TARGET_TOLERANCE&&x<=box.x+box.w+ARROWHEAD_TARGET_TOLERANCE)candidates.push(Math.abs(y-box.y),Math.abs(y-(box.y+box.h)));
-  if(candidates.length)return Math.min(...candidates);
-  return Math.hypot(Math.max(box.x-x,0,x-(box.x+box.w)),Math.max(box.y-y,0,y-(box.y+box.h)));
-}
-function decisionBranchQuality(nodes,routes){
-  const issues=[];
-  for(const node of nodes.filter((item)=>item.type==='decision')){
-    if(node.outcomes.length<2){issues.push('DECISION_OUTCOMES_MISSING '+node.id+' must name at least two outcomes');continue;}
-    const labels=new Set(routes.filter((route)=>route.from===node.id).map((route)=>route.label).filter(Boolean));
-    for(const outcome of node.outcomes)if(!labels.has(outcome))issues.push('DECISION_OUTCOME_MISSING '+node.id+' '+outcome);
-    for(const label of labels)if(!node.outcomes.includes(label))issues.push('DECISION_OUTCOME_UNDECLARED '+node.id+' '+label);
-  }
-  return issues;
-}
-
-function routeLength(route){return route.segments.reduce((sum,[x1,y1,x2,y2])=>sum+Math.hypot(x2-x1,y2-y1),0);}
-function routeBends(route){
-  const directions=route.segments.map(([x1,y1,x2,y2])=>{const dx=x2-x1,dy=y2-y1,length=Math.hypot(dx,dy);return length?{x:dx/length,y:dy/length}:null;}).filter(Boolean);
-  let bends=0;
-  for(let i=1;i<directions.length;i++)if(directions[i-1].x*directions[i].x+directions[i-1].y*directions[i].y<Math.SQRT1_2)bends++;
-  return bends;
-}
-function routeManhattanDistance(route){
-  const start=route.segments[0]?.slice(0,2),end=route.segments.at(-1)?.slice(2,4);
-  return start&&end?Math.abs(start[0]-end[0])+Math.abs(start[1]-end[1])||null:null;
-}
-function alignedRouteKind(route,nodes){
-  const from=nodes.find((node)=>node.id===route.from),to=nodes.find((node)=>node.id===route.to);
-  if(!from||!to)return null;
-  const sameRow=Math.abs(from.y+from.h/2-(to.y+to.h/2))<=1,sameColumn=Math.abs(from.x+from.w/2-(to.x+to.w/2))<=1;
-  const horizontal=route.segments.every(([x1,y1,x2,y2])=>Math.abs(y1-y2)<=1),vertical=route.segments.every(([x1,y1,x2,y2])=>Math.abs(x1-x2)<=1);
-  if(sameRow&&nodes.every((node)=>node===from||node===to||Math.abs(node.y+node.h/2-(from.y+from.h/2))>1||node.x+node.w/2<=Math.min(from.x+from.w/2,to.x+to.w/2)||node.x+node.w/2>=Math.max(from.x+from.w/2,to.x+to.w/2))&&!horizontal)return 'same-row';
-  if(sameColumn&&nodes.every((node)=>node===from||node===to||Math.abs(node.x+node.w/2-(from.x+from.w/2))>1||node.y+node.h/2<=Math.min(from.y+from.h/2,to.y+to.h/2)||node.y+node.h/2>=Math.max(from.y+from.h/2,to.y+to.h/2))&&!vertical)return 'same-column';
-  return null;
-}
-function routeCrossesBoundary(route,outline){
-  const points=route.segments.flatMap(([x1,y1,x2,y2])=>[[x1,y1],[x2,y2],[(x1+x2)/2,(y1+y2)/2]]);
-  const inside=points.some(([x,y])=>x>outline.x&&x<outline.x+outline.w&&y>outline.y&&y<outline.y+outline.h);
-  const outside=points.some(([x,y])=>x<outline.x||x>outline.x+outline.w||y<outline.y||y>outline.y+outline.h);
-  return inside&&outside;
-}
-function collinearOverlap(a,b){
-  for(const [ax1,ay1,ax2,ay2] of a.segments)for(const [bx1,by1,bx2,by2] of b.segments){
-    if(Math.abs(ay1-ay2)<=.5&&Math.abs(by1-by2)<=.5&&Math.abs(ay1-by1)<12){if(Math.min(Math.max(ax1,ax2),Math.max(bx1,bx2))-Math.max(Math.min(ax1,ax2),Math.min(bx1,bx2))>=12)return true;}
-    if(Math.abs(ax1-ax2)<=.5&&Math.abs(bx1-bx2)<=.5&&Math.abs(ax1-bx1)<12){if(Math.min(Math.max(ay1,ay2),Math.max(by1,by2))-Math.max(Math.min(ay1,ay2),Math.min(by1,by2))>=12)return true;}
-  }
-  return false;
-}
-function segmentIntersectionPoint(a,b){
-  const rx=a[2]-a[0],ry=a[3]-a[1],sx=b[2]-b[0],sy=b[3]-b[1],denominator=rx*sy-ry*sx;
-  if(Math.abs(denominator)<1e-8)return null;
-  const qx=b[0]-a[0],qy=b[1]-a[1],t=(qx*sy-qy*sx)/denominator,u=(qx*ry-qy*rx)/denominator;
-  if(t< -1e-8||t>1+1e-8||u< -1e-8||u>1+1e-8)return null;
-  return [a[0]+t*rx,a[1]+t*ry];
-}
-function routeEndpoints(route){
-  return [{id:route.from,point:route.segments[0].slice(0,2)},{id:route.to,point:route.segments.at(-1).slice(2,4)}];
-}
-function routeCrossingPoints(a,b){
-  const aEnds=routeEndpoints(a),bEnds=routeEndpoints(b),points=[];
-  for(const first of a.segments)for(const second of b.segments){
-    const point=segmentIntersectionPoint(first,second);
-    if(!point)continue;
-    const sharedNodeEndpoint=aEnds.some((left)=>bEnds.some((right)=>left.id===right.id&&Math.hypot(left.point[0]-right.point[0],left.point[1]-right.point[1])<=.5&&Math.hypot(left.point[0]-point[0],left.point[1]-point[1])<=.5));
-    if(sharedNodeEndpoint||points.some((prior)=>Math.hypot(prior[0]-point[0],prior[1]-point[1])<=.5))continue;
-    points.push(point);
-  }
-  return points;
-}
-function sequenceQuality(source,svg=svgContent(source),nodes=rectangles(svg),routes=parseRoutes(svg)){
-  if(!/\bdata-type\s*=\s*["']sequence(?:-oauth)?["']/i.test(source)&&!/\bid\s*=\s*["']diagram-sequence(?:-oauth)?-[^"']+["']/i.test(svg))return [];
-  const lifelines=new Map();
-  for(const match of svg.matchAll(/<line\b([^>]*)>/gi)){
-    const a=attributes(match[1]),name=a['data-lifeline-for'];
-    if(name&&a['stroke-dasharray']&&Number(a.x1)===Number(a.x2)&&Number(a.y2)>Number(a.y1))lifelines.set(name,{x:Number(a.x1),top:Number(a.y1),bottom:Number(a.y2)});
-  }
-  const issues=[],messages=routes.map((route)=>({route,start:route.segments[0].slice(0,2),end:route.segments.at(-1).slice(2,4),y:(route.segments[0][1]+route.segments.at(-1)[3])/2}));
-  const lastMessageY=Math.max(0,...messages.map((message)=>message.y));
-  for(const node of nodes){
-    const line=lifelines.get(node.id);
-    if(!line){issues.push('SEQUENCE_LIFELINE_MISSING '+node.id);continue;}
-    if(Math.abs(line.x-(node.x+node.w/2))>1||Math.abs(line.top-(node.y+node.h))>1)issues.push('SEQUENCE_LIFELINE_ALIGNMENT '+node.id);
-    if(line.bottom+1<lastMessageY)issues.push('SEQUENCE_LIFELINE_SHORT '+node.id+' ends before last message');
-  }
-  let previousY=-Infinity;
-  for(const message of messages){
-    const from=lifelines.get(message.route.from),to=lifelines.get(message.route.to);
-    if(!from||!to)continue;
-    if(Math.abs(message.start[0]-from.x)>1||Math.abs(message.end[0]-to.x)>1)issues.push('SEQUENCE_MESSAGE_OFF_LIFELINE '+message.route.from+'->'+message.route.to);
-    if(message.y<=previousY)issues.push('SEQUENCE_MESSAGE_ORDER '+message.route.from+'->'+message.route.to+' is not top-to-bottom');
-    previousY=message.y;
-  }
-  return issues;
-}
-
-function visualQuality(source,{enforceCanvas=false,scale=null}={}){
-  const svg=svgContent(source),texts=visibleSvgText(svg),nodes=rectangles(svg),routes=parseRoutes(svg),outlines=boundaryOutlines(svg),markers=markerDefinitions(svg),metrics=sourceMetrics(source),issues=[],sequenceDiagram=/\bdata-type\s*=\s*["']sequence(?:-oauth)?["']/i.test(source);
-  const contaminated=texts.filter((t)=>contamination.some((rule)=>rule.test(t.label))).map((t)=>t.label);
-  if(contaminated.length)issues.push('PROCESS_TEXT '+[...new Set(contaminated)].join(' | '));
-  for(const text of texts.filter((item)=>item.role==='edge'||item.edgeFor)){
-    const matches=routes.filter((route)=>route.from+'|'+route.to===text.edgeFor&&(!route.label||route.label===text.label));
-    if(!text.edgeFor||matches.length!==1){issues.push('EDGE_LABEL_UNBOUND '+(text.edgeFor||text.label));continue;}
-    const own=matches[0],distance=routeDistance(text.anchor,own),nearestOther=Math.min(Infinity,...routes.filter((route)=>route!==own).map((route)=>routeDistance(text.anchor,route)));
-    if(distance>MAX_EDGE_LABEL_ANCHOR_DISTANCE)issues.push('EDGE_LABEL_TOO_FAR '+text.label+' own='+distance.toFixed(1)+'px max='+MAX_EDGE_LABEL_ANCHOR_DISTANCE+'px');
-    if(Number.isFinite(nearestOther)&&distance>=nearestOther)issues.push('EDGE_LABEL_NEAREST_PATH '+text.label+' own='+distance.toFixed(1)+'px other='+nearestOther.toFixed(1)+'px');
-    for(const node of nodes)if(textOverlapsNode(text,node))issues.push('EDGE_LABEL_NODE_COLLISION '+text.label+' overlaps '+node.id);
-  }
-  for(const route of routes){
-    const facing=routeManhattanDistance(route),ratio=facing?routeLength(route)/facing:null,aligned=alignedRouteKind(route,nodes);
-    if(ratio>1.4)issues.push('ROUTE_DETOUR '+route.from+'->'+route.to+' ratio='+ratio.toFixed(2)+' max=1.40');
-    if(aligned)issues.push('ROUTE_ALIGNED_PATH '+route.from+'->'+route.to+' '+aligned+' neighbors require one straight segment');
-    const crossesBoundary=outlines.some((outline)=>routeCrossesBoundary(route,outline)),bendLimit=crossesBoundary?3:2,bends=routeBends(route);
-    if(bends>bendLimit)issues.push('ROUTE_BENDS '+route.from+'->'+route.to+' bends='+bends+' max='+bendLimit);
-    if(route.markerStart&&route.markerEnd)issues.push('ROUTE_OPPOSED_HEADS '+route.from+'->'+route.to);
-    for(const text of texts)for(const segment of route.segments)if(segmentHitsText(segment,text)){issues.push('EDGE_TEXT_COLLISION '+route.from+'->'+route.to+': '+text.label);break;}
-    for(const node of nodes)if(node.id!==route.from&&node.id!==route.to&&route.segments.some((s)=>segmentHitsBox(s,node,8)))issues.push('ROUTE_THROUGH_NODE '+route.from+'->'+route.to+' via '+node.id);
-    for(const outline of outlines)if(route.segments.some((segment)=>segmentAlongOutline(segment,outline))){issues.push('ROUTE_ALONG_BOUNDARY '+route.from+'->'+route.to+' along '+outline.id);break;}
-    const target=nodes.find((node)=>node.id===route.to);
-    for(const edge of ['start','end'])if(edge==='end'?route.markerEnd:route.markerStart){
-      const marker=markerFor(route,edge,markers),minimum=Math.max(ARROWHEAD_STROKE_MULTIPLE*route.strokeWidth,ARROWHEAD_CANVAS_FLOOR*(metrics.viewBox?.w||1080));
-      const length=markerHeadLength(marker)*markerScale(marker||{units:'userSpaceOnUse'},route);
-      if(!marker)issues.push('ARROWHEAD_GEOMETRY_MISSING '+route.from+'->'+route.to+' '+edge);
-      else if(length+0.01<minimum)issues.push('ARROWHEAD_SIZE_FLOOR '+route.from+'->'+route.to+' '+edge+'='+length.toFixed(1)+'px min='+minimum.toFixed(1)+'px (12/1080 canvas, 5x stroke)');
-    }
-    if(route.markerEnd&&target&&!sequenceDiagram){
-      const marker=markerFor(route,'end',markers),tip=markerTip(route,marker,'end');
-      if(tip&&distanceToBoxBoundary(tip,target)>ARROWHEAD_TARGET_TOLERANCE)issues.push('ARROWHEAD_TIP_MISSED_TARGET '+route.from+'->'+route.to+' gap='+distanceToBoxBoundary(tip,target).toFixed(1)+'px max='+ARROWHEAD_TARGET_TOLERANCE+'px');
-    }
-    if(route.markerEnd&&target&&markerOverlapsTarget(route,target,markers))issues.push('ARROWHEAD_TARGET_OVERLAP '+route.from+'->'+route.to+' marker intersects target '+target.id);
-  }
-  issues.push(...decisionBranchQuality(nodes,routes));
-  issues.push(...officeQuality(svg,nodes,texts,outlines));
-  for(let i=0;i<routes.length;i++)for(let j=i+1;j<routes.length;j++){
-    if(collinearOverlap(routes[i],routes[j]))issues.push('ROUTE_COLLINEAR_OVERLAP '+routes[i].from+'->'+routes[i].to+' / '+routes[j].from+'->'+routes[j].to+' shared within 12px');
-    for(const point of routeCrossingPoints(routes[i],routes[j]))issues.push('ROUTE_CROSSING '+routes[i].from+'->'+routes[i].to+' / '+routes[j].from+'->'+routes[j].to+' at '+point[0].toFixed(1)+','+point[1].toFixed(1));
-  }
-  issues.push(...sequenceQuality(source,svg,nodes,routes));
-  for(const text of texts)for(const outline of outlines)if(textHitsOutline(text,outline)){issues.push('OUTLINE_TEXT_COLLISION '+text.label+' crosses '+outline.id);break;}
-  const boundaryTexts=texts.filter((text)=>isBoundaryLabel(text,outlines));
-  const boundaryContrastFailures=boundaryTexts.filter((text)=>metrics.contrastFailures.some((failure)=>failure.text===text.label));
-  for(const text of boundaryContrastFailures)issues.push('BOUNDARY_CONTRAST_FLOOR '+text.label+' below 4.5:1');
-  for(let i=0;i<nodes.length;i++)for(let j=i+1;j<nodes.length;j++)if(gap(nodes[i],nodes[j])<12)issues.push('NODE_GAP '+nodes[i].id+'/'+nodes[j].id+' below 12px');
-  const fontFailures=[];
-  if(enforceCanvas){
-    const ratio=scale??(metrics.viewBox?Math.min(metrics.viewBox.w/1080,metrics.viewBox.h/640):1);
-    if(!texts.some((t)=>t.role==='title'))issues.push('TITLE_ROLE_MISSING visible title must use data-role="title"');
-    for(const t of texts){const boundary=isBoundaryLabel(t,outlines),minimum=t.role==='title'?28:t.role==='edge'||boundary?13:t.role==='node'?15:0;if(minimum&&t.size+0.01<minimum*ratio){const failure=(boundary?'boundary':t.role)+':'+t.label+'='+t.size+'px (min '+(minimum*ratio).toFixed(1)+'px)';if(boundary)issues.push('BOUNDARY_FONT_FLOOR '+failure);else fontFailures.push(failure);}}
-    if(fontFailures.length)issues.push('FONT_FLOOR '+fontFailures.join(' | '));
-    const points=nodes.flatMap((n)=>[[n.x,n.y],[n.x+n.w,n.y+n.h]]).concat(routes.flatMap((r)=>r.segments.flatMap((s)=>[[s[0],s[1]],[s[2],s[3]]])));
-    const box=points.reduce((b,p)=>({left:Math.min(b.left,p[0]),top:Math.min(b.top,p[1]),right:Math.max(b.right,p[0]),bottom:Math.max(b.bottom,p[1])}),{left:Infinity,top:Infinity,right:-Infinity,bottom:-Infinity});
-    if(nodes.length&&metrics.viewBox){const safeWidth=metrics.viewBox.w*.90,safeHeight=metrics.viewBox.h*.74,width=(box.right-box.left)/safeWidth,height=(box.bottom-box.top)/safeHeight;if(width<.75||height<.54)issues.push('CONTENT_FILL safe-area-width='+width.toFixed(3)+' safe-area-height='+height.toFixed(3)+' minimum=.75/.54');}
-    if(!nodes.length)issues.push('CONTENT_NODES_MISSING');
-  }
-  return {issues,contaminated,fonts:fontFailures,nodes:nodes.length,edges:routes.length,edgeLabelMaxAnchorDistance:MAX_EDGE_LABEL_ANCHOR_DISTANCE,arrowheadFloor:{canvas:ARROWHEAD_CANVAS_FLOOR,strokeMultiple:ARROWHEAD_STROKE_MULTIPLE,targetTolerance:ARROWHEAD_TARGET_TOLERANCE},boundaryTexts:boundaryTexts.length};
-}
-export { visualQuality, visibleSvgText, parseRoutes, rectangles, boundaryOutlines, sequenceQuality };

package/.grok/skills/lit-docx/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 wjgoarxiv
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/.grok/skills/lit-docx/NOTICE.md

@@ -1 +0,0 @@
-The publisher-docx engine and templates are user-authored work by wjgoarxiv, provided under the MIT License in this directory. This LitGrok port adapts its entry points and guidance to Grok Build.

package/.grok/skills/lit-docx/examples/01-report-ko.md

@@ -1,137 +0,0 @@
----
-title: 본사 옥상 태양광 설비 1년 운영 결과
-subtitle: 2025년 10월~2026년 9월 발전 실적, 전기요금 절감과 2027년 보완 계획
-author: 시설관리팀 에너지파트
-organization: 예시 주식회사
-date: 2026-10-05
-short_title: 옥상 태양광 1년 운영 결과
-notice: "예시 데이터: 회사명, 설비 용량, 금액은 모두 가정입니다. 실제 수치로 바꿔 주세요"
-tonality: Report
----
-
-::: cover variant=masthead kicker="운영 결과 보고"
-본사 옥상 태양광 설비를 가동한 첫 1년의 발전량, 자가소비 비율, 전기요금 절감액, 고장 이력을 정리하고 2027년 보완 공사와 예산 요청을 함께 담았다.
-:::
-
-# 요약
-
-옥상 태양광 설비는 1년 동안 312MWh를 생산해 본사 연간 전력 사용량의 8.4%를 대체했다. 설계 단계에서 예측한 발전량 298MWh보다 4.7% 많다. 생산한 전력은 대부분 건물 안에서 바로 썼고, 휴일 낮에 남은 전력만 한전 계통으로 보냈다.
-
-::: keyfigures
-- **312MWh** 연간 발전량 (예시)
-  * 2025. 10.~2026. 9. 인버터 누적 기록
-- **8.4%** 본사 전력 사용량 대비 (예시)
-  * 같은 기간 수전 계량기 기준
-- **4,180만 원** 전기요금 절감액 (예시)
-  * 계시별 요금 적용, 부가세 제외
-:::
-
-절감액은 투자비 회수 계획의 연간 목표 3,900만 원을 넘었다. 다만 여름철 한낮에 모듈 온도가 올라 출력이 떨어지는 시간이 예상보다 길었고, 동쪽 구역 인버터 1대가 두 차례 멈춰 11일 동안 발전량 손실이 있었다. 2027년 상반기에 인버터 교체와 모듈 세척 주기 조정을 진행하며, 이에 필요한 예산 2,600만 원의 승인을 요청한다.
-
-# 설비 개요
-
-## 설치 규모와 구성
-
-설비는 본관과 별관 옥상 두 곳에 나뉘어 있다. 본관에는 모듈 540장(설비 용량 248kW), 별관에는 모듈 160장(73kW)이 남향 15도 경사로 놓였다. 인버터는 본관 4대, 별관 1대이며, 각 인버터의 출력은 지하 2층 수전반에서 건물 부하와 합쳐진다.
-
-표 1. 구역별 설비 구성 (예시)
-
-| 구분 | 본관 옥상 | 별관 옥상 | 합계 |
-| --- | ---: | ---: | ---: |
-| 모듈 수 (장) | 540 | 160 | 700 |
-| 설비 용량 (kW) | 248 | 73 | 321 |
-| 인버터 (대) | 4 | 1 | 5 |
-| 설치 면적 (㎡) | 1,620 | 480 | 2,100 |
-
-자료: 시설관리팀 준공 도서(2025. 9.)
-
-## 계량과 기록 방식
-
-발전량은 인버터별 누적 계량값을 15분 간격으로 원격 수집한다. 건물 사용량은 한전 수전 계량기와 내부 부하 계량기를 함께 읽는다. 두 값의 차이로 자가소비량과 역송량을 계산하며, 월말에 한전 청구서와 대조해 오차가 1%를 넘으면 원인을 찾는다. 1년 동안 오차가 1%를 넘은 달은 2026년 2월 한 번뿐이었고, 원인은 계량기 통신 장애로 확인했다.
-
-# 발전 실적
-
-## 월별 발전량
-
-발전량은 5월에 가장 많았고 12월에 가장 적었다. 일사량이 가장 많은 달은 6월이었지만, 장마가 일찍 시작된 데다 모듈 온도가 높아 5월 실적에 못 미쳤다. 겨울철에는 해가 낮아 별관 옥상 일부가 본관 그림자에 가렸다. 아래 표의 예측값은 설계 시뮬레이션의 월별 값을 분기로 합한 것이다.
-
-표 2. 분기별 발전량과 예측 대비 실적 (예시)
-
-| 분기 | 예측 (MWh) | 실적 (MWh) | 예측 대비 (%) |
-| --- | ---: | ---: | ---: |
-| 2025년 4분기 | 58 | 61 | 105.2 |
-| 2026년 1분기 | 66 | 69 | 104.5 |
-| 2026년 2분기 | 94 | 101 | 107.4 |
-| 2026년 3분기 | 80 | 81 | 101.3 |
-| 합계 | 298 | 312 | 104.7 |
-
-자료: 인버터 원격 감시 기록
-
-3분기 실적이 예측과 거의 같았던 것은 8월 인버터 정지의 영향이다. 정지가 없었다면 3분기 실적은 약 85MWh로 추정되며, 이 경우 연간 실적은 예측보다 6% 정도 많았을 것이다.
-
-## 자가소비와 역송
-
-생산 전력의 93%를 건물 안에서 바로 썼다. 평일 낮에는 사무 부하와 냉방 부하가 발전량보다 커서 남는 전력이 거의 없다. 역송은 주로 토요일과 공휴일 낮에 생겼고, 1년 동안 모두 22MWh였다. 역송 전력은 상계 거래로 처리해 다음 달 요금에서 차감했다.
-
-## 효율 저하 요인
-
-출력을 깎은 요인은 세 가지였다. 첫째는 여름철 모듈 온도다. 7월과 8월 한낮에 모듈 표면 온도가 65도를 넘은 시간이 하루 평균 3.2시간이었고, 이 시간대 출력은 정격의 78% 수준에 머물렀다. 둘째는 먼지와 새 배설물이다. 봄철 황사 이후 세척 전후의 출력 차이가 4% 안팎으로 측정됐다. 셋째는 겨울철 별관 그림자로, 12월과 1월 오전 10시 이전에는 별관 모듈 중 40장 정도가 그늘에 들었다.
-
-# 비용과 절감 효과
-
-## 전기요금 절감액
-
-절감액은 자가소비량에 해당 시간대 요금 단가를 곱한 값과 상계 처리된 역송 금액을 더해 계산했다. 여름철 낮 시간대 단가가 높아 6~8월 세 달의 절감액이 연간 절감액의 36%를 차지했다.
-
-표 3. 절감액과 운영비 (예시)
-
-| 항목 | 금액 (만 원) | 비고 |
-| --- | ---: | --- |
-| 자가소비 절감액 | 3,890 | 계시별 단가 적용 |
-| 역송 상계 금액 | 290 | 22MWh |
-| 유지보수 계약비 | 480 | 연 1회 정밀 점검 포함 |
-| 모듈 세척비 | 120 | 연 3회 |
-| 순절감액 | 3,580 | 절감액에서 운영비를 뺀 값 |
-
-자료: 재무팀 전기요금 정산 자료, 시설관리팀 계약 대장
-
-## 투자비 회수 전망
-
-설치 투자비는 5억 1,000만 원이었다. 첫해 순절감액 3,580만 원이 그대로 유지된다고 보면 회수에는 약 14년이 걸린다. 그러나 전기요금 단가는 2026년에만 두 차례 올랐고, 모듈 출력은 해마다 0.5% 정도씩 낮아진다. 두 요인을 함께 넣은 재무팀 추정으로는 회수 기간이 12~13년이다.
-
-::: callout kind=note title="회수 기간 추정의 전제"
-요금 단가는 연 3% 상승, 모듈 출력은 연 0.5% 저하, 유지보수비는 연 2% 상승을 가정했다. 단가 상승률이 연 1%에 그치면 회수 기간은 15년으로 늘어난다.
-:::
-
-# 운영상 문제와 대응
-
-## 인버터 정지
-
-동쪽 구역 3번 인버터가 2026년 3월과 8월 두 차례 과열 경보로 멈췄다. 3월에는 하루 만에 재가동했지만, 8월에는 냉각 팬 부품을 해외에서 들여오느라 10일이 걸렸다. 국내 재고가 없었다. 두 번의 정지로 잃은 발전량은 약 5MWh, 금액으로는 70만 원 정도다. 제조사는 같은 모델의 냉각 팬 결함을 인정하고 2027년 1분기 안에 무상 교체를 약속했다. 그러나 팬만 바꾸면 설치 위치의 환기 부족은 그대로 남는다.
-
-## 세척 주기
-
-계약상 세척은 연 3회(3월, 6월, 10월)였다. 문제는 시기다. 황사가 심했던 4월과 꽃가루가 많았던 5월 사이에는 세척 전후 출력 차이가 4%를 넘었다. 세척 시기를 황사 직후로 옮기고 여름 장마 전 한 번을 추가하면, 연간 발전량이 1.5% 정도 늘 것으로 본다. 세척 업체와는 2026년 12월 계약 갱신 때 횟수와 시기를 함께 바꾸기로 협의했고, 추가 1회 비용은 기존 단가인 회당 40만 원을 그대로 적용하기로 했으며, 황사 특보가 사흘 이상 이어진 주에는 업체가 먼저 일정을 제안하도록 계약서에 넣기로 했다.
-
-## 안전 관리
-
-옥상 출입은 시설관리팀 승인을 받은 인원만 가능하고, 출입 기록은 보안실 출입 통제 시스템에 남는다. 1년 동안 안전사고는 없었다. 외부 세척 업체 작업자도 작업 당일 현장 안전교육을 받고 추락 방지 장비를 점검받은 뒤에만 옥상에 올라갔으며, 교육 기록과 장비 점검표는 시설관리팀이 작업일마다 받아 보관했다. 다만 별관 옥상 난간 높이가 기준보다 10cm 낮아 2026년 6월에 임시 안전망을 설치했다.
-
-# 2027년 보완 계획과 예산
-
-## 보완 과제
-
-보완 과제는 세 가지다. 3번 인버터를 환기가 되는 위치로 옮기면서 냉각 팬을 교체하고, 세척 주기를 연 4회로 늘리며, 별관 옥상 난간을 기준 높이로 높인다. 그늘 문제는 모듈 배치를 바꿔야 해결되므로 비용 대비 효과를 따져 2028년에 다시 검토한다.
-
-표 4. 2027년 보완 예산 요청 (예시)
-
-| 과제 | 시기 | 금액 (만 원) |
-| --- | --- | ---: |
-| 3번 인버터 이설과 환기 덕트 | 2027년 1분기 | 1,450 |
-| 세척 1회 추가(연 4회) | 2027년 6월 | 40 |
-| 별관 옥상 난간 보강 | 2027년 2분기 | 1,110 |
-| 합계 | | 2,600 |
-
-## 기대 효과
-
-인버터 이설과 세척 주기 조정으로 연간 발전량이 2~3% 늘면, 절감액은 연 80만~120만 원 정도 늘어난다. 금액만 보면 크지 않다. 그러나 같은 고장이 되풀이되면 한 번에 10일 이상 발전이 멈출 수 있고, 난간 보강은 법정 안전 기준을 맞추기 위한 공사다. 예산이 승인되면 2027년 1월에 업체를 선정하고, 공사는 발전량이 적은 2월 안에 마친다.

package/.grok/skills/lit-docx/examples/02-brief-ko.md

@@ -1,82 +0,0 @@
----
-title: 사내 메신저 전환 검토 보고
-subtitle: 현행 계약 만료에 따른 대안 비교와 2027년 1분기 전환안
-author: 정보전략팀
-organization: 예시 공사
-date: 2026-10-05
-short_title: 사내 메신저 전환 검토
-notice: "예시 데이터: 기관명, 인원, 금액은 모두 가정입니다. 실제 수치로 바꿔 주세요"
-tonality: Brief
----
-
-::: cover variant=masthead kicker="검토 보고"
-:::
-
-::: callout kind=key title="결정 요청"
-현행 메신저 계약을 연장하지 않고 2027년 3월 말까지 그룹웨어 내장 메신저(안 2)로 전환하는 안, 그리고 전환 비용 3,200만 원(예시)을 2026년 4분기 정보화 예비비에서 집행하는 안의 승인을 요청한다.
-:::
-
-# 요약
-
-안 2로 전환하면 3년간 1억 1,400만 원을 아낀다. 현행 메신저를 3년 더 쓰는 비용은 2억 400만 원이고, 그룹웨어 내장 메신저는 전환비를 포함해 9,000만 원이다(예시).
-
-기능 손실은 크지 않다. 직원 1,240명의 최근 6개월 사용 기록을 보면 대화, 파일 전송, 화상 통화가 전체 사용의 96%를 차지하며, 세 기능 모두 내장 메신저에 있다.
-
-보안 요건도 충족한다. 내장 메신저는 사내 서버에 대화를 저장하고, 2026년 8월 보안 진단에서 지적 사항 없이 통과했다.
-
-위험은 전환 기간의 혼선이다. 대화 기록 이관과 외부 협력사 계정 재발급에 6주가 걸리므로, 2027년 1월 첫 주에 착수해야 3월 말 계약 만료 전에 끝난다.
-
-# 검토 배경
-
-- 현행 메신저 계약 만료일 2027. 3. 31., 연장 시 사용료 연 18% 인상 통보 받음
-- 그룹웨어는 2025년 교체 때 메신저 기능을 포함해 계약, 현재 사용하지 않는 상태
-- 두 메신저를 함께 쓰는 부서가 생겨 업무 요청 누락 사례가 분기마다 보고됨
-- 2026년 7월 경영진 회의에서 메신저 일원화 검토를 지시
-
-# 대안 비교
-
-표 1. 대안별 3년 비용과 주요 특성 (예시)
-
-| 구분 | 안 1 현행 연장 | 안 2 그룹웨어 내장 | 안 3 신규 도입 |
-| --- | ---: | ---: | ---: |
-| 3년 사용료 (만 원) | 20,400 | 5,800 | 13,500 |
-| 전환비 (만 원) | 0 | 3,200 | 4,600 |
-| 3년 합계 (만 원) | 20,400 | 9,000 | 18,100 |
-| 대화 서버 위치 | 외부 | 사내 | 외부 |
-| 전환 기간 | 없음 | 6주 | 10주 |
-
-자료: 업체 견적(2026. 9.), 정보전략팀 산출
-
-- 안 1은 전환 부담이 없으나 비용이 가장 크고, 인상분이 매년 반복될 가능성 있음
-- 안 2는 비용이 가장 적고 대화가 사내 서버에 남음. 화면 공유 중 원격 제어 기능은 없으나 사용 비중 0.4%로 원격 지원 도구로 대체 가능
-- 안 3은 기능이 가장 많으나 비용과 전환 기간 모두 안 2보다 불리함
-
-# 전환 일정과 위험
-
-## 추진 일정
-
-- 2027년 1월 1주: 전환 공지, 부서별 담당자 지정
-- 2027년 1월 2~4주: 최근 1년 대화 기록 이관, 협력사 계정 380개 재발급
-- 2027년 2월: 두 메신저 병행 운영, 현행 메신저는 읽기 전용으로 전환
-- 2027년 3월 2주: 현행 메신저 종료, 3월 말 계약 만료
-
-## 위험 대응
-
-- 대화 기록 이관 누락: 이관 전후 건수를 부서별로 대조하고, 원본은 계약 만료 후 1년간 보관
-- 협력사 계정 재발급 지연: 협력사별 담당자 목록을 12월 중 먼저 확보
-- 병행 기간의 요청 누락: 2월부터 업무 요청은 내장 메신저로만 받도록 부서장 회의에서 공지
-
-# 소요 예산
-
-표 2. 전환 비용 내역 (예시)
-
-| 항목 | 금액 (만 원) |
-| --- | ---: |
-| 대화 기록 이관 용역 | 1,800 |
-| 협력사 계정 발급과 인증 설정 | 700 |
-| 사용자 교육과 안내 자료 | 400 |
-| 예비비 | 300 |
-| 합계 | 3,200 |
-
-- 집행 재원: 2026년 4분기 정보화 예비비(잔액 5,100만 원)
-- 2027년 이후 사용료는 그룹웨어 유지보수 계약에 포함