@rosenfan/matrix 0.1.1 → 0.1.2

package/assets/skills-zh-CN/matrix-build/SKILL.md

@@ -1,11 +1,35 @@
 ---
 name: matrix-build
-description: 用测试优先的纵向切片实现冻结的 Matrix 计划。
+description: 用测试优先的纵向切片实现冻结的 Matrix 计划。仅在活动 Matrix 阶段为 build 时使用。
 ---
 
 # Matrix Build
 
-只实现冻结计划中的范围。使用 `implement` 与预先确认的 `tdd` 测试边界；持续记录 `artifacts/verification.md` 的 `## Build evidence`。如发现范围或设计变化，返回设计阶段。
+读取 `matrix workflow inspect`、`plan.md`、`design.md`、已批准 Contract 与仓库指令，只实现冻结范围。
+
+## 编排
+
+- **Prim**：使用 Matrix 自身实现与测试能力。
+- **Arch**：可测试行为变化时调用 `tdd`；真实失败且根因未知时调用 `diagnosing-bugs`；仅在进行中的 merge/rebase 冲突时调用 `resolving-merge-conflicts`。
+
+调用前说明能力与原因。companion 不得 commit、review、transition、archive 或扩大范围。正确安装的能力失败时最多执行一次同能力 Matrix fallback，并记录调用、失败、fallback 与证据；安装完整性问题必须停止并修复。
+
+## 范围纪律
+
+若实现暴露范围或设计变化，停止并执行：
+
+```powershell
+matrix workflow return design --reason design-gap
+```
+
+回到 Design 会清除既有 Contract 批准并轮换当前验证证据；重新进入 Build 必须生成新的批准与新证据。
+
+## 流程
+
+1. 用 `tdd` 以纵向切片实现。
+2. 在 `artifacts/verification.md` 的 `## Build evidence` 记录具体命令和结果。
+3. 运行 Build guard；它同时确认批准的 Contract 仍精确匹配。
+4. 通过后推进至 Verify，并进入 `$matrix-verify`。
 
 ```powershell
 matrix workflow guard build

package/assets/skills-zh-CN/matrix-claude/SKILL.md

@@ -1,30 +1,31 @@
 ---
 name: matrix-claude
-description: 将冻结的 Matrix 设计导出为受边界约束的 Claude Code 任务包，不改变 Matrix 工作流状态。
+description: 将已批准的 Matrix Contract 导出为受边界约束的 Claude Code 任务包，不改变 Matrix 工作流状态。
 ---
 
 # Matrix Claude Handoff
 
-这是可选的旁路操作，而不是 Matrix phase。它不得执行 `transition`、`archive`，也不得写入 `matrix.yaml`、`run-state.json` 或 `events.jsonl`。
+这是可选旁路，不是 Matrix phase。它不得执行 `transition`、`archive`，也不得写入 `matrix.yaml` 或 `events.jsonl`。
 
-仅当设计阶段守卫已通过，并且用户明确选择由 Claude Code 实现时使用。先检查：
+仅当变更已进入 Build、`design -> build` 已批准精确 Contract，并且用户明确选择 Claude Code 实现时使用。先检查：
 
 ```powershell
-matrix workflow guard design
+matrix workflow guard build
 ```
 
-如果主命令确实不在 PATH 中，才使用已安装根 Matrix Skill 中的 bundled runtime；主命令已启动但返回业务错误时不得回退。
-
-导出通用任务包：
+若结果为 `CONTRACT_CHANGED`、`CONTRACT_UNAPPROVED` 或 `CONTRACT_READ_FAILED`，回到 `$matrix-design`，修订后重新进入 Build 取得新批准。导出只读取批准快照中的 `proposal.md`、`design.md` 与 `plan.md`。
 
 ```powershell
+# 通用项目：只导出 Matrix 产物
 matrix workflow export --task-id <ID> --target generic
