@xgent-ai/skills 0.7.5 → 0.7.6

package/dist/phoenix-diagram/VERSION.json

@@ -0,0 +1,39 @@
+{
+  "schemaVersion": 1,
+  "distribution": "release",
+  "tool": "phoenix-diagram",
+  "toolVersion": "0.2.0",
+  "npmPackageVersion": "0.7.6",
+  "sourceCommit": "6a01c326c1f3dd0390151882e6e03205ea1dc6b8",
+  "sourceInputSha256": "0f1df3fb0de1d1be7289d102dffccebe58e25a4393104385690f5e666e1af29e",
+  "inputContractSchema": 1,
+  "receiptSchema": 1,
+  "viewerRevision": "phoenix-v2",
+  "bundleSha256": "58d1580a3a443f79a3aa41ee2c9000542de5a8d4b799377a4be673298ad8589e",
+  "engines": {
+    "darwin-arm64": {
+      "asset": "phoenix-diagram-darwin-arm64",
+      "size": 17566448,
+      "sha256": "7f86c913a72a9767607529ffe36a426ced92e5f6c480cafbad6ab41d227376ef",
+      "url": "https://download.xgent.ai/vendor/phoenix-diagram/v0.7.6/darwin-arm64/phoenix-diagram-darwin-arm64"
+    },
+    "darwin-x64": {
+      "asset": "phoenix-diagram-darwin-x64",
+      "size": 19576864,
+      "sha256": "5b826e660f39fd234a500d521d8b2bf96bb47f352aee4f528209291f7a2c5cc5",
+      "url": "https://download.xgent.ai/vendor/phoenix-diagram/v0.7.6/darwin-x64/phoenix-diagram-darwin-x64"
+    },
+    "linux-x64": {
+      "asset": "phoenix-diagram-linux-x64",
+      "size": 21880592,
+      "sha256": "37cbf5d8b4a2b1daa0f7c44f462f1d34b0e1a5d3b3e438bfe0988021cfcee457",
+      "url": "https://download.xgent.ai/vendor/phoenix-diagram/v0.7.6/linux-x64/phoenix-diagram-linux-x64"
+    },
+    "linux-arm64": {
+      "asset": "phoenix-diagram-linux-arm64",
+      "size": 19406792,
+      "sha256": "cb1ceb6cabc492b0c22e5f57f270cb1484ee6332b028b29bc8a824fff74095ae",
+      "url": "https://download.xgent.ai/vendor/phoenix-diagram/v0.7.6/linux-arm64/phoenix-diagram-linux-arm64"
+    }
+  }
+}

package/dist/phoenix-diagram/bundle/ENGINE.json

@@ -0,0 +1,39 @@
+{
+  "schemaVersion": 1,
+  "distribution": "release",
+  "tool": "phoenix-diagram",
+  "toolVersion": "0.2.0",
+  "npmPackageVersion": "0.7.6",
+  "sourceCommit": "6a01c326c1f3dd0390151882e6e03205ea1dc6b8",
+  "sourceInputSha256": "0f1df3fb0de1d1be7289d102dffccebe58e25a4393104385690f5e666e1af29e",
+  "inputContractSchema": 1,
+  "receiptSchema": 1,
+  "viewerRevision": "phoenix-v2",
+  "bundleSha256": "58d1580a3a443f79a3aa41ee2c9000542de5a8d4b799377a4be673298ad8589e",
+  "engines": {
+    "darwin-arm64": {
+      "asset": "phoenix-diagram-darwin-arm64",
+      "size": 17566448,
+      "sha256": "7f86c913a72a9767607529ffe36a426ced92e5f6c480cafbad6ab41d227376ef",
+      "url": "https://download.xgent.ai/vendor/phoenix-diagram/v0.7.6/darwin-arm64/phoenix-diagram-darwin-arm64"
+    },
+    "darwin-x64": {
+      "asset": "phoenix-diagram-darwin-x64",
+      "size": 19576864,
+      "sha256": "5b826e660f39fd234a500d521d8b2bf96bb47f352aee4f528209291f7a2c5cc5",
+      "url": "https://download.xgent.ai/vendor/phoenix-diagram/v0.7.6/darwin-x64/phoenix-diagram-darwin-x64"
+    },
+    "linux-x64": {
+      "asset": "phoenix-diagram-linux-x64",
+      "size": 21880592,
+      "sha256": "37cbf5d8b4a2b1daa0f7c44f462f1d34b0e1a5d3b3e438bfe0988021cfcee457",
+      "url": "https://download.xgent.ai/vendor/phoenix-diagram/v0.7.6/linux-x64/phoenix-diagram-linux-x64"
+    },
+    "linux-arm64": {
+      "asset": "phoenix-diagram-linux-arm64",
+      "size": 19406792,
+      "sha256": "cb1ceb6cabc492b0c22e5f57f270cb1484ee6332b028b29bc8a824fff74095ae",
+      "url": "https://download.xgent.ai/vendor/phoenix-diagram/v0.7.6/linux-arm64/phoenix-diagram-linux-arm64"
+    }
+  }
+}

package/dist/phoenix-diagram/bundle/SKILL.md

