create-yss-spec 2.1.4 → 2.1.6

package/template/.codex/skills/beautiful-article/theme-profiles/sottsass.md

@@ -1,57 +0,0 @@
-# Theme Profile · sottsass（孟菲斯 / 80s 撞色）
-
-> 这是给 **AI 写作时读** 的 authoring profile，不是 CSS。CSS token 由组件库
-> 运行时主题持有（`data-theme="sottsass"`）。本文件是"如何选择和使用这个主题"。
-> 详尽版本见组件库 canonical md：`src/theme/themes/sottsass/sottsass.md`（写代码 /
-> 公式 / 媒体 / Raw 前请读它）。
-
-- **runtime theme id**：`sottsass`（`<ThemeProvider theme="sottsass">`）
-- **气质**：后现代 / 孟菲斯（米兰 1981）。暖奶油纸、黑墨，故意撞色的孟菲斯粉彩
-  （艳粉 / 青绿 / 阳光黄 / 钴蓝）。识别度来自 80s 游戏感：无模糊硬投影、轻微旋转、
-  圆角彩色药丸、波浪下划线、几何彩屑。响亮欢快但仍可读。
-
-## 适合 / 不适合的文章类型
-
-- **适合**：好玩的科普 / 解释、设计 / 文化 / 潮流写作、发布与活动稿、轻松上手；
-  "个性大于精致"、敢撞色不端着的内容。
-- **不适合**：学术（`knuth`）、黑白大刊（`bodoni`）、冷调规格（`vignelli`）、
-  暗底工程（`shannon` / `fuller`）、严肃克制内容、安静治愈（`andy` 更柔）、幻灯片。
-
-## 排版气质
-
-- 标题 / 标签用 Space Grotesk（顽皮几何），正文用 Hanken Grotesk（干净 grotesque）。
-- 正文 ~17px，行距 1.65；display 字重 700；强调不用斜体（协议级禁用），用色块 / 高亮。
-- **撞色是表达、钴蓝是结构**：链接 / 序号固定钴蓝（可读）；粉 / 青 / 黄只作大胆填充，绝不作小字。
-
-## Raw 风格
-
-像一页孟菲斯海报式的图解。
-
-- 约束的是**气质**（撞色块、无模糊硬投影、混合圆角、轻旋转、彩屑 / 波纹），不是**媒介**。
-- 典型：硬投影卡片、撞色几何图、彩屑 / 波纹装饰、旋转标签、明快的比例 / 步骤图。
-- 构图：黑描边 + 偏移硬投影 + 撞色 + 混合圆角；可轻微旋转。
-- 动效：带回弹的弹入 / 位移；避免无限霓虹循环。
-
-## 媒体（图片 / 视频 / 音频）风格
-
-- 适合：几何彩屑插画、撞色海报、波纹 / 水磨石纹理、硬投影拼贴、明快人物 / 静物。
-- 构图大胆撞色、可旋转 / 不对称、黑描边 + 硬投影；caption 简洁俏皮；必配 alt。
-- 色彩粉 / 青 / 黄 / 蓝撞色 + 黑白；不用柔光渐变与霓虹。
-
-## 代码 / 公式风格
-
-- `CodeBlock` 像潮流杂志的代码卡片：暖浅 surface + 黑边 + 适度圆角，可有硬投影；不用暗终端。
-- Prism token：标签 / 函数走钴蓝，关键字走红玫 risk，字符串走青 success；撞色在边框 / 高亮，不在语法色彩虹。
-- `Formula` 可有圆角 surface 与一抹色，克制对齐。
-
-## 禁止项
-
-- 把粉 / 青 / 黄当正文 / 小字 / 链接色（可读结构固定钴蓝）。
-- 柔光模糊阴影（本主题用无模糊硬投影）、廉价渐变、霓虹。
-- "撞色 + 硬投影"用力过猛到读不下去（仍要保证正文从容可读）。用斜体强调（协议级禁用）。
-
-## 不同信息密度下的表现建议（建议，非限制）
-
-- `100% 好玩 explainer`：撞色长文 + 旋转章节块 + 硬投影 callout + 彩屑点缀，正文为主体。
-- `60-80% 内容`：保留关键硬投影卡 + 撞色图解，波浪下划线点睛。
-- `40% briefing`：Raw 偏撞色比例 / 步骤图，文字更短，仍是孟菲斯形态。

package/template/.codex/skills/beautiful-article/theme-profiles/tufte.md

