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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tuner-testkit
-Version: 4.3.0
+Version: 4.4.0
 Summary: Shared test runtime, recorders, and DNA overlay for SUT test repos
 Author: tuner-testkit contributors
 License-Expression: MIT
@@ -210,4 +210,8 @@ uv sync --extra all
 
 `uv sync --extra dev` 与 `--extra all` 等价（`dev` 只是引用 `[all]`）。
 
+本仓是**平台仓**，不是 workspace。`dogfood/` 是用 `tuner-init scaffold dogfood --no-ai` 生成的 workspace 示范
+（被测系统 = 平台本身，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)。

{tuner_testkit-4.3.0 → tuner_testkit-4.4.0}/README.md

@@ -165,4 +165,8 @@ uv sync --extra all
 
 `uv sync --extra dev` 与 `--extra all` 等价（`dev` 只是引用 `[all]`）。
 
+本仓是**平台仓**，不是 workspace。`dogfood/` 是用 `tuner-init scaffold dogfood --no-ai` 生成的 workspace 示范
+（被测系统 = 平台本身，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)。

{tuner_testkit-4.3.0 → tuner_testkit-4.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tuner-testkit"
-version = "4.3.0"
+version = "4.4.0"
 description = "Shared test runtime, recorders, and DNA overlay for SUT test repos"
 readme = "README.md"
 license = "MIT"
@@ -90,6 +90,10 @@ include = ["tuner_testkit*"]
 build_py = "tuner_testkit.apps.dna.build.BuildPyWithDna"
 sdist = "tuner_testkit.apps.dna.build.SdistWithDna"
 
+[tool.uv.workspace]
+# dogfood/ is a workspace scaffolded by `tuner-init` from this repo (SUT = the platform itself).
+members = ["dogfood"]
+
 [tool.tuner-testkit]
 page_objects = "packages/page_objects"
 api_objects = "packages/api_objects"

{tuner_testkit-4.3.0 → tuner_testkit-4.4.0}/tuner_testkit/__init__.py

@@ -2,4 +2,4 @@
 
 from __future__ import annotations
 
-__version__ = "4.3.0"
+__version__ = "4.4.0"

{tuner_testkit-4.3.0 → tuner_testkit-4.4.0}/tuner_testkit/apps/dna/build.py

@@ -31,8 +31,19 @@ def _payload_ready(root: Path | None = None) -> bool:
 
 
 def _bundle() -> None:
+    """Refresh ``dna_payload`` from the template tree when building a wheel.
+
+    A leftover ``dna_payload/`` from an older build must not short-circuit:
+    that shipped stale DNA (4.3.0 payload inside a 4.4.0 wheel).
+    """
     _ensure_src_on_path()
-    if _payload_ready():
+    from tuner_testkit.project import template_source_root
+
+    if template_source_root() is None:
+        if not _payload_ready():
+            raise RuntimeError(
+                "no DNA payload in this install and no template checkout to bundle from"
+            )
         return
 
     from tuner_testkit.apps.dna.cli import cmd_bundle

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

@@ -47,6 +47,7 @@ def cmd_sync(args: argparse.Namespace) -> int:
                 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)
@@ -82,7 +83,7 @@ def cmd_check(args: argparse.Namespace) -> int:
         print(f"  missing: {rel}", file=sys.stderr)
     for rel in changed:
         print(f"  changed: {rel}", file=sys.stderr)
-    print("Run `tuner-dna sync` to refresh platform DNA.", file=sys.stderr)
+    print("Run `tuner-dna sync --overwrite` to refresh platform DNA.", file=sys.stderr)
     return 1
 
 

{tuner_testkit-4.3.0 → tuner_testkit-4.4.0}/tuner_testkit/apps/dna/dna_payload/.cursor/agents/bdd-asset-pipeline.md

@@ -1,6 +1,6 @@
 ---
 name: bdd-asset-pipeline
-version: 2.0.0
+version: 2.0.1
 description: Lower-half of SUT self-learning — Feature Sets + design knowledge → Reuse Analysis → Freeze API Objects → Maintain Page Objects → Maintain Steps → behave regression. Use only for behave/BDD automation assets. Do NOT use when the user explicitly requests pytest. Do NOT use this agent as the explore-first entry; start from docs/spec/sut-self-learning.md instead.
 ---
 
