Home / gzx2211 / dsh-visual-workflow · GitHub

AGENTS.md@testsA

AGENTS.md@tests from gzx2211/dsh-visual-workflow is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned

mdr add gzx2211/dsh-visual-workflow/tests/AGENTS.md@git:20261010.f913e19

Pins git:20261010.f913e19 in mdr.lock. Pin the fingerprint instead.

Audit grade: A, 14 of 14 checks passed
Kind: AGENTS.md file
Repository: gzx2211/dsh-visual-workflow
Path: tests/AGENTS.md
Versions recorded: 4
Latest version: git:20261010.f913e19, committed Oct 10, 2026
First version recorded: Sep 21, 2026
Size: 4,096 bytes
Repository stars: 65
License: MIT

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Test Module Rules

## 范围与目标

适用于 `tests/`。测试用于验证真实行为、稳定契约、模块协作和完整流程，而非提高覆盖率数字。禁止为通过测试或提高覆盖率制造无意义断言。
本文件是**测试侧唯一权威**：测试的层级选择、文件命名、编写规则与覆盖率要求只在本文件出现一次。

## 层级与选择
- `tests/client/`、`tests/host/`：单元测试。
- `tests/integration/`：集成测试。验证多模块协作。可用受控基础设施，但不得全量 Mock 内部模块。
- `tests/contract/`：包与构建契约门禁。验证发布包形态、挂载契约、构建产物与随包资产。只做静态文本/产物断言，不验证运行时协作。
- `tests/e2e/`：端到端测试。覆盖完整 Workflow、Client → Host → Runtime、用户关键路径。

选择能最低成本验证目标行为的最低测试层级。不得因 E2E 可测而跳过 Unit / Integration，也不得为数量把真实协作全部 Mock 成 Unit。

## 文件与命名
- `tests/client/`、`tests/host/` 必须镜像对应 `src/` 目录。
- `tests/contract/` 其断言对象是包级产物与构建链路，按被验证的契约命名。
- 测试文件统一为 `<source-name>.test.ts`。源码移动或重命名时，同步调整测试位置与 import。
- 纯类型、声明、barrel、常量、极薄适配层、已被上层测试覆盖的代码，不强制创建空测试文件。
- 任何新增可测试业务逻辑必须有相应测试覆盖。

## 编写规则
- 使用 AAA：Arrange / Act / Assert。一个测试聚焦一个行为，多行为应拆分。
- 测试必须独立：不得依赖执行顺序、其他测试数据、共享可变状态、残留文件、数据库、全局变量或 Mock 状态。
- 时间、随机数、异步必须确定：使用 fake timer、固定时间、固定随机源、可控 Promise。显式等待目标完成，禁止任意 `sleep`。
- 测试数据最小、可读、与目的直接相关。复杂对象用 Factory / Fixture。不得修改全局 Fixture 影响其他测试。
- 断言必须验证可观察结果与业务语义。避免 `toBeDefined`、`toBeTruthy` 等空断言。避免测试私有变量、内部临时函数、无关调用顺序。
- 必测正常路径、失败路径、边界条件、分支。错误测试需验证实际错误语义，而非仅“抛出异常”。
- Mock 只用于隔离测试边界。禁止 Mock 被测对象、所有内部函数。需要大量 Mock 时，检查测试层级、模块耦合与边界。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint

mdr add gzx2211/dsh-visual-workflow/tests/AGENTS.md@sha256:ce8150d7e61a7fce

The line at the top of this page pins the label git:20261010.f913e19, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

[![mdr](https://markdownregistry.com/badge/art_bf5goeekowd6cijs.svg)](https://markdownregistry.com/a/art_bf5goeekowd6cijs)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Sep 21, 2026 and Oct 10, 2026, about one every 6 days.

version	committed	commit	size	audit
git:20261010.f913e19 latest	2026-10-10	f913e19	4,096 B	A	view · diff
git:20260923.4575b13	2026-09-23	4575b13	4,180 B	A	view · diff
git:20260922.e71ebae	2026-09-22	e71ebae	4,369 B	A	view · diff
git:20260921.c0879f8	2026-09-21	c0879f8	4,020 B	A	view

Audit of the latest version

A 14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.

pass: Size between 200 bytes and 200 KB (4096 bytes)
pass: No zero-width or bidi control characters
pass: No instruction hidden inside an HTML comment
pass: No link to an exfiltration or paste host
pass: No credential-shaped string
pass: No instruction to send local credentials anywhere
pass: No text hidden with inline styles
pass: No prompt-injection phrasing
pass: No curl or wget piped into a shell
pass: No recursive delete of root, home or parent
pass: No instruction to read or print local credentials
pass: No base64 blob over 200 characters
pass: No link to a raw IP address
pass: No script tag

Source

GitHub

gzx2211/dsh-visual-workflow · 65 stars · license MIT · pushed 2026-10-29 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_bf5goeekowd6cijs
GET https://markdownregistry.com/api/v1/resolve?ref=gzx2211/dsh-visual-workflow/tests/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/ce8150d7e61a7fcef532221d71142c3829cb0e5924a9ac998ef6f270d200a40b

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.