@@ -1,64 +0,0 @@
-# Theme Profile · tufte（Data-Ink）
-
-> 这是给 **AI 写作时读** 的 authoring profile，不是 CSS。CSS token 由组件库
-> 运行时主题持有（`data-theme="tufte"`）。本文件是"如何选择和使用这个主题"。
-> 详尽版本见组件库 canonical md：`src/theme/themes/tufte/tufte.md`（写代码 /
-> 公式 / 媒体 / Raw 前请读它）。
-
-- **runtime theme id**：`tufte`（`<ThemeProvider theme="tufte">`）
-- **气质**：Edward Tufte 数据墨水比。页面上每一滴墨水都承载信息。去除卡片、
-  填色、阴影、圆角、装饰色。留下文字、发丝级参考线、充裕页边、由排版承载的含义。
-
-## 适合 / 不适合的文章类型
-
-- **适合**：`longform`、`full-report`、`explainer`、`review`（技术 / 数据型）、
-  `tutorial`。以论点与证据为主角的长文阅读。
-- **不适合**：需要 10 米外观看的幻灯片（正文字号刻意偏小）；移动端优先且需要大量
-  边注的场景。
-
-## 排版气质
-
-- 正文与标题用老式（old-style）衬线（et-book → Palatino / Georgia / 宋体），字重 400。
-- 标签 / 注释 / 表头用人文 sans，小字号。
-- 正文刻意偏小（~16px），行距 1.6；标题层级克制（h1≈2.5rem，h2≈1.7rem）。
-- 强调靠字重 / 颜色 / 间距，不靠斜体（协议级禁用斜体），不靠厚黑体。
-
-## Raw 风格
-
-像作者为当前段落手画的一张小图，不是营销组件。
-
-- 约束的是**气质**（克制、线条化、数据密集、低装饰），不是**媒介** —— 可用任意
-  HTML / CSS / React，按需才用 SVG / canvas。
-- 典型：细线折线 / 散点 / slopegraph、小坐标轴、可拖动阈值线、局部高亮、文本旁注、
-  微型 sparkline、轻量可调参数控件、紧凑对照排版。
-- 构图：少填充、多线条；信息密度可以高，但每条线 / 每个元素都要有含义。
-- 动效：默认无；必须交互时只用即时响应或极轻过渡，不用弹跳 / 漂浮 / 循环装饰。
-- 颜色 / 字体 / 间距必须取自 `--ra-*`，不自造 palette。
-
-## 媒体（图片 / 视频 / 音频）风格
-
-- 适合：真实数据图、论文 / 报告截图、表格截屏、产品界面局部、低饱和摄影、黑白或
-  暖纸感线稿、地图 / 时间轴 / 细线示意图。
-- 构图留白充足、主体清楚、边缘干净；必须配清晰 caption / source / alt。
-- 截图优先裁掉浏览器 chrome。
-
-## 代码 / 公式风格
-
-- `CodeBlock` 像正文里的精密标本：纸面轻 surface + 发丝线，不用深色编辑器壳 / 发光边框 /
-  彩色标题栏。行号可见但退后。
-- Prism token 色从主题派生：结构 / 标签用青灰 accent，关键字 / 警示用暖红 risk，
-  字符串用低饱和绿。
-- `Formula` 像正文里的数学标注，块级公式只用发丝线与留白承载。
-
-## 禁止项
-
-- 卡片、面板、填色块、投影、圆角；比 `#D8D2C2` 更深的网格线。
-- emoji / 图标当装饰；色彩用于"承载含义"以外的任何用途。
-- 库存感 hero 图、3D 插画、渐变背景、装饰光斑、强饱和科技蓝紫、卡通人物。
-- 在 Raw 里写出与 Data-Ink 相反的装饰性组件（仪表盘大屏、粒子背景、玻璃拟态）。
-
-## 不同信息密度下的表现建议（建议，非限制）
-
-- `100% longform / full-report`：克制长文为主，Raw 点亮关键概念，数据证据优先。
-- `60-80% explainer / review`：保留核心证据 + 图解，正文仍是主体。
-- `40% visual-essay`：仍成立，但 Raw 应偏图解 / 证据、低装饰，文字更短。

package/template/.codex/skills/beautiful-article/theme-profiles/vignelli.md

@@ -1,63 +0,0 @@
-# Theme Profile · vignelli（瑞士国际主义文档）
-
-> 这是给 **AI 写作时读** 的 authoring profile，不是 CSS。CSS token 由组件库
-> 运行时主题持有（`data-theme="vignelli"`）。本文件是"如何选择和使用这个主题"。
-> 详尽版本见组件库 canonical md：`src/theme/themes/vignelli/vignelli.md`（写代码 /
-> 公式 / 媒体 / Raw 前请读它）。
-
-- **runtime theme id**：`vignelli`（`<ThemeProvider theme="vignelli">`）
-- **气质**：瑞士国际主义排版。ReActicle **唯一的 sans 正文 + 冷中性**主题。冷中性纸、
-  一个 grotesque 字族在不同字号上建立层级、发丝网格线、一抹瑞士红、等宽体承载元数据。
-  完整继承结构纪律（以线代框、去垃圾表格、色彩承载含义）。
-
-## 适合 / 不适合的文章类型
-
-- **适合**：`docs` / 产品文档、`spec` / 技术规格、`changelog` / release notes、
-  `reference` / SDK·API 参考、AI 工具 / 平台文档、`explainer`、`tutorial`。
-  需要强结构、可扫读的中性内容。
-- **不适合**：温暖叙事（`press`）；正式学术论文（`knuth`）；暗底工程现场（`shannon`）；幻灯片。
-
-## 排版气质
-
-- 正文与标题用单一 grotesque 字族（Söhne → Aktiv Grotesk → Helvetica Neue → Arial），
-  **靠字号与留白、而非堆字重**建立层级。
-- 标签 / 表头用同一字族小字号；元数据 / 代码用等宽体作 metadata "chip"（以线与字重呈现，
-  绝不做成彩色胶囊或卡片）。
-- 正文 ~17px，行距 1.6；大标题带负字距保持紧致。强调不用斜体（协议级禁用）。
-
-## Raw 风格
-
-像一页严格按网格设计的系统文档插图。
-
-- 约束的是**气质**（冷中性、强网格、系统化、可扫读），不是**媒介**。
-- 典型：网格示意、流程 / 状态图、规格对照表、键盘 / 快捷键图、可切换参数说明、
-  带 mono 标注的 SVG。
-- 构图：强网格对齐、清晰层级、瑞士红作识别线索；填色克制、服务理解。颜色只用 `--ra-*`。
-- 动效：允许短促干脆的一次性过渡（~120ms）；避免无限循环装饰。
-
-## 媒体（图片 / 视频 / 音频）风格
-
-- 适合：界面截图（裁净 chrome）、信息图 / 流程图 / 网格示意、图标系统说明、线框 / 规格图、
-  低饱和中性摄影。
-- 构图强网格对齐、留白克制、主体清楚；caption 简洁说明来源；必须配 alt。
-- 色彩贴近冷中性体系，强调只用瑞士红承载信息。
-
-## 代码 / 公式风格
-
-- `CodeBlock` 像排版严谨的技术规格：冷纸浅 surface + 发丝线，不用暗色编辑器窗口。行号克制。
-- Prism token 从主题派生：标签 / 函数用瑞士红 accent（克制），关键字 / 风险用 risk 深红，
-  字符串用绿，其余走墨色 / muted。
-- `Formula` 像规格里的公式：克制、对齐、发丝线与留白承载。
-
-## 禁止项
-
-- 卡片、面板、填色块、投影、圆角、**彩色左边框强调卡**（被点名的 slop）。
-- 把瑞士红当装饰；第二个红色用于"警示"以外；用堆字重代替字号层级。
-- 紫粉渐变 SaaS hero、霓虹、Tailwind 默认味、emoji / 图标当装饰、3D 渲染图标。
-- Raw / 媒体变成营销落地页或仪表盘大屏。
-
-## 不同信息密度下的表现建议（建议，非限制）
-
-- `100% docs / reference`：系统化长文 + 规格表 + 网格图，正文为主体。
-- `60-80% spec / changelog`：保留关键规格 + 流程图，mono 元数据带扫读友好。
-- `40% briefing`：Raw 偏网格图解，文字更短，仍是文档形态。

