tuner-testkit 5.3.0__tar.gz → 6.0.0__tar.gz

{tuner_testkit-5.3.0/tuner_testkit.egg-info → tuner_testkit-6.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tuner-testkit
-Version: 5.3.0
+Version: 6.0.0
 Summary: Shared test runtime, recorders, and DNA overlay for SUT test repos
 Author: tuner-testkit contributors
 License-Expression: MIT
@@ -221,4 +221,4 @@ uv sync --extra all
 （被测系统 = 平台本身，uv workspace 成员，共用 `.venv`）：路线图在 `dogfood/assets/domain-notes/platform/roadmap.md`，
 验收活文档在 `dogfood/tests/features/`。见 [`dogfood/README.md`](dogfood/README.md)。
 
-5.3.0 发行说明（功能用例集 `assets/testcases/`）见 [`docs/changelog/TEMPLATE-5.3.0.md`](docs/changelog/TEMPLATE-5.3.0.md)；5.2.0 发行说明（work task / 测试设计 / 证据附件）见 [`docs/changelog/TEMPLATE-5.2.0.md`](docs/changelog/TEMPLATE-5.2.0.md)；5.1.0 发行说明（工作台 / meta stamp / `--json`）见 [`docs/changelog/TEMPLATE-5.1.0.md`](docs/changelog/TEMPLATE-5.1.0.md)；5.0.0（Plane Job 协议退场、`tuner-workspace`）见 [`TEMPLATE-5.0.0.md`](docs/changelog/TEMPLATE-5.0.0.md)；4.3.0 见 [`TEMPLATE-4.3.0.md`](docs/changelog/TEMPLATE-4.3.0.md)；3.x → 4.x 迁移见 [`TEMPLATE-4.0.0.md`](docs/changelog/TEMPLATE-4.0.0.md)。平台能力地图见 [`INDEX.md`](INDEX.md)。
+6.0.0 发行说明（一条用例一个文件）见 [`docs/changelog/TEMPLATE-6.0.0.md`](docs/changelog/TEMPLATE-6.0.0.md)；5.3.1 发行说明（已回答提问归档）见 [`docs/changelog/TEMPLATE-5.3.1.md`](docs/changelog/TEMPLATE-5.3.1.md)；5.3.0 发行说明（功能用例集 `assets/testcases/`）见 [`docs/changelog/TEMPLATE-5.3.0.md`](docs/changelog/TEMPLATE-5.3.0.md)；5.2.0 发行说明（work task / 测试设计 / 证据附件）见 [`docs/changelog/TEMPLATE-5.2.0.md`](docs/changelog/TEMPLATE-5.2.0.md)；5.1.0 发行说明（工作台 / meta stamp / `--json`）见 [`docs/changelog/TEMPLATE-5.1.0.md`](docs/changelog/TEMPLATE-5.1.0.md)；5.0.0（Plane Job 协议退场、`tuner-workspace`）见 [`TEMPLATE-5.0.0.md`](docs/changelog/TEMPLATE-5.0.0.md)；4.3.0 见 [`TEMPLATE-4.3.0.md`](docs/changelog/TEMPLATE-4.3.0.md)；3.x → 4.x 迁移见 [`TEMPLATE-4.0.0.md`](docs/changelog/TEMPLATE-4.0.0.md)。平台能力地图见 [`INDEX.md`](INDEX.md)。

{tuner_testkit-5.3.0 → tuner_testkit-6.0.0}/README.md

@@ -173,4 +173,4 @@ uv sync --extra all
 （被测系统 = 平台本身，uv workspace 成员，共用 `.venv`）：路线图在 `dogfood/assets/domain-notes/platform/roadmap.md`，
 验收活文档在 `dogfood/tests/features/`。见 [`dogfood/README.md`](dogfood/README.md)。
 
-5.3.0 发行说明（功能用例集 `assets/testcases/`）见 [`docs/changelog/TEMPLATE-5.3.0.md`](docs/changelog/TEMPLATE-5.3.0.md)；5.2.0 发行说明（work task / 测试设计 / 证据附件）见 [`docs/changelog/TEMPLATE-5.2.0.md`](docs/changelog/TEMPLATE-5.2.0.md)；5.1.0 发行说明（工作台 / meta stamp / `--json`）见 [`docs/changelog/TEMPLATE-5.1.0.md`](docs/changelog/TEMPLATE-5.1.0.md)；5.0.0（Plane Job 协议退场、`tuner-workspace`）见 [`TEMPLATE-5.0.0.md`](docs/changelog/TEMPLATE-5.0.0.md)；4.3.0 见 [`TEMPLATE-4.3.0.md`](docs/changelog/TEMPLATE-4.3.0.md)；3.x → 4.x 迁移见 [`TEMPLATE-4.0.0.md`](docs/changelog/TEMPLATE-4.0.0.md)。平台能力地图见 [`INDEX.md`](INDEX.md)。
+6.0.0 发行说明（一条用例一个文件）见 [`docs/changelog/TEMPLATE-6.0.0.md`](docs/changelog/TEMPLATE-6.0.0.md)；5.3.1 发行说明（已回答提问归档）见 [`docs/changelog/TEMPLATE-5.3.1.md`](docs/changelog/TEMPLATE-5.3.1.md)；5.3.0 发行说明（功能用例集 `assets/testcases/`）见 [`docs/changelog/TEMPLATE-5.3.0.md`](docs/changelog/TEMPLATE-5.3.0.md)；5.2.0 发行说明（work task / 测试设计 / 证据附件）见 [`docs/changelog/TEMPLATE-5.2.0.md`](docs/changelog/TEMPLATE-5.2.0.md)；5.1.0 发行说明（工作台 / meta stamp / `--json`）见 [`docs/changelog/TEMPLATE-5.1.0.md`](docs/changelog/TEMPLATE-5.1.0.md)；5.0.0（Plane Job 协议退场、`tuner-workspace`）见 [`TEMPLATE-5.0.0.md`](docs/changelog/TEMPLATE-5.0.0.md)；4.3.0 见 [`TEMPLATE-4.3.0.md`](docs/changelog/TEMPLATE-4.3.0.md)；3.x → 4.x 迁移见 [`TEMPLATE-4.0.0.md`](docs/changelog/TEMPLATE-4.0.0.md)。平台能力地图见 [`INDEX.md`](INDEX.md)。

{tuner_testkit-5.3.0 → tuner_testkit-6.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tuner-testkit"
-version = "5.3.0"
+version = "6.0.0"
 description = "Shared test runtime, recorders, and DNA overlay for SUT test repos"
 readme = "README.md"
 license = "MIT"

{tuner_testkit-5.3.0 → tuner_testkit-6.0.0}/tuner_testkit/__init__.py

@@ -2,4 +2,4 @@
 
 from __future__ import annotations
 
-__version__ = "5.3.0"
+__version__ = "6.0.0"

{tuner_testkit-5.3.0 → tuner_testkit-6.0.0}/tuner_testkit/apps/dna/dna_payload/.cursor/rules/assets-knowledge.mdc

@@ -2,7 +2,7 @@
 description: assets/ is the knowledge base for humans and the LLM; enforce provenance metadata, raw-vs-curated boundaries, and grounding (consult INDEX before generating)
 globs: assets/**
 alwaysApply: false
-version: 1.2.0
+version: 1.2.1
 ---
 
 # assets — 知识层硬约束
@@ -26,7 +26,7 @@ SUT 自学习见 `docs/spec/sut-self-learning.md`；design schema 见
 
 - 目录分类固定：`ddl/<datasource>/`、`sql/`、`usecases/<domain>/`、
   `domain-notes/<domain>/`、`explore/<app>/`、`design/<app>/`、`testdesign/`、
-  `testcases/<模块>/`、`testreport/`
+  `testcases/<模块>/<套件>/`、`testreport/`
   （新增类别前先改 spec，再改本 rule）。功能用例集见 `docs/spec/testcase-syntax.md`。
 - 人工/半自动区文件头必须带元数据：`domain / source / date / version / confidence`
   （Markdown 用 YAML front-matter，SQL 用顶部 `--` 注释）。

tuner_testkit-6.0.0/tuner_testkit/apps/dna/dna_payload/.cursor/rules/testcases.mdc

@@ -0,0 +1,31 @@
+---
+description: Functional testcases live one case per file under assets/testcases/<module>/<suite>/<Case-ID>.md; suite notes live in that folder's README
+globs: assets/testcases/**
+alwaysApply: false
+version: 1.3.0
+---
+
+# testcases — 功能用例集
+
+完整规范：`docs/spec/testcase-syntax.md`。生成或改写走 skill `maintain-testcases`。
+
+## 位置
+
+- 总索引：`assets/testcases/README.md`
+- 模块说明：`assets/testcases/<模块>/README.md`
+- 一个套件一个目录：`assets/testcases/<模块>/<套件>/README.md`
+- 一条用例一个文件：`assets/testcases/<模块>/<套件>/<用例ID>.md`
+- 不要写到 `usecases/`、`testdesign/` 或 `tests/features/`。
+
+## 用例文件
+
+- 文件名等于 `id`。一级标题是 `<id> <title>`。
+- `type` 为 `正向` 或 `反向`。`status` 为 `就绪` 或 `废弃`。`execution` 为 `手工` 或 `自动`。
+- `## 步骤` 从 `### 1` 连续编号。每步有 `- 操作：` 和 `- 预期：`。
+- 套件级、不属于单条用例的说明写在套件 README 的 `## 详情`。
+- ID 形如 `User-Login-valid-credentials`：`id_prefix` 加小写 kebab-case slug（2–5 个词）。全库唯一；不改、不复用。删除一条不改其余 ID。
+
+## 禁止
+
+- 密码、token、Cookie、Authorization。账号只写 `account_id`。
+- 没有出处的业务规则。出处是用户本次说明，或索引能指向的知识。

{tuner_testkit-5.3.0 → tuner_testkit-6.0.0}/tuner_testkit/apps/dna/dna_payload/.cursor/rules/work-task.mdc

@@ -1,7 +1,7 @@
 ---
 description: Work tasks live in work/tasks. When a human must choose a missing evidence channel, write an inbox question and block the task instead of inventing the channel.
 alwaysApply: true
-version: 1.0.0
+version: 1.1.0
 ---
 
 # 工作任务与人类提问
@@ -15,7 +15,7 @@ version: 1.0.0
 - 端到端点击用 `type: test-execution`，`design` 指向已有测试设计；报告写入 `assets/testreport/`，证据用 `tuner-evidence persist` 或 `attach` 挂上 `task_id`、截图、脱敏日志、接口 JSON。
 - 执行结束后把结果写入该测试设计的「执行反馈」，只引用证据路径。
 - 仓库没有写明的证据通道（典型是后端日志：SSH 目录、日志接口、Rancher API）立刻 `tuner-task ask`。日志主题用 `sut-log-source`。
-- 提问写入 `artifacts/inbox/questions/` 后停止这一支，把任务保持在 `blocked`，直到 `tuner-task answer`。
+- 提问写入 `artifacts/inbox/questions/` 后停止这一支，把任务保持在 `blocked`，直到 `tuner-task answer`。回答后的问题文件在 `artifacts/inbox/archived-question/`。
 
 ## Must not
 

tuner_testkit-6.0.0/tuner_testkit/apps/dna/dna_payload/.cursor/skills/maintain-testcases/SKILL.md

@@ -0,0 +1,167 @@
+---
+name: maintain-testcases
+version: 1.3.0
+description: Creates and updates functional testcases so each case is its own Markdown file under assets/testcases/<module>/<suite>/<Case-ID>.md, with suite notes in that folder's README. Uses a TestLink-style template (summary, preconditions, numbered steps, expected results, status). Use when the user asks to 编写/生成/维护测试用例, add a module or suite, or mentions assets/testcases or a case ID. Do not use for testdesign click-paths or behave .feature files.
+---
+
+# Maintain testcases
+
+## Scope
+
+- **Write**: `assets/testcases/**` only.
+- **Must follow**: `docs/spec/testcase-syntax.md`.
+- **Out of scope**: `assets/testdesign/`（用 `derive-test-design`）、`tests/features/**`（用 `feature-authoring`）、pytest。
+
+## Before writing
+
+1. 读 `assets/testcases/README.md`、目标模块的 `README.md`、目标套件的 `README.md`（没有就先按下面的模板建）。
+2. 读 `INDEX.md`；存在 `INDEX.project.md` 时一并读。只采用已有 usecase / domain-notes / explore / design，或用户本次给出的事实。
+3. 套件 README 已有 `id_prefix` 就沿用，不要另起缩写。新建套件时用套件名的英文词，每词首字母大写、`-` 连接（`用户登录` → `User-Login`）。确认这个前缀没有被别的套件占用。
+4. 新用例 ID 为 `<id_prefix>-<slug>`，文件名就是 `<用例ID>.md`。`slug` 是测试点的英文短名：小写 kebab-case，2–5 个词，只含 `[a-z0-9]` 与 `-`。从测试点提炼条件，不翻译整段步骤，不加序号，不把正向/反向写进 slug。
+5. 查重：`rg -N "^id: User-Login-valid-credentials$" assets/testcases`。完整 ID 全库唯一。已出现过的 slug 不复用（含已从树里删除、仍被报告或 evidence 引用的 ID）。
+
+## Where a case goes
+
+- 已有同名 `<模块>/<套件>/`：只新增或修改其中的 `<用例ID>.md`，并改套件 README 的用例表。不把多条用例写回一个文件。
+- 模块已存在、套件没有：新建 `assets/testcases/<模块>/<套件>/README.md` 和用例文件，并在该模块 README 的套件清单加一行。
+- 模块也没有：新建模块目录和模块 README，再在总索引的模块表加一行，然后写套件。
+
+套件级说明（数据流、共同前置、本套件特有的边界）不属于任何一条用例时，只写在套件 `README.md` 的 `## 详情`。没有这种说明就不写 `## 详情`。
+
+## Templates
+
+用例文件。空的可选节不要写出。步骤从 1 编号；原来只有一段操作和一段预期时保持一步。
+
+```markdown
+---
+kind: testcase
+id: User-Login-valid-credentials
+title: 正确账号密码
+suite: 用户登录
+module: 用户系统
+id_prefix: User-Login
+type: 正向
+status: 就绪
+execution: 手工
+source: <依据路径或需求名>
+version: 1.0.0
+confidence: medium
+---
+
+# User-Login-valid-credentials 正确账号密码
+
+## 前置条件
+
+账号已注册。
+
+## 步骤
+
+### 1
+
+- 操作：输入已注册账号与正确密码，点击登录
+- 预期：进入首页或个人中心
+```
+
+反向用例是另一个文件，例如 `User-Login-wrong-password.md`，`type: 反向`。可选节：`## 摘要`、`## 测试数据`、`## 备注`。不知道重要性就不写 `importance`。
+
+套件 README：
+
+```markdown
+---
+kind: testcase-suite
+id: user-login
+id_prefix: User-Login
+title: 用户登录
+module: 用户系统
+source: <依据路径或需求名>
+version: 1.0.0
+confidence: medium
+---
+
+# 用户登录
+
+## 详情
+
+不属于任何一条用例的说明。没有就不写这一节。
+
+## 用例
+
+| ID | 名称 | 类型 | 状态 |
+| --- | --- | --- | --- |
+| [User-Login-valid-credentials](User-Login-valid-credentials.md) | 正确账号密码 | 正向 | 就绪 |
+```
+
+总索引 `assets/testcases/README.md`：
+
+```markdown
+---
+kind: testcase-index
+title: 测试用例模块索引
+version: 1.0.0
+confidence: high
+---
+
+# 测试用例模块索引
+
+规范：`docs/spec/testcase-syntax.md`。一个套件一个目录，一条用例一个文件。ID 全库唯一。删除一条用例不改其余 ID，不复用 slug。
+
+## 放置规则
+
+- 新用例归入已有模块的套件目录；对不上时才新增模块目录。
+- 套件目录名 = 套件标题。用例文件名 = 用例 ID。
+- 不写密码、token、Cookie。账号只写 `account_id`。
+
+## 模块
+
+| 模块 | 目录 | 范围 | 状态 |
+| --- | --- | --- | --- |
+| <模块> | `assets/testcases/<模块>/` | <一句话> | 在用 |
+```
+
+模块 README：
+
+```markdown
+---
+kind: testcase-module
+id: <ascii-slug>
+title: <模块>
+module: <模块>
+version: 1.0.0
+confidence: high
+---
+
+# <模块>
+
+## 范围
+
+## 不测
+
+## 套件
+
+| 套件 | 目录 |
+| --- | --- |
+| <套件> | [<套件>](<套件>/README.md) |
+
+## 相关知识
+
+无
+```
+
+字段和 TestLink 的对应关系见 `docs/spec/testcase-syntax.md`。
+
+## Update rules
+
+- 改操作或预期：保留原 ID，只 bump 该用例文件的 `version`。套件详情或用例表变了，再 bump 套件 README。
+- 测试点含义变了才换 slug，新建文件。旧 ID 不复用。在 `## 备注` 写 `曾用：<旧 ID>`。
+- 删除：删掉该 `<用例ID>.md`，并从套件用例表去掉这一行。不改其他用例的 ID。
+- 废弃：`status` 改为 `废弃`，在备注写原因。不删除文件，不把 ID 让给新用例，标题不加 `（废弃）`。
+- 拆套件或改套件名：用例带着原 ID 搬家，并改两边 README 的链接。每条用例的 `suite` 改成新目录名。
+
+## Finish
+
+```bash
+python -m tuner_testkit.testcases assets/testcases
+uv run tuner-workspace meta stamp <改过的.md> --kind <testcase|testcase-suite|testcase-module|testcase-index>
+```
+
+校验失败就改文件再跑，通过后再停。有 `INDEX.project.md` 时在其知识表登记新套件 README 的路径（只读 front-matter）；平台仓没有业务用例时不要往根 `INDEX.md` 填模块明细。

{tuner_testkit-5.3.0 → tuner_testkit-6.0.0}/tuner_testkit/apps/dna/dna_payload/AGENTS.md

@@ -1,4 +1,4 @@
-<!-- version: 1.7.0 -->
+<!-- version: 1.7.1 -->
 # AGENTS — 平台总入口（轻量 DM）
 
 > 本文件是"repo as a platform"的**稳定世界观**：只写不常变的分层结构与角色。
@@ -21,7 +21,7 @@
 | 测试层 | `tests/` | 自动化测试代码（behave `features/` + `pytest/`）。 | behave / pytest |
 | 文档层 | `docs/` | 仓库使用说明与规范（`docs/spec/**`）。 | 只读 |
 
-配套：`config/`（环境/数据源）、`.cursor/`（AI 组件，见下）、`work/tasks/`（入库的任务上下文，规范 `docs/spec/work-task.md`）、`artifacts/`·`logs/`（运行产出，规范 `docs/spec/artifacts-layout.md`：MCP evidence 落 `artifacts/evidence/<run_id>/`；agent 任务记录落 `artifacts/inbox/`；阻塞式人类提问落 `artifacts/inbox/questions/`；工具运行落 `artifacts/runs/<run_id>/`；回归报告落 `artifacts/reports/<run_id>/`，每个 run 目录带 `manifest.json`）。SUT 登录本机文件：`data/sut-accounts.local.yaml`（gitignore）。
+配套：`config/`（环境/数据源）、`.cursor/`（AI 组件，见下）、`work/tasks/`（入库的任务上下文，规范 `docs/spec/work-task.md`）、`artifacts/`·`logs/`（运行产出，规范 `docs/spec/artifacts-layout.md`：MCP evidence 落 `artifacts/evidence/<run_id>/`；agent 任务记录落 `artifacts/inbox/`；阻塞式人类提问未回答时落 `artifacts/inbox/questions/`，回答后移到 `artifacts/inbox/archived-question/`；工具运行落 `artifacts/runs/<run_id>/`；回归报告落 `artifacts/reports/<run_id>/`，每个 run 目录带 `manifest.json`）。SUT 登录本机文件：`data/sut-accounts.local.yaml`（gitignore）。
 
 ## 2. 三角色
 
@@ -62,7 +62,7 @@ flowchart TD
 - **仓库初始化/发布** → `tuner-init scaffold`（骨架 + 依赖 `tuner-testkit` + 一次 `tuner-dna sync`）+ `release-template` skill。下游升 kit：`uv add tuner-testkit==x.y.z` 然后 `tuner-dna sync`，再提交。
 - **读/索引知识** → 先查 `INDEX.md`；若存在 `INDEX.project.md` 则一并查。索引维护用 `maintain-index` skill。
 - **发布任务** → `tuner-task create` 写入 `work/tasks/`。测试设计走 `derive-test-design`；端到端点击报告走 `run-test-execution`。缺人才能决定的通道（如后端日志）用 `tuner-task ask`，不要猜。
-- **功能测试用例** → skill `maintain-testcases`，落在 `assets/testcases/<模块>/<功能>.md`（规格 `docs/spec/testcase-syntax.md`）。这不是测试设计，也不直接产出 `.feature`。
+- **功能测试用例** → skill `maintain-testcases`，落在 `assets/testcases/<模块>/<套件>/<用例ID>.md`（规格 `docs/spec/testcase-syntax.md`）。这不是测试设计，也不直接产出 `.feature`。
 
 ## 5. 全程硬约束（跨分支）
 

{tuner_testkit-5.3.0 → tuner_testkit-6.0.0}/tuner_testkit/apps/dna/dna_payload/docs/spec/agent-task-log.md

@@ -72,7 +72,7 @@ evidence:
 artifacts/inbox/questions/Q-<YYYYMMDD>-<nnn>.md
 ```
 
-字段与命令见 `docs/spec/work-task.md`。提问后把对应 `work/tasks` 标为 `blocked`。回答写入任务的 `## Decisions`；可复用的通道说明策展到 `assets/domain-notes/`。
+回答后同一文件移到 `artifacts/inbox/archived-question/`。字段与命令见 `docs/spec/work-task.md`。提问后把对应 `work/tasks` 标为 `blocked`。回答写入任务的 `## Decisions`；可复用的通道说明策展到 `assets/domain-notes/`。
 
 ## 5. 密钥
 

{tuner_testkit-5.3.0 → tuner_testkit-6.0.0}/tuner_testkit/apps/dna/dna_payload/docs/spec/artifacts-layout.md

@@ -16,7 +16,8 @@ description: 交付物目录 artifacts/ 的子目录职责、run 级 manifest.js
 artifacts/
 ├── evidence/<run_id>/     # Playwright MCP / 网络 dump（tuner-evidence persist）；脱敏；gitignore
 ├── inbox/<utc>-<agent>-<slice>.md   # agent 任务记录（agent-task-log.md）；gitignore
-├── inbox/questions/Q-<YYYYMMDD>-<nnn>.md # 阻塞式人类提问（work-task.md）；gitignore
+├── inbox/questions/Q-<YYYYMMDD>-<nnn>.md # 未回答的人类提问（work-task.md）；gitignore
+├── inbox/archived-question/Q-<YYYYMMDD>-<nnn>.md # 已回答的提问；gitignore
 ├── runs/<run_id>/         # 工具 / 动作词的一次运行（tuner-workspace run、工作台）；gitignore
 ├── reports/<run_id>/      # 一次回归（behave / pytest）的报告与摘要；gitignore
 ├── catalogs/workspace.json          # tuner-workspace catalog 产物；gitignore
@@ -68,7 +69,7 @@ artifacts/
 | behave（`*_environment.py` 钩子） | `reports/<run_id>/` | `summary.json`（feature/scenario 状态）、`manifest.json`；`-f html-pretty -o $TUNER_REPORT_DIR/report.html` 时 html 同目录 |
 | pytest | `reports/<run_id>/` | `pytest --junitxml artifacts/reports/<run_id>/junit.xml`，再 `tuner_testkit.artifacts.finish_run` 写 manifest |
 | `tuner-evidence persist` / `attach` | `evidence/<run_id>/` | `network.jsonl` / `actions.jsonl` / `run_summary.md` / `screenshots/` / `logs/` / `api/`；`manifest.params.task_id` 指向 `work/tasks` |
-| agent（编排） | `inbox/` | 会话流水见 `agent-task-log.md`；人类提问见 `inbox/questions/` 与 `work-task.md` |
+| agent（编排） | `inbox/` | 会话流水见 `agent-task-log.md`；未回答提问见 `inbox/questions/`，已回答见 `inbox/archived-question/` |
 | `tuner-workspace catalog` | `catalogs/workspace.json` | 见 `tuner_testkit/workspace/README.md` |
 
 环境变量 `TUNER_REPORT_DIR` 指定本次回归的 run 目录（不设则钩子自动生成 `reports/<run_id>/`）；

{tuner_testkit-5.3.0 → tuner_testkit-6.0.0}/tuner_testkit/apps/dna/dna_payload/docs/spec/assets-knowledge-syntax.md

@@ -17,9 +17,10 @@ assets/
 ├── explore/<app>/<name>.md        # 探索式测试产出的能力清单 / 站点地图（半自动）
 ├── design/<app>/<route-slug>.md   # API↔DB effects 收敛知识（见 design-knowledge-syntax）
 ├── testdesign/<sut>/<slug>.md     # 测试设计（见 test-design-syntax）；执行反馈回写在此
-├── testcases/README.md            # 功能用例集总索引（见 testcase-syntax）
-├── testcases/<模块>/README.md     # 模块范围与功能清单
-├── testcases/<模块>/<功能>.md     # 该功能的全部用例（四级标题 + CASE ID）
+├── testcases/README.md                         # 功能用例集总索引（见 testcase-syntax）
+├── testcases/<模块>/README.md                  # 模块范围与套件清单
+├── testcases/<模块>/<套件>/README.md           # 套件说明与用例索引
+├── testcases/<模块>/<套件>/<用例ID>.md         # 一条用例一个文件
 ├── testreport/<name>.md           # 测试报告类原始资产
 └── CHANGELOG.md                   # 自动区变更流水(供 maintain-index 读取 delta)
 ```

{tuner_testkit-5.3.0 → tuner_testkit-6.0.0}/tuner_testkit/apps/dna/dna_payload/docs/spec/metadata-conventions.md

@@ -1,6 +1,6 @@
 ---
 name: metadata-conventions
-version: 1.0.0
+version: 1.1.0
 description: 统一 front-matter / run manifest 字段家族，供 catalog、工作台与未来企业平台解析「谁在何时创建了什么」。
 ---
 
@@ -13,7 +13,7 @@ description: 统一 front-matter / run manifest 字段家族，供 catalog、工
 
 | 字段 | 类型 | 含义 |
 | --- | --- | --- |
-| `kind` | string | `app` / `action_word` / `testreport` / `inbox` / `question` / `task` / `testdesign` / `testcase` / `testcase-module` / `testcase-index` / `explore` / `design` / `usecase` / `domain-note` |
+| `kind` | string | `app` / `action_word` / `testreport` / `inbox` / `question` / `task` / `testdesign` / `testcase` / `testcase-suite` / `testcase-module` / `testcase-index` / `explore` / `design` / `usecase` / `domain-note` |
 | `id` | string | 稳定标识（`tool_id` / `word_id` / 报告 slug） |
 | `title` | string | 短标题 |
 | `author` | email | 创建者，来自 `git config user.email` |
@@ -54,9 +54,9 @@ catalog 同时用 `git log --diff-filter=A --format=%ae -- <path>` 算首次提
 ### 任务与测试设计
 
 - `kind: task` 落在 `work/tasks/TASK-*.md`，字段见 `docs/spec/work-task.md`。
-- `kind: question` 落在 `artifacts/inbox/questions/Q-*.md`（不入库）。
+- `kind: question` 未回答落在 `artifacts/inbox/questions/Q-*.md`，回答后移到 `artifacts/inbox/archived-question/`（不入库）。
 - `kind: testdesign` 落在 `assets/testdesign/<sut>/<slug>.md`，字段见 `docs/spec/test-design-syntax.md`。
-- `kind: testcase` 落在 `assets/testcases/<模块>/<功能>.md`；模块说明是 `testcase-module`，总索引是 `testcase-index`。字段见 `docs/spec/testcase-syntax.md`。
+- `kind: testcase` 落在 `assets/testcases/<模块>/<套件>/<用例ID>.md`；套件说明是 `testcase-suite`，模块说明是 `testcase-module`，总索引是 `testcase-index`。字段见 `docs/spec/testcase-syntax.md`。
 
 ### run manifest
 

tuner_testkit-6.0.0/tuner_testkit/apps/dna/dna_payload/docs/spec/testcase-syntax.md

@@ -0,0 +1,194 @@
+---
+name: testcase-syntax
+version: 1.3.0
+description: assets/testcases 的模块、套件目录、单用例文件，以及和 TestLink 对齐的步骤字段。功能用例集的唯一事实源。
+---
+
+# 测试用例（testcase-syntax）
+
+> 一条用例一个 Markdown 文件。一个套件一个目录，不属于任何一条用例的说明写在该目录的 `README.md`。
+> 字段对齐 TestLink 的 Test Suite / Test Case：套件详情、摘要、前置条件、分步操作与预期、执行方式、状态。
+> 维护流程见 skill `maintain-testcases`。编辑约束见 `.cursor/rules/testcases.mdc`。
+
+## 1. 和相邻知识的分工
+
+| 路径 | 记什么 |
+| --- | --- |
+| `assets/usecases/` | 导入或讲解过的业务场景，不是带稳定 ID 的用例集 |
+| `assets/testdesign/` | 一次任务的范围、策略和点击路径 |
+| `assets/testcases/` | 按模块 / 套件维护的用例集。每条用例一个文件、一个稳定 ID |
+| `tests/features/` | 已自动化的 Gherkin。本规范不写 `.feature` |
+
+## 2. 目录
+
+```text
+assets/testcases/README.md                              # 模块总索引
+assets/testcases/<模块>/README.md                       # 模块范围、边界、套件清单
+assets/testcases/<模块>/<套件>/README.md                # 套件说明和用例索引
+assets/testcases/<模块>/<套件>/<用例ID>.md              # 一条用例
+```
+
+例子：`assets/testcases/用户系统/用户登录/User-Login-valid-credentials.md`。
+
+- 模块目录名 = 模块显示名。
+- 套件目录名 = 套件显示名 = 套件 README 的 `title` 与一级标题。
+- 用例文件名（不含 `.md`）= 该文件 front-matter 的 `id`。
+- 只允许这两层：模块下面是套件目录，套件目录里只有 `README.md` 和用例文件。
+- 名称不要用 `\ / : * ? " < > |`。
+
+## 3. 套件 README
+
+`kind: testcase-suite`。`id_prefix` 写在这里，之后不得改。同一 `id_prefix` 只能属于一个套件。
+
+```markdown
+# 用户登录
+
+## 详情
+
+不属于任何一条用例的说明。没有这种说明就不写这一节。
+
+## 用例
+
+| ID | 名称 | 类型 | 状态 |
+| --- | --- | --- | --- |
+| [User-Login-valid-credentials](User-Login-valid-credentials.md) | 正确账号密码 | 正向 | 就绪 |
+```
+
+一级标题等于套件目录名。用例表的每一行指向同目录下的一个用例文件，不多不少。
+
+## 4. 用例文件
+
+`kind: testcase`。一个文件只有一条用例。
+
+```markdown
+---
+kind: testcase
+id: User-Login-valid-credentials
+title: 正确账号密码
+suite: 用户登录
+module: 用户系统
+id_prefix: User-Login
+type: 正向
+status: 就绪
+execution: 手工
+source: <assets/… 或需求名>
+version: 1.0.0
+confidence: medium
+---
+
+# User-Login-valid-credentials 正确账号密码
+
+## 摘要
+
+登录成功后进入已登录页面。
+
+## 前置条件
+
+账号已注册。
+
+## 测试数据
+
+账号 `account_id`。口令不写进本文件。
+
+## 步骤
+
+### 1
+
+- 操作：输入已注册账号与正确密码，点击登录
+- 预期：进入首页或个人中心
+
+## 备注
+
+可选。
+```
+
+空的可选节不要写出来。节的顺序固定为：摘要、前置条件、测试数据、步骤、备注。
+
+| 节 | 是否必填 | 写什么 |
+| --- | --- | --- |
+| 摘要 | 否 | 标题里放不下的目的。不要把 `title` 再抄一遍 |
+| 前置条件 | 否 | 开测前必须已经成立的状态 |
+| 测试数据 | 否 | `account_id` 或数据文件路径。不写密码、token、Cookie |
+| 步骤 | 是 | 从 `### 1` 连续编号。每步先 `- 操作：`，再 `- 预期：` |
+| 备注 | 否 | 已知限制、曾用 ID、废弃原因 |
+
+原来只有一段操作和一段预期的用例，保持为一步。不要拆成文件里没有写出的多步。
+
+`type` 只取 `正向` 或 `反向`。`status` 只取 `就绪` 或 `废弃`。`execution` 只取 `手工` 或 `自动`，没写自动化的用例用 `手工`。`importance` 可选，只取 `低`、`中`、`高`；不知道就不写。
+
+一级标题必须是 `<id> <title>`。`title` 末尾不要加 `（废弃）`。
+
+## 5. 用例 ID
+
+ID 是全库唯一键：`<id_prefix>-<slug>`。
+
+- `id_prefix`：套件名的英文词，每词首字母大写，用 `-` 连接。`用户登录` → `User-Login`。只含字母和连字符，不含数字。
+- `slug`：这条用例在验证的条件。英文小写 kebab-case，2–5 个词，每词只含 `[a-z0-9]`。从测试点提炼，不翻译整段步骤，不加序号。正向/反向留在 `type`，不写进 slug。
+- 例：`User-Login-valid-credentials`、`User-Login-wrong-password`。不同套件的前缀不同，所以 slug 可以相同。
+- 新增前查完整 ID：`rg -N "^id: User-Login-valid-credentials$" assets/testcases`。
+- 已发出的 ID 不改、不复用。删除一条用例时删掉该文件，并从其套件 README 的用例表去掉这一行。不改其他 ID。
+- 不再新发 `<id_prefix>` 紧接 4 位序号的 ID（如 `User-Login0001`）。
+- 测试点含义变了才换 slug，新文件的备注写 `曾用：<旧 ID>`。旧文件删除或标废弃，旧 ID 不复用。
+- 废弃：`status` 改为 `废弃`，原因写进备注。保留文件，不把 ID 让给新用例。
+
+`assets/testreport/` 与 `artifacts/evidence/` 里的旧序号是当时的报告键和文件名，不回写。
+
+没有依据的业务规则不要写进操作或预期。依据来自用户说明，或 `INDEX.md` / `INDEX.project.md` 能指向的 usecase、domain-notes、explore、design。
+
+## 6. 和 TestLink 的对应
+
+| TestLink | 本规范 |
+| --- | --- |
+| Test Suite | `<套件>/` 目录 |
+| Suite details | 套件 README 的 `## 详情` |
+| Test Case | `<用例ID>.md` |
+| Name | `title` |
+| Summary | `## 摘要` |
+| Preconditions | `## 前置条件` |
+| Step actions | `- 操作：` |
+| Expected Results | `- 预期：` |
+| Execution Type（Manual / Automated） | `execution`：`手工` / `自动` |
+| Importance（Low / Medium / High） | `importance`：`低` / `中` / `高`。不知道省略 |
+| Status = Obsolete | `status: 废弃`。在用为 `就绪` |
+| 自定义说明 | `## 备注`；账号和夹具写在 `## 测试数据` |
+
+不另造 TestLink 外部编号。`id` 就是稳定键。
+
+## 7. Front-matter
+
+套件 README：
+
+```yaml
+---
+kind: testcase-suite
+id: user-login
+id_prefix: User-Login
+title: 用户登录
+module: 用户系统
+sut: <sut 短名，未知可省略>
+source: <assets/… 或需求名>
+version: 1.0.0
+confidence: medium
+---
+```
+
+用例文件见第 4 节。`suite` 等于套件目录名，`module` 等于模块目录名，`id_prefix` 等于所属套件的 `id_prefix`。
+
+模块 README 用 `kind: testcase-module`。总索引用 `kind: testcase-index`。
+
+人工修改后 bump 被改文件的 `version`。改一条用例的操作或预期时，只 bump 该用例文件。增删用例，或修改套件详情时，bump 套件 README。署名用 `tuner-workspace meta stamp <path> --kind testcase`（套件 README 用 `testcase-suite`，模块 README 用 `testcase-module`，总索引用 `testcase-index`）。
+
+## 8. 三份 README
+
+`assets/testcases/README.md` 告诉人和 LLM：模块怎么划分、新套件该进哪个目录、当前有哪些模块。至少包含：
+
+- 放置规则（指向本 spec）
+- 模块表：模块名、目录、一句话范围、状态（`在用` / `规划中`）
+
+`assets/testcases/<模块>/README.md` 至少包含：
+
+- 这个模块测什么、不测什么
+- 套件清单：每个套件一行，链接到 `<套件>/README.md`
+- 相关知识路径（没有就写「无」）
+
+套件 README 的用例表与该目录下的用例文件一致。新增或重命名套件时，模块 README 和总索引一起改。

{tuner_testkit-5.3.0 → tuner_testkit-6.0.0}/tuner_testkit/apps/dna/dna_payload/docs/spec/work-task.md

@@ -14,7 +14,8 @@ description: 入库任务 work/tasks、阻塞式人类提问，以及和测试
 
 ```text
 work/tasks/TASK-<YYYYMMDD>-<nnn>.md          # 入库
-artifacts/inbox/questions/Q-<YYYYMMDD>-<nnn>.md   # gitignore，本机异步信箱
+artifacts/inbox/questions/Q-<YYYYMMDD>-<nnn>.md        # 未回答；gitignore
+artifacts/inbox/archived-question/Q-<YYYYMMDD>-<nnn>.md # 已回答；gitignore
 ```
 
 `work/**` 的提交 scope 是 `work`。问题文件不入库；人答完后的结论写回任务的 `## Decisions`，需要留下的通道说明再策展到 `assets/domain-notes/`。
@@ -73,6 +74,7 @@ tuner-task answer Q-20260924-001 --option rancher-api \
 ```
 
 - 提问立刻落盘，并把任务标为 `blocked`。只挡住依赖该答案的回写；不依赖日志的点击可以先做完，但在回答前不要编写取日志实现，也不要选定通道。
+- `tuner-task answer` 把问题文件从 `questions/` 移到 `archived-question/`，未回答的问题仍只留在 `questions/`。同一天的新问题编号会计入归档，避免复用已回答的 ID。
 - `--note` 只留可入库的指向。CLI 拒绝 `password=` / `token:` / `Bearer …` 这类赋值。
 - `skip` 表示报告里日志证据写「无」，设计上的日志断言保持未验证。
 - `tuner-task finish` 在仍有 `status: open` 且 `blocking: true` 的问题时失败。