+
+# FnSec：仅在 active.md 含有 NO_ACTIVE_OBJECTIVE 时更新看板
+matrix workflow export --task-id <ID> --target fnsec --apply-fnsec-board
 ```
 
-导出 FnSec 任务包时，只有在 `docs/tasks/active.md` 包含 `NO_ACTIVE_OBJECTIVE` 时才可使用 `--apply-fnsec-board`；现有任务绝不覆盖：
+任务包包含批准的 Contract hash 与 revision，以及同一快照的 proposal、design、plan。导出本身不改变 Build 阶段；Claude 完成后，补齐 `## Build evidence`，然后继续：
 
 ```powershell
-matrix workflow export --task-id <ID> --target fnsec --apply-fnsec-board
+matrix workflow guard build
+matrix workflow transition verify
 ```
-
-任务包会包含冻结的 proposal、design、plan，以及 Claude Code 回执所需的改动、验证、边界确认和 `NEEDS_DECISION` 项目。

package/assets/skills-zh-CN/matrix-design/SKILL.md

@@ -1,13 +1,18 @@
----
-name: matrix-design
-description: 在实现前设计并冻结活动 Matrix 变更。
----
+---
+name: matrix-design
+description: 在实现前设计并冻结活动 Matrix 变更。
+---
+
+# Matrix Design
+
+读取 `matrix workflow inspect`、proposal 与冻结 `orchestration`，写入 `design.md`（`## Decisions`、`## Boundaries`、`## Test seams`、`## Risks`）与 `plan.md`（`## Steps`、`## Validation`、`## Stop conditions`）。
 
-# Matrix Design
+- **Prim**：使用 Matrix 自身能力调查并设计。
+- **Arch**：仅按事实触发 `domain-modeling`、`research`、`wayfinder`、`prototype`、`codebase-design`，不得机械执行固定序列。每次调用前说明能力与原因。
 
-阅读 proposal，写入 `design.md`（`## Decisions`、`## Boundaries`、`## Test seams`、`## Risks`）与 `plan.md`（`## Steps`、`## Validation`、`## Stop conditions`）。重大范围或架构决策须先由用户确认。
-
-```powershell
-matrix workflow guard design
-matrix workflow transition build
-```
+长期有效的领域、ADR 或研究产物遵循仓库约定，关键结论必须同步进入 Matrix design/plan。prototype 默认写入系统临时目录。companion 不得拥有 Matrix 状态或创建竞争计划。重大范围或架构决策须先由用户确认。
+
+```powershell
+matrix workflow guard design
+matrix workflow transition build
+```

package/assets/skills-zh-CN/matrix-hotfix/SKILL.md

@@ -1,8 +1,8 @@
----
-name: matrix-hotfix
-description: 为可复现的小型缺陷运行受约束的 Matrix 工作流。
----
-
-# Matrix Hotfix
-
-从 `$matrix` 以 `hotfix` 工作流启动。使用 `diagnosing-bugs` 建立可复现的红色反馈循环；如果问题影响架构、公开 API、数据模式或多模块协调，要求升级为完整工作流。
+---
+name: matrix-hotfix
+description: 为可复现的小型缺陷运行受约束的 Matrix 工作流。
+---
+
+# Matrix Hotfix
+
+从 `$matrix` 以 `hotfix` 工作流启动并保持冻结的 Prim/Arch 编排。Prim 自行诊断；Arch 仅在真实失败存在且根因未知时调用 `diagnosing-bugs`。companion 输出必须回到 Matrix 产物与状态。若问题影响架构、公开 API、数据模式或多模块协调，受控 Return 后升级为完整工作流。

package/assets/skills-zh-CN/matrix-open/SKILL.md

@@ -1,13 +1,18 @@
----
-name: matrix-open
-description: 将开发请求澄清为有证据的 Matrix 提案。
----
+---
+name: matrix-open
+description: 将开发请求澄清为有证据的 Matrix 提案。
+---
+
+# Matrix Open
+
+读取 `matrix workflow inspect` 的活动变更与冻结 `orchestration`；写入 `artifacts/proposal.md`，必须包含 `## Goal`、`## Scope`、`## Non-goals`、`## Acceptance`、`## Risks`。
 
-# Matrix Open
+- **Prim**：使用 Matrix 自身能力澄清并编写提案。
+- **Arch**：仅在存在重大歧义或用户要求压力测试时调用 `grilling`；仅在领域词汇、不变量或架构决定不清晰时调用 `domain-modeling`。调用前说明能力与原因。
 