@@ -104,3 +104,5 @@ Before writing Then-assertions, **read `assets/design/**`**:
 - `behave --stage ui` succeeds for UI features that exist.
 - `behave --stage api` succeeds for API features that exist (or `--dry-run`
   with documented TODO).
+- Task log written to `artifacts/inbox/` per `docs/spec/agent-task-log.md`
+  (no secrets).

tuner_testkit-4.4.0/tuner_testkit/apps/dna/dna_payload/.cursor/agents/sut-self-learning.md

@@ -0,0 +1,72 @@
+---
+name: sut-self-learning
+version: 1.0.0
+description: Orchestrate explore-first SUT self-learning — accounts → Playwright MCP explore → evidence → freeze API/page objects → design knowledge → index, with an artifacts/inbox task log. Hand off to bdd-asset-pipeline only when Feature Sets are in scope. Do NOT use when the user explicitly requests pytest-only work.
+---
+
+# SUT self-learning orchestrator (upper half + optional handoff)
+
+## Purpose
+
+串起「学习被测 Web 系统并生长测试资产」的**上半程**。规格
+`docs/spec/sut-self-learning.md`。本文件是可执行编排；规格不是本 agent 的替代。
+
+**下半程**（已有 feature set → steps / behave）交给
+`.cursor/agents/bdd-asset-pipeline.md`，不要在本 agent 里硬造 Gherkin，除非用户明确要验收自动化。
+
+## When to use
+
+- 工程师说「探索 SUT / 学习某某模块 / 生成测试资产 / 再跑一轮自学习」。
+- 下游仓已有 `tuner-init` 骨架，SUT 可访问。
+
+## Inputs
+
+1. `INDEX.md` + 若存在 `INDEX.project.md`（已有切片、勿重复冻登录接口）。
+2. **账号**（只读，禁止拷进仓库/evidence/inbox）：
+   1. `data/sut-accounts.local.yaml`（gitignore，首选）
+   2. 否则 `config/env_local.py` 的 `TEST_ACCOUNT`
+   3. 都没有则停，让工程师按 `data/sut-accounts.example.yaml` 补本机文件
+3. 垂直切片（一个模块，不是全站爬）。
+4. 可选：SUT 源码根（如 Plane `apps/api`）——有则跑 `sut-source-to-design`。
+
+## Skills / agents（顺序）
+
+| 步 | 组件 | 产出 |
+| --- | --- | --- |
+| 0 | 读账号 + `explore-safety` | 登录参数（内存） |
+| 1 | `dump-ddl`（缺表才跑，禁 `--all`） | `assets/ddl/<ds>/` |
+| 2 | `explore-sut` | `artifacts/evidence/<run_id>/` + `assets/explore/` |
+| 3 | `analyze-mcp-network`（`tuner-evidence routes`） | 路由表 JSON |
+| 4 | `reuse-analysis` | 复用 vs 新建 |
+| 5 | `freeze-api-objects` | `packages/api_objects/`（跳过 sign-in） |
+| 6 | `maintain-page-objects` | `packages/page_objects/` |
+| 7 | `derive-design-knowledge`；有源码则 **`sut-source-to-design`** | `assets/design/` |
+| 8 | `maintain-index` | `INDEX.project.md` 或 `INDEX.md` |
+| 9 | **本 agent** 写 inbox | `artifacts/inbox/<utc>-sut-self-learning-<slice>.md` |
+| 10 | 仅当用户要 `.feature` | `derive-feature-sets` → **`bdd-asset-pipeline`** |
+
+每步先 **Read** 对应 `SKILL.md` / agent 正文再执行。不要跳过 evidence 落盘。
+
+## Inbox（强制）
+
+遵循 `docs/spec/agent-task-log.md`。SUT 自学习日志 **必须**含：
+
+- `## Pages explored`（url pattern / title / 按钮）
+- `## Assets added this run`（本任务新增或更新的 api/page/explore/design/ddl）
+- `run_id`；`account_id`（无密码）
+- 若这是第 N 轮 dogfood：`## Loop delta` 对比上一轮 inbox / 平台能力
+
+## Hard rules
+
+- 活体 SUT：`explore-safety`（throwaway 数据；不问不准删）。
+- 密钥不入库、不进 evidence、不进 inbox。
+- Web cookie session 的 path 占位用 `{workspace_slug}` 等，调用走 `set_path`。
+- 页面资产 app 名对齐现有 `packages/page_objects/<app>/`，勿与装饰器模块重名。
+- 未走 Gate 1 证据不得写 api/page/design。
+
+## Done
+
+- evidence 在磁盘且已脱敏。
+- 切片的 explore +（若有写操作）design 已引用 `run_id`。
+- 新路由已冻或书面说明跳过原因。
+- inbox 已落盘，页面清单与资产增量齐全。