@@ -0,0 +1,109 @@
+---
+name: phoenix-diagram
+description: "用于架构、工作流、时序、数据流、状态、ER、类、树、时间线、耗时瀑布图及 Mermaid 转换；不用于数值图表、仪表盘或其他 infographic。缺必需事实时仅提必要问题；齐备后交付经 Rust、浏览器与实际看图核对的独立 HTML。品牌采集、本地预览和架构比较仅在明确请求时启用。"
+license: MIT
+metadata:
+  internal: true
+  version: "0.2.0"
+  based_on: "tt-a1i/Archify; Cocoon-AI/architecture-diagram-generator (MIT)"
+---
+
+# Phoenix Diagram
+
+把授权材料整理成完整的 JSON 图解，由原生引擎生成独立 HTML。保留每个必要实体、关系、方向、条件和标签，不设节点、边、列、成员、事件、跨度或卡片配额。示例只说明字段结构，不能成为用户的私有事实。缺少影响含义的参与者、条件、日期或金额时先询问，收到答复前不写 candidate 或生成图。
+
+普通依据材料作图时，原材料已明确指出业务条件、日期或金额缺失，就直接走澄清分支；不能以主干仍可画或已有结果标签为由继续作图。其他影响含义的必需事实缺失时，同样先澄清：
+
+1. 只提取阻止按原材料作图的必需缺口，不发散到材料未提及的可选分支、异常路径或设计选择。已给出的角色、关系和标签直接按原文使用，不以细化称谓、层级或内部细节为由追加问题。例如，“超预算还需批准”只说明追加条件；材料未要求具体执行先后时，不补造先后，也不为细化先后追加问题。
+2. 把每个缺口写成询问其实际内容的开放式问题。不列候选答案，不用疑问句、选项或括号夹带假设的日期、金额、阈值、分支、触发条件、次数上限或终止规则；需要字段格式时只用未赋值占位符。
+3. 发送前逐条删去候选答案、假设例子、扩展问题、流程复述，以及列表前后汇报已核事实或解释为何要问的段落，**只输出剩下的简短问题列表，随后立即结束**。从第一条问题开始，列表前后不加介绍、解释或后续创作步骤。
+
+本轮不写 candidate 或生成图，不提供流程草稿，不用缺失规则卡片代替询问。把具体值称为“草拟”“默认”或“待确认”，也不能代替用户提供事实。
+
+只有用户明确要求拟定这些值或规则时，才给清楚标为建议的方案；普通作图请求不包含这项授权。
+
+## 选择图型
+
+| 类型 | 适用问题 | 示例 |
+| --- | --- | --- |
+| `architecture` | 组件职责、服务连接、真实系统边界 | [最小架构](examples/minimal.architecture.json) |
+| `workflow` | 审批、操作流程、条件分支和回路 | [最小工作流](examples/minimal.workflow.json) |
+| `sequence` | 参与者之间的调用、返回和异步消息 | [最小时序](examples/minimal.sequence.json) |
+| `dataflow` | 数据来源、加工、存储和消费关系 | [最小数据流](examples/minimal.dataflow.json) |
+| `lifecycle` | 状态变化、等待、终止和恢复 | [最小生命周期](examples/minimal.lifecycle.json) |
+| `erd` | 表或实体、字段、主/外/唯一键及其间基数 | [最小 ER 图](examples/minimal.erd.json) |
+| `class` | 类、接口、所选成员，以及依赖、关联、继承、实现、组合、聚合 | [最小类图](examples/minimal.class.json) |
+| `tree` | 单父包含层级：仓库或模块目录、能力分解、组织式拆分 | [最小树](examples/minimal.tree.json) |
+| `timeline` | 何时发生：事故复盘、发布历史、带泳道的成比例时间轴 | [最小时间线](examples/minimal.timeline.json) |
+| `waterfall` | 时间花在哪：一次请求或运行的跨度时长、重叠与嵌套 | [最小耗时瀑布](examples/minimal.waterfall.json) |
+
+不明确时运行 `guide`，按返回的包内 `schema`、`commonSchema`、`example` 路径选择。数值图表、仪表盘和其他 infographic 不在范围内，不能改称上述图型来绕过。
+
+Mermaid 作为语义材料处理：`flowchart` / `graph` 转为 workflow，组件连接图可选 architecture；`sequenceDiagram` 保留参与者、消息方向、同步/异步与 return；`stateDiagram` 保留主路径、waiting、终止及真实 recovery 边；`erDiagram` 转为 erd，保留实体、字段、键与两端基数；`classDiagram` 转为 class，保留类型种类、所选成员与关系种类。由宿主写新的 JSON，不运行 Mermaid 或 Node 图解 renderer，不照搬 Mermaid 样式。
+
+以下能力按用户请求分别启用，不因普通作图自动执行：
+
+- 明确要求品牌标识时读[品牌资源](references/brand-marks.md)。固定目录可离线查询；只有明确采集请求才访问用户给出的公共站点，普通生成只消费已固定的本地资源。不从组件名称猜品牌或 URL。
+- 明确要求本地预览时读[预览会话](references/preview.md)。服务与正式成果分离，只有 `--open` 才打开系统浏览器；停止服务后仍按正式交付流程验收。
+- 明确要求比较两份架构输入时读[架构比较](references/architecture-compare.md)，使用 Before/Delta/After 及比较专用审核合同。不能用下方单图 finalize 流程替代比较交付，也不推断风险、原因或可合并性。
+- 明确要求项目级旧入口迁移或安装事务恢复/回滚时读[迁移与安装恢复](references/migration.md)。普通作图和 install 不移除旧入口，旧 skill 无目标备份；只处理已确认的精确项目/provider，不扩到个人或共享配置。
+- 导入旧输入或解释兼容回执时读[兼容约定](references/compatibility.md)；维护者增加图型时读[扩展约定](references/extending-types.md)。
+
+## 最短创作路径
+
+以下创作步骤仅适用于事实已齐备的材料。
+
+用户或宿主对 CLI 执行器、命令形式或原始结果留存有明确约束时，所有 CLI 调用（含 `guide` 和帮助命令）都按这些约束执行。下方示例只说明参数，不能据此省略任务已明确要求的调用层或结果记录。命令形式已固定时，不自行添加环境变量赋值前缀或更换调用层。资料范围已限定时，搜索也须限于获准资料；不能用整个 skill 根的搜索读到已排除的实现，排障也不枚举授权外的个人缓存或应用目录。
+
+命令从用户工作目录执行。将下方 `PD` 替换为**当前加载的本 skill 目录**中的绝对路径，候选和输出路径使用用户项目的实际路径：
+
+```sh
+PD="<当前加载的skill目录>/scripts/phoenix-diagram"
+"$PD" guide "API 调用链" --json
+```
+
+1. 新稿只读所选 `schemas/<type>.schema.json`、[common schema](schemas/common.schema.json)、一个匹配示例及[创作默认值](references/authoring-defaults.md)。必需资料的宿主读取返回若被截断，先分段补齐缺失内容，再写完整 candidate；子进程 stdout 完整不代表宿主返回完整。新稿设置 `meta.input_contract: "phoenix-v1"`、`meta.quality_profile: "showcase"`；从自动路线和自动标签开始。保留用户提供的固定几何，不在首稿预先添加 `via`、`channelX`、`channelY` 或 `labelAt`。ER 图列出每张表的全部物理列及其类型和键角色，外键写 `references`；时间线每个时刻带明确偏移；没有记录的计时只能标为示意。
+
+   ER 图写 candidate 前，分别核对关系每端的最大基数、最小参与数与引用列可空性。外键只证明引用目标，不自动证明 `NOT NULL`；“可有多个”不单独证明最小数为零。`fromOptional`/`toOptional` 省略或写 `false` 仍表示该端最小值为1，写 `true` 表示0；两种取值都要有材料依据，省略字段不能表示未知。以已给 SQL 约束、联合主键、显式文字或 Mermaid 端点为依据，材料已明确就直接使用，不重复询问或要求另选表现形式。需要表示的最小数或可空性缺少依据时，按前述开放问题规则先问并停止；不先画 `0..N`/`1` 再标“待确认”，不用卡片兜底。用户明确授权拟定规则时仍走建议分支。
+
+   类图分别核对关系、生命周期和数量：保留“一个/多个”等已给数量，不能只保留组合或创建销毁而漏掉数量。没有依据的下界不补数字；按[创作默认值](references/authoring-defaults.md)的 Class 规则处理，只有无依据的可选数值标注可以省略。
+
+   图要解释真实仓库时，先读[仓库来源创作](references/repository-authoring.md)：只读用户指定的仓库与切片，首稿即为主要元素写 `sources` 并在 `meta.repository` 固定提交，交付时用 `--repo-root` 指向该仓库根。仓库图缩写文字、改写卡片或调整布局后，也要保留实际命令名、源码条件和替代路径，所用函数或校验名称仍与各入口、命令的条件对应；只在特定分支执行的校验，不能写成所有调用必经的前置条件或安全保证。合并不同入口、命令或条件分支时，共享前置只能放这些实际可走路径共同必经的动作；例如 A 入口执行 X、B 入口执行 Y，不能合并为两者都执行 X。分别沿源码核对有条件的校验、默认补足和失败返回，保留各自的条件与结果。沿调用链把实际传入的参数和禁用开关带入条件判断；可被入口参数跳过的校验，不能写成必经步骤或无条件保证。对短路、跳过、禁止或必经的断言，逐条核对实际分支的完整条件；源码存在一个提前返回分支，不代表相关入口或不同参数组合都走该分支。来源核验为 `verified` 也不能代替这项语义核对。
+
+   审批有多个继续分支时，逐条保留各分支所需的全部批准前提；某一分支写有批准，不代表其他仅按资格分流的分支也已获准。逐个从获准结果沿实际可达分支回溯，核对每条路径的条件是否足以推出该结果所需的全部批准；不能只因有拒绝出口，就把其余资格分流边视为已批准。源码或图中的等价条件表达同样有效，不要求固定批准词或独立批准节点、边。
+
+   写出 candidate 或完成涉及语义的修复后，按原材料逐分支走读实际可走路径，核对条件、动作、执行者与先后关系；进入处理步骤不等于已经通过或获准；资格条件与批准结果分别核对。原文要求某人批准后才能执行的动作，须由该执行者的批准节点或出边中的批准条件控制，不能仅以进入审批和满足资格条件代替。仅在某条件成立后允许的动作，必须留在该条件控制的分支上，不能前移为其他分支的共同前置动作，也不能因合并节点或回路改变原有顺序。跨阶段适用的动作，先按原文枚举许可覆盖的全部非终态，再逐项核对主图路径；例如“任一下单前可撤回”也覆盖提交、补充材料等适用阶段。每个适用阶段都应能行使该许可并抵达相应结果，无需先满足额外条件或完成审批、提交、补交等其他业务动作。无条件且不执行业务动作的瞬时起始跳转可与后续阶段等价，显式覆盖全部适用阶段的结构也可等价表达，不要求逐节点各画一条直接边。有条件出口或执行检查的阶段不属于这种瞬时起始跳转。例如，材料给“合并前可撤回”时，图中单独表示的批准阶段或获批后尚未合并的阶段也要保留撤回路径，不能在审批通过时提前结束这项许可。卡片或“各阶段可……”文案不能代替主图中这项许可的完整范围。节点文字、`tag`/`sublabel`、卡片标题与条目、线型、颜色与图例都必须对应材料事实。推导比较、极值和排序结论时，以材料已给事实、已知数值或上下界为依据，不默认未知值更小；不能证明全体比较时，写清材料支持的比较范围。材料直接给定的比较事实照用，不为证明它额外索要数值。未说明的同步/异步、批处理等执行方式，使用中性职责、动作与普通关系；不能仅凭 Queue、Worker 等名称推定节点任务的执行方式，也不为可省略的标注追加问题。组件的用途同样须有材料依据，不能按常见用法补充；例如，材料只给“读写 Redis”时，不标为“缓存”。节点、标签齐全或卡片复述不代表路径等价；只据已给事实修正，必需事实缺失时沿用前述澄清规则，不自行补规则。
+2. 已有完整 candidate 直接进入 `finalize`。不先读 renderer、扫描全仓或重新改写输入。架构、工作流、时序、数据流、生命周期的未标记旧 JSON 默认按 `legacy-2.17` 处理，不静默切换新合同；用户说明 JSON 来自 Archify 3.1 时，用 `--input-contract phoenix-v1` 读取，不改写原文件。ER、类、树、时间线、耗时瀑布只有 `phoenix-v1`。
+
+   ```sh
+   "$PD" finalize <type> candidate.json diagram.html --json
+   "$PD" finalize <type> candidate.json diagram.html --repo-root "<仓库根>" --json
+   ```
+
+   第二种用于带来源的仓库图。退出码 0 不代表来源已核对：读回执 `evidence.status`（`verified`、`partial`、`unverified` 或 `none`）及 `evidence.unverified`、`evidence.unsourced`。
+
+3. 每轮失败后，在可回读的进度或本次项目记录中写明实际失败门、诊断阶段、客观 error 数、历史最佳值和停滞计数；首次失败的停滞计数为0。同一门每次修复后，只有 error 低于该门历史最佳才更新最佳并清零，否则停滞计数加1。修改 candidate 或修复前先核对该门计数：达到2立即停止并列出未解决项；即使不再运行命令，也不能继续修改 candidate 或将它回退到历史较好版本。错误种类变化不能重置计数，也不允许再试一次。修复前实际读到失败 diagnostic 的 `subject`、`evidence`、`supportedFixes`；宿主返回截断或提取遗漏时先补齐，不能把原有实测或字符串修法筛掉、转成空对象后视为已读。只修相关邻域。修复后重新 finalize；必要时用 `validate <type> candidate.json --layout-json --json` 定向诊断。重建 candidate 或交付、调整布局或卡片、返回已记录门时，沿用该门历史，不因新回执重新初始化；对最小示例的只读对照或验证不计修复，也不重置历史。环境失败也不允许无限重试。已通过前门而首次进入后门属于实际进展，按新门初始化记录；同一 validate 门内诊断 `stage` 首次由 `input` 变为 `layout` 也算进入后门。`supportedFixes` 写明经整图验证时，选定的一项修法所列全部路径是同一整组方案，须一次完整应用，不挑单个路径先试；保留每轮全部门的真实状态，不把不同门的顶层 error 数拼成同一停滞序列。不能删语义、降低质量、缩字或隐藏溢出来换通过。
+4. 按[交付合同](references/delivery-contract.md)实际打开当前四张暗/亮截图，检查主图、标签、卡片、关系遮挡、层级和控件。默认必须做实际图像审核；DOM 数值、截图存在或测试通过不能替代看图。随后 `review-record` 登记，再回读**同一交付**的当前 summary。只为登记审核或取得完整状态不得再次 finalize。
+
+自动四门通过后，视觉状态仍可能是 `required-pending`；只有四门 `pass`、`automatedStatus: "pass"`、`visualReview.status: "passed"`、`deliveryStatus: "complete"` 且身份仍绑定当前输入/HTML/配置/引擎/截图时，才能报告完整交付。修改 candidate 会使旧证据失效，需要新交付及对应的新审核。
+
+## 环境与停止
+
+普通 launcher 和安装脚本需要 Node.js 18+；图解核心为 Rust，消费环境不需要 Rust、Cargo 或检出源码。普通命令只验证已存在的引擎，不下载、不更新、不安装，不主动打开用户浏览器页面或启动 preview 服务。`finalize` 的隔离浏览器验收属于默认交付路径。
+
+工具或图像能力不可用时如实保留 `unavailable` / `not-run` / `required-pending` 和未完成门，交付可用 candidate 或已有文件。无 shell 时不能手写 SVG 冒充 Rust 校验通过。出现 `recovery-required` 时按交付合同识别确切事务，不自动选择恢复记录。
+
+缺引擎时给出错误回执的 `setupCommand`；只有用户已明确请求引擎安装才执行，并按当前 `ENGINE.json` 的 `distribution` 处理：
+
+- `release`：使用回执给出的固定发行版本命令。
+- `candidate` / `development`：先核对用户或本题已提供材料是否明确给出了配套完整 release-dir 的实际绝对路径。
+  - **未提供路径：只询问该绝对路径并停止安装，等待答复。** 安装授权不包含寻找或推定候选资源来源；不搜索项目外目录，不猜路径，不省略 `--release-dir` 试装，也不执行含 `MATCHING_RELEASE_DIR` 占位符的命令。
+  - **已提供路径：** 将回执命令中的 `MATCHING_RELEASE_DIR` 替换为该实际绝对路径后再执行；不改用 registry 获取同名同版本的另一份包。
+
+首次阅读为 Still，用户主动选择 Live。保留用户主要语言和原样的产品、代码、协议与 API 标识。只在用户请求 Reader 功能、导出或阅读交互时读[阅读器运行约定](references/viewer-runtime.md)。
+
+## 交付答复
+
+简短返回 HTML 和 candidate 路径、图型、原 `deliveryReceiptId`、当前四门结果、图像审核结果及 summary 路径。答复中的 HTML、candidate 和 summary 路径优先原样复制同一交付回执给出的真实值。若转为相对路径，先以宿主实际报告的本次工作目录逐条核对它们仍指向相同文件，再输出这些已核对的字符串；不能拿上级目录或消息中出现的其他目录作相对基准。简短回复也要保留定位所需的目录，不能用 `...` 代替路径或裁去前缀冒充绝对路径。有失败时说明真实阶段、保留文件和具体缺口。退出码非零、旧输出存在或自动检查通过都不能单独描述为完整成功。另读取同一 summary 中名为 `deliver` 的阶段回执 `receipt.compatibility.coreCompatibility` 与 `receipt.compatibility.dispositions`；逐项交接非 `supported` 字段的实际处理及原因，按[兼容约定](references/compatibility.md)说明未重建的展示能力，不再称为延期。`deliveryStatus: complete` 仅表示交付流程完成，不能代替这些兼容限制的交接。
+
+带来源的图还要说明 `evidence.status`：不是 `verified` 时，列出待核实元素及原因（如工作树改动的路径、缺少 `--repo-root`）和未提供来源的元素，不称其已核对。时间线或耗时瀑布标为示意（`illustrative`）或日精度时，说明这些时间不是实测或只精确到日。回执 `locale.fallback` 为 true 时，说明界面语言已回退英文。