package/template/.codex/skills/drawio/.mcp.json

@@ -1,8 +0,0 @@
-{
-  "mcpServers": {
-    "drawio": {
-      "command": "npx",
-      "args": ["--yes", "@next-ai-drawio/mcp-server@0.4.13"]
-    }
-  }
-}

package/template/.codex/skills/drawio/CHANGELOG.md

@@ -1,216 +0,0 @@
-# Changelog — drawio base skill
-
-## Unreleased
-
-### Upstream capability integration
-
-Offline capabilities ported from upstream `drawio-skill` behind the canonical
-boundary; committed at version `2.7.0` but not yet cut as a tagged release.
-
-- Config and IaC importers: Terraform, Kubernetes, Compose, SQL DDL, OpenAPI,
-  GitHub Actions, and GitLab CI adapters (`--input-format terraform` /
-  `kubernetes` / `compose` / `sql` / `openapi` / `github-actions` / `gitlab-ci`),
-  each projected to `CanonicalGraphProjection v1` with stable declared identity;
-  optional isolated Python worker (`python-hcl2`, `sqlglot`) for HCL/SQL, offline.
-- Code relationship importers: Python imports/classes, JavaScript/TypeScript ESM,
-  Go, and Rust adapters over a bounded local project directory, using pinned
-  optional parsers and never invoking a language toolchain, Cargo, or Graphviz.
-- Live snapshots and architecture drift: saved Terraform state/plan, Docker
-  inspect, and Kubernetes live JSON adapters plus a deterministic drift comparator
-  and renderer over stable node/edge identity; no provider CLI, daemon, or cluster
-  capture (real provider, daemon, and cluster evidence remain missing).
-- Offline AI icon catalog: 309 fixed, licensed, offline `lobe.*` / `ai.*` brand
-  SVGs with deterministic aliases through the shared `icon-resolver.js`, replacing
-  CDN lookup; catalog, security, render, and Desktop-fixture checks
-  command-executed (visual-model review remains missing evidence).
-- Multi-page canonical bundle v1: stable page and object identity, structured
-  page links, per-page validation, and an `--all-pages --export-spec` round-trip
-  through a single `<mxfile>` and arch v2 sidecar (Desktop multi-page export
-  remains missing evidence).
-- Postprocess suite: offline `mermaid`, `explain`, `relabel`, `restyle`,
-  `heatmap`, and script-free self-contained `html`, each writing a
-  `*.postprocess.json` provenance sidecar. The shipped surface is exactly those
-  six; runbook, animated SVG, tube/sequence layout, compression, buildup, PPTX,
-  timelapse, and PR diff remain deferred, not hidden commands.
-- Structured raster extraction: `--input-format raster-extraction` normalizes a
-  strict, versioned, model- or human-produced extraction JSON into a canonical
-  spec, then reuses canonical validation, ELK, renderer, and sidecars (OCR and
-  model fidelity remain missing evidence).
-- SysML/BPMN stencils: searchable `mxgraph.sysml.*` and `mxgraph.bpmn.*` base
-  names in the bundled catalog; source-row counts are not capability counts and
-  nested constructs remain deferred.
-
-### Packaging, provisioning docs, and slimmer entrypoint
-
-- Release zips now contain exactly git-tracked content, with in-recipe
-  self-checks, so local scratch can no longer leak into archives.
-- Documented the tracked `.mcp.json` live-refinement provisioning (pinned
-  version, npx network behavior, offline independence) in SKILL.md and
-  mcp-tools.md.
-- Added an indexed examples catalog (`references/examples/README.md`) and
-  palette swatch template/schema pointers; removed two stale legacy docs
-  (`examples.md`, `drawio-aesthetic-guide.md`).
-- Recorded the first base eval baseline (97.2 dry_run in
-  `evals/darwin-results.tsv`) plus a post-slim no-regression spot check.
-- Style presets: documented user-first lookup precedence and unknown-name
-  errors (no silent fallback), closing both eval e08 governance gaps.
-- Slimmed the SKILL.md initial load by 36% (21.8KB -> 14.0KB) with all
-  behavior contracts preserved; added `agents/openai.yaml` packaging parity.
-
-## 2.7.0 (2026-07-14)
-
-### Palette system
-
-- Added 15 metadata-backed academic, engineering, and general palettes that
-  compose independently with themes through `meta.palette` and `$paletteN`
-  color tokens.
-- Added user palette loading, deterministic swatch previews, structured
-  colorblind/grayscale/print diagnostics, and intent-gated palette selection
-  with source-color preservation for replication.
-
-## 2.6.0 (2026-07-14)
-
-### Open arrowheads by default
-
-- Flow connectors (`primary`, `data`, `control`, `memory_read`, `memory_write`,
-  `feedback`) and the untyped-edge fallback now default to an open head
-  (`endArrow=open`, unfilled "V") instead of a filled `block`. Applied in the base
-  connector map (`scripts/dsl/spec-to-drawio.js`), the AH adapter, and all 11 theme
-  JSONs under `assets/themes/`.
-- Open heads keep the bold `endSize=12` for visibility on 2px connectors;
-  `optional`/`async` (already open) now also receive `endSize=12`.
-- `endFill` now follows the arrowhead's own convention: an explicit `endArrow=block`
-  renders filled again, while UML/ER markers (inheritance `block;endFill=0`,
-  composition `diamond;endFill=1`) and `dependency` diamonds are untouched.
-- `block`/`classic` heads remain available on explicit request.
-
-### Default export: 300dpi PNG
-
-- The default delivered image is now a **300dpi PNG** via draw.io Desktop instead of a
-  standalone SVG. `cli.js` gains `--dpi` (default 300; scale = `dpi / 96` passed to Desktop for
-  raster formats only), and `buildDrawioExportArgs` adds `-s <scale>` for PNG/JPG.
-- When draw.io Desktop is unavailable, a requested PNG/PDF/JPG automatically falls back to a
-  standalone SVG with a stderr warning (exit 0), preserving offline authoring.
-- SVG, PDF, and JPG remain available on explicit request.
-
-### Architecture design language (arch-dark)
-
-- New built-in theme `assets/themes/arch-dark.json`: slate-950 background with
-  role-coded semantic colors (cyan frontend, emerald backend, violet database,
-  amber cloud, orange message bus, rose security accents), adapted from
-  architecture-diagram-generator v1.1 (MIT, Cocoon AI); attribution in
-  `assets/licenses/architecture-diagram-generator-MIT.txt`.
-- New reference `references/docs/architecture-diagrams.md`: role-to-type
-  mapping, two-line component labeling, dashed amber region / rose security
-  group boundary conventions via module style overrides, message-bus gap
-  placement, legend-outside-boundaries rule, and module headroom guidance.
-- New `architecture` task route in SKILL.md wiring the design language into
-  the create flow; frontmatter description unchanged.
-- Three ported examples: `arch-dark-web-app.yaml`,
-  `arch-dark-aws-serverless.yaml`, `arch-dark-microservices.yaml`, all clean
-  under `--validate` (0 node crossings).
-
-## 2.5.0 (2026-07-07)
-
-Replication-quality round driven by an original-vs-replica comparison (industrial
-architecture figure): straight native connectors, transparent text, faithful
-vertical CJK labels.
-
-### Straight orthogonal routing
-
-- `buildRoutedEdges` resolves a shared absolute coordinate per edge (narrower-face
-  center clamped into the faces' overlap interval) and derives exit/entry fractions
-  from it, so no-waypoint orthogonal edges render as single straight segments by
-  construction; same-face edges spread ≥30px with both endpoints moving together,
-  and bidirectional pairs become two parallel straight lines.
-- Face detection prefers the axis with a positive face-to-face gap, fixing wide-bar
-  vs narrow-box pairs that previously routed through shape bodies.
-- Legacy `0.25/0.5/0.75` slots remain only as the no-overlap fallback and now dodge
-  coordinates already occupied on the same face (best-effort max-distance when the
-  face is too small).
-- New straightness audit in `validateEdgeQuality`: warns when an avoidable bend
-  exists (collinear solution available but unused); `--strict` fails.
-
-### Transparent text and label fidelity
-
-- Plain `type: text` nodes always emit `fillColor=none;strokeColor=none;labelBackgroundColor=none`;
-  explicit fills are ignored and reported by the new `validateTextNodeStyles`
-  (which also warns when declared bounds are smaller than the content estimate).
-  `overflow=hidden` removed from text nodes (no more clipped labels).
-- Label newlines become `<br>` in emitted XML (XML attribute normalization used to
-  fold them into spaces — the root cause of scrambled vertical CJK labels); math
-  labels keep raw newlines. Vertical CJK label pattern (one char per line) documented.
-- Content-aware default `labelOffset` (8px clearance + half label extent, axis
-  flipped on bent/star/mesh edges) and a new `validateLabelCollisions` lint for
-  labels on their own connector, across other connectors, and label/label overlap.
-- `validateColorScheme` accepts `none`/`transparent` as explicit transparency.
-
-### Native connectors and arrowheads
-
-- Block/classic arrows default to a bold solid head (`endSize=12`, `startSize=12`
-  with a start arrow), overridable per edge or theme.
-- `validateXml` now returns `warnings` (additive) and reports floating edges
-  (missing `source`/`target`), arrow shapes posing as connectors
-  (`singleArrow`/`doubleArrow`/`triangle`/`mxgraph.arrows2.*`), and white-filled
-  plain text cells; the CLI prints them and `--strict` fails on them.
-
-### Assets and docs
-
-- New regression fixture `evals/fixtures/industrial-architecture.yaml` (18-edge
-  replica of the audited figure; baseline had 13 bent edges, now 0).
-- `edge-quality-rules.md` (collinear-first, native-bound-edges, transparent-text
-  blocking rules; counterpart-projection face policy), `tokens.md` (enforced
-  transparency, vertical CJK pattern), `replicate.md` (mandatory transparency,
-  content-aware offsets, new validate checklist), `SKILL.md` rules 13-14.
-- Known follow-up: `aws-vpc-topology`, `campus-lan-topology`, `e-commerce`, and
-  `vendor-device-mapping` examples still carry advisory label-collision warnings
-  from dense layouts; they need layout spacing, not just offsets.
-
-## 2.4.0 (2026-07-07)
-
-Quality round driven by the 2026-07-06 audit (19 findings): academic figures and
-network topologies now render faithfully offline, without hand-written bounds.
-
-### SVG renderer fidelity (P0)
-
-- Absolute geometry for module children (parent-relative coordinates resolved
-  through the cell hierarchy); edges anchor on node boundaries instead of raw
-  centers, honoring exit/entry anchors and `<Array as="points">` waypoints.
-- Orthogonal bend synthesis for anchored edges, multi-line labels (`\n`,
-  `<br>`, `&#10;`) as tspans, mxgraph cube rendering, 2-decimal coordinate output.
-
-### Theme and style fidelity
-
-- New vendored shape catalog (`assets/catalog/shape-catalog.json.gz`, 1.8k names)
-  with `validateShapeReferences`: unknown stencil names now warn instead of
-  rendering empty boxes; fake names corrected (cisco firewall/access point,
-  `aws.ec2_instance` → `aws.ec2`, `aws.api-gateway` → `aws.api_gateway` alias).
-- aws4 resource icons emit the compound `shape=mxgraph.aws4.resourceIcon;resIcon=…`
-  style; theme `rounded`/typography tokens actually reach node styles; falsy
-  style values (`strokeWidth: 0`, `rounded: false`) no longer swallowed by `||`.
-
-### Validators (academic consistency)
-
-- Density verdicts unified under `checkComplexity` (41/61/100 tiers); the
-  contradictory 18/12 academic density warning is gone.
-- Verbose-label rule measures visible length (TeX commands ≈ 1 glyph) and
-  exempts `type: text` legends; long-label infos aggregate into one line.
-- New `validateSchemaDrift`: unknown `meta` keys, `node.style` keys, and module
-  keys (e.g. `canvasSize`, `style.shape`, module `bounds`) warn instead of being
-  silently ignored. New oversized-canvas warning (>1500px with sub-8pt effective
-  labels at IEEE single-column 252pt).
-
-### Auto-layout engine
-
-- Vendored `elkjs@0.11.1` (EPL-2.0, offline, no npm dependency): `layout:
-hierarchical` specs without explicit geometry get an edge-aware layered
-  layout — modules as compound containers, orthogonal edge routes played back
-  as draw.io waypoints. Legacy grid remains as fallback (engine unavailable,
-  mixed manual geometry, direct sync API use).
-- Single-edge faces connect at the `0.5` center (was the off-center `0.25`
-  slot); multi-edge faces keep the 0.25/0.5/0.75 distribution.
-- New `layout: tiered`: North-South network rows from `network.tier`/`role`
-  or semantic type (external on top, endpoints at the bottom).
-- New `computeLayoutQualityMetrics` (node crossings / edge crossings / total
-  edge length) reported by `--validate`. All 13 bundled examples pass
-  `--validate` with zero warnings.

package/template/.codex/skills/drawio/SKILL.md

@@ -1,157 +0,0 @@
----
-name: drawio
-version: "2.7.0"
-description: "Create, edit, replicate, import, and export draw.io diagrams with an offline YAML-first workflow: architecture, network topologies, flowcharts, UML/ER, org charts, Mermaid/CSV conversion, existing .drawio bundles, style presets, themes, and non-publication formula diagrams. For publication figures (paper, thesis, IEEE, camera-ready) use drawio-academic-skills instead."
-license: MIT
-homepage: https://github.com/bahayonghang/drawio-skills
-compatibility: "Node 20+ for the YAML/CLI workflow. draw.io Desktop produces the default 300dpi PNG (plus PDF/JPG or embedded .drawio.svg); without it, image exports fall back to a standalone SVG. No MCP server is required for offline authoring; the optional live-refinement backend needs a browser/MCP provider."
-platforms: [macos, linux, windows]
-metadata:
-  category: visual-design
-  tags:
-    - diagram
-    - drawio
-    - architecture
-    - flowchart
-    - network-topology
-    - uml
-    - mermaid
-    - csv
-    - design-system
-    - math
-argument-hint: [diagram-description-or-instruction]
-allowed-tools: Read, Write, Bash, AskUserQuestion
----
-
-# Draw.io Base Skill
-
-Create, edit, validate, replicate, import, and export draw.io diagrams through a YAML-first offline workflow. It is the single maintained base for sibling overlays and owns the local CLI, schemas, references, themes, palettes, examples, style presets, and export helpers.
-
-## Scope
-
-Use this base skill for general draw.io work: software/system architecture; network topologies and infrastructure maps; flowcharts, swimlanes, process maps, and org charts; UML class/sequence/state/ER; Mermaid and CSV conversion; structured redraw and non-academic replication; formula-bearing technical diagrams; `.drawio` import, sidecar export, and local validation.
-
-For paper, thesis, IEEE, journal, manuscript, or publication-ready figure requests, route to the sibling `drawio-academic-skills` overlay; the base does not apply academic publication gates. Without the overlay, render the local YAML bundle but report that overlay policy was not applied.
-
-## Runtime Stack
-
-Use the lightest path that satisfies the request:
-
-- **Offline Authoring Path (default)** — the YAML spec generates the final `.drawio` plus the default delivered image, a **300dpi PNG** via draw.io Desktop (standalone SVG fallback).
-- **Desktop-Enhanced Export** — 300dpi PNG default, plus PDF/JPG or embedded `.drawio.svg` on explicit request.
-- **Live Refinement Backend (optional)** — browser refinement provider only; the offline bundle remains canonical. Provisioned by the tracked `.mcp.json` (pinned `@next-ai-drawio/mcp-server@0.4.13`, fetched over the network by `npx`; see `references/docs/mcp-tools.md`); offline authoring never reads it.
-- **Direct XML Exception** — tiny one-off or raw mxGraph handoff when exact XML control is the real requirement.
-
-The optional MCP/live backend is a refinement provider only. Never required for normal authoring, editing, import, replication, or export.
-
-## Task Routing
-
-Choose the route first, then load only that route's references. All paths below live under `references/`; the reusable YAML example catalog is `references/examples/README.md`.
-
-- `create` — new diagram from text, YAML, Mermaid, CSV, or a concise spec → `workflows/create.md`, `docs/design-system/README.md`, `docs/design-system/specification.md`
-- `config-import` — declared Terraform, Kubernetes, Compose, SQL DDL, OpenAPI, GitHub Actions, or GitLab CI architecture → `docs/config-importers.md`, `docs/canonical-graph-projection.md`
-- `live-drift` — compare explicit Terraform state/plan JSON, Docker inspect JSON, or Kubernetes live JSON against a declared projection without capture → `docs/live-snapshots-drift.md`, `docs/canonical-graph-projection.md`, `workflows/visual-review.md`
-- `code-import` — Python module/class, JavaScript/TypeScript ESM, Go package, or Rust module relationships from a local project directory → `docs/code-importers.md`, `docs/canonical-graph-projection.md`
-- `multi-page` — create, import, validate, or transform bundle v1 pages with stable page/object identity and structured links → `docs/upstream-capability-compatibility.md`, `docs/xml-format.md`
-- `raster-replicate` — normalize a trusted structured visual extraction through `--input-format raster-extraction` before canonical rendering → `workflows/replicate.md`, `docs/upstream-capability-compatibility.md`
-- `postprocess` — project or transform canonical YAML/Draw.io with offline `mermaid`, `explain`, `relabel`, `restyle`, `heatmap`, or script-free `html` → `docs/upstream-capability-compatibility.md`
-- `architecture` — system/software architecture, microservice or cloud-service maps with role-based color coding, plus AI agent / RAG / memory diagrams（架构、微服务、云架构、agent、RAG、记忆、multi-agent、工具调用；非拓扑、非论文）→ `workflows/create.md`, `docs/architecture-diagrams.md`, `docs/agent-diagrams.md`, `docs/design-system/README.md`
-- `edit` — modify an existing sidecar bundle or imported `.drawio` → `workflows/edit.md`, `docs/migration-readiness.md`
-- `replicate` — redraw an uploaded image, screenshot, SVG, or reference diagram → `workflows/replicate.md`, `docs/design-system/README.md`, `docs/design-system/specification.md`, `docs/design-system/color-guide.md`
-- `palette` — palette, colorblind safety, grayscale/black-and-white printing, or multi-category distinction → `docs/design-system/color-guide.md`, `docs/design-system/themes.md`, `docs/design-system/specification.md`, `examples/palettes/README.md`
-- `math-formula` — formulas, equations, LaTeX, AsciiMath, MathJax, or Chinese formula keywords → `docs/math-typesetting.md`, `docs/design-system/formulas.md`
-- `stencil-heavy` — cloud, AI brand, SysML, BPMN, network gear, or exact draw.io shape work → `docs/stencil-library-guide.md`, `docs/upstream-capability-compatibility.md`, `official/xml-reference.md`, `official/style-reference.md`
-- `network-topology` — network topology, VLAN / subnet / gateway, campus / data-center / cloud network maps（拓扑、子网、网关、VLAN）→ `docs/ieee-network-diagrams.md`, `docs/stencil-library-guide.md`, `official/xml-reference.md`
-- `edge-audit` — dense or routing-sensitive diagrams → `docs/edge-quality-rules.md`, `official/xml-reference.md`
-- `visual-review` — inspect an exported artifact, record issues, or apply targeted rework → `workflows/visual-review.md`
-- `live-refinement` — explicit browser/inline visual refinement → `docs/mcp-tools.md`, `docs/migration-readiness.md`
-- `direct-xml` — tiny XML-only handoff or raw mxGraph edits → `official/xml-reference.md`, `official/style-reference.md`, `docs/xml-format.md`, `upstream/pure-drawio-skill.md`
-
-Use `network-topology` when the diagram **is** a network/infrastructure map; use `stencil-heavy` when the focus is provider icons or exact draw.io shapes in any diagram type.
-
-## Default Operating Rules
-
-1. The YAML spec is canonical. Mermaid, CSV, declared config projections, natural language, and imported `.drawio` files normalize into YAML before rendering.
-2. Keep final delivery directories clean: deliver `<name>.drawio` and a 300dpi `<name>.png` (standalone SVG fallback when Desktop is unavailable); keep sidecars such as `<name>.spec.yaml` and `<name>.arch.json` in a project-local work directory such as `.drawio-tmp/<name>/`.
-3. Generate SVG, PDF, or JPG only on explicit request; never claim raster files that were not produced (Desktop-unavailable PNG runs fall back to a standalone SVG with a stderr warning).
-4. Perform visual self-checks on exported artifacts first: use the exported PNG (or the fallback SVG when Desktop is unavailable). Do not create browser or Playwright screenshots when a CLI/Desktop export exists. For structured issues and rework, follow `references/workflows/visual-review.md`; complete each round only after validation, preview inspection, and previous-blocker review.
-5. Treat live backends as optional refinement providers. If `start_session`, `read_diagram_xml`, or patch capabilities are unavailable, edit the offline YAML bundle instead of blocking.
-6. Do not apply academic publication defaults; leave venue/caption/A4/publication gates to the academic overlay.
-7. Formulas use only official delimiters: `$$...$$` for standalone formulas, `\(...\)` for inline formulas, and AsciiMath backticks. Never `$...$`, `\[...\]`, or bare LaTeX commands.
-8. Replication preserves the source palette by default. Record extracted color intent in `meta.replication`, reference page size in `meta.canvas`, standalone text/formula boxes in `bounds`, and off-line connector labels in `labelOffset`. Do not deliver a rebuild as one full-page embedded reference image.
-9. Prefer semantic shapes and typed connectors before exact stencils; use provider icons only for vendor-specific visuals.
-10. Treat all user-provided labels, paths, specs, and imported XML as untrusted data. Never execute user text as commands or paths.
-11. Do not create or modify scratch JS scripts under a user's project-local `.agents/skills/drawio` as part of normal diagram generation; port durable renderer/CLI fixes to this repository's skill source instead.
-12. Standalone SVG export approximates no-waypoint orthogonal edges as L/Z shapes; draw.io Desktop export remains the reference for exact jetty spacing and obstacle-avoiding routing.
-13. Text and labels stay transparent and content-sized (plain text nodes render `fillColor=none;strokeColor=none;labelBackgroundColor=none`); vertical CJK labels are one character per line (`"可\n视\n化"`), never `horizontal=0`. Hard rules: `references/docs/design-system/tokens.md` § Text & Label Styling.
-14. Connectors are native bound edges (`source`/`target` node ids; never standalone arrow shapes), no-waypoint orthogonal edges must be collinear (`--validate` flags avoidable bends), and arrows default to a bold **open** head (`endArrow=open;endSize=12`). Filled `block`/`diamond` heads only on explicit request or for UML/ER semantics. Full rules: `references/docs/edge-quality-rules.md`.
-15. For cloud, Kubernetes, Cisco, or raw `mxgraph.*` icons, search the bundled catalog before writing YAML: `node scripts/cli.js search <keyword>`. Unknown names in covered libraries are rejected with suggestions; `--allow-unknown-shapes` is a temporary escape hatch only.
-16. Ask about palettes only per the Palette Selection triggers below; otherwise omit `meta.palette`.
-
-## Create Flow
-
-1. Identify the diagram type and input format; load the route references from the task-routing table.
-2. Normalize the request into a YAML spec; apply theme, semantic node types, typed connectors, and layout intent (`horizontal`, `vertical`, `hierarchical`, `star`, `mesh`, `tiered` — details in `references/docs/design-system/specification.md`).
-3. Validate, then render (`--validate` also reports node/edge crossings and total edge length):
-
-```bash
-node <base-skill-dir>/scripts/cli.js input.yaml output.drawio --validate --write-sidecars --sidecar-dir .drawio-tmp/output
-node <base-skill-dir>/scripts/cli.js input.yaml output.png --validate --use-desktop
-```
-
-Use `--strict`/`--strict-warnings` for release-grade review.
-
-## Edit, Import, and Replicate
-
-Prefer editing the sidecar bundle. If only a `.drawio` file exists, import it first, edit the generated `.spec.yaml`, then regenerate:
-
-```bash
-node <base-skill-dir>/scripts/cli.js existing.drawio --input-format drawio --export-spec --write-sidecars --sidecar-dir .drawio-tmp/existing
-```
-
-Write beside-output sidecars only when the user asks for a reproducible editing bundle.
-
-For `/drawio replicate` (uploaded images or screenshots): extract structure, palette, and text-placement intent; represent position-sensitive titles, captions, formulas, callouts, and edge labels explicitly; set `meta.source: replicated`; render and self-check text positions against the exported PNG (or fallback SVG) before claiming completion. Playbook: `references/workflows/replicate.md`.
-
-## Desktop and Diagrams.net Export
-
-PNG/PDF/JPG and embedded `.drawio.svg` exports require draw.io Desktop (`--use-desktop`; `--dpi` defaults to 300); without it the PNG export falls back to a standalone `.svg` (stderr warning) so you still deliver `.drawio` plus an image. For browser handoff:
-
-```bash
-node <base-skill-dir>/scripts/runtime/diagrams-net-url.js output.drawio
-```
-
-The diagram content is encoded in the URL fragment after `#R` and is not sent as a server query parameter.
-
-## Style Presets
-
-Bundled style presets live under `styles/built-in/`; user presets live outside the repository, e.g. `~/.drawio-skill/styles/` or an overlay-specific user directory. Resolve preset names user-first (user directory before `styles/built-in/`); an unknown preset name is an error, never a silent fallback.
-
-To learn a reusable preset from an existing diagram and render an approval sample, follow `references/docs/style-extraction.md`. Copy-paste style strings: `references/docs/style-presets.md`.
-
-Never mutate bundled presets. Copy a bundled preset to the user preset directory before making it the default or editing it.
-
-## Palette Selection
-
-Theme and palette are independent: theme owns typography, spacing, shapes, line styles, modules, and canvas; `meta.palette` optionally replaces semantic/category colors. Omitting `meta.palette` preserves the selected theme byte-for-byte.
-
-Ask only when the request mentions palette/color choice, colorblind safety, grayscale or black-and-white printing, or multi-category distinction and does not name a palette. Then use `AskUserQuestion` as a single-select: offer 3-4 relevant palettes, put the best fit first with `(Recommended)`, use each palette's `displayName` as the label, and summarize colorblind/grayscale safety plus intended use in the description. If the user already specified a palette, apply it directly and do not ask.
-
-For `replicate`, preserve source colors by default and do not ask for a palette. Ask only when the user explicitly requests normalization or a replacement palette; record that choice in `meta.replication.colorMode` and set `meta.palette` only for the normalized result.
-
-Bundled palette metadata and previews: `assets/palettes/` and `references/examples/palettes/`. User palettes live under `~/.drawio-skill/palettes/`; an explicit invalid palette is an error, never a silent fallback.
-
-## Validation Policy
-
-Validate before claiming completion:
-
-- Structure: schema, IDs, theme/layout/profile.
-- Layout: complexity, position consistency, overlap risk.
-- Quality: edge-quality rules, label clearance, replication text placement.
-- Visual verification: inspect the exported PNG (or the fallback SVG when Desktop is unavailable) first, or another Desktop-exported format when that is the requested final artifact. Use `references/workflows/visual-review.md` for the dimension-bounded preview, structured evidence, YAML-first patch, and stopping rules. Browser/live screenshots only when the user explicitly requested live review and no exported artifact can be inspected.
-
-If validation fails, fix the YAML or imported XML and rerun; if an optional export cannot run, report the missing provider and fall back to the offline bundle.
-
-## Completion Report
-
-End with a concise report: deliverables written with paths; the intermediate work directory when sidecars or diagnostics were generated; validation and export commands run; the exported artifact used for visual verification (or why none); the visual review record and unresolved blockers when rework was requested; the selected palette and its colorblind/grayscale safety flags when `meta.palette` is present; unavailable optional exports or live-refinement providers; any remaining manual visual checks.

package/template/.codex/skills/drawio/agents/interface.yaml

@@ -1,26 +0,0 @@
-interface:
-  display_name: 'Draw.io Base'
-  short_description: 'Create, edit, replicate, import, and export draw.io diagrams with an offline YAML-first workflow, themes, schemas, style presets, and optional Desktop export'
-  brand_color: '#2563EB'
-
-policy:
-  allow_implicit_invocation: true
-
-capabilities:
-  - Create engineering and product diagrams from natural language, YAML, Mermaid, or CSV
-  - Edit and import existing .drawio bundles through a YAML-first spec
-  - Replicate uploaded images, screenshots, or SVGs as structured redraws
-  - Import code, declared config, and saved live snapshots through stable canonical identities
-  - Create and round-trip multi-page bundles with structured page links
-  - Run offline postprocess operations for Mermaid, explain, relabel, restyle, heatmap, and script-free HTML
-  - Use the offline AI icon and SysML/BPMN stencil catalogs without network access
-  - Generate .drawio, .spec.yaml, .arch.json, and standalone SVG as the offline bundle
-  - Export PNG, SVG, PDF, and JPG through draw.io Desktop when available
-  - Generate diagrams.net browser URLs when Desktop export is unavailable
-  - Apply built-in and user style presets, themes, and 15 metadata-backed palettes
-  - Validate palette category capacity, boundary contrast, colorblind notices, and grayscale print safety
-  - Work without MCP through the local CLI; optional live refinement is a refinement provider only
-
-prerequisites:
-  - Node 20+
-  - draw.io Desktop app for PNG/PDF/JPG and embedded SVG exports

package/template/.codex/skills/drawio/agents/openai.yaml

@@ -1,26 +0,0 @@
-interface:
-  display_name: 'Draw.io Base'
-  short_description: 'Create, edit, replicate, import, and export draw.io diagrams with an offline YAML-first workflow, themes, schemas, style presets, and optional Desktop export'
-  brand_color: '#2563EB'
-
-policy:
-  allow_implicit_invocation: true
-
-capabilities:
-  - Create engineering and product diagrams from natural language, YAML, Mermaid, or CSV
-  - Edit and import existing .drawio bundles through a YAML-first spec
-  - Replicate uploaded images, screenshots, or SVGs as structured redraws
-  - Import code, declared config, and saved live snapshots through stable canonical identities
-  - Create and round-trip multi-page bundles with structured page links
-  - Run offline postprocess operations for Mermaid, explain, relabel, restyle, heatmap, and script-free HTML
-  - Use the offline AI icon and SysML/BPMN stencil catalogs without network access
-  - Generate .drawio, .spec.yaml, .arch.json, and standalone SVG as the offline bundle
-  - Export PNG, SVG, PDF, and JPG through draw.io Desktop when available
-  - Generate diagrams.net browser URLs when Desktop export is unavailable
-  - Apply built-in and user style presets, themes, and 15 metadata-backed palettes
-  - Validate palette category capacity, boundary contrast, colorblind notices, and grayscale print safety
-  - Work without MCP through the local CLI; optional live refinement is a refinement provider only
-
-prerequisites:
-  - Node 20+
-  - draw.io Desktop app for PNG/PDF/JPG and embedded SVG exports