tuner-testkit 4.4.0__tar.gz → 5.0.0__tar.gz

{tuner_testkit-4.4.0/tuner_testkit.egg-info → tuner_testkit-5.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tuner-testkit
-Version: 4.4.0
+Version: 5.0.0
 Summary: Shared test runtime, recorders, and DNA overlay for SUT test repos
 Author: tuner-testkit contributors
 License-Expression: MIT
@@ -167,6 +167,10 @@ git add -A && git commit
 
 `tuner-dna check` 核对项目树 DNA 是否与**当前 PATH 上那份** kit 一致。建议先 `uv tool upgrade`，再 `sync`，避免 CLI 还是旧包、`.venv` 已是新包。
 
+**其他 AI IDE**：DNA 以 Cursor 布局为源，`tuner-dna sync --ide claude,agents`（或 `all`）把 skills 渲染到
+`.claude/skills/` / `.agents/skills/`、subagents 到 `.claude/agents/`，并生成 `CLAUDE.md`（`@AGENTS.md` + always-on 规则内联 + 路径规则清单）。
+`tuner-dna targets` 列出各目标落点；hooks.json 不跨工具翻译。目录约定随各工具文档变动，用前核对。
+
 新仓第一次仍用第 2 节的 `tuner-init scaffold`（会写依赖并做一次 `tuner-dna sync`），不是每次发版都重新 scaffold。
 
 `[phone-ui]` 为预留空 extra，4.0 未实现。
@@ -214,4 +218,4 @@ uv sync --extra all
 （被测系统 = 平台本身，uv workspace 成员，共用 `.venv`）：路线图在 `dogfood/assets/domain-notes/platform/roadmap.md`，
 验收活文档在 `dogfood/tests/features/`。见 [`dogfood/README.md`](dogfood/README.md)。
 
-4.3.0 发行说明见 [`docs/changelog/TEMPLATE-4.3.0.md`](docs/changelog/TEMPLATE-4.3.0.md)；4.2.0 见 [`TEMPLATE-4.2.0.md`](docs/changelog/TEMPLATE-4.2.0.md)；3.x → 4.x 迁移见 [`TEMPLATE-4.0.0.md`](docs/changelog/TEMPLATE-4.0.0.md)。平台能力地图见 [`INDEX.md`](INDEX.md)。
+5.0.0 发行说明（Plane Job 协议退场、`tuner-workspace`）见 [`docs/changelog/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-4.4.0 → tuner_testkit-5.0.0}/README.md

@@ -122,6 +122,10 @@ git add -A && git commit
 
 `tuner-dna check` 核对项目树 DNA 是否与**当前 PATH 上那份** kit 一致。建议先 `uv tool upgrade`，再 `sync`，避免 CLI 还是旧包、`.venv` 已是新包。
 
+**其他 AI IDE**：DNA 以 Cursor 布局为源，`tuner-dna sync --ide claude,agents`（或 `all`）把 skills 渲染到
+`.claude/skills/` / `.agents/skills/`、subagents 到 `.claude/agents/`，并生成 `CLAUDE.md`（`@AGENTS.md` + always-on 规则内联 + 路径规则清单）。
+`tuner-dna targets` 列出各目标落点；hooks.json 不跨工具翻译。目录约定随各工具文档变动，用前核对。
+
 新仓第一次仍用第 2 节的 `tuner-init scaffold`（会写依赖并做一次 `tuner-dna sync`），不是每次发版都重新 scaffold。
 
 `[phone-ui]` 为预留空 extra，4.0 未实现。
@@ -169,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)。
 
-4.3.0 发行说明见 [`docs/changelog/TEMPLATE-4.3.0.md`](docs/changelog/TEMPLATE-4.3.0.md)；4.2.0 见 [`TEMPLATE-4.2.0.md`](docs/changelog/TEMPLATE-4.2.0.md)；3.x → 4.x 迁移见 [`TEMPLATE-4.0.0.md`](docs/changelog/TEMPLATE-4.0.0.md)。平台能力地图见 [`INDEX.md`](INDEX.md)。
+5.0.0 发行说明（Plane Job 协议退场、`tuner-workspace`）见 [`docs/changelog/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-4.4.0 → tuner_testkit-5.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tuner-testkit"
-version = "4.4.0"
+version = "5.0.0"
 description = "Shared test runtime, recorders, and DNA overlay for SUT test repos"
 readme = "README.md"
 license = "MIT"
@@ -69,7 +69,7 @@ tuner-mock-server = "tuner_testkit.apps.mock_server.cli:main"
 tuner-dna = "tuner_testkit.apps.dna.cli:main"
 tuner-init = "tuner_testkit.apps.init_repo.__main__:main"
 tuner-index-ai = "tuner_testkit.apps.index_ai.__main__:main"
-tuner-index-platform = "tuner_testkit.apps.index_platform.__main__:main"
+tuner-workspace = "tuner_testkit.workspace.cli:main"
 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_testkit-4.4.0 → tuner_testkit-5.0.0}/tuner_testkit/api_mock/store.py

@@ -6,9 +6,8 @@ Two layers:
 * **overrides** — whatever the admin API changed since startup.
 
 Overrides win on read and stay in memory until :meth:`MockStore.persist` writes
-them out. That split is deliberate: the Plane runner must be able to redefine a
-response without the server writing into the checked-out repo (see
-``tuner_testkit/apps/index_platform/README.md`` — catalog jobs do not write git).
+them out. That split is deliberate: a test platform or the workbench must be able
+to redefine a response without the server writing into the checked-out repo.
 """
 from __future__ import annotations
 

{tuner_testkit-4.4.0 → tuner_testkit-5.0.0}/tuner_testkit/apps/dna/cli.py

@@ -3,7 +3,6 @@
 from __future__ import annotations
 
 import argparse
-import hashlib
 import json
 import shutil
 import sys
@@ -16,44 +15,39 @@ from tuner_testkit.apps.dna.source import (
     iter_dna_files,
     payload_package_dir,
 )
+from tuner_testkit.apps.dna.targets import (
+    TARGET_LAYOUTS,
+    diff_file_map,
+    parse_targets,
+    render_target,
+    write_file_map,
+)
 from tuner_testkit.project import ProjectRootError, project_root
 
 
-def _hash_bytes(data: bytes) -> str:
-    return hashlib.sha256(data).hexdigest()
-
-
 def _target_root(explicit: str | None) -> Path:
     if explicit:
         return Path(explicit).expanduser().resolve()
     return project_root()
 
 
+def _targets(args: argparse.Namespace) -> list[str]:
+    return parse_targets(getattr(args, "ide", None))
+
+
 def cmd_sync(args: argparse.Namespace) -> int:
     try:
         source = dna_source_root()
         dest = _target_root(args.target)
-    except (DnaSourceError, ProjectRootError) as exc:
+        targets = _targets(args)
+    except (DnaSourceError, ProjectRootError, ValueError) as exc:
         print(str(exc), file=sys.stderr)
         return 2
 
-    copied = 0
-    skipped = 0
-    for rel, src in iter_dna_files(source):
-        dst = dest / rel
-        if dst.exists() and not args.overwrite:
-            if dst.is_file() and src.read_bytes() == dst.read_bytes():
-                skipped += 1
-                continue
-            if dst.is_file() and not args.overwrite:
-                skipped += 1
-                print(f"skip {rel} (differs; pass --overwrite)")
-                continue
-        dst.parent.mkdir(parents=True, exist_ok=True)
-        shutil.copy2(src, dst)
-        copied += 1
-        print(f"copy {rel}")
-    print(f"dna sync: copied={copied} skipped={skipped} dest={dest}")
+    for target in targets:
+        files = render_target(source, target)
+        copied, skipped = write_file_map(dest, files, overwrite=args.overwrite)
+        print(f"dna sync[{target}]: copied={copied} skipped={skipped} dest={dest}")
     marker = dest / ".tuner-dna-version"
     marker.write_text(_kit_version() + "\n", encoding="utf-8")
     return 0
@@ -63,28 +57,33 @@ def cmd_check(args: argparse.Namespace) -> int:
     try:
         source = dna_source_root()
         dest = _target_root(args.target)
-    except (DnaSourceError, ProjectRootError) as exc:
+        targets = _targets(args)
+    except (DnaSourceError, ProjectRootError, ValueError) as exc:
         print(str(exc), file=sys.stderr)
         return 2
 
-    missing: list[str] = []
-    changed: list[str] = []
-    for rel, src in iter_dna_files(source):
-        dst = dest / rel
-        if not dst.is_file():
-            missing.append(rel)
+    drifted = False
+    for target in targets:
+        missing, changed = diff_file_map(dest, render_target(source, target))
+        if not missing and not changed:
+            print(f"DNA[{target}] matches installed kit payload.")
             continue
-        if _hash_bytes(src.read_bytes()) != _hash_bytes(dst.read_bytes()):
-            changed.append(rel)
-    if not missing and not changed:
-        print("DNA matches installed kit payload.")
-        return 0
-    for rel in missing:
-        print(f"  missing: {rel}", file=sys.stderr)
-    for rel in changed:
-        print(f"  changed: {rel}", file=sys.stderr)
-    print("Run `tuner-dna sync --overwrite` to refresh platform DNA.", file=sys.stderr)
-    return 1
+        drifted = True
+        for rel in missing:
+            print(f"  [{target}] missing: {rel}", file=sys.stderr)
+        for rel in changed:
+            print(f"  [{target}] changed: {rel}", file=sys.stderr)
+    if drifted:
+        print("Run `tuner-dna sync --overwrite [--ide <targets>]` to refresh platform DNA.", file=sys.stderr)
+        return 1
+    return 0
+
+
+def cmd_targets(_args: argparse.Namespace) -> int:
+    for name, layout in TARGET_LAYOUTS.items():
+        print(f"{name:8s} skills={layout.skills_dir or '-':16s} agents={layout.agents_dir or '-':16s} "
+              f"instructions={layout.instructions_file or '-':10s} {layout.note}")
+    return 0
 
 
 def cmd_bundle(_args: argparse.Namespace) -> int:
@@ -124,19 +123,25 @@ def _kit_version() -> str:
 def main(argv: list[str] | None = None) -> int:
     parser = argparse.ArgumentParser(
         prog="tuner-dna",
-        description="Sync Cursor/git DNA from tuner-testkit into a project repo.",
+        description="Sync AI-IDE / git DNA from tuner-testkit into a project repo (Cursor by default; --ide for others).",
     )
     sub = parser.add_subparsers(dest="cmd", required=True)
+    ide_help = "comma-separated IDE targets: cursor (default), claude, agents, codex, all"
 
-    p_sync = sub.add_parser("sync", help="copy DNA files into the project")
+    p_sync = sub.add_parser("sync", help="copy / render DNA files into the project")
     p_sync.add_argument("--target", default=None, help="project root (default: cwd project)")
     p_sync.add_argument("--overwrite", action="store_true", help="overwrite differing files")
+    p_sync.add_argument("--ide", default=None, help=ide_help)
     p_sync.set_defaults(func=cmd_sync)
 
     p_check = sub.add_parser("check", help="report DNA drift vs the kit payload")
     p_check.add_argument("--target", default=None)
+    p_check.add_argument("--ide", default=None, help=ide_help)
     p_check.set_defaults(func=cmd_check)
 
+    p_targets = sub.add_parser("targets", help="list IDE targets and where each renders")
+    p_targets.set_defaults(func=cmd_targets)
+
     p_bundle = sub.add_parser("bundle", help="copy DNA into the wheel payload directory")
     p_bundle.set_defaults(func=cmd_bundle)
 

{tuner_testkit-4.4.0 → tuner_testkit-5.0.0}/tuner_testkit/apps/dna/dna_payload/.cursor/rules/apps-authoring.mdc

@@ -2,7 +2,7 @@
 description: SUT apps/ and kit tuner_testkit.apps tools must be standalone-runnable and reuse tuner_testkit plus this repo's packages business assets; no reinventing wheels, no secrets, not imported by tests
 globs: apps/**,tuner_testkit/apps/**
 alwaysApply: false
-version: 1.4.0
+version: 2.0.0
 ---
 
 # apps — 创建期约束
@@ -30,18 +30,20 @@ version: 1.4.0
 - 不得被 `tests/` import（复用逻辑下沉到 `packages/` 业务资产或 `tuner_testkit`）。
 - 不得写入 token / cookie / 密码 / Authorization / session 等敏感值。
 - 破坏性操作无开关、默认非 dry-run/只读 → 禁止。
-- 不得为了「被 Plane 看见」而给本地维护工具加 `@plane_app`（dump_ddl / recorder /
-  api_recorder / page_recorder / init_repo / index_ai 保持本机 CLI，产物进 git）。
-
-## Plane 可运行 vs 本地维护
-
-- **本地维护**（工程师跑完再 commit）：不必 `plane.py`，Plane Runner 不会执行。
-- **Plane Job**：必须提供 import-safe 的 `apps/<name>/plane.py`，用
-  `tuner_testkit.apps._shared.plane_app.@plane_app` / `register_plane_app` 登记；SUT CLI 为
-  `python -m apps.<name>`。领域逻辑在 `packages/`，apps 只做协议适配。
-  造数 / API / UI 动作不要再做成伪 app；给 word 加 `@plane_db_seed` 等即可。
-- 发现器只 import 存在 `plane.py` 的包；`cli.py` 可以较重，但 `plane.py` 禁止
-  顶层 import DB / mitmproxy。
+- 造数 / API / UI 动作不得做成伪 app：写成 action word（`@register` 后自动进目录与工作台）。
+
+## 工作台可见 vs 本地维护
+
+- **工作台可见**（团队成员要在 `tuner-workbench` 里填参运行）：提供 import-safe 的
+  `apps/<name>/tool.py`，用 `tuner_testkit.tools.tool(tool_id=..., name=..., module="apps.<name>", group=...,
+  destructive=..., timeout=...)` 装饰 `build_parser`；`tuner-workspace catalog` 据此导出
+  `params_schema` / `argv_plan`。每个参数必须有 `help`（即表单 label）；破坏性工具声明 `destructive=True`
+  且 CLI 默认 dry-run。
+- **本地维护**（工程师跑完再 commit，产物进 git；如 dump_ddl / recorder / init_repo / index_ai）：
+  不写 `tool.py`，或写了但 `visibility="local"`。
+- 发现器只 import `apps/*/tool.py` 与 kit 的 `tuner_testkit/apps/*/tool.py`；`cli.py` 可以较重，
+  但 `tool.py` 及其 import 的模块禁止顶层 import DB 驱动 / Playwright / mitmproxy。
+- 需要机器可读输出时用 `--json` envelope（`status / outputs[] / artifacts[] / log_path`），见规范 §7。
 
 ## 相关
 

{tuner_testkit-4.4.0 → tuner_testkit-5.0.0}/tuner_testkit/apps/dna/dna_payload/.cursor/rules/bdd-asset-layering.mdc

@@ -2,7 +2,7 @@
 description: Enforce layered boundaries between feature/steps/action_words/page_objects/api_objects and tuner_testkit runtime; no selector or request leakage across layers
 globs: **/*.py
 alwaysApply: false
-version: 1.3.1
+version: 1.4.0
 ---
 
 # Asset Layering — boundary rules per layer
@@ -43,8 +43,8 @@ Each layer owns one responsibility. Leakage across layers (e.g. selectors in ste
 - **No secrets in repo**, ever: `Authorization`, `Cookie`, `Set-Cookie`, `*token*`, `*secret*`, `*password*`, `*session*`. Also applies to captures under `artifacts/evidence/`.
 - **Evidence-driven edits**: Page/API object changes must be backed by Playwright MCP snapshots, `tuner-recorder` / `tuner-api-recorder` captures (`python -m tuner_testkit.apps.recorder` / `api_recorder`), or run_summary findings; avoid locator/path guesses.
 - **`tests/**` must not import `apps.*`**. Action words for BDD/pytest stay in
-  `tuner_testkit.action_words`. Opt into Plane with `@plane_db_seed` (etc.) from
-  `tuner_testkit.action_words.plane`; do not wrap them as `apps.*`.
+  `tuner_testkit.action_words`; every `@register`ed word is already listed by
+  `tuner-workspace catalog` and runnable from the workbench — do not wrap them as `apps.*`.
 
 ## Examples
 

{tuner_testkit-4.4.0 → tuner_testkit-5.0.0}/tuner_testkit/apps/dna/dna_payload/.cursor/rules/index-hygiene.mdc

@@ -2,7 +2,7 @@
 description: Keep the repo-level INDEX.md current and require managed assets to leave a changelog trail; index is the discovery entry for humans and the LLM
 globs: assets/**,packages/api_objects/**,packages/page_objects/**,apps/**,tuner_testkit/apps/**,dogfood/assets/**,dogfood/packages/**,dogfood/apps/**,dogfood/INDEX.project.md
 alwaysApply: false
-version: 1.2.0
+version: 1.3.0
 ---
 
 # index-hygiene — 索引与留痕纪律
@@ -22,7 +22,9 @@ version: 1.2.0
 
 ## 增量维护（省 token）
 
-- 更新 `INDEX.md` 时**优先读各区 `CHANGELOG` 的 delta**，据此补条目；
+- 索引里 `<!-- auto:begin:<zone> -->` 围栏内的区块由 `tuner-workspace index render` 从
+  `artifacts/catalogs/workspace.json` 确定性渲染，**禁止手写**；CI 跑 `tuner-workspace index check`。
+- 围栏外的人工区更新 `INDEX.md` 时**优先读各区 `CHANGELOG` 的 delta**，据此补条目；
   **不要为维护索引而全量读取 `assets/ddl/*.sql` 正文**。
 - AI 组件区（`.cursor/**`）不手写进 `INDEX.md`：由 `python -m tuner_testkit.apps.index_ai`
   确定性生成 `.cursor/REGISTRY.md`，`INDEX.md` 只链接过去。

{tuner_testkit-4.4.0 → tuner_testkit-5.0.0}/tuner_testkit/apps/dna/dna_payload/.cursor/skills/maintain-index/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: maintain-index
 description: Updates the repo-level INDEX.md (knowledge/capability map) incrementally by reading changelog deltas, not full asset bodies. Use after new assets/tools/objects are added, or when INDEX.md drifts from reality.
-version: 1.1.2
+version: 1.2.0
 ---
 
 # Maintain INDEX.md（增量、省 token）
@@ -13,6 +13,19 @@ version: 1.1.2
 - **写范围**：`INDEX.md`；若 `INDEX.project.md` 存在则也可改它。AI 组件区不手写（见下）。
 - **分流**：平台工具 / 公共 `packages` / AI 组件链接 → `INDEX.md`。业务 DDL / SQL / 用例 / explore / design / api_objects / page_objects / features → 有 `INDEX.project.md` 就写那里，不要把 SUT 明细填进 `INDEX.md`。
 
+## 先跑确定性渲染，再做人工区
+
+索引文件里被 `<!-- auto:begin:<zone> -->` … `<!-- auto:end:<zone> -->` 围起来的区块**不要手写**：
+
+```bash
+uv run tuner-workspace catalog          # 刷新 artifacts/catalogs/workspace.json
+uv run tuner-workspace index render     # 渲染 INDEX.project.md（无则 INDEX.md）的 auto 围栏
+uv run tuner-workspace index check      # CI：自动区过期则 exit 1
+```
+
+zone：`ddl` / `sql` / `assets` / `api_objects` / `page_objects` / `action_words` / `apps` / `features`。
+本 skill 只负责围栏**之外**的人工区（用途一句话、confidence 采信说明、平台工具的交接文档链接等）。
+
 ## 核心原则：读 delta，不全量读
 
 - **自动区**（`assets/ddl/`、`packages/api_objects/`、`packages/page_objects/` 等）：**只读各区 `CHANGELOG` 的尾部增量**

{tuner_testkit-4.4.0 → tuner_testkit-5.0.0}/tuner_testkit/apps/dna/dna_payload/.cursor/skills/maintain-page-objects/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: maintain-page-objects
-version: 2.0.2
+version: 2.1.0
 description: Creates or updates page assets under packages/page_objects/ on the tuner_testkit.page_test runtime (PageModel element table + declarative flows, or BasePage escape hatch) following page-objects-syntax.md. Use when UI steps fail due to locators, new UI flows are needed, selector leakage must be removed from steps, or doctor reports locator rot.
 ---
 
@@ -50,7 +50,7 @@ description: Creates or updates page assets under packages/page_objects/ on the
 - 每个 flow 带 `description` 与 `example_params`（让 `run --example` 可一键跑）。
 - 页面级 `asserts` / `extracts` 只放**页面自身的稳定契约**（`open()` 时执行）；
   flow 级断言写在该 flow 的 steps 里。
-- 需要上 Plane Formulation 时加 `@plane_pageobject`。
+- 不需要任何装饰器就会出现在 `tuner-workspace catalog` 与工作台的只读页面清单里（静态扫描 `page_id`）。
 
 ## Quick validation（必须跑）
 

{tuner_testkit-4.4.0 → tuner_testkit-5.0.0}/tuner_testkit/apps/dna/dna_payload/AGENTS.md

@@ -21,7 +21,7 @@
 | 测试层 | `tests/` | 自动化测试代码（behave `features/` + `pytest/`）。 | behave / pytest |
 | 文档层 | `docs/` | 仓库使用说明与规范（`docs/spec/**`）。 | 只读 |
 
-配套：`config/`（环境/数据源）、`.cursor/`（AI 组件，见下）、`artifacts/`·`logs/`（运行产出；MCP evidence 落 `artifacts/evidence/<run_id>/`；agent 任务记录落 `artifacts/inbox/`）。SUT 登录本机文件：`data/sut-accounts.local.yaml`（gitignore）。
+配套：`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）。
 
 ## 2. 三角色
 
@@ -81,3 +81,7 @@ flowchart TD
 - **下游 SUT 测试仓**用 `tuner-init scaffold` 从空白目录新建，用 `uv add tuner-testkit==x.y.z` + `tuner-dna sync` 取平台能力。业务资产（`assets/`、objects、features、`INDEX.project.md`）只活在下游仓。
 - 试用中发现框架要改：在 `public-main` 改并提交（内循环可用 `uv tool install --from <this-repo>`）；阶段收口打 tag 发 PyPI，下游再升级。
 - 历史分支 `plane-dogfood` **退役**：分支式 dogfood 验不了 `tuner-init` + PyPI 全链。Plane 的业务测试仓是外部仓（如 `tuner-test-platform-testrepo`）。
+- **「Plane」在本仓只指 dogfood 的被测系统**（plane.so 类项目管理产品）。曾经的 Plane Job / Sync 协议
+  （`@plane_app`、`@plane_*`、`index_platform`）已在 5.0.0 退场，对应能力中立化为 `tuner_testkit.tools`
+  （tool manifest）与 `tuner_testkit.catalog`（`tuner-workspace catalog`）；云端拉取 workspace 属于 D 阶段，
+  见 `dogfood/assets/domain-notes/platform/roadmap.md`。

{tuner_testkit-4.4.0 → tuner_testkit-5.0.0}/tuner_testkit/apps/dna/dna_payload/MANIFEST.txt

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

{tuner_testkit-4.4.0 → tuner_testkit-5.0.0}/tuner_testkit/apps/dna/dna_payload/docs/spec/action-words-syntax.md

@@ -11,8 +11,8 @@ description: Action Words spec for unified test-asset management. Covers the bas
 - **目标**：把测试资产收敛为**最小可复用业务动作单元**（action word），统一管理
   DB 造数 / DB 断言 / 接口请求 / 接口断言 / 页面操作 / 页面断言六类工作，做到：
   - 每个 word **独立可运行**（CLI 一键执行），也可被 behave 步骤或 pytest 直接调用；
-  - 入参/出参有**统一数据契约**（pydantic v2），可导出 JSON Schema 供 Plane
-    Formulation 做可视化表单与一键执行；
+  - 入参/出参有**统一数据契约**（pydantic v2），可导出 JSON Schema 供本地工作台
+    （`tuner-workbench`）做可视化表单与一键执行；
   - 造数产生的行**按表登记 cleanup**，测试夹具场景后精确删除。
 - **边界**：
   - action word 是**业务动作**，不是技术封装——`tuner_testkit/db`、`tuner_testkit/api_test`、
@@ -26,7 +26,7 @@ description: Action Words spec for unified test-asset management. Covers the bas
 框架（基类 / registry / CLI）在 **`tuner_testkit.action_words`**。SUT 仓的 `packages/action_words/` 只做 re-export 并放本仓 word：
 
 ```
-tuner_testkit/action_words/   # kit：base / context / registry / plane / CLI
+tuner_testkit/action_words/   # kit：base / context / registry / CLI
 packages/action_words/
 ├── __init__.py          # re-export ActionWord / ActionResult / register 等
 ├── __main__.py          # 转到 tuner_testkit.action_words CLI
@@ -129,7 +129,8 @@ uv run python -m tuner_testkit.action_words catalog [-o out.json] # 全量目录
 
 - `run` 输出 `Result` 的 JSON（含 cleanup 登记），退出码 0/1 对应成功/失败；
 - 手工造数后需要清理时，按输出的 cleanup 逐表 `DELETE ... WHERE id IN (...)`。
-- `catalog` 供本机调用 `export_catalog()`；**Plane 列表只收带 `@plane_*` 的词条**，由 `apps.index_platform` 写入 `components.action_words`。
+- `catalog` 供本机调用 `export_catalog()`；`tuner-workspace catalog` 把**全部** `@register` 的词条（含 `params_schema`、
+  `destructive` 推断）写入 `artifacts/catalogs/workspace.json` 的 `action_words[]`，工作台据此渲染表单。
 
 ## 与 BDD / pytest 的集成
 
@@ -141,15 +142,14 @@ uv run python -m tuner_testkit.action_words catalog [-o out.json] # 全量目录
   纯构建函数（`build_*_rows` / `build_links`）可离线断言列集与关联键。
 - **禁止**：`tests/**` import `apps.*`。组合层永远是本包。
 
-## 与 Plane（TestCopilot）
+## 与本地工作台（workbench）
 
-- 仅 `@register` 的 word 供 BDD / 本机 CLI；**不上 Plane**。
-- 要上 Formulation / Job：再加 `@plane_db_seed` / `@plane_db_assert` /
-  `@plane_api_request` / `@plane_api_assert` / `@plane_ui_action` /
-  `@plane_ui_assert`（`from tuner_testkit.action_words.plane import ...`，内部仍调用 `@register`）。
-- 运行：`python -m tuner_testkit.action_words run <word_id>`。Plane 不暴露 CLI 的
-  `--username` / `--password` / `--params-file`；Job 只有 `word_id`、`--params` JSON、`--example`。
-- 词条 `params_schema` 仍给 Formulation 业务表单；Job 校验用 `job_params_schema`。
+- `@register` 即可见：工作台从 `tuner-workspace catalog` 的 `action_words[]` 读取词条，不需要额外装饰器。
+- 运行：工作台经 `tuner-workspace run <word_id> --params JSON` 调用
+  `python -m tuner_testkit.action_words run <word_id> --params JSON`；只暴露 `word_id` 与 `--params`，
+  不暴露 `--username` / `--password` / `--params-file`（凭据来自本机 `config/env_local.py`）。
+- `db_seed` / `api_request` / `ui_action` 三类按类别推断为 **destructive**：工作台要求勾选确认，未确认拒绝运行。
+- 每个 `Params` 字段的 `Field(description=...)` 就是表单 label；缺 description 会被模板测试拦截。
 
 
 ## 敏感信息
@@ -169,4 +169,4 @@ uv run python -m tuner_testkit.action_words catalog [-o out.json] # 全量目录
 5. `uv run pytest packages/tests/test_action_word_template.py` 通过；
 6. `python -m tuner_testkit.action_words run <word_id> --example` 冒烟（需要环境时）；
 7. 若供 behave 使用，在步骤层接线并跑 `behave --stage api --dry-run`。
-8. 若要出现在 TestCopilot Formulation：再加对应 `@plane_*` 装饰器。
+8. `tuner-workspace catalog` 后确认词条出现在 `action_words[]`（工作台随即可见）。

{tuner_testkit-4.4.0 → tuner_testkit-5.0.0}/tuner_testkit/apps/dna/dna_payload/docs/spec/api-objects-syntax.md

@@ -26,10 +26,10 @@ description: API Objects (APIModel) spec for an AI-assisted automation repo. Foc
 - **唯一对齐**：`method + normalized_path` 决定“落到哪个资产”。
 - **禁止**：同一路由为不同场景重复创建多个 API Object（除非重大变更需要升级版本）。
 
-## Plane（TestCopilot）
+## 目录可见性（workspace catalog）
 
-要出现在 Formulation API：在资产实例上加 `@plane_apiobject`（`from packages.api_objects.plane import plane_apiobject`）。
-`auth.py` 等辅助模块不要装饰。本期只读展示，不在 Plane 发请求。
+`tuner-workspace catalog` 用静态扫描（`method = ...` / `path = ...`）列出全部冻结资产，不需要任何装饰器；
+`auth.py` / `registry.py` / `recording/` 等辅助模块会被跳过。API Object 在工作台只做只读展示，不从工作台发请求。
 
 ## 目录结构与命名规范
 

{tuner_testkit-4.4.0 → tuner_testkit-5.0.0}/tuner_testkit/apps/dna/dna_payload/docs/spec/apps-authoring-syntax.md

@@ -2,7 +2,7 @@
 
 > `apps/` 存放 **SUT 私有**、可独立运行的测试工具（`python -m apps.<name>`）。
 > **平台**工具在 `tuner_testkit.apps`（`tuner-recorder`、`tuner-dump-ddl` 等），不要再拷进下游 `apps/`。
-> 领域动作（造数 / API / UI）留在 `packages/`，用 `@plane_db_seed` 等 opt-in 上架，不经 apps 冒充。
+> 领域动作（造数 / API / UI）留在 `packages/`（action words 经 `@register` 自动进入目录与工作台），不经 apps 冒充。
 > 供 `apps-authoring.mdc`（创建期）与 `apps-handover.mdc`（完成期）引用。
 
 ## 1. 目录与入口
@@ -14,8 +14,9 @@ apps/                            # 仅 SUT 私有工具
 ├── __init__.py
 └── <your_tool>/
     ├── __init__.py __main__.py
-    ├── cli.py
-    ├── README.md
+    ├── cli.py                   # argparse build_parser() + main()
+    ├── tool.py                  # import-safe @tool 清单（工作台 / catalog 读取）
+    ├── README.md                # 交接文档（front-matter 见 metadata-conventions）
     └── tests/
 
 # 平台工具（已安装的 tuner-testkit，不要写进本仓 apps/）
@@ -63,10 +64,11 @@ apps/                            # 仅 SUT 私有工具
 - 不得写入 token / cookie / 密码 / Authorization / session 等敏感值（含产出文件与日志）。
 - apps 是**独立运行**的工具，**不得被 `tests/` import**（测试复用逻辑应下沉到 `packages/`）。
 - 破坏性操作（写生产库、删除文件）必须显式开关 + 默认 dry-run/只读。
-- **Plane vs 本地**：只有要在 Plane 跑的 **CLI 工具** 才加 `plane.py` + `@plane_app`。
-  回填 git 的工具（DDL/api_objects/REGISTRY/脚手架）不要注册。领域动作留在
-  `packages/`，用 `@plane_db_seed` 等标记上架；发现器只加载 `apps/*/plane.py`
-  作为 `tools[]`。Plane 装饰器从 `tuner_testkit.apps._shared.plane_app` 导入。
+- **工作台可见 vs 本地维护**：要出现在 `tuner-workspace catalog` / 工作台的工具，提供 import-safe 的
+  `apps/<name>/tool.py`，用 `tuner_testkit.tools.tool` 装饰 `build_parser`（argparse → `params_schema` + `argv_plan`）。
+  纯本地维护、产物直接进 git 的工具可以不写 `tool.py`，或写了但声明 `visibility="local"`。
+  `tool.py` 及其 import 的模块**不得**在顶层 import DB 驱动 / 浏览器 / 代理。领域动作留在 `packages/`
+  （action words 经 `@register` 自动进目录）。
 
 ## 6. 测试
 

tuner_testkit-5.0.0/tuner_testkit/apps/dna/dna_payload/docs/spec/artifacts-layout.md

@@ -0,0 +1,94 @@
+---
+name: artifacts-layout
+version: 1.0.0
+description: 交付物目录 artifacts/ 的子目录职责、run 级 manifest.json 契约、与 assets/testreport 的边界。
+---
+
+# artifacts 交付物规范（artifacts-layout）
+
+> `artifacts/` 是 workspace 的**运行产出与交付物**目录：工具运行、回归报告、探索证据、agent 任务记录、catalog。
+> 它是唯一的同步边界——本地工作台读它，将来 `tuner-publish` 从它往企业平台送。
+> 知识层 `assets/`（含 `assets/testreport/`）放**人工策展后**的内容；`artifacts/` 放**原始产出**。
+
+## 1. 目录
+
+```text
+artifacts/
+├── evidence/<run_id>/     # Playwright MCP / 网络 dump（tuner-evidence persist）；脱敏；gitignore
+├── inbox/<utc>-<agent>-<slice>.md   # agent 任务记录（agent-task-log.md）；gitignore
+├── runs/<run_id>/         # 工具 / 动作词的一次运行（tuner-workspace run、工作台）；gitignore
+├── reports/<run_id>/      # 一次回归（behave / pytest）的报告与摘要；gitignore
+├── catalogs/workspace.json          # tuner-workspace catalog 产物；gitignore
+├── exports/               # 待发布到企业平台的暂存区（C 阶段 tuner-publish）；gitignore
+├── playwright/            # 失败截图等浏览器产物；gitignore
+└── page_test/             # page_test doctor / run 的产物（历史路径，保留）
+```
+
+- `run_id`：`<YYYYMMDDTHHMMSSZ>-<slug>`（UTC，slug 为短横线小写），全 workspace 唯一；`tuner_testkit.artifacts.new_run_id(slug)` 生成。
+- 路径解析统一走 `tuner_testkit.project.asset_path("artifacts_<kind>")`（见 §4），禁止在代码里硬编码 `artifacts/...`。
+- 除 `artifacts/.gitkeep` 外全部 gitignore；要入库的知识请策展到 `assets/`。
+
+## 2. run 级 `manifest.json`（强制）
+
+`runs/`、`reports/`、`evidence/` 下每个 run 目录必须带 `manifest.json`，由 `tuner_testkit.artifacts.RunManifest` 写入：
+
+```json
+{
+  "manifest_version": 1,
+  "kind": "run",                      // run | report | evidence
+  "run_id": "20260922T081200Z-sample-tool",
+  "producer": {
+    "tool_id": "sample_tool",         // 或 suite: "behave --stage api"
+    "argv": ["python", "-m", "apps.sample_tool", "--count", "3"],
+    "user_email": "qa@example.com",   // git config user.email；无则 null
+    "host": "DESKTOP-1",
+    "kit_version": "5.0.0"
+  },
+  "params": {"count": 3, "label": "demo"},
+  "started": "2026-09-22T08:12:00Z",
+  "ended": "2026-09-22T08:12:03Z",
+  "status": "succeeded",              // running | succeeded | failed | cancelled
+  "exit_code": 0,
+  "files": [{"path": "stdout.log", "kind": "log", "bytes": 1024}],
+  "summary": {"total": 12, "passed": 12, "failed": 0}
+}
+```
+
+- `status=running` 在开始时写入，结束时改写为终态；工作台与 catalog 靠它区分「还在跑」与「跑完」。
+- `files[]` 只列 run 目录内的相对路径；`kind` 建议：`log` / `report` / `envelope` / `screenshot` / `json` / `other`。
+- `summary` 自由结构但必须是 JSON 对象；报告类建议 `total / passed / failed / skipped`。
+- **禁止**写入 token / cookie / 密码；`params` 中命中敏感键名（`*password*` / `*token*` / `*secret*` / `*cookie*` / `authorization`）的值写入前必须掩码为 `***`（`RunManifest` 自动处理）。
+
+## 3. 谁写什么
+
+| 产出者 | 目录 | 写法 |
+| --- | --- | --- |
+| `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-workspace catalog` | `catalogs/workspace.json` | 见 `tuner_testkit/workspace/README.md` |
+
+环境变量 `TUNER_REPORT_DIR` 指定本次回归的 run 目录（不设则钩子自动生成 `reports/<run_id>/`）；
+`TUNER_RUN_ID` 指定 run_id（不设则自动生成）。
+
+## 4. 路径键（`tuner_testkit.project`）
+
+| key | 默认 | 覆盖环境变量 |
+| --- | --- | --- |
+| `artifacts` | `artifacts` | `TUNER_ARTIFACTS_DIR` |
+| `artifacts_evidence` | `artifacts/evidence` | — |
+| `artifacts_inbox` | `artifacts/inbox` | — |
+| `artifacts_runs` | `artifacts/runs` | — |
+| `artifacts_reports` | `artifacts/reports` | — |
+| `artifacts_catalogs` | `artifacts/catalogs` | — |
+| `artifacts_exports` | `artifacts/exports` | — |
+| `artifacts_playwright` | `artifacts/playwright` | — |
+| `artifacts_page_test` | `artifacts/page_test` | `PAGE_TEST_ARTIFACTS_DIR` |
+
+## 5. 与知识层的边界
+
+- `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>/`。

{tuner_testkit-4.4.0 → tuner_testkit-5.0.0}/tuner_testkit/apps/dna/dna_payload/docs/spec/page-objects-syntax.md

@@ -40,7 +40,8 @@ allowed-tools: [Read, Write, Edit, Bash, Glob, Grep]
 - **无 host**：`url_path` 与 `Goto(path=...)` 只写路径；host 由
   `tuner_testkit.config.get_ui_base_url()` 运行时注入。
 - **无凭据**：敏感值写 `{{password}}` 占位符，运行时从入参或环境变量代入，**永不落盘**。
-- **Plane**：要出现在 Formulation Page，用 `@plane_pageobject`（`packages.page_objects.plane`）。
+- **目录可见**：`tuner-workspace catalog` 静态扫描 `packages/page_objects/**` 中带 `page_id` 的 `PageModel` /
+  `BasePage` 文件，不需要装饰器；`session.py` / `pages.py` 等辅助模块会被跳过。
 - **可审计**：脆弱 locator 必须声明 `confidence="fragile"` 并在 `note` 写清风险与替代建议。
 
 ## Locator 策略