package/dist/phoenix-diagram/bundle/examples/minimal.architecture.json

@@ -0,0 +1,11 @@
+{
+  "schema_version": 1,
+  "diagram_type": "architecture",
+  "meta": { "title": "Request architecture", "output": "minimal.architecture.html", "input_contract": "phoenix-v1", "quality_profile": "showcase", "locale": "en" },
+  "layout": { "mode": "grid", "cols": 2 },
+  "components": [
+    { "id": "client", "type": "frontend", "label": "Client", "row": 0, "col": 0 },
+    { "id": "service", "type": "backend", "label": "Service", "row": 0, "col": 1 }
+  ],
+  "connections": [{ "id": "request", "from": "client", "to": "service", "label": "Request" }]
+}

package/dist/phoenix-diagram/bundle/examples/minimal.class.json

@@ -0,0 +1,23 @@
+{
+  "schema_version": 1,
+  "diagram_type": "class",
+  "meta": { "title": "Payment types", "output": "minimal.class.html", "input_contract": "phoenix-v1", "quality_profile": "showcase", "locale": "en" },
+  "layout": { "mode": "grid" },
+  "types": [
+    { "id": "gateway", "label": "PaymentGateway", "kind": "interface", "row": 0, "col": 0.5, "methods": [
+      { "name": "charge", "parameters": "amount: Money", "returns": "Receipt", "visibility": "public" }
+    ] },
+    { "id": "card", "label": "CardGateway", "kind": "class", "row": 1, "col": 0, "attributes": [
+      { "name": "token", "type": "string", "visibility": "private" }
+    ], "methods": [
+      { "name": "charge", "parameters": "amount: Money", "returns": "Receipt", "visibility": "public" }
+    ] },
+    { "id": "wallet", "label": "WalletGateway", "kind": "class", "row": 1, "col": 1, "methods": [
+      { "name": "charge", "parameters": "amount: Money", "returns": "Receipt", "visibility": "public" }
+    ] }
+  ],
+  "relationships": [
+    { "id": "card_implements", "from": "card", "to": "gateway", "kind": "realization" },
+    { "id": "wallet_implements", "from": "wallet", "to": "gateway", "kind": "realization" }
+  ]
+}

