用途:对已脚手架化的 harness 执行 Ed25519 见证清单(witness manifest)签名校验,属于快速的是/否式校验,用于证明发布者签名的正是当前这套文件。它与 validate-harness 不同,后者是总括检查(doctor、verify、path-guard、mcp、secrets),而 verify-witness 只做签名检查。
主要能力:读取 .harness/witness.json,检查文件是否存在、清单结构是否包含 harness、version、entries、public_key、signature 等必需字段,并用内嵌公钥做 Ed25519 签名验证,最终报告 VALID 或 INVALID 及一行原因。严格模式下若无见证文件则退出非零;非严格模式则软跳过并报 PASS。
使用方式:在 Codex 中可用命令 /verify-witness、/verify-witness path=./my-harness、/verify-witness path=./my-harness strict=false。等价的 CLI 命令为:harness verify ./my-harness。退出码约定为 Exit 0 表示签名 VALID,Exit 1 表示 INVALID 或严格模式下缺失。
适用场景:两个 harness 进行联邦(iter 9)时,需要先确认彼此的见证签名,再执行完整发布就绪检查,拆分此表面可让联邦对等方做快速签名握手而不必承担完整校验开销;只关心签名完整性的 CI 工作流(例如把已发布的 harness 镜像到私有 registry)也可调用它而非更重的总括检查。
限制:资料未提供定价、平台支持范围及更多配置项说明;仅确认其在 Codex 与等价 CLI 下的上述调用方式和退出码行为。