SCzhengand修雨
809d026b7e
* ci(interface): 添加接口完整性和CLI烟雾测试检查 - 在Makefile中新增interface-integrity、update-interface-baseline、cli-smoke和mock-mcp-smoke目标 - 实现接口基线脚本以比较CLI公共命令树与基线文件 - 新增脚本确保二进制文件可渲染所有顶层命令的帮助信息 - 添加mock-mcp-smoke测试验证HTTP和stdio MCP请求/响应传输 - 在GitHub Actions CI工作流中加入interface-integrity、cli-smoke和mock-mcp-smoke检查 - 新增AI行为检查工作流，限制AI生成PR的改动范围和禁改保护文件 - 文档中补充PR质量门禁要求及接口变更流程说明 * feat(policy): 增加多项兼容性和完整性检查 - Makefile中新增reset-interface-baseline、schema-compatibility、update-schema-baseline、skill-command-integrity等目标 - CI流程新增schema-compatibility和skill-command-integrity步骤 - 文档中详细说明接口兼容性基线更新和重置流程及schema基线注意事项 - 实现interface-baseline工具支持兼容性重置和合并，多项接口兼容性检查逻辑完善 - 新增schema-compat工具用于标准化schema列表及兼容性检查与合并 - 新增skill-command-integrity检查确保技能中引用命令存在 - 为interface-baseline和schema-compat添加单元测试覆盖基本兼容性规则 * test(skill-command-check): 增加命令解析和解析结果测试用例 - 补充对 parseReference 函数的边界情况和跳过条件的测试 - 新增 resolveCommandReference 函数测试，覆盖有效、无效及跳过场景 - 增加 isPlaceholder 函数的测试，验证占位符识别准确性 refactor(skill-command-check): 优化命令路径解析和验证逻辑 - 使用 resolveCommandReference 统一处理命令解析结果，清晰区分有效、无效和跳过情况 - 新增 commandResolution 类型及常量，提升代码可读性和扩展性 - 调整 parseReference 增加对 shell 组合符 “ & ” 的跳过处理 docs(mono): 更新最佳实践和产品文档命令示例 - 优化《best_practices/07-minutes.md》中行动项与摘要拉取示例命令，提升准确性 - 修改产品文档中 ALIDOC 表格数据和多维表格记录相关命令，命令路径更规范统一 - 同步多端技能文档，确保命令示例一致且正确 * ci: check interface against PR merge-base * feat(policy): enforce CLI contract compatibility * ci: enforce PR coverage thresholds * ci: add fail-closed CI gate * ci: adapt schema compatibility gate to runtime catalog * fix(ci): close schema compatibility gate gaps * test(auth): skip POSIX mode assertion on Windows * test(auth): scope POSIX file-backend checks * fix(ci): enforce native platform coverage * test(ci): make skill paths portable --------- Co-authored-by: 修雨 <huyizhou.hyz@alibaba-inc.com>
50 lines
1.6 KiB
Bash
Executable File
50 lines
1.6 KiB
Bash
Executable File
#!/bin/sh
|
|
set -eu
|
|
|
|
# Verify that the shipped binary can render help for every public top-level
|
|
# command without login state or network access. Interface Integrity checks
|
|
# the complete tree; this smoke test checks the actual compiled artifact.
|
|
|
|
ROOT="$(CDPATH= cd -- "$(dirname -- "$0")/../.." && pwd)"
|
|
BIN="${DWS_BIN:-$ROOT/dws}"
|
|
BASELINE="$ROOT/test/fixtures/cli-interface-baseline.txt"
|
|
|
|
if [ ! -x "$BIN" ]; then
|
|
printf 'error: dws binary not found at %s (run make build first)\n' "$BIN" >&2
|
|
exit 1
|
|
fi
|
|
if [ ! -f "$BASELINE" ]; then
|
|
printf 'error: interface baseline missing at %s\n' "$BASELINE" >&2
|
|
exit 1
|
|
fi
|
|
|
|
SNAPSHOT_HOME="$(mktemp -d)"
|
|
trap 'rm -rf "$SNAPSHOT_HOME"' EXIT
|
|
|
|
# DWS_DISABLE_KEYCHAIN=1 routes the DEK to a file (the Linux scheme) instead of
|
|
# the macOS system Keychain. Without it, running the binary under this fresh
|
|
# HOME triggers a GUI Keychain authorization prompt that blocks the
|
|
# non-interactive smoke test indefinitely. Linux CI already uses the file DEK.
|
|
run_help() {
|
|
output="$(HOME="$SNAPSHOT_HOME" DWS_DISABLE_KEYCHAIN=1 DWS_LANG=zh "$BIN" "$@" --help 2>&1)" || {
|
|
printf 'error: dws %s --help exited non-zero\n%s\n' "$*" "$output" >&2
|
|
return 1
|
|
}
|
|
}
|
|
|
|
run_help
|
|
|
|
command_line="$(sed -n '/^\[root\]$/{n;s/^ commands: //;p;q;}' "$BASELINE")"
|
|
if [ -z "$command_line" ]; then
|
|
printf 'error: no root commands found in interface baseline\n' >&2
|
|
exit 1
|
|
fi
|
|
|
|
count=0
|
|
for command in $(printf '%s\n' "$command_line" | tr -d ','); do
|
|
run_help "$command"
|
|
count=$((count + 1))
|
|
done
|
|
|
|
printf 'CLI smoke check: ok (root + %s public top-level commands)\n' "$count"
|