package/dist/phoenix-diagram/bundle/examples/minimal.dataflow.json

@@ -0,0 +1,11 @@
+{
+  "schema_version": 1,
+  "diagram_type": "dataflow",
+  "meta": { "title": "Records dataflow", "output": "minimal.dataflow.html", "input_contract": "phoenix-v1", "quality_profile": "showcase", "locale": "en" },
+  "stages": [{ "label": "Source" }, { "label": "Process" }],
+  "nodes": [
+    { "id": "source", "type": "database", "label": "Input store", "stage": 0, "row": 0 },
+    { "id": "process", "type": "backend", "label": "Transform", "stage": 1, "row": 0 }
+  ],
+  "flows": [{ "id": "records", "from": "source", "to": "process", "label": "records" }]
+}

package/dist/phoenix-diagram/bundle/examples/minimal.erd.json

@@ -0,0 +1,25 @@
+{
+  "schema_version": 1,
+  "diagram_type": "erd",
+  "meta": { "title": "Order schema", "output": "minimal.erd.html", "input_contract": "phoenix-v1", "quality_profile": "showcase", "locale": "en" },
+  "layout": { "mode": "grid" },
+  "entities": [
+    { "id": "customer", "label": "customer", "tag": "accounts", "row": 0, "col": 0, "attributes": [
+      { "name": "id", "type": "bigint", "key": "pk" },
+      { "name": "email", "type": "varchar(255)", "key": "uk" }
+    ] },
+    { "id": "order", "label": "order", "row": 0, "col": 1, "attributes": [
+      { "name": "id", "type": "bigint", "key": "pk" },
+      { "name": "customer_id", "type": "bigint", "key": "fk", "references": "customer.id" },
+      { "name": "placed_at", "type": "timestamptz" }
+    ] },
+    { "id": "payment", "label": "payment", "row": 1, "col": 1, "attributes": [
+      { "name": "id", "type": "bigint", "key": "pk" },
+      { "name": "order_id", "type": "bigint", "key": "fk", "references": "order.id" }
+    ] }
+  ],
+  "relationships": [
+    { "id": "order_customer", "from": "order", "to": "customer", "label": "placed by", "fromCardinality": "many", "toCardinality": "one" },
+    { "id": "payment_order", "from": "payment", "to": "order", "fromCardinality": "many", "fromOptional": true, "toCardinality": "one", "identifying": false }
+  ]
+}