{tuner_testkit-4.3.0 → tuner_testkit-4.4.0}/tuner_testkit/apps/dna/dna_payload/.cursor/agents/sut-source-to-design.md

@@ -1,6 +1,6 @@
 ---
 name: sut-source-to-design
-version: 1.0.0
+version: 1.0.1
 description: Walk SUT backend source (Django models/views/serializers, or equivalent) plus assets/ddl to draft assets/design/<app>/<route-slug>.md. Use when the engineer points at a source tree. Do not invent tables. Complements derive-design-knowledge; this agent is the source-channel playbook.
 ---
 
@@ -31,3 +31,5 @@ Highest-quality `writes` / `noise` / `reads` often come from **models.save / vie
 - `confidence: inferred` for source-only; `observed` only with DB/log evidence.
 - No secrets.
 - Do not generate action words here.
+- Write `artifacts/inbox/<utc>-sut-source-to-design-<slice>.md` per
+  `docs/spec/agent-task-log.md` (outputs = design files; no secrets).

tuner_testkit-4.4.0/tuner_testkit/apps/dna/dna_payload/.cursor/rules/agent-task-log.mdc

@@ -0,0 +1,22 @@
+---
+description: Every agent run must leave a task log under artifacts/inbox/ (no secrets).
+alwaysApply: true
+version: 1.0.0
+---
+
+# Agent task log — `artifacts/inbox/`
+
+每次按 `.cursor/agents/*.md` 编排执行（含 SUT 自学习），结束前必须写一份任务记录。
+细则见 `docs/spec/agent-task-log.md`。
+
+## Must
+
+- 路径：`artifacts/inbox/<UTC>-<agent>-<slice>.md`（例 `20260914T031200Z-sut-self-learning-cycles.md`）。
+- 必填：`agent`、意图、输入、产出文件列表、下一步。
+- **SUT 自学习**额外必填：本次探索的页面（url pattern + 标题）、本次新增/更新的测试资产路径。
+- 只写 `account_id` / workspace slug，**禁止**密码、token、Cookie。
+
+## Must not
+
+- 用聊天摘要代替 inbox 落盘。
+- 把 inbox 当 evidence（网络 dump 仍走 `artifacts/evidence/<run_id>/`）。