-读取 `matrix workflow inspect` 的活动变更。使用 `grill-with-docs` 澄清完整工作流请求；写入 `artifacts/proposal.md`，必须包含 `## Goal`、`## Scope`、`## Non-goals`、`## Acceptance`、`## Risks`。
-
-```powershell
-matrix workflow guard open
-matrix workflow transition design
-```
+companion 输出只能作为当前 proposal 的证据，不得创建第二套工作流、提案、确认状态或阶段转换。正确安装的能力失败时最多执行一次同能力 Matrix fallback；安装完整性问题必须修复。
+
+```powershell
+matrix workflow guard open
+matrix workflow transition design
+```

package/assets/skills-zh-CN/matrix-status/SKILL.md

@@ -1,14 +1,15 @@
----
-name: matrix-status
-description: 检查活动 Matrix 工作流的磁盘状态、守卫与恢复命令。
----
-
-# Matrix Status
-
-执行：
-
-```powershell
+---
+name: matrix-status
+description: 检查活动 Matrix 工作流的磁盘状态、守卫与恢复命令。
+---
+
+# Matrix Status
+
+执行：
+
+```powershell
 matrix workflow inspect
+matrix workflow doctor
 ```
 
-报告变更 ID、工作流、阶段、守卫结果和 `next_skill`；不得修改状态。
+报告变更 ID、工作流、冻结 `orchestration`、阶段、守卫结果、`next_skill`、Workflow health、未完成 transaction、可用策略和精确恢复命令。Arch 完整性失败时列出平台/Skill 事实并报告 `matrix init --with-mattpocock`，不得把 change 解释为 Prim。两条命令都只读；不得推断恢复策略、运行 `--repair` 或修改状态。

package/assets/skills-zh-CN/matrix-tweak/SKILL.md

@@ -1,8 +1,8 @@
----
-name: matrix-tweak
-description: 为边界清晰的小改动运行轻量 Matrix 工作流。
----
-
-# Matrix Tweak
-
-从 `$matrix` 以 `tweak` 工作流启动。保持提案和设计简洁，但仍定义验收条件与测试边界。若涉及 API、模式、架构或跨模块协调，升级为完整工作流。
+---
+name: matrix-tweak
+description: 为边界清晰的小改动运行轻量 Matrix 工作流。
+---
+
+# Matrix Tweak
+
+从 `$matrix` 以 `tweak` 工作流启动并保持冻结的 Prim/Arch 编排。保持提案和设计简洁，但仍定义验收条件与测试边界。Arch 只调用满足正常事实触发条件的能力，轻量流程不会获得固定 companion 序列或更弱的证据要求。若涉及 API、模式、架构或跨模块协调，受控 Return 后升级为完整工作流。

package/assets/skills-zh-CN/matrix-verify/SKILL.md

@@ -1,13 +1,27 @@
----
-name: matrix-verify
-description: 依据计划验证 Matrix 变更并审查差异。
----
+---
+name: matrix-verify
+description: 依据计划验证 Matrix 变更并审查差异。
+---
+
+# Matrix Verify
+
+运行计划的验证命令，在 `verification.md` 写入 `## Test evidence`。读取冻结 `orchestration`：
 
-# Matrix Verify
+- **Prim**：Matrix 自行完成 Standards 与 Spec 双轴审查。
+- **Arch**：调用 `code-review` 产生双轴证据，并说明调用原因。
 
-运行计划的验证命令，在 `verification.md` 写入 `## Test evidence`。使用 `code-review` 完成标准与规格双轴审查，并在 `## Review evidence` 记录结论。失败时回到产生问题的阶段。
+审查结果只是 Matrix Verify 的输入；companion 不得决定阶段结果、扩大已批准架构、推进或归档。不得调用事后架构改进 wrapper。正确安装的审查能力失败时最多执行一次同能力 Matrix fallback；安装完整性问题必须停止。
+
+失败时使用受控 Return：
 
 ```powershell
-matrix workflow guard verify
-matrix workflow transition archive
+matrix workflow return build --reason verification-failed
+matrix workflow return design --reason acceptance-or-design-gap
 ```