package/dist/phoenix-diagram/bundle/examples/minimal.lifecycle.json

@@ -0,0 +1,11 @@
+{
+  "schema_version": 3,
+  "diagram_type": "lifecycle",
+  "meta": { "title": "Request lifecycle", "output": "minimal.lifecycle.html", "input_contract": "phoenix-v1", "quality_profile": "showcase", "locale": "en" },
+  "mainPath": ["created", "complete"],
+  "states": [
+    { "id": "created", "type": "start", "label": "Created" },
+    { "id": "complete", "type": "success", "label": "Complete" }
+  ],
+  "transitions": [{ "id": "finish", "from": "created", "to": "complete", "label": "Finish" }]
+}

package/dist/phoenix-diagram/bundle/examples/minimal.sequence.json

@@ -0,0 +1,13 @@
+{
+  "schema_version": 1,
+  "diagram_type": "sequence",
+  "meta": { "title": "Request sequence", "output": "minimal.sequence.html", "input_contract": "phoenix-v1", "quality_profile": "showcase", "locale": "en" },
+  "participants": [
+    { "id": "client", "type": "frontend", "label": "Client" },
+    { "id": "service", "type": "backend", "label": "Service" }
+  ],
+  "messages": [
+    { "id": "request", "from": "client", "to": "service", "y": 180, "label": "Request" },
+    { "id": "result", "from": "service", "to": "client", "y": 236, "label": "Result", "variant": "return" }
+  ]
+}