{tuner_testkit-4.3.0 → tuner_testkit-4.4.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.0.0
+version: 1.1.0
 ---
 
 # 提交规范（Conventional Commits + 六层 scope）
@@ -12,7 +12,8 @@ version: 1.0.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`（多层用逗号分隔，如 `feat(apps,packages): ...`）。
+  init_repo / index / dogfood`（多层用逗号分隔，如 `feat(apps,packages): ...`；
+  `dogfood/**` 一律用 `dogfood`）。
 - **scope 必须覆盖本次真实改动涉及的层**（`packages` 是三个子资产层的上位 scope）。
 
 一眼可读优先：让人从提交信息就看出"更新了 assets、新增了 apps、录制了新的 api_objects"等。

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

@@ -1,13 +1,14 @@
 ---
 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/**
+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.1.3
+version: 1.2.0
 ---
 
 # index-hygiene — 索引与留痕纪律
 
 根 `INDEX.md` 是**平台**能力地图（发现入口）。若存在 `INDEX.project.md`，那是试验田 / 下游项目仓的**业务资产**地图；两份索引都必须与各自职责范围内的仓库状态一致。
+平台仓内的 `dogfood/` 是用 scaffold 生成的 workspace，它的业务地图是 `dogfood/INDEX.project.md`。
 
 ## 留痕（changelog trail）
 

{tuner_testkit-4.3.0 → tuner_testkit-4.4.0}/tuner_testkit/apps/dna/dna_payload/.cursor/skills/explore-sut/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: explore-sut
-version: 1.1.0
+version: 1.2.0
 description: Explore-first Playwright MCP session against a live SUT. Produces sanitized artifacts/evidence/<run_id>/ plus assets/explore capability notes. Use when learning a web SUT, mapping pages/buttons, or gathering evidence before any .feature exists. Do NOT use when the user already has a feature to implement — use run-feature-playwright-mcp instead.
 ---
 
@@ -23,6 +23,10 @@ description: Explore-first Playwright MCP session against a live SUT. Produces s
 ## Steps
 
 1. Read `INDEX.md` and `INDEX.project.md` if present. Note base URLs from `config`.
+   Load login from **`data/sut-accounts.local.yaml`** if it exists; else
+   `config/env_local.py` `TEST_ACCOUNT`. Copy `data/sut-accounts.example.yaml`
+   when neither exists and **stop**. Never write the password into evidence,
+   explore notes, inbox, or git.
 2. Pick a **vertical slice** (e.g. workspace → project → issue), not a full-site crawl.
 3. Navigate with Playwright MCP. After each meaningful action, dump network + snapshot.
 4. Persist with **`tuner-evidence persist`** (do not leave captures only in chat):

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

@@ -1,4 +1,4 @@
-<!-- version: 1.3.0 -->
+<!-- version: 1.5.0 -->
 # AGENTS — 平台总入口（轻量 DM）
 
 > 本文件是"repo as a platform"的**稳定世界观**：只写不常变的分层结构与角色。
@@ -21,7 +21,7 @@
 | 测试层 | `tests/` | 自动化测试代码（behave `features/` + `pytest/`）。 | behave / pytest |
 | 文档层 | `docs/` | 仓库使用说明与规范（`docs/spec/**`）。 | 只读 |
 
-配套：`config/`（环境/数据源）、`.cursor/`（AI 组件，见下）、`artifacts/`·`logs/`（运行产出；MCP evidence 落 `artifacts/evidence/<run_id>/`）。
+配套：`config/`（环境/数据源）、`.cursor/`（AI 组件，见下）、`artifacts/`·`logs/`（运行产出；MCP evidence 落 `artifacts/evidence/<run_id>/`；agent 任务记录落 `artifacts/inbox/`）。SUT 登录本机文件：`data/sut-accounts.local.yaml`（gitignore）。
 
 ## 2. 三角色
 
@@ -43,7 +43,7 @@
 ```mermaid
 flowchart TD
   Start[任务到达] --> Q{任务类型?}
-  Q -->|"学习被测系统 / 探索式测试"| Learn["SUT 自学习\ndocs/spec/sut-self-learning.md"]
+  Q -->|"学习被测系统 / 探索式测试"| Learn["SUT 自学习编排\n.cursor/agents/sut-self-learning.md"]
   Q -->|"业务 UI/API 流自动化"| BDD["BDD 资产流水线（下半程）\n.cursor/agents/bdd-asset-pipeline.md"]
   Q -->|"明确要求 pytest / 性能 / DB 核对"| Pytest["pytest 路径\n复用 tuner_testkit + packages，不产出 .feature"]
   Q -->|"需要一个新的独立工具"| App["create-app skill\napps-authoring / apps-handover 规则"]
@@ -52,7 +52,7 @@ flowchart TD
   Q -->|"读/策展/索引知识"| Idx["查 INDEX.md + maintain-index skill"]
 ```
 
-- **学习被测系统** → `docs/spec/sut-self-learning.md`（explore-first：能力清单 + design 知识；证据来源开放、design 产物收敛）。
+- **学习被测系统** → `.cursor/agents/sut-self-learning.md`（编排 explore → freeze → design；规格 `docs/spec/sut-self-learning.md`；任务 log 见 `docs/spec/agent-task-log.md`）。
 - **业务 UI/API 流** → `.cursor/agents/bdd-asset-pipeline.md`（自学习的**下半程**；内部含三门禁，仅在此分支生效）。
 - **明确 pytest** → 直接写 pytest，复用 `tuner_testkit` 与本仓 `packages/**` 业务资产，不要为满足分层而硬造 Gherkin。
 - **造工具** → `create-app` skill；工具做好按 `apps-handover.mdc` 补交接文档。证据通道（日志/DB 日志取数）也落 `apps/`，遵守 CLI + JSON 输出约定。
@@ -65,11 +65,14 @@ flowchart TD
 - 不得将 token / cookie / Authorization / 密码 / session 等敏感信息写入仓库（含 capture 与 api_objects）。
 - 提交遵循 Conventional Commits + 六层 scope，见 `docs/spec/commit-convention.md`（`commit-msg` hook 会校验）。
 - DB 只走 `tuner_testkit.db`，日志只走 `tuner_testkit.logging`（见对应 rule）。
-- 密钥只放本机 `config/env_local.py` 或环境变量，**任何分支都不得提交**。多套 prd/uat/dev 写在 `env_local.ENVIRONMENTS` 里，用 `python -m tuner_testkit.config use <name>` 切换（或 `TUNER_ENV`）。
+- 密钥只放本机 `config/env_local.py`、`data/**/*.local.yaml` 或环境变量，**任何分支都不得提交**。多套 prd/uat/dev 写在 `env_local.ENVIRONMENTS` 里，用 `python -m tuner_testkit.config use <name>` 切换（或 `TUNER_ENV`）。探索账号优先 `data/sut-accounts.local.yaml`（模板 `data/sut-accounts.example.yaml`）。
 
 ## 6. 分支与下游仓
 
 本公开仓只维护**平台**：`tuner_testkit/`、`.cursor/**`、`docs/spec/**`、`INDEX.md`。
+**本仓不是 workspace**：真正的个人 workspace 是 `tuner-init scaffold` 生成的下游仓。仓内 `dogfood/`
+是用同一 scaffold 生成的 workspace 示范（被测系统 = 平台本身），存放路线图、验收剧本与活文档；
+它是 uv workspace 成员，不带自己的 `.cursor/`（根 DNA 覆盖全树），提交 scope 用 `dogfood`。
 
 | 分支 | 职责 | 谁改 |
 | --- | --- | --- |

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

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

tuner_testkit-4.4.0/tuner_testkit/apps/dna/dna_payload/docs/spec/agent-task-log.md

@@ -0,0 +1,70 @@
+# Agent 任务日志（`artifacts/inbox/`）
+
+> 给 `.cursor/agents/**` 编排任务用的**运行记录**约定。
+> 硬约束见 `.cursor/rules/agent-task-log.mdc`。
+> Evidence（网络/DOM dump）仍落 `artifacts/evidence/<run_id>/`，本目录不替代它。
+
+## 1. 路径
+
+```text
+artifacts/inbox/<YYYYMMDDTHHMMSSZ>-<agent>-<slice>.md
+```
+
+- `<agent>`：与 agent front-matter `name` 一致（如 `sut-self-learning`）。
+- `<slice>`：短横线 slug（如 `cycles`、`issue-create`）。
+- 本目录默认 gitignore；本机下次会话靠读磁盘复用，不入库。
+
+## 2. 通用模板（所有 agent）
+
+```markdown
+---
+agent: sut-self-learning
+slice: cycles
+started: 2026-09-14T03:12:00Z
+ended: 2026-09-14T03:40:00Z
+status: done
+account_id: dogfood-admin
+evidence:
+  - artifacts/evidence/20260914T031200Z-cycles/
+---
+
+# <slice> — <一句话意图>
+
+## Intent
+（用户要什么）
+
+## Inputs
+- INDEX / INDEX.project / accounts 文件 / 源码路径
+
+## Outputs
+| kind | path | action |
+| --- | --- | --- |
+| explore | assets/explore/web/….md | add |
+| api_object | packages/api_objects/… | add |
+
+## Next
+- …
+```
+
+`kind` 建议：`explore` / `design` / `ddl` / `api_object` / `page_object` / `action_word` / `feature` / `index` / `inbox`。
+
+## 3. SUT 自学习额外章节（强制）
+
+编排 agent `.cursor/agents/sut-self-learning.md` 的 inbox **必须**再写：
+
+```markdown
+## Pages explored
+| url pattern | title | primary actions |
+| --- | --- | --- |
+| `/{workspace}/projects/{id}/cycles/` | Cycles | New cycle, Save |
+
+## Assets added this run
+（只列本任务新增或更新的路径，不要把仓库里已有资产再抄一遍）
+```
+
+对照两轮 dogfood 时，另写 `## Loop delta`：相对上一份 inbox，少了哪些手工步骤、多了哪些平台能力。
+
+## 4. 密钥
+
+- 可用 `account_id` 指向 `data/sut-accounts.local.yaml` 的条目。
+- 禁止密码、token、Cookie、Authorization 原文。

{tuner_testkit-4.3.0 → tuner_testkit-4.4.0}/tuner_testkit/apps/dna/dna_payload/docs/spec/commit-convention.md

@@ -51,6 +51,7 @@
 | `hooks` | `.cursor/hooks*`、`tools/git-hooks/**` | 钩子 |
 | `init_repo` | `tuner_testkit/apps/init_repo/**` | 初始化工具与 release |
 | `index` | `INDEX.md`、`INDEX.project.md`、`.cursor/REGISTRY.md` | 索引/注册表 |
+| `dogfood` | `dogfood/**` | 平台仓内用 scaffold 生成的 dogfood workspace（知识、feature、fixture） |
 
 > `packages` 视为 `api_objects` / `page_objects` / `action_words` 的**上位 scope**：
 > 声明 `packages` 可覆盖这三者的改动。
@@ -80,4 +81,5 @@ feat(apps,packages): add init_repo and release manifest surface
 git config core.hooksPath tools/git-hooks
 ```
 
-CI 可复用同一校验脚本（对齐 `docs/note.md` 里 Ruff+CI 规划）。合并/回滚提交（`Merge`/`Revert` 开头）跳过校验。
+CI 可复用同一校验脚本。合并/回滚提交（`Merge`/`Revert` 开头）跳过校验。
+测试或活文档可用环境变量 `TUNER_COMMIT_STAGED`（换行分隔的路径列表）注入"已暂存文件"，替代 `git diff --cached`。

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

@@ -48,6 +48,10 @@ artifacts/evidence/<run_id>/     ← 统一落盘（强制）
               steps imple → Auto UAT（behave）
 ```
 
+**上半程编排**：[`.cursor/agents/sut-self-learning.md`](../../.cursor/agents/sut-self-learning.md)
+（本机账号 → explore → evidence → freeze → design → `artifacts/inbox/`）。
+任务记录约定：[`agent-task-log.md`](agent-task-log.md)。
+
 下半程（已有 feature set + design 时写 steps）由
 [`.cursor/agents/bdd-asset-pipeline.md`](../../.cursor/agents/bdd-asset-pipeline.md) 编排。
 
@@ -87,5 +91,7 @@ artifacts/evidence/<run_id>/     ← 统一落盘（强制）
 - **阶段 2 design 闭环**：`derive-design-knowledge` + `sut-source-to-design` agent；schema 仍为 v0.1（Plane 切片缺口记在 design spec §6）。
 - **阶段 3 双路汇合**：`derive-feature-sets`；bdd-asset-pipeline 下半程。
 - **阶段 4 知识自治**：knowledge-curator；确定性 `secret-scan` hook。
+- **编排与任务 log（4.4.0 DNA）**：`sut-self-learning` agent + `artifacts/inbox/`；
+  探索账号本机文件 `data/sut-accounts.local.yaml`。
 
 内循环用 `uv tool install --from <platform-repo>`；阶段收口才打 tag 发 PyPI。

{tuner_testkit-4.3.0 → tuner_testkit-4.4.0}/tuner_testkit/apps/dna/dna_payload/tools/git-hooks/validate_commit_msg.py

@@ -17,6 +17,7 @@ Exit code 0 = ok, 1 = rejected.
 """
 from __future__ import annotations
 
+import os
 import re
 import subprocess
 import sys
@@ -30,10 +31,15 @@ ALLOWED_TYPES = {
 ALLOWED_SCOPES = {
     "assets", "apps", "packages", "api_objects", "page_objects", "action_words",
     "tests", "docs", "rules", "skills", "agents", "hooks", "init_repo", "index",
+    # in-repo dogfood workspace (scaffolded from this platform repo)
+    "dogfood",
     # fine-grained package aliases also accepted
     "db", "logging", "recorder", "config", "api_test", "excel",
 }
 
+# Tests can inject the staged file list instead of calling git.
+STAGED_ENV = "TUNER_COMMIT_STAGED"
+
 # packages umbrella covers these sub-layers
 PACKAGES_UMBRELLA = {"api_objects", "page_objects", "action_words", "packages",
                      "db", "logging", "api_test", "excel", "config"}
@@ -44,6 +50,9 @@ HEADER_RE = re.compile(
 
 
 def _staged_files() -> list[str]:
+    injected = os.environ.get(STAGED_ENV)
+    if injected is not None:
+        return [line.strip() for line in injected.splitlines() if line.strip()]
     try:
         out = subprocess.run(
             ["git", "diff", "--cached", "--name-only"],
@@ -57,6 +66,8 @@ def _staged_files() -> list[str]:
 def _path_to_layer(path: str) -> str | None:
     """Map a repo path to a canonical scope layer, or None if unrecognized."""
     p = path.replace("\\", "/")
+    if p.startswith("dogfood/"):
+        return "dogfood"
     if p.startswith("packages/api_objects/"):
         return "api_objects"
     if p.startswith("packages/page_objects/"):
@@ -108,7 +119,7 @@ def main(argv: list[str]) -> int:
         return 1
 
     try:
-        with open(argv[1], encoding="utf-8") as fh:
+        with open(argv[1], encoding="utf-8-sig") as fh:  # tolerate a Windows editor BOM
             raw = fh.read()
     except OSError as exc:
         print(f"commit-msg: cannot read message file: {exc}", file=sys.stderr)

{tuner_testkit-4.3.0 → tuner_testkit-4.4.0}/tuner_testkit/apps/dna/tests/test_cli.py

@@ -19,3 +19,6 @@ def test_dna_sync_and_check(tmp_path: Path):
     assert (tmp_path / "tools" / "git-hooks" / "commit-msg").is_file()
     assert (tmp_path / ".tuner-dna-version").is_file()
     assert main(["check", "--target", str(tmp_path)]) == 0
+    assert (tmp_path / ".cursor" / "agents" / "sut-self-learning.md").is_file()
+    assert (tmp_path / ".cursor" / "rules" / "agent-task-log.mdc").is_file()
+    assert (tmp_path / "docs" / "spec" / "agent-task-log.md").is_file()

{tuner_testkit-4.3.0 → tuner_testkit-4.4.0}/tuner_testkit/apps/init_repo/scaffold.py

@@ -32,6 +32,7 @@ SKELETON_DIRS: tuple[str, ...] = (
     "artifacts",
     "artifacts/evidence",
     "artifacts/catalogs",
+    "artifacts/inbox",
 )
 
 # Thin SUT files copied from this template (not the full kit runtime).
@@ -52,20 +53,19 @@ _STUB_FILES: tuple[str, ...] = (
     "packages/action_words/_internal/params.py",
     "apps/__init__.py",
     "behave.ini",
+    "data/sut-accounts.example.yaml",
 )
 
 
 def _stub_root() -> pathlib.Path | None:
     """Directory that contains thin SUT stub files (``config/env.py``, …).
 
-    Wheel installs have no template checkout beside site-packages, and
-    ``project_root()`` must not be used: scaffold is how a project is created.
+    ``init_repo/stubs/`` is the single source of truth for both editable and
+    wheel installs: the platform repo itself is **not** a workspace (its
+    workspace example lives in ``dogfood/``), so scaffold never copies from
+    the repo root. ``project_root()`` must not be used: scaffold is how a
+    project is created.
     """
-    from tuner_testkit.project import template_source_root
-
-    editable = template_source_root()
-    if editable is not None:
-        return editable
     bundled = pathlib.Path(__file__).resolve().parent / "stubs"
     if (bundled / "config" / "env.py").is_file():
         return bundled

{tuner_testkit-4.3.0 → tuner_testkit-4.4.0}/tuner_testkit/apps/init_repo/stubs/config/env.py

@@ -5,6 +5,7 @@
 #   1. 本文件 DATABASES / TEST_* 占位
 #   2. config/env_overlay.py（可选，项目/试验田提交：额外别名与类型，仍无密钥）
 #   3. config/env_local.py（gitignore，本机真实 host/密码/账号）
+#   探索登录优先读 data/sut-accounts.local.yaml（gitignore；模板 data/sut-accounts.example.yaml）
 #      - 若定义了非空 ENVIRONMENTS：由 tuner_testkit.config 按激活名只套用那一套
 #        （TUNER_ENV > config/.active_env > ACTIVE_ENV > 唯一 key）
 #      - 否则按扁平 DATABASES / TEST_* 合并（旧写法）

tuner_testkit-4.4.0/tuner_testkit/apps/init_repo/stubs/data/sut-accounts.example.yaml

@@ -0,0 +1,18 @@
+# Copy to data/sut-accounts.local.yaml (gitignored) and fill real values.
+# LLM explore reads the .local file; never commit passwords.
+
+sut: example-app
+ui_base_url: http://localhost:3000
+api_base_url: http://localhost:8000
+accounts:
+  - id: dogfood-admin
+    email: you@example.com
+    password: "replace-me"
+    notes: first-login onboarding / i18n caveats
+workspace:
+  slug: demo
+  name: Demo
+project:
+  identifier: DEMO
+  id: "00000000-0000-0000-0000-000000000000"
+  name: Demo

{tuner_testkit-4.3.0 → tuner_testkit-4.4.0}/tuner_testkit/apps/init_repo/tests/test_scaffold.py

@@ -27,6 +27,9 @@ def test_scaffold_from_non_project_cwd(tmp_path: Path, monkeypatch):
     assert (dest / "config" / "env.py").is_file()
     assert (dest / "packages" / "action_words" / "__init__.py").is_file()
     assert (dest / ".cursor" / "rules").is_dir()
+    assert (dest / "artifacts" / "inbox").is_dir()
+    assert (dest / "data" / "sut-accounts.example.yaml").is_file()
+    assert "replace-me" in (dest / "data" / "sut-accounts.example.yaml").read_text(encoding="utf-8")
     assert any(line.startswith("copy config/env.py") for line in actions)
     assert any("dna sync (exit 0)" in line for line in actions)
 
@@ -43,5 +46,7 @@ def test_scaffold_uses_packaged_stubs_when_not_editable(tmp_path: Path, monkeypa
     assert (dest / "config" / "env.py").read_text(encoding="utf-8") == _STUB_ENV.read_text(
         encoding="utf-8"
     )
+    assert (dest / "artifacts" / "inbox").is_dir()
+    assert (dest / "data" / "sut-accounts.example.yaml").is_file()
     assert any(line.startswith("copy config/env.py") for line in actions)
     assert any("dna sync (exit 0)" in line for line in actions)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tuner-testkit
-Version: 4.3.0
+Version: 4.4.0
 Summary: Shared test runtime, recorders, and DNA overlay for SUT test repos
 Author: tuner-testkit contributors
 License-Expression: MIT
@@ -210,4 +210,8 @@ uv sync --extra all
 
 `uv sync --extra dev` 与 `--extra all` 等价（`dev` 只是引用 `[all]`）。
 
+本仓是**平台仓**，不是 workspace。`dogfood/` 是用 `tuner-init scaffold dogfood --no-ai` 生成的 workspace 示范
+（被测系统 = 平台本身，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)。

{tuner_testkit-4.3.0 → tuner_testkit-4.4.0}/tuner_testkit.egg-info/SOURCES.txt

@@ -68,6 +68,7 @@ tuner_testkit/apps/dna/source.py
 tuner_testkit/apps/dna/dna_payload/AGENTS.md
 tuner_testkit/apps/dna/dna_payload/MANIFEST.txt
 tuner_testkit/apps/dna/dna_payload/docs/spec/action-words-syntax.md
+tuner_testkit/apps/dna/dna_payload/docs/spec/agent-task-log.md
 tuner_testkit/apps/dna/dna_payload/docs/spec/api-objects-syntax.md
 tuner_testkit/apps/dna/dna_payload/docs/spec/apps-authoring-syntax.md
 tuner_testkit/apps/dna/dna_payload/docs/spec/assets-knowledge-syntax.md
@@ -106,6 +107,7 @@ tuner_testkit/apps/init_repo/scaffold.py
 tuner_testkit/apps/init_repo/stubs/behave.ini
 tuner_testkit/apps/init_repo/stubs/apps/__init__.py
 tuner_testkit/apps/init_repo/stubs/config/env.py
+tuner_testkit/apps/init_repo/stubs/data/sut-accounts.example.yaml
 tuner_testkit/apps/init_repo/stubs/packages/__init__.py
 tuner_testkit/apps/init_repo/stubs/packages/action_words/__init__.py
 tuner_testkit/apps/init_repo/stubs/packages/action_words/models.py