+
+Return 会轮换旧 `verification.md`；不得把旧结论直接复制为新的当前证据。
+
+```powershell
+matrix workflow guard verify
+matrix workflow transition archive
+```

package/bin/matrix.js

@@ -1,15 +1,15 @@
-#!/usr/bin/env node
-
-import { main } from "../src/cli.js";
-
-main(process.argv.slice(2)).then((exitCode) => {
-  if (Number.isInteger(exitCode) && exitCode !== 0) process.exitCode = exitCode;
-}).catch((error) => {
-  if (error.code === "CANCELLED") {
-    console.log("\nCancelled.");
-    process.exitCode = 0;
-  } else {
-    console.error(`\nMatrix error: ${error.message}`);
-    process.exitCode = 1;
-  }
-});
+#!/usr/bin/env node
+
+import { main } from "../src/cli.js";
+
+main(process.argv.slice(2)).then((exitCode) => {
+  if (Number.isInteger(exitCode) && exitCode !== 0) process.exitCode = exitCode;
+}).catch((error) => {
+  if (error.code === "CANCELLED") {
+    console.log("\nCancelled.");
+    process.exitCode = 0;
+  } else {
+    console.error(`\nMatrix error: ${error.message}`);
+    process.exitCode = 1;
+  }
+});

package/package.json

@@ -1,56 +1,56 @@
-{
-  "name": "@rosenfan/matrix",
-  "version": "0.1.1",
-  "description": "Install and manage the Matrix workflow for Matt Pocock's agent skills.",
-  "license": "MIT",
-  "type": "module",
-  "bin": {
-    "matrix": "bin/matrix.js"
-  },
-  "files": [
-    "bin/",
-    "src/",
-    "assets/skills-zh-CN",
-    ".claude/skills/matrix",
-    ".claude/skills/matrix-open",
-    ".claude/skills/matrix-design",
-    ".claude/skills/matrix-build",
-    ".claude/skills/matrix-verify",
-    ".claude/skills/matrix-archive",
-    ".claude/skills/matrix-hotfix",
-    ".claude/skills/matrix-tweak",
-    ".claude/skills/matrix-status",
-    ".claude/skills/matrix-claude",
-    "!.claude/skills/**/__pycache__",
-    "!.claude/skills/**/scripts/test_*.py",
-    "README.md",
-    "README.zh-CN.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "test": "node --test",
-    "pack:check": "npm pack --dry-run",
-    "prepublishOnly": "npm run test && npm run pack:check"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Rosenfan/Matrix.git"
-  },
-  "bugs": {
-    "url": "https://github.com/Rosenfan/Matrix/issues"
-  },
-  "homepage": "https://github.com/Rosenfan/Matrix#readme",
-  "publishConfig": {
-    "access": "public"
-  },
-  "keywords": [
-    "claude-code",
-    "agent-skills",
-    "workflow",
-    "tdd",
-    "ai"
-  ]
-}
+{
+  "name": "@rosenfan/matrix",
+  "version": "0.1.2",
+  "description": "Evidence-driven development workflow with Prim and Arch agent-skill orchestration.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "matrix": "bin/matrix.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "assets/skills-zh-CN",
+    ".claude/skills/matrix",
+    ".claude/skills/matrix-open",
+    ".claude/skills/matrix-design",
+    ".claude/skills/matrix-build",
+    ".claude/skills/matrix-verify",
+    ".claude/skills/matrix-archive",
+    ".claude/skills/matrix-hotfix",
+    ".claude/skills/matrix-tweak",
+    ".claude/skills/matrix-status",
+    ".claude/skills/matrix-claude",
+    "!.claude/skills/**/__pycache__",
+    "!.claude/skills/**/scripts/test_*.py",
+    "README.md",
+    "README.zh-CN.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node --test",
+    "pack:check": "npm pack --dry-run",
+    "prepublishOnly": "npm run test && npm run pack:check"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Rosenfan/Matrix.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Rosenfan/Matrix/issues"
+  },
+  "homepage": "https://github.com/Rosenfan/Matrix#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "claude-code",
+    "agent-skills",
+    "workflow",
+    "tdd",
+    "ai"
+  ]
+}