package/dist/phoenix-diagram/bundle/examples/minimal.timeline.json

@@ -0,0 +1,15 @@
+{
+  "schema_version": 1,
+  "diagram_type": "timeline",
+  "meta": { "title": "Release day", "output": "minimal.timeline.html", "input_contract": "phoenix-v1", "quality_profile": "showcase", "locale": "en", "evidence": "observed", "timezone": "Asia/Shanghai" },
+  "lanes": [
+    { "id": "release", "label": "Release" },
+    { "id": "operations", "label": "Operations" }
+  ],
+  "events": [
+    { "id": "tagged", "at": "2026-10-01T12:00:00+08:00", "title": "Release tagged", "lane": "release", "kind": "change", "precision": "day" },
+    { "id": "deployed", "at": "2026-10-01T14:20:00+08:00", "title": "Deployment finished", "lane": "release", "kind": "change" },
+    { "id": "alert", "at": "2026-10-01T14:35:00+08:00", "title": "Error rate alert", "lane": "operations", "kind": "alert" },
+    { "id": "recovered", "at": "2026-10-01T15:05:00+08:00", "title": "Error rate recovered", "lane": "operations", "kind": "recovery" }
+  ]
+}

package/dist/phoenix-diagram/bundle/examples/minimal.tree.json

@@ -0,0 +1,13 @@
+{
+  "schema_version": 1,
+  "diagram_type": "tree",
+  "meta": { "title": "Service ownership", "output": "minimal.tree.html", "input_contract": "phoenix-v1", "quality_profile": "showcase", "locale": "en" },
+  "nodes": [
+    { "id": "platform", "label": "Platform", "sublabel": "Owned capabilities" },
+    { "id": "payments", "label": "Payments", "parent": "platform" },
+    { "id": "card", "label": "Card payments", "parent": "payments" },
+    { "id": "wallet", "label": "Wallet payments", "parent": "payments" },
+    { "id": "operations", "label": "Operations", "parent": "platform", "collapsed": true },
+    { "id": "refunds", "label": "Refunds", "parent": "operations" }
+  ]
+}

package/dist/phoenix-diagram/bundle/examples/minimal.waterfall.json

@@ -0,0 +1,12 @@
+{
+  "schema_version": 1,
+  "diagram_type": "waterfall",
+  "meta": { "title": "Checkout request", "output": "minimal.waterfall.html", "input_contract": "phoenix-v1", "quality_profile": "showcase", "locale": "en", "evidence": "illustrative", "unit": "ms" },
+  "spans": [
+    { "id": "request", "name": "POST /checkout", "service": "checkout", "start": 0, "end": 420 },
+    { "id": "auth", "name": "Authenticate", "service": "identity", "parent": "request", "start": 0, "duration": 60 },
+    { "id": "stock", "name": "Reserve stock", "service": "inventory", "parent": "request", "start": 60, "duration": 180 },
+    { "id": "charge", "name": "Charge card", "service": "payments", "parent": "request", "start": 240, "duration": 150, "status": "error" },
+    { "id": "receipt", "name": "Send receipt", "parent": "request", "start": 390, "status": "incomplete" }
+  ]
+}

package/dist/phoenix-diagram/bundle/examples/minimal.workflow.json

