test: decouple the translation prompt snapshot from live documents

The snapshot embedded five live bilingual document pairs as reviewed examples, so editing any of them (README, development guide, i18n docs) churned the snapshot. Replace them with three synthetic fixture pairs (product, rules, agent-note shapes) under scripts/fixtures; the prompt examples stay representative without tracking real document content.
2026-08-29 04:26:38 +00:00 · 2026-08-13 13:07:57 +08:00
parent e5819569f4
commit 16d86cfba7
8 changed files with 121 additions and 28 deletions
@@ -0,0 +1,17 @@
+# Agent Note: Offline-first defaults
+
+Status: implemented
+
+English | [中文](agent-note.zh.md)
+
+## Problem
+
+Online checks delayed every run.
+
+## Decision
+
+Run offline by default; expose one opt-in flag.
+
+## Consequences
+
+Runs start instantly. Telemetry stays off unless enabled.
@@ -0,0 +1,17 @@
+# Agent Note: 默认离线
+
+Status: implemented
+
+[English](agent-note.md) | 中文
+
+## 问题
+
+每次运行都被在线检查拖慢。
+
+## 决策
+
+默认离线运行；提供一个选择加入的开关。
+
+## 后果
+
+运行即刻启动；遥测保持关闭，除非显式启用。
@@ -0,0 +1,22 @@
+# Acme Agent
+
+English | [中文](product.zh.md)
+
+Acme Agent is an open-source agent harness that automates repository chores.
+
+It runs fully offline. **No telemetry is transmitted.**
+
+## Install
+
+Install Node.js 24, then run:
+
+```sh
+npx acme-agent setup
+```
+
+The command prints the setup URL, which is `http://127.0.0.1:3080` by default.
+
+## Community
+
+- Report bugs in the issue tracker.
+- Add the `acme-agent` topic to your plugin repository.
@@ -0,0 +1,22 @@
+# Acme Agent
+
+[English](product.md) | 中文
+
+Acme Agent 是一款开源 agent harness（智能体框架），用于自动化仓库日常事务。
+
+它完全离线运行。**不会传输任何遥测数据。**
+
+## 安装
+
+安装 Node.js 24，然后运行：
+
+```sh
+npx acme-agent setup
+```
+
+该命令会打印设置地址，默认地址为 `http://127.0.0.1:3080`。
+
+## 社区
+
+- 在 Issue 跟踪器中报告 bug。
+- 为你的插件仓库添加 `acme-agent` 主题。
@@ -0,0 +1,15 @@
+# Pairing rules
+
+English | [中文](rules.zh.md)
+
+These rules govern the Chinese counterpart of every documentation pair.
+
+## Priority levels
+
+| Level | Meaning |
+|---|---|
+| MUST | The pairing gate rejects a non-conforming pair. |
+| SHOULD | Deviate only with a stated reason. |
+
+- Preserve every proposition of the source.
+- Keep code spans verbatim.
@@ -0,0 +1,15 @@
+# 配对规则
+
+[English](rules.md) | 中文
+
+这些规则约束每个文档配对的中文对侧。
+
+## 优先级
+
+| 级别 | 含义 |
+|---|---|
+| MUST | 配对门禁会拒绝不符合要求的配对。 |
+| SHOULD | 仅在说明理由后偏离。 |
+
+- 保留源文的每个命题。
+- 代码片段原样保留。
@@ -24,14 +24,15 @@ try {
  if (mode !== undefined && mode !== '--snapshot') throw new Error(`unsupported argument ${JSON.stringify(mode)}`)
  const document = read('docs/i18n/translation-prompt.md')
  const terminology = read('docs/i18n/terminology.md')
+  // Synthetic reviewed examples, not live documents: editing a paired document must not
+  // churn the prompt snapshot. Each pair mirrors the other side's structure and uses
+  // terminology-table forms.
  const examplePaths = [
-    ['README.md', 'README.zh.md'],
-    ['docs/development.md', 'docs/development.zh.md'],
-    ['docs/i18n/README.md', 'docs/i18n/README.zh.md'],
-    ['docs/i18n/translation-rules.md', 'docs/i18n/translation-rules.zh.md'],
+    ['scripts/fixtures/translation-prompt/examples/product.md', 'scripts/fixtures/translation-prompt/examples/product.zh.md'],
+    ['scripts/fixtures/translation-prompt/examples/rules.md', 'scripts/fixtures/translation-prompt/examples/rules.zh.md'],
    [
-      '.agents/notes/implemented/process/2026-07-02-bilingual-docs-and-pairing-gate.md',
-      '.agents/notes/implemented/process/2026-07-02-bilingual-docs-and-pairing-gate.zh.md',
+      'scripts/fixtures/translation-prompt/examples/agent-note.md',
+      'scripts/fixtures/translation-prompt/examples/agent-note.zh.md',
    ],
  ] as const
  const examples: TranslationExample[] = examplePaths.map(([english, chinese]) => ({