package/src/catalog.js

@@ -1,87 +1,92 @@
-import crypto from "node:crypto";
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-export const LANGUAGE_IDS = ["en", "zh-CN"];
-export const PLATFORM_IDS = ["claude-code", "codex"];
-export const MATRIX_SKILLS = [
-  "matrix", "matrix-open", "matrix-design", "matrix-build", "matrix-verify",
-  "matrix-archive", "matrix-hotfix", "matrix-tweak", "matrix-status", "matrix-claude"
-];
+import crypto from "node:crypto";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+export const LANGUAGE_IDS = ["en", "zh-CN"];
+export const PLATFORM_IDS = ["claude-code", "codex"];
+export const MATRIX_SKILLS = [
+  "matrix", "matrix-open", "matrix-design", "matrix-build", "matrix-verify",
+  "matrix-archive", "matrix-hotfix", "matrix-tweak", "matrix-status", "matrix-claude"
+];
 export const MATT_SKILLS = [
-  "grill-with-docs", "grilling", "domain-modeling", "research", "wayfinder", "prototype",
-  "codebase-design", "implement", "tdd", "code-review", "diagnosing-bugs",
-  "resolving-merge-conflicts", "improve-codebase-architecture"
+  "grilling", "domain-modeling", "research", "wayfinder", "prototype",
+  "codebase-design", "tdd", "diagnosing-bugs", "resolving-merge-conflicts", "code-review"
 ];
