tuner-testkit 5.1.0__tar.gz → 5.2.0__tar.gz

{tuner_testkit-5.1.0/tuner_testkit.egg-info → tuner_testkit-5.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tuner-testkit
-Version: 5.1.0
+Version: 5.2.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.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)。
+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.1.0 → tuner_testkit-5.2.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.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)。
+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.1.0 → tuner_testkit-5.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tuner-testkit"
-version = "5.1.0"
+version = "5.2.0"
 description = "Shared test runtime, recorders, and DNA overlay for SUT test repos"
 readme = "README.md"
 license = "MIT"
@@ -78,6 +78,7 @@ tuner-fake = "tuner_testkit.fake.cli:main"
 tuner-page-test = "tuner_testkit.page_test.__main__:main"
 tuner-action-words = "tuner_testkit.action_words.__main__:main"
 tuner-evidence = "tuner_testkit.apps.evidence.cli:main"
+tuner-task = "tuner_testkit.apps.task.cli:main"
 tuner-workbench = "tuner_testkit.workbench.cli:main"
 
 [build-system]

{tuner_testkit-5.1.0 → tuner_testkit-5.2.0}/tuner_testkit/__init__.py

@@ -2,4 +2,4 @@
 
 from __future__ import annotations
 
-__version__ = "5.1.0"
+__version__ = "5.2.0"

{tuner_testkit-5.1.0 → tuner_testkit-5.2.0}/tuner_testkit/apps/dna/dna_payload/.cursor/rules/commit-convention.mdc

@@ -1,7 +1,7 @@
 ---
 description: Commits must follow Conventional Commits with a layer-aligned scope; the declared scope must cover the layers actually changed. Single source of truth is docs/spec/commit-convention.md.
 alwaysApply: true
-version: 1.1.0
+version: 1.2.0
 ---
 
 # 提交规范（Conventional Commits + 六层 scope）