@@ -0,0 +1,12 @@
+{
+  "schema_version": 2,
+  "diagram_type": "workflow",
+  "meta": { "title": "Request workflow", "output": "minimal.workflow.html", "input_contract": "phoenix-v1", "quality_profile": "showcase", "locale": "en" },
+  "lanes": [{ "id": "work", "label": "Work" }],
+  "nodes": [
+    { "id": "prepare", "lane": "work", "col": 0, "type": "backend", "label": "Prepare" },
+    { "id": "complete", "lane": "work", "col": 1, "type": "backend", "label": "Complete" }
+  ],
+  "edges": [{ "id": "continue", "from": "prepare", "to": "complete", "label": "Continue", "role": "main" }],
+  "mainPath": ["prepare", "complete"]
+}

package/dist/phoenix-diagram/bundle/manifest.json

@@ -0,0 +1,253 @@
+{
+  "schemaVersion": 1,
+  "tool": "phoenix-diagram",
+  "version": "0.2.0",
+  "files": [
+    {
+      "path": "SKILL.md",
+      "size": 19165,
+      "sha256": "1e4e57d3ea9f842f5f57f4278ded701ba495340ee5bd55e77fa5c76a2a42c1f8",
+      "mode": 420
+    },
+    {
+      "path": "examples/legacy.agent-tool-call.workflow.json",
+      "size": 5687,
+      "sha256": "4d3f6c23de2ca7d306e05d0041a9506833bb5a164a2bddc2d1984cf4da3ee90c",
+      "mode": 420
+    },
+    {
+      "path": "examples/legacy.async-job-roundtrip.sequence.json",
+      "size": 4370,
+      "sha256": "545f20920c89b69c2bb1f15508d5543fddbeb15cffba61e102206e04bd5a5cd9",
+      "mode": 420
+    },
+    {
+      "path": "examples/legacy.deployment-release.lifecycle.json",
+      "size": 4274,
+      "sha256": "735c2c5819266e6ea2a71775b6eefce98b53030ce90cb721dc8e1d022ce5be71",
+      "mode": 420
+    },
+    {
+      "path": "examples/legacy.product-analytics.dataflow.json",
+      "size": 5618,
+      "sha256": "91411404fb4828a3b7ea358f3a7b9877781c9e9dc9c04b42b6eb4a757281b59f",
+      "mode": 420
+    },
+    {
+      "path": "examples/legacy.web-app.architecture.json",
+      "size": 3793,
+      "sha256": "483350f5297df682aba4e4a0fa491307ce3d3abd725ae4df07fab177490752cf",
+      "mode": 420
+    },
+    {
+      "path": "examples/minimal.architecture.json",
+      "size": 552,
+      "sha256": "af2adbcf0f7a8ed531236a10489938063dfd33d497085219481a83fe8a7113d7",
+      "mode": 420
+    },
+    {
+      "path": "examples/minimal.class.json",
+      "size": 1189,
+      "sha256": "90be6447369379f288e71426c06a7f0e5d2ce588b9837d63b52c2c62167315f9",
+      "mode": 420
+    },
+    {
+      "path": "examples/minimal.dataflow.json",
+      "size": 558,
+      "sha256": "f773be76cbb4618e8e1209c634209621f7db9707d5dcc9305555e4be46206865",
+      "mode": 420
+    },
+    {
+      "path": "examples/minimal.erd.json",
+      "size": 1317,
+      "sha256": "40675c35b4e46bc67e06d4f05f5d6de62c7a4690310c4f8a6b4f751eb0895d1b",
+      "mode": 420
+    },
+    {
+      "path": "examples/minimal.lifecycle.json",
+      "size": 496,
+      "sha256": "aa09cfb1cbff35d1d31cef5babd9dd74a6cd8568e92e86d429aeaa74c493dae8",
+      "mode": 420
+    },
+    {
+      "path": "examples/minimal.sequence.json",
+      "size": 583,
+      "sha256": "f3a87f15792cf20071ab01887ccc1761a6528adbee7161453e59f5eaad845d85",
+      "mode": 420
+    },
+    {
+      "path": "examples/minimal.timeline.json",
+      "size": 928,
+      "sha256": "fa7da309dcd87268784f76510cbe9162a8c53f1808376efe993dd37e89f4543f",
+      "mode": 420
+    },
+    {
+      "path": "examples/minimal.tree.json",
+      "size": 678,
+      "sha256": "feb42bc6f3b78b3832c2fa27f2170940fec6510283acdec0a50f17e9968bc113",
+      "mode": 420
+    },
+    {
+      "path": "examples/minimal.waterfall.json",
+      "size": 862,
+      "sha256": "67630b6716fea1b803e10256f11df1d5edced57b5c8ede13462e943160421bb9",
+      "mode": 420
+    },
+    {
+      "path": "examples/minimal.workflow.json",
+      "size": 608,
+      "sha256": "e2421e77955c3b4e9bf225b9f1e50f1cf3d2304d85b2420f3c87b7c2448ccb87",
+      "mode": 420
+    },
+    {
+      "path": "references/architecture-compare.md",
+      "size": 8445,
+      "sha256": "c760ed03277e8dfb5abad06ba64d56ef6932019c622cb92eb8b4691de466e658",
+      "mode": 420
+    },
+    {
+      "path": "references/authoring-defaults.md",
+      "size": 12726,
+      "sha256": "45f4c685ca6937b5645a31c4d43a145c758d67933e57b72e36e5c6844414a998",
+      "mode": 420
+    },
+    {
+      "path": "references/brand-marks.md",
+      "size": 5056,
+      "sha256": "fd05816d87871454f72b51e6c911b6cb9c7909d7c29f02e66807a871333b4b7a",
+      "mode": 420
+    },
+    {
+      "path": "references/compatibility.md",
+      "size": 1819,
+      "sha256": "806e3314078dbd991ad3410a0caf271527d7d7bf41308d49fbc1cc0fde409f4b",
+      "mode": 420
+    },
+    {
+      "path": "references/delivery-contract.md",
+      "size": 10406,
+      "sha256": "1b78c76b6347b5845d97f1375962d959ae3a35e42212e55763c960d40e357ec6",
+      "mode": 420
+    },
+    {
+      "path": "references/extending-types.md",
+      "size": 2023,
+      "sha256": "3180cbc6803f8f5fe3662ce4a1af43e308a5744965107eeac65d22111d513652",
+      "mode": 420
+    },
+    {
+      "path": "references/migration.md",
+      "size": 6211,
+      "sha256": "9aad9f2d99eb2f2da9d2f2d656a7a7f01179862a815a6b07f3bf450fe565453a",
+      "mode": 420
+    },
+    {
+      "path": "references/preview.md",
+      "size": 4577,
+      "sha256": "ac8c4ecc1f90d366e980ecd8fb234049ecfcdc587247638ca642dc26a2b5d2e4",
+      "mode": 420
+    },
+    {
+      "path": "references/repository-authoring.md",
+      "size": 4980,
+      "sha256": "29e86cb5e4d629a28aee825c07300e386dd4a324f3e79d4c264f20971efa4f73",
+      "mode": 420
+    },
+    {
+      "path": "references/viewer-runtime.md",
+      "size": 3289,
+      "sha256": "ba92156c1e311f07374974fd11698e17414ed0807f2a7fe1f97e9cceacd2bbe7",
+      "mode": 420
+    },
+    {
+      "path": "schemas/README.md",
+      "size": 3109,
+      "sha256": "4109c6b16e7bafa84bb5a23b94765da7823e18a2b78cf8f0eed271a37b7197bc",
+      "mode": 420
+    },
+    {
+      "path": "schemas/architecture.schema.json",
+      "size": 8003,
+      "sha256": "cf6cbe9f33a19a4b219493b3bf33c4fa7bab8865f620cd917c82664a576a2fd7",
+      "mode": 420
+    },
+    {
+      "path": "schemas/class.schema.json",
+      "size": 8191,
+      "sha256": "2b1601fcf26a4e7cd20775da8a8f2affd7cc13133d774279be0c425ba9c4c0fa",
+      "mode": 420
+    },
+    {
+      "path": "schemas/common.schema.json",
+      "size": 7551,
+      "sha256": "e288d7f35fee4ead02a96e7e091ecbf601d0aa74da41b2ecf31c9e664be09685",
+      "mode": 420
+    },
+    {
+      "path": "schemas/dataflow.schema.json",
+      "size": 6609,
+      "sha256": "c5d4203fe2014f1d95214e3694cb7e5b0112beb562bbe26f0cccf29c797635c9",
+      "mode": 420
+    },
+    {
+      "path": "schemas/erd.schema.json",
+      "size": 9400,
+      "sha256": "d71cb4a394bc3604b56c0cadecf31470da3ef3781a8100a6ea19dbe9810e2e11",
+      "mode": 420
+    },
+    {
+      "path": "schemas/lifecycle.schema.json",
+      "size": 5733,
+      "sha256": "60ef8990ed65e9b5aa506f6e100a979ee2e0570a2171b0b9065054518249e604",
+      "mode": 420
+    },
+    {
+      "path": "schemas/sequence.schema.json",
+      "size": 6503,
+      "sha256": "11b9ce2bc6f495e4a854f2da4074600b707670d197cec3ef2c5c5584ed0a841b",
+      "mode": 420
+    },
+    {
+      "path": "schemas/timeline.schema.json",
+      "size": 4284,
+      "sha256": "6d87ee8cf0f2b2ff6aae0a7baf64d745d96f86e76417c6ed2a7820663670f613",
+      "mode": 420
+    },
+    {
+      "path": "schemas/tree.schema.json",
+      "size": 3243,
+      "sha256": "41889536e9a61a0b0670667d45e558439a0b71575800864934772e8531f67fd6",
+      "mode": 420
+    },
+    {
+      "path": "schemas/waterfall.schema.json",
+      "size": 3597,
+      "sha256": "8fc221fb04c0bf873441ce0962e8e5d4c68efdd37bb5dc5bf5e8286cde40fb7e",
+      "mode": 420
+    },
+    {
+      "path": "schemas/workflow.schema.json",
+      "size": 10522,
+      "sha256": "cca36492e633e5c3ae68b9271dd88317b5552eacee402cd4822c9f04db6bbf7a",
+      "mode": 420
+    },
+    {
+      "path": "scripts/phoenix-bootstrap.cjs",
+      "size": 45211,
+      "sha256": "35fe87eb4e534470bc3bb2e6cc05e5483796694a8dd58f01c7702f3129132b71",
+      "mode": 420
+    },
+    {
+      "path": "scripts/phoenix-diagram",
+      "size": 253,
+      "sha256": "01c5ff1736d619ae17e9de466fce482cc2371c2e390953c1eb4911f985244b53",
+      "mode": 493
+    },
+    {
+      "path": "scripts/phoenix-launcher.cjs",
+      "size": 556,
+      "sha256": "a88e7902c3a9398931601cad6f4c08f5f8b2571dfc112ba0e915ed32c223086f",
+      "mode": 493
+    }
+  ]
+}