-
-const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
-const packageManifest = JSON.parse(fs.readFileSync(path.join(packageRoot, "package.json"), "utf8"));
-
-export const PLATFORMS = {
-  "claude-code": {
-    id: "claude-code", name: "Claude Code", skillsCliAgent: "claude-code",
-    skillRoot(base) { return path.join(base, ".claude", "skills"); },
-    legacyRoots() { return []; }
-  },
-  codex: {
-    id: "codex", name: "Codex", skillsCliAgent: "codex",
-    skillRoot(base) { return path.join(base, ".agents", "skills"); },
-    legacyRoots(base) { return [path.join(base, ".codex", "skills")]; }
-  }
-};
-
-export function sourceSkillsRoot(language = "en") {
-  const localized = language === "zh-CN"
-    ? path.join(packageRoot, "assets", "skills-zh-CN")
-    : path.join(packageRoot, ".claude", "skills");
-  if (!fs.existsSync(localized)) throw new Error(`Matrix package is incomplete: ${language} assets are missing.`);
-  return localized;
-}
-
-export function scopeBase(scope, projectRoot, home = os.homedir()) {
-  return scope === "global" ? home : projectRoot;
-}
-
-export function installationRoot(scope, projectRoot, home) {
-  return path.join(scopeBase(scope, projectRoot, home), ".matrix");
-}
-
-export function manifestPath(scope, projectRoot, home) {
-  return path.join(installationRoot(scope, projectRoot, home), "installation.json");
-}
-
-export function hashDirectory(directory, extraFiles = []) {
-  const hash = crypto.createHash("sha256");
-  const files = new Map();
-  const visit = (current, relative = "") => {
-    for (const entry of fs.readdirSync(current, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
-      const child = path.join(current, entry.name);
-      const childRelative = path.join(relative, entry.name).replaceAll("\\", "/");
-      if (entry.isDirectory()) visit(child, childRelative);
-      else if (entry.isFile()) {
-        files.set(childRelative, fs.readFileSync(child));
-      }
-    }
-  };
-  visit(directory);
-  for (const extra of extraFiles) files.set(extra.path, Buffer.from(extra.contents));
-  for (const [relative, contents] of [...files.entries()].sort(([left], [right]) => left.localeCompare(right))) {
-    hash.update(`${relative}\0`);
-    hash.update(contents);
-  }
-  return hash.digest("hex");
-}
-
+export const UNMANAGED_MATT_SKILLS = ["grill-with-docs", "implement", "improve-codebase-architecture"];
+
+const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const packageManifest = JSON.parse(fs.readFileSync(path.join(packageRoot, "package.json"), "utf8"));
+
+export const PLATFORMS = {
+  "claude-code": {
+    id: "claude-code", name: "Claude Code", skillsCliAgent: "claude-code",
+    skillRoot(base) { return path.join(base, ".claude", "skills"); },
+    legacyRoots() { return []; }
+  },
+  codex: {
+    id: "codex", name: "Codex", skillsCliAgent: "codex",
+    skillRoot(base) { return path.join(base, ".agents", "skills"); },
+    legacyRoots(base) { return [path.join(base, ".codex", "skills")]; }
+  }
+};
+
+export function sourceSkillsRoot(language = "en") {
+  const localized = language === "zh-CN"
+    ? path.join(packageRoot, "assets", "skills-zh-CN")
+    : path.join(packageRoot, ".claude", "skills");
+  if (!fs.existsSync(localized)) throw new Error(`Matrix package is incomplete: ${language} assets are missing.`);
+  return localized;
+}
+
+export function scopeBase(scope, projectRoot, home = os.homedir()) {
+  return scope === "global" ? home : projectRoot;
+}
+
+export function installationRoot(scope, projectRoot, home) {
+  return path.join(scopeBase(scope, projectRoot, home), ".matrix");
+}
+
+export function manifestPath(scope, projectRoot, home) {
+  return path.join(installationRoot(scope, projectRoot, home), "installation.json");
+}
+
+export function hashDirectory(directory, extraFiles = []) {
+  const hash = crypto.createHash("sha256");
+  const files = new Map();
+  const visit = (current, relative = "") => {
+    for (const entry of fs.readdirSync(current, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+      const child = path.join(current, entry.name);
+      const childRelative = path.join(relative, entry.name).replaceAll("\\", "/");
+      if (entry.isDirectory()) visit(child, childRelative);
+      else if (entry.isFile()) {
+        files.set(childRelative, fs.readFileSync(child));
+      }
+    }
+  };
+  visit(directory);
+  for (const extra of extraFiles) files.set(extra.path, Buffer.from(extra.contents));
+  for (const [relative, contents] of [...files.entries()].sort(([left], [right]) => left.localeCompare(right))) {
+    hash.update(`${relative}\0`);
+    hash.update(contents);
+  }
+  return hash.digest("hex");
+}
+
 export function workflowRuntimeSource() { return path.join(packageRoot, "src", "workflow.js"); }
-
-export function releaseCatalog(language = "en") {
-  if (!LANGUAGE_IDS.includes(language)) throw new Error(`Unsupported language: ${language}`);
+export function workflowTransactionSource() { return path.join(packageRoot, "src", "workflow-transaction.js"); }
+
+export function releaseCatalog(language = "en") {
+  if (!LANGUAGE_IDS.includes(language)) throw new Error(`Unsupported language: ${language}`);
   const root = sourceSkillsRoot(language);
   const missing = MATRIX_SKILLS.filter((skill) => !fs.existsSync(path.join(root, skill, "SKILL.md")));
   if (missing.length) throw new Error(`Matrix package is incomplete. Missing: ${missing.join(", ")}`);
   const runtime = fs.readFileSync(workflowRuntimeSource());
-  const skills = Object.fromEntries(MATRIX_SKILLS.map((skill) => [skill, hashDirectory(path.join(root, skill), [{ path: "scripts/matrix-runtime.mjs", contents: runtime }])]));
-  return { language, root, version: packageManifest.version, skills, digest: crypto.createHash("sha256").update(JSON.stringify(skills)).digest("hex") };
-}
+  const transaction = fs.readFileSync(workflowTransactionSource());
+  const skills = Object.fromEntries(MATRIX_SKILLS.map((skill) => [skill, hashDirectory(path.join(root, skill), [
+    { path: "scripts/matrix-runtime.mjs", contents: runtime },
+    { path: "scripts/workflow-transaction.js", contents: transaction }
+  ])]));
+  return { language, root, version: packageManifest.version, skills, digest: crypto.createHash("sha256").update(JSON.stringify(skills)).digest("hex") };
+}