ws-spec-kit 0.1.0-beta.0

package/dist/domain/artifacts.js

@@ -0,0 +1,241 @@
+import { readFile, realpath } from "node:fs/promises";
+import path from "node:path";
+import * as canonicalizeModule from "canonicalize";
+import { parse, stringify } from "yaml";
+import { sha256 } from "./digests.js";
+import { resolveRepositoryRegularFile } from "./repository-path.js";
+import { SchemaValidationError, validate } from "../schemas/index.js";
+const canonicalize = canonicalizeModule.default;
+export function artifactOutputId(reference) {
+    if (reference.outputId !== undefined && reference.outputId !== "")
+        return reference.outputId;
+    return reference.artifactType === "requirement-source" ? "requirement-source" : undefined;
+}
+export class ArtifactError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "ArtifactError";
+    }
+}
+const sectionContracts = {
+    specification: ["目标与背景", "范围", "需求", "验收条件", "约束", "排除项", "开放问题"],
+    design: ["上下文与架构", "组件职责和边界", "接口与数据契约", "安全与权限", "失败与恢复", "兼容或迁移", "测试策略", "已知权衡"],
+    plan: ["有序交付任务", "任务依赖", "精确文件范围", "验证方式", "人工检查点", "回滚方式"],
+    tasks: ["任务"],
+    "implementation-result": ["实际改动", "修改文件", "计划偏差", "验证摘要", "未完成项", "残余风险"],
+    "review-result": ["Findings"],
+    "verification-result": ["Gate/Evidence 矩阵", "未通过项", "覆盖限制", "残余风险"],
+    "knowledge-entry": ["背景", "需求或 Bug", "关键决策", "实现摘要", "验证证据", "适用范围", "限制", "相关引用"],
+};
+export function normalizeArtifactBody(body) {
+    const normalized = body
+        .replaceAll("\r\n", "\n")
+        .replaceAll("\r", "\n")
+        .split("\n")
+        .map((line) => line.replace(/[ \t]+$/u, ""))
+        .join("\n")
+        .replace(/\n*$/u, "");
+    return `${normalized}\n`;
+}
+export function computeArtifactContentHash(metadataWithoutHash, body) {
+    const canonicalMetadata = canonicalize(metadataWithoutHash);
+    if (canonicalMetadata === undefined) {
+        throw new ArtifactError("WSSPEC_ARTIFACT_SCHEMA_MISMATCH", "Artifact 元数据无法规范化。");
+    }
+    return sha256(`${canonicalMetadata}\n${normalizeArtifactBody(body)}`);
+}
+export function createArtifactDocument(input) {
+    const body = normalizeArtifactBody(input.body);
+    verifySections(input.artifactType, body, true);
+    const metadataWithoutHash = {
+        artifactType: input.artifactType,
+        outputId: input.outputId,
+        schemaVersion: 1,
+        workItemId: input.workItemId,
+        stageId: input.stageId,
+        attemptId: input.attemptId,
+        revision: 1,
+    };
+    const contentHash = computeArtifactContentHash(metadataWithoutHash, body);
+    const metadata = { ...metadataWithoutHash, contentHash };
+    return {
+        content: `---\n${stringify(metadata, { lineWidth: 0 })}---\n${body}`,
+        reference: {
+            artifactType: input.artifactType,
+            outputId: input.outputId,
+            schemaVersion: 1,
+            mediaType: "text/markdown",
+            revision: 1,
+            contentHash,
+        },
+    };
+}
+function decodeStrict(buffer) {
+    if (buffer.length >= 3 && buffer[0] === 0xef && buffer[1] === 0xbb && buffer[2] === 0xbf) {
+        throw new ArtifactError("WSSPEC_ARTIFACT_ENCODING_INVALID", "Artifact 禁止 UTF-8 BOM。");
+    }
+    try {
+        return new TextDecoder("utf-8", { fatal: true }).decode(buffer);
+    }
+    catch {
+        throw new ArtifactError("WSSPEC_ARTIFACT_ENCODING_INVALID", "Artifact 必须是严格 UTF-8。");
+    }
+}
+export async function readArtifact(filename) {
+    const content = decodeStrict(await readFile(filename));
+    const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/u.exec(content);
+    if (match === null) {
+        throw new ArtifactError("WSSPEC_ARTIFACT_SCHEMA_MISMATCH", "Artifact 缺少完整 YAML front matter。");
+    }
+    let metadata;
+    try {
+        metadata = validate("builtin.artifact.v1", parse(match[1]));
+    }
+    catch (error) {
+        if (error instanceof SchemaValidationError) {
+            throw new ArtifactError("WSSPEC_ARTIFACT_SCHEMA_MISMATCH", `${error.path}: ${error.message}`);
+        }
+        throw error;
+    }
+    return { metadata, body: match[2] };
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+}
+function sectionBody(type, section, body) {
+    const heading = new RegExp(`^#{1,6}\\s+${escapeRegExp(section)}\\s*$`, "mu");
+    const match = heading.exec(body);
+    if (match === null)
+        throw new ArtifactError("WSSPEC_ARTIFACT_INCOMPLETE", `${type} 缺少必需章节：${section}`);
+    const afterHeading = body.slice(match.index + match[0].length).replace(/^\r?\n/u, "");
+    const nextHeading = /^#{1,6}\s+/mu.exec(afterHeading);
+    const content = afterHeading.slice(0, nextHeading?.index ?? afterHeading.length).trim();
+    if (content === "")
+        throw new ArtifactError("WSSPEC_ARTIFACT_INCOMPLETE", `${type} 的必需章节为空：${section}`);
+    return content;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function structuredYaml(type, section, body) {
+    const fenced = /```yaml\s*\n([\s\S]*?)\n```/u.exec(sectionBody(type, section, body));
+    if (fenced === null)
+        throw new ArtifactError("WSSPEC_ARTIFACT_SCHEMA_MISMATCH", `${type}.${section} 缺少 fenced YAML。`);
+    const value = parse(fenced[1]);
+    if (!isRecord(value))
+        throw new ArtifactError("WSSPEC_ARTIFACT_SCHEMA_MISMATCH", `${type}.${section} 必须是对象。`);
+    return value;
+}
+function requireString(record, field) {
+    const value = record[field];
+    if (typeof value !== "string" || value.trim() === "") {
+        throw new ArtifactError("WSSPEC_ARTIFACT_SCHEMA_MISMATCH", `结构化字段 ${field} 必须是非空字符串。`);
+    }
+    return value;
+}
+function verifyStructuredContent(type, body) {
+    if (type === "tasks") {
+        const tasks = structuredYaml(type, "任务", body).tasks;
+        if (!Array.isArray(tasks) || tasks.length === 0)
+            throw new ArtifactError("WSSPEC_ARTIFACT_SCHEMA_MISMATCH", "tasks 必须是非空数组。");
+        for (const task of tasks) {
+            if (!isRecord(task) || !Array.isArray(task.dependencies))
+                throw new ArtifactError("WSSPEC_ARTIFACT_SCHEMA_MISMATCH", "task 结构不完整。");
+            requireString(task, "id");
+            requireString(task, "completion");
+            if (!["pending", "in_progress", "completed", "blocked"].includes(requireString(task, "status"))) {
+                throw new ArtifactError("WSSPEC_ARTIFACT_SCHEMA_MISMATCH", "task.status 不合法。");
+            }
+        }
+    }
+    if (type === "review-result") {
+        const findings = structuredYaml(type, "Findings", body).findings;
+        if (!Array.isArray(findings))
+            throw new ArtifactError("WSSPEC_ARTIFACT_SCHEMA_MISMATCH", "findings 必须是数组。");
+        for (const finding of findings) {
+            if (!isRecord(finding))
+                throw new ArtifactError("WSSPEC_ARTIFACT_SCHEMA_MISMATCH", "finding 必须是对象。");
+            requireString(finding, "id");
+            if (!["P0", "P1", "P2", "P3"].includes(requireString(finding, "severity"))) {
+                throw new ArtifactError("WSSPEC_ARTIFACT_SCHEMA_MISMATCH", "finding.severity 不合法。");
+            }
+            requireString(finding, "description");
+            requireString(finding, "evidence");
+            const findingPath = requireString(finding, "path");
+            if (path.isAbsolute(findingPath) || findingPath.split(/[\\/]/u).includes("..")) {
+                throw new ArtifactError("WSSPEC_ARTIFACT_SCHEMA_MISMATCH", "finding.path 必须是仓库相对路径。");
+            }
+            if (!["open", "fixed", "accepted", "false-positive"].includes(requireString(finding, "disposition"))) {
+                throw new ArtifactError("WSSPEC_ARTIFACT_SCHEMA_MISMATCH", "finding.disposition 不合法。");
+            }
+            if (finding.line !== undefined && (!Number.isInteger(finding.line) || finding.line < 1)) {
+                throw new ArtifactError("WSSPEC_ARTIFACT_SCHEMA_MISMATCH", "finding.line 必须是正整数。");
+            }
+        }
+    }
+    if (type === "verification-result") {
+        const gates = structuredYaml(type, "Gate/Evidence 矩阵", body).gates;
+        if (!Array.isArray(gates) || gates.length === 0)
+            throw new ArtifactError("WSSPEC_ARTIFACT_SCHEMA_MISMATCH", "gates 必须是非空数组。");
+        for (const gate of gates) {
+            if (!isRecord(gate) || typeof gate.required !== "boolean")
+                throw new ArtifactError("WSSPEC_ARTIFACT_SCHEMA_MISMATCH", "gate 结构不完整。");
+            for (const field of ["gateId", "expectedLevel", "evidenceId", "workspaceTreeDigest", "result"])
+                requireString(gate, field);
+            if (!(typeof gate.occurredAt === "string" || gate.occurredAt instanceof Date)) {
+                throw new ArtifactError("WSSPEC_ARTIFACT_SCHEMA_MISMATCH", "gate.occurredAt 必须是时间字符串。");
+            }
+        }
+    }
+}
+function verifySections(type, body, allowUnregisteredType) {
+    const sections = sectionContracts[type];
+    if (sections === undefined) {
+        if (allowUnregisteredType)
+            return;
+        throw new ArtifactError("WSSPEC_ARTIFACT_SCHEMA_NOT_FOUND", `未注册内置 Artifact 类型：${type}`);
+    }
+    for (const section of sections)
+        sectionBody(type, section, body);
+    verifyStructuredContent(type, body);
+}
+export async function verifyArtifact(filename, expected, options = {}) {
+    const root = await realpath(expected.repositoryRoot);
+    const relative = path.relative(path.resolve(expected.repositoryRoot), path.resolve(filename));
+    if (relative.startsWith("..") || path.isAbsolute(relative) || relative === "") {
+        throw new ArtifactError("WSSPEC_ARTIFACT_REFERENCE_INVALID", "Artifact 路径越出仓库边界。");
+    }
+    let actual;
+    try {
+        actual = await resolveRepositoryRegularFile(root, relative.split(path.sep).join("/"));
+    }
+    catch {
+        throw new ArtifactError("WSSPEC_ARTIFACT_REFERENCE_INVALID", "Artifact 必须是仓库内的普通文件，且不能经过符号链接。");
+    }
+    const artifact = await readArtifact(actual);
+    const { metadata } = artifact;
+    if (metadata.artifactType !== expected.artifactType ||
+        metadata.workItemId !== expected.workItemId ||
+        metadata.stageId !== expected.stageId ||
+        metadata.attemptId !== expected.attemptId) {
+        throw new ArtifactError("WSSPEC_ARTIFACT_REFERENCE_INVALID", "Artifact 类型或生产者身份与预期不符。");
+    }
+    verifySections(metadata.artifactType, artifact.body, options.allowUnregisteredType === true);
+    const { contentHash, ...metadataWithoutHash } = metadata;
+    const actualHash = computeArtifactContentHash(metadataWithoutHash, artifact.body);
+    if (actualHash !== contentHash) {
+        throw new ArtifactError("WSSPEC_ARTIFACT_HASH_MISMATCH", "Artifact 内容哈希与规范化内容不匹配。");
+    }
+    return {
+        artifactType: metadata.artifactType,
+        ...(metadata.outputId === undefined ? {} : { outputId: metadata.outputId }),
+        schemaVersion: metadata.schemaVersion,
+        path: relative.split(path.sep).join("/"),
+        mediaType: "text/markdown",
+        revision: metadata.revision,
+        contentHash,
+    };
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/domain/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/domain/artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,KAAK,kBAAkB,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAExC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEtE,MAAM,YAAY,GAAG,kBAAkB,CAAC,OAA4D,CAAC;AAoCrG,MAAM,UAAU,gBAAgB,CAAC,SAA+D;IAC9F,IAAI,SAAS,CAAC,QAAQ,KAAK,SAAS,IAAI,SAAS,CAAC,QAAQ,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC,QAAQ,CAAC;IAC7F,OAAO,SAAS,CAAC,YAAY,KAAK,oBAAoB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5F,CAAC;AAED,MAAM,OAAO,aAAc,SAAQ,KAAK;IACjB;IAArB,YAAqB,IAAY,EAAE,OAAe;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QADI,SAAI,GAAJ,IAAI,CAAQ;QAE/B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,gBAAgB,GAA6B;IACjD,aAAa,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC;IACjE,MAAM,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;IACnF,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;IAC3D,KAAK,EAAE,CAAC,IAAI,CAAC;IACb,uBAAuB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IACzE,eAAe,EAAE,CAAC,UAAU,CAAC;IAC7B,qBAAqB,EAAE,CAAC,kBAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IACnE,iBAAiB,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC;CACnF,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,MAAM,UAAU,GAAG,IAAI;SACpB,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC;SACxB,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC;SACtB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;SAC3C,IAAI,CAAC,IAAI,CAAC;SACV,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACxB,OAAO,GAAG,UAAU,IAAI,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,mBAA4C,EAAE,IAAY;IACnG,MAAM,iBAAiB,GAAG,YAAY,CAAC,mBAAmB,CAAC,CAAC;IAC5D,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,IAAI,aAAa,CAAC,iCAAiC,EAAE,oBAAoB,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,iBAAiB,KAAK,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAOtC;IACC,MAAM,IAAI,GAAG,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/C,cAAc,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/C,MAAM,mBAAmB,GAAG;QAC1B,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,aAAa,EAAE,CAAU;QACzB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,CAAC;KACZ,CAAC;IACF,MAAM,WAAW,GAAG,0BAA0B,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAqB,EAAE,GAAG,mBAAmB,EAAE,WAAW,EAAE,CAAC;IAC3E,OAAO;QACL,OAAO,EAAE,QAAQ,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,QAAQ,IAAI,EAAE;QACpE,SAAS,EAAE;YACT,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,aAAa,EAAE,CAAC;YAChB,SAAS,EAAE,eAAe;YAC1B,QAAQ,EAAE,CAAC;YACX,WAAW;SACZ;KACF,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,MAAc;IAClC,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACzF,MAAM,IAAI,aAAa,CAAC,kCAAkC,EAAE,wBAAwB,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,aAAa,CAAC,kCAAkC,EAAE,uBAAuB,CAAC,CAAC;IACvF,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,6CAA6C,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1E,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,aAAa,CAAC,iCAAiC,EAAE,kCAAkC,CAAC,CAAC;IACjG,CAAC;IACD,IAAI,QAA0B,CAAC;IAC/B,IAAI,CAAC;QACH,QAAQ,GAAG,QAAQ,CAAmB,qBAAqB,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC;IACjF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,qBAAqB,EAAE,CAAC;YAC3C,MAAM,IAAI,aAAa,CAAC,iCAAiC,EAAE,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAChG,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAE,EAAE,CAAC;AACvC,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,OAAe,EAAE,IAAY;IAC9D,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,cAAc,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC7E,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,IAAI;QAAE,MAAM,IAAI,aAAa,CAAC,4BAA4B,EAAE,GAAG,IAAI,WAAW,OAAO,EAAE,CAAC,CAAC;IACvG,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACtF,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACxF,IAAI,OAAO,KAAK,EAAE;QAAE,MAAM,IAAI,aAAa,CAAC,4BAA4B,EAAE,GAAG,IAAI,YAAY,OAAO,EAAE,CAAC,CAAC;IACxG,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,OAAe,EAAE,IAAY;IACjE,MAAM,MAAM,GAAG,8BAA8B,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IACrF,IAAI,MAAM,KAAK,IAAI;QAAE,MAAM,IAAI,aAAa,CAAC,iCAAiC,EAAE,GAAG,IAAI,IAAI,OAAO,kBAAkB,CAAC,CAAC;IACtH,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC;IAChC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,aAAa,CAAC,iCAAiC,EAAE,GAAG,IAAI,IAAI,OAAO,SAAS,CAAC,CAAC;IAC9G,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,MAA+B,EAAE,KAAa;IACnE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,IAAI,aAAa,CAAC,iCAAiC,EAAE,SAAS,KAAK,YAAY,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAY,EAAE,IAAY;IACzD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC;QACrD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,aAAa,CAAC,iCAAiC,EAAE,gBAAgB,CAAC,CAAC;QAC9H,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC;gBAAE,MAAM,IAAI,aAAa,CAAC,iCAAiC,EAAE,aAAa,CAAC,CAAC;YACpI,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC1B,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YAClC,IAAI,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC;gBAChG,MAAM,IAAI,aAAa,CAAC,iCAAiC,EAAE,kBAAkB,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC;QACjE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YAAE,MAAM,IAAI,aAAa,CAAC,iCAAiC,EAAE,iBAAiB,CAAC,CAAC;QAC5G,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,MAAM,IAAI,aAAa,CAAC,iCAAiC,EAAE,gBAAgB,CAAC,CAAC;YACrG,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC7B,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC;gBAC3E,MAAM,IAAI,aAAa,CAAC,iCAAiC,EAAE,uBAAuB,CAAC,CAAC;YACtF,CAAC;YACD,aAAa,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;YACtC,aAAa,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YACnC,MAAM,WAAW,GAAG,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACnD,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/E,MAAM,IAAI,aAAa,CAAC,iCAAiC,EAAE,yBAAyB,CAAC,CAAC;YACxF,CAAC;YACD,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC;gBACrG,MAAM,IAAI,aAAa,CAAC,iCAAiC,EAAE,0BAA0B,CAAC,CAAC;YACzF,CAAC;YACD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAK,OAAO,CAAC,IAAe,GAAG,CAAC,CAAC,EAAE,CAAC;gBACpG,MAAM,IAAI,aAAa,CAAC,iCAAiC,EAAE,sBAAsB,CAAC,CAAC;YACrF,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,IAAI,KAAK,qBAAqB,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,EAAE,kBAAkB,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC;QACnE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,aAAa,CAAC,iCAAiC,EAAE,gBAAgB,CAAC,CAAC;QAC9H,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,SAAS;gBAAE,MAAM,IAAI,aAAa,CAAC,iCAAiC,EAAE,aAAa,CAAC,CAAC;YACrI,KAAK,MAAM,KAAK,IAAI,CAAC,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,qBAAqB,EAAE,QAAQ,CAAC;gBAAE,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC3H,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,YAAY,IAAI,CAAC,EAAE,CAAC;gBAC9E,MAAM,IAAI,aAAa,CAAC,iCAAiC,EAAE,2BAA2B,CAAC,CAAC;YAC1F,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,IAAY,EAAE,qBAA8B;IAChF,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,IAAI,qBAAqB;YAAE,OAAO;QAClC,MAAM,IAAI,aAAa,CAAC,kCAAkC,EAAE,qBAAqB,IAAI,EAAE,CAAC,CAAC;IAC3F,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,QAAQ;QAAE,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACjE,uBAAuB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAgB,EAChB,QAA6B,EAC7B,UAA+C,EAAE;IAEjD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9F,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,KAAK,EAAE,EAAE,CAAC;QAC9E,MAAM,IAAI,aAAa,CAAC,mCAAmC,EAAE,oBAAoB,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QAAC,MAAM,GAAG,MAAM,4BAA4B,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAAC,CAAC;IAC9F,MAAM,CAAC;QAAC,MAAM,IAAI,aAAa,CAAC,mCAAmC,EAAE,iCAAiC,CAAC,CAAC;IAAC,CAAC;IAC1G,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;IAC9B,IACE,QAAQ,CAAC,YAAY,KAAK,QAAQ,CAAC,YAAY;QAC/C,QAAQ,CAAC,UAAU,KAAK,QAAQ,CAAC,UAAU;QAC3C,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC,OAAO;QACrC,QAAQ,CAAC,SAAS,KAAK,QAAQ,CAAC,SAAS,EACzC,CAAC;QACD,MAAM,IAAI,aAAa,CAAC,mCAAmC,EAAE,yBAAyB,CAAC,CAAC;IAC1F,CAAC;IACD,cAAc,CAAC,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,qBAAqB,KAAK,IAAI,CAAC,CAAC;IAC7F,MAAM,EAAE,WAAW,EAAE,GAAG,mBAAmB,EAAE,GAAG,QAAQ,CAAC;IACzD,MAAM,UAAU,GAAG,0BAA0B,CAAC,mBAAmB,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAClF,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;QAC/B,MAAM,IAAI,aAAa,CAAC,+BAA+B,EAAE,yBAAyB,CAAC,CAAC;IACtF,CAAC;IACD,OAAO;QACL,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,GAAG,CAAC,QAAQ,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC3E,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QACxC,SAAS,EAAE,eAAe;QAC1B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/domain/digests.d.ts

@@ -0,0 +1,11 @@
+export interface TreeEntry {
+    path: string;
+    type: "file" | "symlink" | "deleted";
+    mode: "100644" | "100755" | "120000" | "deleted";
+    digest?: string;
+    target?: string;
+}
+export declare function sha256(content: string | Uint8Array): string;
+export declare function computeWorkspaceSnapshot(cwd: string): Promise<TreeEntry[]>;
+export declare function computeWorkspaceTreeDigest(cwd: string): Promise<string>;
+export declare function computeArtifactTreeDigest(cwd: string): Promise<string>;

package/dist/domain/digests.js

@@ -0,0 +1,106 @@
+import { createHash } from "node:crypto";
+import { lstat, readFile, readdir, readlink } from "node:fs/promises";
+import path from "node:path";
+import { repositoryRoot, runGitRaw } from "../storage/git.js";
+export function sha256(content) {
+    return `sha256:${createHash("sha256").update(content).digest("hex")}`;
+}
+function volatileRuntimePath(candidate) {
+    return /^\.wsspec\/work-items\/[^/]+\/control-plane\/(?:runtime\.json|events\.jsonl|runtime\.lock)$/u.test(candidate);
+}
+function artifactPath(candidate) {
+    return /^\.wsspec\/work-items\/[^/]+\/artifacts\//u.test(candidate);
+}
+async function snapshotPaths(root, paths) {
+    const entries = [];
+    for (const relativePath of paths) {
+        const absolutePath = path.join(root, relativePath);
+        try {
+            const stat = await lstat(absolutePath);
+            if (stat.isSymbolicLink()) {
+                entries.push({ path: relativePath, type: "symlink", mode: "120000", target: await readlink(absolutePath) });
+            }
+            else if (stat.isFile()) {
+                entries.push({
+                    path: relativePath,
+                    type: "file",
+                    mode: (stat.mode & 0o111) === 0 ? "100644" : "100755",
+                    digest: sha256(await readFile(absolutePath)),
+                });
+            }
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                entries.push({ path: relativePath, type: "deleted", mode: "deleted" });
+            else
+                throw error;
+        }
+    }
+    return entries;
+}
+async function listedPaths(root) {
+    const output = await runGitRaw(root, ["ls-files", "-z", "--cached", "--others", "--exclude-standard"]);
+    return output.split("\0").filter((candidate) => candidate !== "")
+        .sort((left, right) => Buffer.from(left).compare(Buffer.from(right)));
+}
+async function artifactPaths(root) {
+    const itemRoot = path.join(root, ".wsspec", "work-items");
+    const result = [];
+    const walk = async (directory, relative) => {
+        const entries = await readdir(directory, { withFileTypes: true });
+        entries.sort((left, right) => Buffer.from(left.name).compare(Buffer.from(right.name)));
+        for (const entry of entries) {
+            const childRelative = `${relative}/${entry.name}`;
+            if (entry.isDirectory())
+                await walk(path.join(directory, entry.name), childRelative);
+            else
+                result.push(childRelative);
+        }
+    };
+    let items;
+    try {
+        items = await readdir(itemRoot, { withFileTypes: true });
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+    items.sort((left, right) => Buffer.from(left.name).compare(Buffer.from(right.name)));
+    for (const item of items) {
+        if (!item.isDirectory())
+            continue;
+        const artifacts = path.join(itemRoot, item.name, "artifacts");
+        const relative = `.wsspec/work-items/${item.name}/artifacts`;
+        let stat;
+        try {
+            stat = await lstat(artifacts);
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                continue;
+            throw error;
+        }
+        if (stat.isDirectory())
+            await walk(artifacts, relative);
+        else
+            result.push(relative);
+    }
+    return result.sort((left, right) => Buffer.from(left).compare(Buffer.from(right)));
+}
+export async function computeWorkspaceSnapshot(cwd) {
+    const root = await repositoryRoot(cwd);
+    const paths = (await listedPaths(root)).filter((candidate) => !artifactPath(candidate)
+        && !volatileRuntimePath(candidate) && !candidate.startsWith(".wsspec/archive/"));
+    return snapshotPaths(root, paths);
+}
+export async function computeWorkspaceTreeDigest(cwd) {
+    const entries = await computeWorkspaceSnapshot(cwd);
+    return sha256(`${JSON.stringify({ version: 1, entries })}\n`);
+}
+export async function computeArtifactTreeDigest(cwd) {
+    const root = await repositoryRoot(cwd);
+    const entries = await snapshotPaths(root, await artifactPaths(root));
+    return sha256(`${JSON.stringify({ version: 1, entries })}\n`);
+}
+//# sourceMappingURL=digests.js.map

package/dist/domain/digests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"digests.js","sourceRoot":"","sources":["../../src/domain/digests.ts"],"names":[],"mappings":"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"}

package/dist/domain/external-receipt.d.ts

@@ -0,0 +1,48 @@
+import type { WorkPackage } from "../protocol/work-package.js";
+export type ExternalTarget = "issue" | "knowledge";
+export interface ExternalBinding {
+    version: 1;
+    kind: "external-binding";
+    target: ExternalTarget;
+    exists: true;
+    stableId: string;
+    externalWorkItemId: string;
+    publishStepId: string;
+    publishAttemptId: string;
+    publishInputDigest: string;
+    expectedPublishedContentDigest: string;
+}
+export interface ExternalReceipt {
+    version: 1;
+    kind: "external-receipt";
+    target: ExternalTarget;
+    stableId: string;
+    externalEffectKind?: "issue.comment";
+    externalEffectId?: string;
+    externalWorkItemId: string;
+    publishStepId: string;
+    publishAttemptId: string;
+    publishInputDigest: string;
+    publishedContentDigest: string;
+    readBackContentDigest: string;
+    status: "confirmed";
+    readBackStatus: "confirmed" | "stale" | "failed";
+}
+export declare function parseExternalReceipt(value: unknown): ExternalReceipt | undefined;
+export declare function parseExternalBinding(value: unknown): ExternalBinding | undefined;
+export declare function externalPublishTarget(action: string | undefined): ExternalTarget | undefined;
+export declare function createExternalBinding(input: {
+    target: ExternalTarget;
+    workPackage: WorkPackage;
+    discoveryBinding: unknown;
+    expectedPublishedContentDigest?: string;
+}): ExternalBinding;
+export declare function externalReceiptValues(evidence: Readonly<Record<string, unknown>>): unknown[];
+export declare function externalBindingValues(evidence: Readonly<Record<string, unknown>>): unknown[];
+export declare function assertExternalReceipts(evidence: Readonly<Record<string, unknown>>, code: `WSSPEC_${string}`): void;
+export declare function externalReceiptMatches(input: {
+    receipt: unknown;
+    target: ExternalTarget;
+    binding: unknown;
+    readBackRequired: boolean;
+}): boolean;

package/dist/domain/external-receipt.js

@@ -0,0 +1,138 @@
+import * as canonicalizeModule from "canonicalize";
+import { sha256 } from "./digests.js";
+import { validate } from "../schemas/index.js";
+const canonicalize = canonicalizeModule.default;
+function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value) ? value : undefined;
+}
+export function parseExternalReceipt(value) {
+    try {
+        return validate("builtin.external-receipt.v1", value);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function parseExternalBinding(value) {
+    try {
+        return validate("builtin.external-binding.v1", value);
+    }
+    catch {
+        return undefined;
+    }
+}
+function normalizedArtifacts(artifacts) {
+    if (artifacts.length === 0 || artifacts.some((artifact) => typeof artifact.contentHash !== "string" || artifact.contentHash === "")) {
+        throw new Error("External publish input 必须包含至少一个具有内容摘要的 Artifact。");
+    }
+    return artifacts.map((artifact) => ({
+        artifactType: artifact.artifactType,
+        ...(artifact.outputId === undefined ? {} : { outputId: artifact.outputId }),
+        schemaVersion: artifact.schemaVersion,
+        ...(artifact.path === undefined ? {} : { path: artifact.path.replaceAll("\\", "/") }),
+        ...(artifact.revision === undefined ? {} : { revision: artifact.revision }),
+        ...(artifact.contentHash === undefined ? {} : { contentHash: artifact.contentHash }),
+        ...(artifact.mediaType === undefined ? {} : { mediaType: artifact.mediaType }),
+        ...(artifact.contentLevel === undefined ? {} : { contentLevel: artifact.contentLevel }),
+    })).sort((left, right) => Buffer.from(JSON.stringify(left)).compare(Buffer.from(JSON.stringify(right))));
+}
+export function externalPublishTarget(action) {
+    if (action === "issue.update")
+        return "issue";
+    if (action === "knowledge.publish")
+        return "knowledge";
+    return undefined;
+}
+export function createExternalBinding(input) {
+    const discovery = record(input.discoveryBinding);
+    if (discovery?.exists !== true || typeof discovery.stableId !== "string" || discovery.stableId === ""
+        || typeof discovery.externalWorkItemId !== "string" || discovery.externalWorkItemId !== input.workPackage.workItemId) {
+        throw new Error(`External ${input.target} discovery binding 缺少当前 Work Item 的稳定身份。`);
+    }
+    const artifacts = normalizedArtifacts(input.workPackage.artifacts);
+    const content = canonicalize({ version: 1, target: input.target, artifacts });
+    const publishInput = canonicalize({
+        version: 1,
+        target: input.target,
+        workItemId: input.workPackage.workItemId,
+        stepId: input.workPackage.stepId,
+        attemptId: input.workPackage.attemptId,
+        artifacts,
+    });
+    if (content === undefined || publishInput === undefined)
+        throw new Error(`External ${input.target} publish input 无法规范化。`);
+    const expectedPublishedContentDigest = input.target === "knowledge"
+        ? input.expectedPublishedContentDigest
+        : sha256(content);
+    if ((input.target === "knowledge" && !/^sha256:[a-f0-9]{64}$/u.test(expectedPublishedContentDigest ?? ""))
+        || (input.target === "issue" && input.expectedPublishedContentDigest !== undefined)) {
+        throw new Error(`External ${input.target} publish content 摘要缺失或不符合生成规则。`);
+    }
+    return {
+        version: 1,
+        kind: "external-binding",
+        target: input.target,
+        exists: true,
+        stableId: discovery.stableId,
+        externalWorkItemId: discovery.externalWorkItemId,
+        publishStepId: input.workPackage.stepId,
+        publishAttemptId: input.workPackage.attemptId,
+        publishInputDigest: sha256(publishInput),
+        expectedPublishedContentDigest: expectedPublishedContentDigest,
+    };
+}
+export function externalReceiptValues(evidence) {
+    return Object.entries(evidence).filter(([key, value]) => key.startsWith("external-receipt:") || record(value)?.kind === "external-receipt")
+        .map(([, value]) => value);
+}
+export function externalBindingValues(evidence) {
+    return Object.entries(evidence).filter(([key, value]) => key.startsWith("external-binding:") || record(value)?.kind === "external-binding")
+        .map(([, value]) => value);
+}
+export function assertExternalReceipts(evidence, code) {
+    const invalidBinding = Object.entries(evidence)
+        .filter(([key, value]) => key.startsWith("external-binding:") || record(value)?.kind === "external-binding")
+        .some(([key, value]) => {
+        const binding = parseExternalBinding(value);
+        return binding === undefined
+            || key !== `external-binding:${binding.target}`;
+    });
+    const invalidReceipt = Object.entries(evidence)
+        .filter(([key, value]) => key.startsWith("external-receipt:") || record(value)?.kind === "external-receipt")
+        .some(([key, value]) => {
+        const receipt = parseExternalReceipt(value);
+        if (receipt === undefined)
+            return true;
+        return key !== `external-receipt:${receipt.target}`
+            || !externalReceiptMatches({
+                receipt,
+                target: receipt.target,
+                binding: evidence[`external-binding:${receipt.target}`],
+                readBackRequired: true,
+            });
+    });
+    if (invalidBinding || invalidReceipt) {
+        const error = new Error("External receipt 不符合严格身份与内容摘要契约。");
+        error.code = code;
+        throw error;
+    }
+}
+export function externalReceiptMatches(input) {
+    const receipt = parseExternalReceipt(input.receipt);
+    const binding = parseExternalBinding(input.binding);
+    return receipt !== undefined
+        && binding !== undefined
+        && receipt.target === input.target
+        && binding.target === input.target
+        && receipt.stableId === binding.stableId
+        && receipt.externalWorkItemId === binding.externalWorkItemId
+        && receipt.publishStepId === binding.publishStepId
+        && receipt.publishAttemptId === binding.publishAttemptId
+        && receipt.publishInputDigest === binding.publishInputDigest
+        && receipt.publishedContentDigest === binding.expectedPublishedContentDigest
+        && receipt.readBackContentDigest === binding.expectedPublishedContentDigest
+        && receipt.status === "confirmed"
+        && (!input.readBackRequired || (receipt.readBackStatus === "confirmed"
+            && receipt.readBackContentDigest === receipt.publishedContentDigest));
+}
+//# sourceMappingURL=external-receipt.js.map

package/dist/domain/external-receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-receipt.js","sourceRoot":"","sources":["../../src/domain/external-receipt.ts"],"names":[],"mappings":"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"}

package/dist/domain/ids.d.ts

@@ -0,0 +1,7 @@
+export type RepositoryId = `repo-${string}`;
+export type WorkItemId = `WSS-${string}`;
+export type ErrorCode = `WSSPEC_${string}`;
+export type StageId = string;
+export type AttemptId = `attempt-${string}`;
+export declare const isWorkItemId: (value: string) => value is WorkItemId;
+export declare const isErrorCode: (value: string) => value is ErrorCode;

package/dist/domain/ids.js

@@ -0,0 +1,5 @@
+const workItemIdPattern = /^WSS-[A-Za-z0-9-]+$/;
+const errorCodePattern = /^WSSPEC_[A-Z0-9_]+$/;
+export const isWorkItemId = (value) => workItemIdPattern.test(value);
+export const isErrorCode = (value) => errorCodePattern.test(value);
+//# sourceMappingURL=ids.js.map

package/dist/domain/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/domain/ids.ts"],"names":[],"mappings":"AAMA,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AAChD,MAAM,gBAAgB,GAAG,qBAAqB,CAAC;AAE/C,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAa,EAAuB,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClG,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAa,EAAsB,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC"}

package/dist/domain/repository-path.d.ts

@@ -0,0 +1,3 @@
+export declare function isRepositoryRelativePattern(value: string): boolean;
+export declare function matchesRepositoryPath(pattern: string, candidate: string): boolean;
+export declare function resolveRepositoryRegularFile(root: string, relativePath: string): Promise<string>;