@@ -12,8 +12,8 @@ version: 1.1.0
 - `type` ∈ `feat|fix|refactor|docs|test|perf|chore|build|ci|style|revert`。
 - `scope` 用**对齐六层/资产类别**的值：`assets / apps / packages / api_objects /
   page_objects / action_words / tests / docs / rules / skills / agents / hooks /
-  init_repo / index / dogfood`（多层用逗号分隔，如 `feat(apps,packages): ...`；
-  `dogfood/**` 一律用 `dogfood`）。
+  init_repo / index / dogfood / work`（多层用逗号分隔，如 `feat(apps,packages): ...`；
+  `dogfood/**` 一律用 `dogfood`；`work/tasks` 用 `work`）。
 - **scope 必须覆盖本次真实改动涉及的层**（`packages` 是三个子资产层的上位 scope）。
 
 一眼可读优先：让人从提交信息就看出"更新了 assets、新增了 apps、录制了新的 api_objects"等。

tuner_testkit-5.2.0/tuner_testkit/apps/dna/dna_payload/.cursor/rules/work-task.mdc

@@ -0,0 +1,24 @@
+---
+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
+---
+
+# 工作任务与人类提问
+
+细则见 `docs/spec/work-task.md`、`docs/spec/test-design-syntax.md`。
+
+## Must
+
+- 人发布的任务用 `tuner-task create` 写入 `work/tasks/TASK-*.md`，不要只留在聊天里。
+- 测试设计写入 `assets/testdesign/`，并用 `tuner-task validate` 检查八个章节。
+- 端到端点击用 `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`。
+
+## Must not
+
+- 在人回答前选定日志通道，或编写对应的 SSH / HTTP / Rancher 取数实现。
+- 把密码、token、Cookie 写进任务、问题、`--note` 或 domain-notes。用 `account_id`、环境变量名或 `config/env_local.py` 指向。
+- 用 `artifacts/inbox/` 的会话流水代替 `work/tasks`。会话流水仍然要写，见 `agent-task-log`。

tuner_testkit-5.2.0/tuner_testkit/apps/dna/dna_payload/.cursor/skills/derive-test-design/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: derive-test-design
+version: 1.0.0
+description: Write assets/testdesign/<sut>/<slug>.md from a work task plus usecases, domain-notes, explore, or design notes. Use when the task type is test-design or the user asks for a test design. Do not invent click paths that are not in evidence or a cited source.
+---
+
+# Derive test design
+
+## Scope
+
+- **Write**: `assets/testdesign/<sut>/<slug>.md`，并让任务的 `outputs` 指向它。
+- **Read**: `work/tasks/<id>.md`、`assets/usecases`、`assets/domain-notes`、`assets/explore`、`assets/design`、`INDEX.md`（及 `INDEX.project.md`）。
+- **Must follow**: `docs/spec/test-design-syntax.md`、`docs/spec/work-task.md`。
+
+## Steps
+
+1. 若还没有任务：`tuner-task create --type test-design --title … --input <已有知识路径>`。
+2. 只根据 inputs 里点名的知识写范围、不测、风险、策略、点击路径、用例大纲。没有页面流或证据支撑的点击行不要编。
+3. 「执行反馈」写「无」。
+4. front-matter：`kind: testdesign`，`task_id` 指向任务，`source` 或 `evidence` 至少一项。
+5. 校验并署名：
+
+```bash
+uv run tuner-task validate assets/testdesign/<sut>/<slug>.md
+uv run tuner-workspace meta stamp assets/testdesign/<sut>/<slug>.md --kind testdesign
+```
+
+6. 把该路径挂到任务上：`uv run tuner-task bind <TASK> --output assets/testdesign/<sut>/<slug>.md`。
+
+## Template
+
+```markdown
+---
+kind: testdesign
+id: <slug>
+title: <一句话>
+sut: <sut>
+task_id: TASK-YYYYMMDD-nnn
+source: <assets/...>
+version: 1.0.0
+confidence: high
+evidence: []
+---
+
+# <title>
+
+## 范围
+
+## 不测
+
+## 风险
+
+## 策略
+
+## 点击路径
+
+| id | 页面流 | 操作 | 期望 |
+| --- | --- | --- | --- |
+
+## 用例大纲
+
+## 执行反馈
+
+| run_id | task_id | 结果 | 要回写的结论 |
+| --- | --- | --- | --- |
+
+## 证据与来源
+```
+
+## Hard rules
+
+- 缺日志来源时 `tuner-task ask --topic sut-log-source`，不要写死 SSH、日志接口或 Rancher。
+- 不把响应体、截图、密钥抄进设计。

{tuner_testkit-5.1.0 → tuner_testkit-5.2.0}/tuner_testkit/apps/dna/dna_payload/.cursor/skills/generate-test-report/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: generate-test-report
 description: Turn a regression run under artifacts/reports/<run_id>/ (plus inbox and optional design notes) into a curated Markdown test report at assets/testreport/<sut>/<yyyy-mm>/<slug>.md with metadata-conventions front-matter. Use when the user asks to 生成测试报告 / write a test report / 汇总回归结果.
-version: 1.0.0
+version: 1.1.0
 ---
 
 # Generate Test Report
@@ -35,6 +35,8 @@ period: <YYYY-MM>
 result: {total: 0, passed: 0, failed: 0}
 evidence: []
 features: []
+task_id:          # 有 work task 时填写
+design:           # test-execution 指向 assets/testdesign/...
 confidence: high
 source: artifacts/reports/<run_id>
 ---

tuner_testkit-5.2.0/tuner_testkit/apps/dna/dna_payload/.cursor/skills/run-test-execution/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: run-test-execution
+version: 1.0.0
+description: Run the click paths in a test design, attach screenshots and sanitized API or log evidence, and write a curated test report that links back to the design. Use when the task type is test-execution or the user asks for an end-to-end click report.
+---
+
+# Run test execution
+
+## Scope
+
+- **Read**: 任务的 `design`（`assets/testdesign/**`）及其「点击路径」。
+- **Write**: `assets/testreport/<sut>/<yyyy-mm>/<slug>.md`，回写设计的「执行反馈」，必要时 `tuner-evidence attach`。
+- **Must follow**: `docs/spec/work-task.md`、`docs/spec/test-design-syntax.md`、`generate-test-report` skill。
+
+## Steps
+
+1. `tuner-task create --type test-execution --title … --design assets/testdesign/<sut>/<slug>.md`，或继续已有任务。然后 `tuner-task start <id>`。
+2. 按「点击路径」每一行执行 `python -m tuner_testkit.page_test run <page_id> --flow <flow>`，或对应的 behave UI 场景。失败步使用 page_test 已有的整页截图路径。
+3. 把当次网络、截图、接口 JSON、日志片段放进同一次 evidence run，并带上任务号：
+
+```bash
+uv run tuner-evidence persist --run-id <run_id> --scenario explore:<slug> --network captures.jsonl --task-id <TASK> --screenshot <png> --api <response.json>
+uv run tuner-evidence attach --run-id <run_id> --task-id <TASK> --log <excerpt.log> --screenshot <png>
+```
+
+4. 设计要求日志证据，但仓库没有 log provider（domain-notes 或 `apps/` 里没有）时，立刻：
+
+```bash
+uv run tuner-task ask --task <TASK> --topic sut-log-source --prompt "仓库没有写明后端日志从哪取"
+```
+
+然后停止依赖日志的回写。不要选择 SSH、日志接口或 Rancher，也不要开始写 fetcher。人回答后再按 `create-app` 做对应工具。人选择 `skip` 时，报告里日志写「无」。
+
+5. 用 `generate-test-report` 写报告。front-matter 额外加上 `task_id` 与 `design`。结果表每一行带证据相对路径（截图、`api/*.json`、`logs/*.log`）。
+6. 在测试设计「执行反馈」追加一行：`run_id`、`task_id`、通过或失败、要回写的结论。不改「范围」，除非人确认。
+7. `uv run tuner-task bind <id> --output assets/testreport/<sut>/<yyyy-mm>/<slug>.md --evidence artifacts/evidence/<run_id>/`，然后 `tuner-task finish <id>`。仍有未答问题时 CLI 会失败。
+
+## Hard rules
+
+- 报告和设计只链到 `artifacts/evidence/<run_id>/`，不入库截图或响应原文。
+- 不编造未出现在 summary 或证据里的失败数。
+- 点出的新副作用策展到 `assets/design/`，并在设计的风险里加一行指向同一 `run_id`。

{tuner_testkit-5.1.0 → tuner_testkit-5.2.0}/tuner_testkit/apps/dna/dna_payload/AGENTS.md

@@ -1,4 +1,4 @@
-<!-- version: 1.5.0 -->
+<!-- version: 1.6.0 -->
 # AGENTS — 平台总入口（轻量 DM）
 
 > 本文件是"repo as a platform"的**稳定世界观**：只写不常变的分层结构与角色。
@@ -13,7 +13,7 @@
 
 | 层 | 目录 | 职责 | 谁运行 |
 | --- | --- | --- | --- |
-| 知识层 | `assets/` | 给人和 LLM 阅读、生成测试代码的基础知识（ddl / sql / usecases / domain-notes / explore / design / testreport）。见 `docs/spec/assets-knowledge-syntax.md`。 | 只读引用 |
+| 知识层 | `assets/` | 给人和 LLM 阅读、生成测试代码的基础知识（ddl / sql / usecases / domain-notes / explore / design / testdesign / testreport）。见 `docs/spec/assets-knowledge-syntax.md`。 | 只读引用 |
 | 运行库 | `tuner_testkit/`（PyPI：`tuner-testkit`） | 公共运行时与 CLI（db / logging / api_test / page_test / fake / recorders / dna）。SUT 用 `uv` 锁版本。 | `import tuner_testkit`；`tuner-recorder` 等 scripts |
 | 组件层 | `packages/` | **本仓业务资产**（api_objects / page_objects / action_words），不是 kit 运行库。 | 被 import |
 | 工具层 | `apps/` | **本仓私有**工具。公共工具在 `tuner_testkit.apps`。见 `docs/spec/apps-authoring-syntax.md`。 | `python -m apps.<name>`（仅项目工具） |
@@ -21,7 +21,7 @@
 | 测试层 | `tests/` | 自动化测试代码（behave `features/` + `pytest/`）。 | behave / pytest |
 | 文档层 | `docs/` | 仓库使用说明与规范（`docs/spec/**`）。 | 只读 |
 
-配套：`config/`（环境/数据源）、`.cursor/`（AI 组件，见下）、`artifacts/`·`logs/`（运行产出，规范 `docs/spec/artifacts-layout.md`：MCP evidence 落 `artifacts/evidence/<run_id>/`；agent 任务记录落 `artifacts/inbox/`；工具运行落 `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/runs/<run_id>/`；回归报告落 `artifacts/reports/<run_id>/`，每个 run 目录带 `manifest.json`）。SUT 登录本机文件：`data/sut-accounts.local.yaml`（gitignore）。
 
 ## 2. 三角色
 
@@ -50,6 +50,7 @@ flowchart TD
   Q -->|"缺少知识(ddl/api/用例)"| Know["先跑 kit CLI 回填 assets\n再走生成"]
   Q -->|"新建/更新项目仓"| Init["tuner-init / tuner-dna / release-template"]
   Q -->|"读/策展/索引知识"| Idx["查 INDEX.md + maintain-index skill"]
+  Q -->|"发布任务 / 测试设计 / 端到端执行"| Task["work/tasks + tuner-task\ndocs/spec/work-task.md"]
 ```
 
 - **学习被测系统** → `.cursor/agents/sut-self-learning.md`（编排 explore → freeze → design；规格 `docs/spec/sut-self-learning.md`；任务 log 见 `docs/spec/agent-task-log.md`）。
@@ -59,6 +60,7 @@ flowchart TD
 - **补知识** → 用 `tuner-dump-ddl`、Playwright MCP 探索（落盘 `artifacts/evidence/`）、`tuner-recorder` / `tuner-api-recorder` / `tuner-page-recorder` 等回填，再进入生成。
 - **仓库初始化/发布** → `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`，不要猜。
 
 ## 5. 全程硬约束（跨分支）
 

{tuner_testkit-5.1.0 → tuner_testkit-5.2.0}/tuner_testkit/apps/dna/dna_payload/MANIFEST.txt

@@ -1,5 +1,5 @@
 {
-  "files": 57,
+  "files": 62,
   "paths": [
     ".cursor/rules",
     ".cursor/skills",

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

@@ -64,7 +64,17 @@ evidence:
 
 对照两轮 dogfood 时，另写 `## Loop delta`：相对上一份 inbox，少了哪些手工步骤、多了哪些平台能力。
 
-## 4. 密钥
+## 4. 人类提问（阻塞）
+
+必须由人选择的缺口（仓库没写明的后端日志来源等）不写进会话流水，立刻另存：
+
+```text
+artifacts/inbox/questions/Q-<YYYYMMDD>-<nnn>.md
+```
+
+字段与命令见 `docs/spec/work-task.md`。提问后把对应 `work/tasks` 标为 `blocked`。回答写入任务的 `## Decisions`；可复用的通道说明策展到 `assets/domain-notes/`。
+
+## 5. 密钥
 
 - 可用 `account_id` 指向 `data/sut-accounts.local.yaml` 的条目。
 - 禁止密码、token、Cookie、Authorization 原文。

{tuner_testkit-5.1.0 → tuner_testkit-5.2.0}/tuner_testkit/apps/dna/dna_payload/docs/spec/artifacts-layout.md

@@ -16,6 +16,7 @@ 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
 ├── runs/<run_id>/         # 工具 / 动作词的一次运行（tuner-workspace run、工作台）；gitignore
 ├── reports/<run_id>/      # 一次回归（behave / pytest）的报告与摘要；gitignore
 ├── catalogs/workspace.json          # tuner-workspace catalog 产物；gitignore
@@ -66,8 +67,8 @@ artifacts/
 | `tuner-workspace run` / 工作台 | `runs/<run_id>/` | `stdout.log`、`stderr.log`、`envelope.json`（工具 `--json` 输出）、`manifest.json` |
 | 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` | `evidence/<run_id>/` | `network.jsonl` / `actions.jsonl` / `run_summary.md`（4.3.0 起）；5.x 起补 `manifest.json` |
-| agent（编排） | `inbox/` | 见 `agent-task-log.md` |
+| `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` |
 | `tuner-workspace catalog` | `catalogs/workspace.json` | 见 `tuner_testkit/workspace/README.md` |
 
 环境变量 `TUNER_REPORT_DIR` 指定本次回归的 run 目录（不设则钩子自动生成 `reports/<run_id>/`）；
@@ -92,3 +93,4 @@ artifacts/
 - `artifacts/reports/<run_id>/` 是**原始交付物**；人工或 `generate-test-report` skill 整理后的报告落
   `assets/testreport/<sut>/<yyyy-mm>/<slug>.md`，front-matter 用 `evidence: [artifacts/reports/<run_id>]` 指回来源。
 - `artifacts/inbox/` 不是 evidence；evidence 只认 `artifacts/evidence/<run_id>/`。
+- 入库的任务在 `work/tasks/`，不在 inbox。inbox 里的 question 只是本机待答消息。

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

@@ -16,13 +16,14 @@ assets/
 ├── domain-notes/<domain>/<name>.md# 业务讲解、字段含义、权限规则、环境约束
 ├── explore/<app>/<name>.md        # 探索式测试产出的能力清单 / 站点地图（半自动）
 ├── design/<app>/<route-slug>.md   # API↔DB effects 收敛知识（见 design-knowledge-syntax）
+├── testdesign/<sut>/<slug>.md     # 测试设计（见 test-design-syntax）；执行反馈回写在此
 ├── testreport/<name>.md           # 测试报告类原始资产
 └── CHANGELOG.md                   # 自动区变更流水(供 maintain-index 读取 delta)
 ```
 
 - **自动区**（工具产出，可被覆盖重写）：`ddl/`、以及每次生成会追加 `CHANGELOG.md`。
   人不手改这些文件的内容语义；要更新就重跑工具。
-- **人工/半自动区**：`sql/`、`usecases/`、`domain-notes/`、`explore/`、`design/`、`testreport/`。
+- **人工/半自动区**：`sql/`、`usecases/`、`domain-notes/`、`explore/`、`design/`、`testdesign/`、`testreport/`。
 - `apidoc/` **不单列**：人工导入的接口说明放 `domain-notes/` 或 `usecases/`；
   运行时冻结的契约在 `packages/api_objects/`。是否再拆目录留给下游实践决定。
 

{tuner_testkit-5.1.0 → tuner_testkit-5.2.0}/tuner_testkit/apps/dna/dna_payload/docs/spec/commit-convention.md

@@ -52,6 +52,7 @@
 | `init_repo` | `tuner_testkit/apps/init_repo/**` | 初始化工具与 release |
 | `index` | `INDEX.md`、`INDEX.project.md`、`.cursor/REGISTRY.md` | 索引/注册表 |
 | `dogfood` | `dogfood/**` | 平台仓内用 scaffold 生成的 dogfood workspace（知识、feature、fixture） |
+| `work` | `work/**` | 入库的任务（`work/tasks`）与任务上的 Decision |
 
 > `packages` 视为 `api_objects` / `page_objects` / `action_words` 的**上位 scope**：
 > 声明 `packages` 可覆盖这三者的改动。

{tuner_testkit-5.1.0 → tuner_testkit-5.2.0}/tuner_testkit/apps/dna/dna_payload/docs/spec/metadata-conventions.md

@@ -13,7 +13,7 @@ description: 统一 front-matter / run manifest 字段家族，供 catalog、工
 
 | 字段 | 类型 | 含义 |
 | --- | --- | --- |
-| `kind` | string | `app` / `action_word` / `testreport` / `inbox` / `explore` / `design` / `usecase` / `domain-note` |
+| `kind` | string | `app` / `action_word` / `testreport` / `inbox` / `question` / `task` / `testdesign` / `explore` / `design` / `usecase` / `domain-note` |
 | `id` | string | 稳定标识（`tool_id` / `word_id` / 报告 slug） |
 | `title` | string | 短标题 |
 | `author` | email | 创建者，来自 `git config user.email` |
@@ -43,6 +43,7 @@ catalog 同时用 `git log --diff-filter=A --format=%ae -- <path>` 算首次提
 落点：`assets/testreport/<sut>/<yyyy-mm>/<slug>.md`。
 
 额外：`run_id` / `period` / `result`（`{total,passed,failed}`）/ `evidence[]` / `features[]`。
+端到端执行报告再加 `task_id` / `design`（指向 `work/tasks` 与 `assets/testdesign`）。
 
 正文固定章节：范围 / 环境 / 结果 / 缺陷 / 风险 / 证据链接。见 skill `generate-test-report`。
 
@@ -50,6 +51,12 @@ catalog 同时用 `git log --diff-filter=A --format=%ae -- <path>` 算首次提
 
 沿用 `docs/spec/agent-task-log.md`，再加 `author`。
 
+### 任务与测试设计
+
+- `kind: task` 落在 `work/tasks/TASK-*.md`，字段见 `docs/spec/work-task.md`。
+- `kind: question` 落在 `artifacts/inbox/questions/Q-*.md`（不入库）。
+- `kind: testdesign` 落在 `assets/testdesign/<sut>/<slug>.md`，字段见 `docs/spec/test-design-syntax.md`。
+
 ### run manifest
 
 `artifacts/runs|<reports>/<run_id>/manifest.json`：`producer.user_email` / `producer.host` /

{tuner_testkit-5.1.0 → tuner_testkit-5.2.0}/tuner_testkit/apps/dna/dna_payload/docs/spec/sut-self-learning.md

@@ -64,7 +64,7 @@ artifacts/evidence/<run_id>/     ← 统一落盘（强制）
 | MCP 网络 + DOM | Playwright MCP；必须落盘 evidence | `artifacts/evidence/` |
 | DDL | `tuner-dump-ddl` | `assets/ddl/` |
 | 源码 | 工程师给出前后端路径，LLM 读 models/views/urls | `assets/design/`（inferred） |
-| 应用日志 | 用户按 `create-app` 写 log fetcher，CLI + JSON | `apps/<name>/` |
+| 应用日志 | 仓库已有说明时按 `create-app` 写 log fetcher；没有说明时 `tuner-task ask --topic sut-log-source`，等人在 SSH 目录、日志接口、Rancher API 中选一个 | `apps/<name>/`；决定记在 `work/tasks` 与 `assets/domain-notes` |
 | DB 日志 / diff | 用户自建，或后续参考 `tuner-db-diff` | `apps/` 或 kit |
 | 人工文档 | 原样放入，只补 front-matter | `assets/usecases` / `domain-notes` |
 

tuner_testkit-5.2.0/tuner_testkit/apps/dna/dna_payload/docs/spec/test-design-syntax.md

@@ -0,0 +1,66 @@
+---
+name: test-design-syntax
+version: 1.0.0
+description: assets/testdesign 的章节、front-matter，以及被 test-execution 回写的执行反馈。
+---
+
+# 测试设计（test-design-syntax）
+
+> 一篇文档描述一条可执行的测试设计。它记「测什么、怎么点、期望是什么」。
+> `assets/design/` 仍只记一条路由的副作用，不要混进本文。
+
+## 1. 路径
+
+```text
+assets/testdesign/<sut>/<slug>.md
+```
+
+## 2. Front-matter
+
+```yaml
+kind: testdesign
+id: order-create
+title: 订单创建
+sut: order
+task_id: TASK-20260924-001
+source: assets/usecases/order/create.md
+version: 1.0.0
+confidence: high
+evidence:
+  - artifacts/evidence/20260924T000000Z-order-create/
+```
+
+`source` 与 `evidence` 至少有一个。`tuner-task validate <path>` 会检查。
+
+## 3. 正文
+
+八个二级标题都要在，缺信息写「无」：
+
+```markdown
+## 范围
+## 不测
+## 风险
+## 策略
+## 点击路径
+## 用例大纲
+## 执行反馈
+## 证据与来源
+```
+
+「点击路径」用表，供 `test-execution` 逐行点击：
+
+```markdown
+| id | 页面流 | 操作 | 期望 |
+| --- | --- | --- | --- |
+| P1 | web.order_create@v1 / submit | 填写必填项并点击提交 | 列表出现新订单 |
+```
+
+「执行反馈」由执行任务回写，不在设计阶段编造结果：
+
+```markdown
+| run_id | task_id | 结果 | 要回写的结论 |
+| --- | --- | --- | --- |
+| 20260924T000000Z-order | TASK-20260924-002 | failed | P1 提交后列表未刷新，见证据截图 |
+```
+
+证据只写 `artifacts/evidence/<run_id>/` 下的相对路径，不粘贴截图、响应体或日志原文。

tuner_testkit-5.2.0/tuner_testkit/apps/dna/dna_payload/docs/spec/work-task.md

@@ -0,0 +1,93 @@
+---
+name: work-task
+version: 1.0.0
+description: 入库任务 work/tasks、阻塞式人类提问，以及和测试设计、证据、测试报告的闭环。
+---
+
+# 工作任务（work-task）
+
+> 人在 workspace 里发布的任务是 Agent 的事务上下文，写入 Git。
+> 会话流水仍在 `artifacts/inbox/<utc>-<agent>-<slice>.md`（gitignore）。
+> 必须由人回答的问题写到 `artifacts/inbox/questions/`，不猜 SSH、日志接口或 Rancher。
+
+## 1. 路径
+
+```text
+work/tasks/TASK-<YYYYMMDD>-<nnn>.md          # 入库
+artifacts/inbox/questions/Q-<YYYYMMDD>-<nnn>.md   # gitignore，本机异步信箱
+```
+
+`work/**` 的提交 scope 是 `work`。问题文件不入库；人答完后的结论写回任务的 `## Decisions`，需要留下的通道说明再策展到 `assets/domain-notes/`。
+
+## 2. 任务类型
+
+| type | 输入 | 产出 | 证据 |
+| --- | --- | --- | --- |
+| `explore` | URL / account_id | `assets/explore/` | `artifacts/evidence/<run_id>/` |
+| `test-design` | 用例、domain-notes、explore、design | `assets/testdesign/<sut>/<slug>.md` | 需求或探索来源，见 test-design-syntax |
+| `test-execution` | 已存在的 testdesign（front-matter `design`） | `assets/testreport/<sut>/<yyyy-mm>/<slug>.md` | 同一次 run 的截图、网络、接口响应、日志 |
+
+`test-execution` 按测试设计里的「点击路径」跑 `page_test run` 或 behave UI，不代替测试设计，也不承担纯 API 回归。
+
+状态：`open` → `in_progress` → `done`。存在未回答的阻塞问题时为 `blocked`。全部答完后回到 `in_progress`。
+
+## 3. Front-matter
+
+```yaml
+kind: task
+id: TASK-20260924-001
+title: 订单创建端到端
+type: test-execution
+status: open
+objective: 按测试设计点完订单创建并写出报告
+scope: [order-create]
+inputs: []
+outputs: []
+design: assets/testdesign/order/create.md
+evidence: []
+questions: []
+```
+
+作者与日期用 `tuner-workspace meta stamp`（`tuner-task create` 会调用）。禁止写入密码、token、Cookie。
+
+## 4. 人类提问循环
+
+仓库里还没有该通道的说明时才问。`assets/domain-notes`、`INDEX`、已有 `apps/<log-fetcher>` 能回答的，直接用。
+
+日志通道没有 provider 时，主题固定为 `sut-log-source`，选项固定为：
+
+| id | 含义 |
+| --- | --- |
+| `ssh-dir` | SSH 到指定目录读日志文件 |
+| `log-api` | 调用已有日志接口 |
+| `rancher-api` | 用 Rancher API 拉 Pod 日志 |
+| `skip` | 本轮不做日志通道 |
+
+```bash
+tuner-task ask --task TASK-20260924-001 --topic sut-log-source \
+  --prompt "仓库没有写明后端日志从哪取"
+
+tuner-task answer Q-20260924-001 --option rancher-api \
+  --note "命名空间见 env_local 的 LOG_SOURCE" \
+  --curate assets/domain-notes/order/log-source.md
+```
+
+- 提问立刻落盘，并把任务标为 `blocked`。只挡住依赖该答案的回写；不依赖日志的点击可以先做完，但在回答前不要编写取日志实现，也不要选定通道。
+- `--note` 只留可入库的指向。CLI 拒绝 `password=` / `token:` / `Bearer …` 这类赋值。
+- `skip` 表示报告里日志证据写「无」，设计上的日志断言保持未验证。
+- `tuner-task finish` 在仍有 `status: open` 且 `blocking: true` 的问题时失败。
+- `test-execution` 收口时，`design` 与 `outputs` 里的路径必须已在磁盘上。
+
+## 5. 和测试设计的闭环
+
+```text
+test-design（点击路径 + 期望）
+  → task type=test-execution
+  → 端到端点击
+  → artifacts/evidence/<run_id>/（截图、network、api、logs）
+  → assets/testreport（每条路径的结果 + 证据路径）
+  → 回写 testdesign「执行反馈」
+  → 通道类决定写入 Decisions，并在需要时策展 domain-notes
+```
+
+点击失败只记入「执行反馈」。接口与落库不一致时写 Decision，并引用 evidence 相对路径。点出设计没覆盖的副作用时策展 `assets/design/`，风险行指向同一 `run_id`。

{tuner_testkit-5.1.0 → tuner_testkit-5.2.0}/tuner_testkit/apps/dna/dna_payload/tools/git-hooks/validate_commit_msg.py

@@ -30,7 +30,7 @@ ALLOWED_TYPES = {
 
 ALLOWED_SCOPES = {
     "assets", "apps", "packages", "api_objects", "page_objects", "action_words",
-    "tests", "docs", "rules", "skills", "agents", "hooks", "init_repo", "index",
+    "tests", "docs", "rules", "skills", "agents", "hooks", "init_repo", "index", "work",
     # in-repo dogfood workspace (scaffolded from this platform repo)
     "dogfood",
     # fine-grained package aliases also accepted
@@ -84,6 +84,8 @@ def _path_to_layer(path: str) -> str | None:
         return "packages"
     if p.startswith("apps/"):
         return "apps"
+    if p.startswith("work/"):
+        return "work"
     if p.startswith("assets/"):
         return "assets"
     if p.startswith("tests/"):

{tuner_testkit-5.1.0 → tuner_testkit-5.2.0}/tuner_testkit/apps/evidence/cli.py

@@ -14,7 +14,7 @@ from pathlib import Path
 from tuner_testkit.logging import log_error
 from tuner_testkit.project import ensure_project_on_path, project_root
 
-from .persist import load_jsonl, load_run, persist
+from .persist import attach, load_jsonl, load_run, persist
 
 
 def build_parser() -> argparse.ArgumentParser:
@@ -34,6 +34,10 @@ def build_parser() -> argparse.ArgumentParser:
     persist_p.add_argument("--actions", type=Path, default=None, help="optional actions JSONL")
     persist_p.add_argument("--intent", default="", help="short intent blurb for generated run_summary.md")
     persist_p.add_argument("--summary", type=Path, default=None, help="optional run_summary.md to copy")
+    persist_p.add_argument("--task-id", default="", help="work task id, stored on the run manifest")
+    persist_p.add_argument("--screenshot", type=Path, action="append", default=[], help="image copied under screenshots/")
+    persist_p.add_argument("--log", type=Path, action="append", default=[], help="log excerpt, redacted, under logs/")
+    persist_p.add_argument("--api", type=Path, action="append", default=[], help="JSON response, sanitized, under api/")
     persist_p.add_argument(
         "--root",
         type=Path,
@@ -41,6 +45,16 @@ def build_parser() -> argparse.ArgumentParser:
         help="project root (default: tuner project_root())",
     )
 
+    attach_p = sub.add_parser("attach", help="add screenshots, logs, or API JSON to a run")
+    attach_p.add_argument("--run-id", required=True)
+    attach_p.add_argument("--scenario", default="attach")
+    attach_p.add_argument("--intent", default="")
+    attach_p.add_argument("--task-id", default="")
+    attach_p.add_argument("--screenshot", type=Path, action="append", default=[])
+    attach_p.add_argument("--log", type=Path, action="append", default=[])
+    attach_p.add_argument("--api", type=Path, action="append", default=[])
+    attach_p.add_argument("--root", type=Path, default=None)
+
     routes_p = sub.add_parser("routes", help="print unique method+path from an existing run")
     routes_p.add_argument("--run-id", required=True)
     routes_p.add_argument("--root", type=Path, default=None)
@@ -73,9 +87,25 @@ def main(argv: list[str] | None = None) -> int:
                 intent=ns.intent,
                 summary_text=summary,
                 root=root,
+                task_id=ns.task_id,
+                screenshots=ns.screenshot,
+                logs=ns.log,
+                apis=ns.api,
             )
             _print_json(payload)
             return 0
+        if ns.cmd == "attach":
+            _print_json(attach(
+                run_id=ns.run_id,
+                root=root,
+                scenario_id=ns.scenario,
+                intent=ns.intent,
+                task_id=ns.task_id,
+                screenshots=ns.screenshot,
+                logs=ns.log,
+                apis=ns.api,
+            ))
+            return 0
         if ns.cmd == "routes":
             _print_json(load_run(ns.run_id, root=root))
             return 0