@tea-agent/loop-agent 0.7.3 → 0.7.4

package/CHANGELOG.md

@@ -4,6 +4,17 @@
 
 ## [Unreleased]
 
+### 新增
+
+- 新增 repository-owned Worker nightly wrapper 与 GitHub Actions 手动/定时适配面：按 feature 互斥、保留超时/批次退出码，并收集 controller、morning report、Observe snapshot 等 artifacts。
+- 新增 `agent-worker task validate-feature` 和可初始化投影的语言无关产品线模板，校验 AC 唯一性、任务依赖、TaskSpec 路径/验证命令及 QA verdict → success closeout 顺序，并接入仓库治理门禁。
+
+## [0.7.4] - 2026-07-11
+
+### 修复
+
+- Worker materialize 现在把 TaskSpec 中所有 required `verify.commands` 写入 task config，并强制合并到 DAG 最终 shell verification；review 不再只能看到仓库级治理命令而缺少任务契约要求的 typecheck/focused tests。
+
 ## [0.7.3] - 2026-07-11
 
 ### 修复

package/README.md

@@ -88,6 +88,15 @@ loop-agent pi-prompt --cwd . --tools read,grep,find,ls "只读评审这个任务
 loop-agent pi-prompt --cwd . --tools read,bash,edit,write,grep,find,ls "<包含 allowedPaths 和 forbiddenPaths 的有边界任务说明>"
 ```
 
+产品线 feature packet 可用伴生 Worker CLI 做 docs CI；仓库也提供外部 CI/cron wrapper，调度仍由外部系统负责：
+
+```bash
+agent-worker task validate-feature <feature-dir>
+bash scripts/worker-nightly.sh <feature-dir> <target-repo> <batch-run-id>
+```
+
+nightly wrapper 按 feature 互斥，保留批次/超时退出码，并输出 morning report、Observe snapshot 和 controller 版本 artifacts。
+
 ## 核心概念
 
 - **Agent DAG**：把一次任务拆成 contract、scout、plan、implement、verify、closeout 等可审查节点。

package/dist/commands/init.js

@@ -418,6 +418,7 @@ checks=(
   "scripts/check-harness-runtime-clean.sh"
   "scripts/check-architecture-boundaries.sh"
   "scripts/check-skill-entry.sh"
+  "scripts/check-product-line-docs.sh"
 )
 
 for check in "\${checks[@]}"; do
@@ -428,6 +429,32 @@ done
 
 echo "仓库治理检查全部通过"
 `;
+const INIT_CHECK_PRODUCT_LINE_DOCS_SH = `#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")/.." && pwd)"
+cd "\${ROOT_DIR}"
+
+if ! command -v agent-worker >/dev/null 2>&1; then
+  echo "product-line docs check skipped: agent-worker is not installed"
+  exit 0
+fi
+
+feature_dirs=()
+for root in features product/features dogfood/features; do
+  [[ -d "\${root}" ]] || continue
+  while IFS= read -r acceptance; do
+    feature_dirs+=("$(dirname "\${acceptance}")")
+  done < <(find "\${root}" -mindepth 2 -maxdepth 2 -name acceptance.yaml -type f | sort)
+done
+
+for feature_dir in "\${feature_dirs[@]}"; do
+  echo "==> validate product-line feature: \${feature_dir}"
+  agent-worker task validate-feature "\${feature_dir}"
+done
+
+echo "product-line docs checks passed: \${#feature_dirs[@]} feature packet(s)"
+`;
 const INIT_CI_GOVERNANCE_SH = `#!/usr/bin/env bash
 set -euo pipefail
 
@@ -570,6 +597,7 @@ const INIT_SCRIPT_FILES = {
     "scripts/check-harness-runtime-clean.sh": INIT_CHECK_HARNESS_RUNTIME_CLEAN_SH,
     "scripts/check-architecture-boundaries.sh": INIT_CHECK_ARCHITECTURE_BOUNDARIES_SH,
     "scripts/check-skill-entry.sh": INIT_CHECK_SKILL_ENTRY_SH,
+    "scripts/check-product-line-docs.sh": INIT_CHECK_PRODUCT_LINE_DOCS_SH,
     "scripts/check-repo.sh": INIT_CHECK_REPO_SH,
     "scripts/ci-governance.sh": INIT_CI_GOVERNANCE_SH,
     "scripts/ci-tests.sh": INIT_CI_TESTS_SH,

package/dist/task/config-types.js

@@ -25,6 +25,11 @@ export const piSubagentModeSchema = z.enum(["off", "analyze-plan", "full"]);
 export const verifyModeSchema = z.enum(["parallel", "serial"]);
 export const verifyPresetSchema = z.enum(["auto", "quick", "standard", "full"]);
 export const verifyQuotaSchema = z.enum(["1", "3", "full"]);
+export const taskVerifyCommandSchema = z.object({
+    label: z.string().min(1),
+    command: z.string().min(1),
+    timeoutMs: z.number().int().positive().optional(),
+});
 export const dagVerifyStrategySchema = z
     .object({
     intermediateQuota: verifyQuotaSchema.optional(),
@@ -73,6 +78,8 @@ export const taskConfigSchema = z.object({
     capabilities: z.array(taskCapabilitySchema).optional(),
     verifyMode: verifyModeSchema.optional().default("parallel"),
     verifyPreset: verifyPresetSchema.optional().default("auto"),
+    /** Task-contract commands that must be included in final DAG shell verification. */
+    verifyCommands: z.array(taskVerifyCommandSchema).optional().default([]),
     /** Verification selection policy. Intermediate loops may use quota; final gates still run full required verification. */
     verifyQuota: verifyQuotaSchema.optional().default("full"),
     /** DAG supervised verify strategy. Final quota is fixed to full; intermediate quota may reduce cost. */

package/dist/task/runtime.js

@@ -104,6 +104,7 @@ export async function createTask(repoRoot, taskId, title) {
         contextProfile: 'full',
         verifyMode: 'parallel',
         verifyPreset: 'auto',
+        verifyCommands: [],
         verifyQuota: 'full',
         verifyRetryCount: 0,
         verifyFailFast: false,

package/dist/worker/cli.js

@@ -16,6 +16,7 @@ import { createObserveServer } from "./observe/server.js";
 import { prepareTaskPoolRetry } from "./pool/run-store.js";
 import { taskSpecSchema } from "./task-spec/schema.js";
 import { validateTaskSpec } from "./task-spec/validate.js";
+import { validateFeatureTaskGraph } from "./task-graph/validate.js";
 export function buildAgentWorkerProgram() {
     const program = new Command();
     program
@@ -49,6 +50,16 @@ export function buildAgentWorkerProgram() {
         const result = resolveLoopAgentProfile(parsed);
         process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
     });
+    task
+        .command("validate-feature")
+        .argument("<feature-dir>", "Feature directory containing acceptance.yaml and tasks/")
+        .description("Validate acceptance ids, task graph, TaskSpecs, paths, and verification commands")
+        .action(async (featureDir) => {
+        const result = await validateFeatureTaskGraph(path.resolve(featureDir));
+        process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+        if (!result.ok)
+            process.exitCode = 1;
+    });
     task
         .command("retry")
         .argument("<task-id>", "Failed Task Pool task to requeue")

package/dist/worker/materialize/harness-task-materializer.js

@@ -44,6 +44,13 @@ export async function materializeTaskSpec(options) {
         verifyMode: options.taskSpec.verify.mode,
         verifyPreset: options.taskSpec.verify.preset,
         verifyQuota: options.taskSpec.verify.quota,
+        verifyCommands: options.taskSpec.verify.commands
+            .filter((command) => command.required)
+            .map((command) => ({
+            label: command.label,
+            command: command.command,
+            timeoutMs: command.timeout_ms,
+        })),
         autoCommitAfterVerify: false,
     };
     await writeTaskConfig(options.repoRoot, harnessTaskId, taskConfig);

package/dist/worker/task-graph/validate.js

@@ -2,6 +2,7 @@ import { access, readFile } from "node:fs/promises";
 import path from "node:path";
 import YAML from "yaml";
 import { taskSpecSchema } from "../task-spec/schema.js";
+import { validateTaskSpec } from "../task-spec/validate.js";
 import { acceptanceSpecSchema } from "./acceptance-schema.js";
 import { computeReadyQueue } from "./ready-queue.js";
 import { taskGraphSpecSchema } from "./task-graph-schema.js";
@@ -13,12 +14,57 @@ export async function validateFeatureTaskGraph(featureDir, options = {}) {
         return result("", acceptance, graph, errors);
     }
     checkDuplicateNodeIds(graph, errors);
+    checkDuplicateAcceptanceIds(acceptance, errors);
     checkAcceptanceTaskRefs(acceptance, graph, errors);
     checkUnknownDependencies(graph, errors);
     checkCycles(graph, errors);
-    await checkTaskFiles(featureDir, graph, errors);
+    await checkTaskFiles(featureDir, graph, acceptance, errors);
+    await checkQaCloseoutOrder(featureDir, options, errors);
     return result(graph.feature_id, acceptance, graph, errors);
 }
+async function checkQaCloseoutOrder(featureDir, options, errors) {
+    const closeoutPath = path.join(featureDir, "closeout.yaml");
+    let raw = options.closeoutOverride;
+    if (raw === undefined) {
+        if (!(await exists(closeoutPath)))
+            return;
+        raw = YAML.parse(await readFile(closeoutPath, "utf-8"));
+    }
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+        errors.push({ code: "closeout-schema-invalid", message: "closeout.yaml must be an object", path: "closeout.yaml" });
+        return;
+    }
+    const record = raw;
+    if (record.status !== "success")
+        return;
+    if (record.qa_verdict !== "pass") {
+        errors.push({
+            code: "qa-verdict-required-before-closeout",
+            message: "success closeout requires qa_verdict: pass",
+            path: "closeout.yaml:qa_verdict",
+        });
+    }
+    if (!Array.isArray(record.qa_evidence) || record.qa_evidence.length === 0) {
+        errors.push({
+            code: "qa-evidence-required-before-closeout",
+            message: "success closeout requires non-empty qa_evidence",
+            path: "closeout.yaml:qa_evidence",
+        });
+    }
+}
+function checkDuplicateAcceptanceIds(acceptance, errors) {
+    const seen = new Set();
+    for (const item of acceptance.acceptance) {
+        if (seen.has(item.id)) {
+            errors.push({
+                code: "duplicate-acceptance-id",
+                message: `duplicate acceptance id: ${item.id}`,
+                path: `acceptance.${item.id}`,
+            });
+        }
+        seen.add(item.id);
+    }
+}
 async function loadAcceptanceSpec(featureDir, options, errors) {
     const raw = options.acceptanceOverride ??
         YAML.parse(await readFile(path.join(featureDir, "acceptance.yaml"), "utf-8"));
@@ -115,7 +161,8 @@ function checkCycles(graph, errors) {
     for (const node of graph.nodes)
         visit(node.id, []);
 }
-async function checkTaskFiles(featureDir, graph, errors) {
+async function checkTaskFiles(featureDir, graph, acceptance, errors) {
+    const acceptanceIds = new Set(acceptance.acceptance.map((item) => item.id));
     for (const node of graph.nodes) {
         const taskPath = path.join(featureDir, "tasks", node.task);
         if (!(await exists(taskPath))) {
@@ -126,7 +173,8 @@ async function checkTaskFiles(featureDir, graph, errors) {
             });
             continue;
         }
-        const parsedTask = taskSpecSchema.safeParse(YAML.parse(await readFile(taskPath, "utf-8")));
+        const rawTask = YAML.parse(await readFile(taskPath, "utf-8"));
+        const parsedTask = taskSpecSchema.safeParse(rawTask);
         if (!parsedTask.success) {
             errors.push({
                 code: "task-spec-schema-invalid",
@@ -136,6 +184,23 @@ async function checkTaskFiles(featureDir, graph, errors) {
             continue;
         }
         const taskSpec = parsedTask.data;
+        const detailed = await validateTaskSpec(rawTask, { taskSpecPath: taskPath });
+        for (const issue of detailed.errors) {
+            errors.push({
+                code: `task-${issue.code}`,
+                message: `${node.id}: ${issue.message}`,
+                path: `${node.task}:${issue.path ?? ""}`,
+            });
+        }
+        for (const acceptanceRef of taskSpec.acceptance_refs) {
+            if (!acceptanceIds.has(acceptanceRef)) {
+                errors.push({
+                    code: "task-acceptance-ref-missing",
+                    message: `${node.id} references missing acceptance ${acceptanceRef}`,
+                    path: `${node.task}:acceptance_refs`,
+                });
+            }
+        }
         if (taskSpec.id !== node.id) {
             errors.push({
                 code: "task-id-mismatch",

package/dist/workflows/dag/init-hybrid.js

@@ -426,12 +426,12 @@ export async function loadTaskHybridSources(repoRoot, taskId) {
                 phase: "intermediate",
                 taskConfig,
             }),
-            final: adapter.getVerifyCommands(repoRoot, {
+            final: mergeFinalVerifyCommands(repoRoot, taskConfig, adapter.getVerifyCommands(repoRoot, {
                 preset,
                 quota: "full",
                 phase: "final",
                 taskConfig,
-            }),
+            })),
         };
         if (verifyCommands.final.length === 0) {
             throw new Error("adapter returned no final verification commands");
@@ -455,6 +455,22 @@ export async function loadTaskHybridSources(repoRoot, taskId) {
         verifyCommands,
     };
 }
+function mergeFinalVerifyCommands(repoRoot, taskConfig, adapterCommands) {
+    const taskCommands = taskConfig.verifyCommands.map((command) => ({
+        args: ["bash", "-lc", command.command],
+        cwd: repoRoot,
+        label: command.label,
+        timeoutMs: command.timeoutMs,
+    }));
+    const seen = new Set();
+    return [...taskCommands, ...adapterCommands].filter((command) => {
+        const key = `${command.cwd}\0${command.args.join("\0")}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
 export function buildStandardHybridDagFromTask(sources) {
     const { taskConfig } = sources;
     const forbiddenPaths = mergeForbiddenPaths(taskConfig);

package/docs/README.md

@@ -54,6 +54,7 @@
 - `templates/worker-dogfood-setup.md` — 发布控制器下的真实 Worker sample setup 与 retry 纪律
 - `templates/worker-dogfood-evidence.md` — BE/FE/QA sample、Observe、morning report 与 coverage evidence 模板
 - `templates/interactive-ui-round2-experiment.md` — interactive UI prompt/model A/B/C 对照实验与统一指标模板
+- `templates/product-line/` — 可投影的 Feature/Task/QA/Links 产品线包；配合 `agent-worker task validate-feature` 做 docs CI
 - `templates/production-readiness-checklist.md` — 低/中风险单仓库 DAG readiness 检查清单
 - `templates/init-evolution-review.md` — 初始化能力演化审查报告模板
 - `templates/adr.md` — 架构决策记录（ADR）

package/docs/init-surface.manifest.json

@@ -17,6 +17,17 @@
     "docs/templates/worker-dogfood-setup.md",
     "docs/templates/worker-dogfood-evidence.md",
     "docs/templates/interactive-ui-round2-experiment.md",
+    "docs/templates/product-line/README.md",
+    "docs/templates/product-line/AGENTS.md",
+    "docs/templates/product-line/requirement.md",
+    "docs/templates/product-line/acceptance.yaml",
+    "docs/templates/product-line/design.md",
+    "docs/templates/product-line/test-plan.md",
+    "docs/templates/product-line/task-graph.yaml",
+    "docs/templates/product-line/task.yaml",
+    "docs/templates/product-line/closeout.yaml",
+    "docs/templates/product-line/links.md",
+    "scripts/check-product-line-docs.sh",
     "docs/templates/agent-dag.schema.json",
     "examples/example-dag.json",
     "skills/loop-agent/SKILL.md",
@@ -46,6 +57,17 @@
     "docs/templates/worker-dogfood-setup.md",
     "docs/templates/worker-dogfood-evidence.md",
     "docs/templates/interactive-ui-round2-experiment.md",
+    "docs/templates/product-line/README.md",
+    "docs/templates/product-line/AGENTS.md",
+    "docs/templates/product-line/requirement.md",
+    "docs/templates/product-line/acceptance.yaml",
+    "docs/templates/product-line/design.md",
+    "docs/templates/product-line/test-plan.md",
+    "docs/templates/product-line/task-graph.yaml",
+    "docs/templates/product-line/task.yaml",
+    "docs/templates/product-line/closeout.yaml",
+    "docs/templates/product-line/links.md",
+    "scripts/check-product-line-docs.sh",
     "scripts/check-repo.sh",
     "scripts/ci-governance.sh",
     "scripts/ci-tests.sh",
@@ -91,6 +113,17 @@
     "docs/templates/worker-dogfood-setup.md": "copied",
     "docs/templates/worker-dogfood-evidence.md": "copied",
     "docs/templates/interactive-ui-round2-experiment.md": "copied",
+    "docs/templates/product-line/README.md": "copied",
+    "docs/templates/product-line/AGENTS.md": "copied",
+    "docs/templates/product-line/requirement.md": "copied",
+    "docs/templates/product-line/acceptance.yaml": "copied",
+    "docs/templates/product-line/design.md": "copied",
+    "docs/templates/product-line/test-plan.md": "copied",
+    "docs/templates/product-line/task-graph.yaml": "copied",
+    "docs/templates/product-line/task.yaml": "copied",
+    "docs/templates/product-line/closeout.yaml": "copied",
+    "docs/templates/product-line/links.md": "copied",
+    "scripts/check-product-line-docs.sh": "copied",
     "scripts/check-repo.sh": "generated",
     "scripts/ci-governance.sh": "generated",
     "scripts/ci-tests.sh": "generated",

package/docs/templates/product-line/AGENTS.md

@@ -0,0 +1,8 @@
+# Product-line execution rules
+
+- Read requirement, acceptance, design, test plan, task graph, and the selected TaskSpec before writing.
+- Treat `constraints.allowed_paths` and `constraints.forbidden_paths` as machine-enforced write boundaries; review DAG writer `writeSet` before execution.
+- Advance only tasks whose dependencies are complete. Preserve failed run records; retries receive new worker run IDs.
+- A Ready task must have acceptance references, non-empty allowed/forbidden paths, and deterministic verification commands.
+- QA records an independent verdict and evidence. Do not write `status: success` closeout until `qa_verdict: pass` and non-empty `qa_evidence` exist.
+- Human gates remain human decisions. Record owner, time, reason, evidence, and follow-up without rewriting failed history.

package/docs/templates/product-line/README.md

@@ -0,0 +1,9 @@
+# Product-line feature packet
+
+Copy this directory for each product feature. Replace angle-bracket placeholders, keep IDs stable, and run:
+
+```bash
+agent-worker task validate-feature <feature-dir>
+```
+
+The validator checks acceptance ID uniqueness, task references and dependencies, cycles, TaskSpec/path/verification completeness, and QA evidence before a successful closeout.

package/docs/templates/product-line/acceptance.yaml

@@ -0,0 +1,14 @@
+schema_version: 1
+feature_id: F-YYYY-NNN
+acceptance:
+  - id: AC-FEATURE-001
+    title: Observable outcome is delivered
+    priority: must
+    type: behavior
+    given: the documented precondition
+    when: the user or system performs the action
+    then: the observable result occurs
+    verification:
+      expected_task_refs:
+        - BE-001
+        - QA-001

package/docs/templates/product-line/closeout.yaml

@@ -0,0 +1,9 @@
+schema_version: 1
+feature_id: F-YYYY-NNN
+status: success
+qa_verdict: pass
+qa_evidence:
+  - <run-or-report-path>
+owner: <human owner>
+decided_at: <ISO-8601 timestamp>
+summary: <what shipped and why evidence is sufficient>

package/docs/templates/product-line/design.md

@@ -0,0 +1,13 @@
+# Design — <Feature title>
+
+## Context and boundaries
+
+Describe existing components, public contracts, trust boundaries, and protected areas.
+
+## Proposed change
+
+Describe the smallest end-to-end path and its failure behavior.
+
+## Decisions and alternatives
+
+Record material trade-offs and link ADRs where needed.

package/docs/templates/product-line/links.md

@@ -0,0 +1,10 @@
+# Traceability links
+
+| Relationship | Link or ID |
+|---|---|
+| Feature | `F-YYYY-NNN` |
+| Acceptance → tests | `AC-FEATURE-001` → `TC-001` |
+| Acceptance → tasks | `AC-FEATURE-001` → `BE-001`, `QA-001` |
+| Task → worker/DAG run | `<workerRunId>` / `<dagRunId>` |
+| Change/MR/PR | `<link>` |
+| QA evidence | `<artifact path or link>` |

package/docs/templates/product-line/requirement.md

@@ -0,0 +1,17 @@
+# <Feature title>
+
+- Feature ID: `<F-YYYY-NNN>`
+- Owner: `<human owner>`
+- Outcome: `<user or business outcome>`
+
+## In scope
+
+- `<observable capability>`
+
+## Out of scope
+
+- `<explicit non-goal>`
+
+## Constraints
+
+- `<security, compatibility, cost, or operational boundary>`

package/docs/templates/product-line/task-graph.yaml

@@ -0,0 +1,15 @@
+schema_version: 1
+feature_id: F-YYYY-NNN
+nodes:
+  - id: BE-001
+    task: BE-001.yaml
+    type: backend-feature
+    depends_on: []
+  - id: QA-001
+    task: QA-001.yaml
+    type: qa-execute
+    depends_on:
+      - BE-001
+parallel_policy:
+  max_parallel_tasks: 2
+  disallow_same_file_parallel_writes: true

package/docs/templates/product-line/task.yaml

@@ -0,0 +1,65 @@
+schema_version: 1
+id: BE-001
+feature_id: F-YYYY-NNN
+title: <Bounded tracer-bullet task>
+description: <Observable delivery>
+repo:
+  name: <repository-name>
+  path_ref: <repository-path-reference>
+  default_branch: main
+type: backend-feature
+priority: P1
+risk_level: medium
+depends_on: []
+source_docs:
+  requirement: ../requirement.md
+  acceptance: ../acceptance.yaml
+  design: ../design.md
+  test_plan: ../test-plan.md
+acceptance_refs:
+  - AC-FEATURE-001
+scope:
+  goals:
+    - <goal>
+  non_goals:
+    - <non-goal>
+constraints:
+  allowed_paths:
+    - <owned/path/**>
+  forbidden_paths:
+    - <protected/path/**>
+  hard_constraints:
+    - Do not access production secrets
+verify:
+  preset: standard
+  mode: serial
+  commands:
+    - id: focused-test
+      label: Focused deterministic verification
+      command: <project-specific verification command>
+      required: true
+      timeout_ms: 300000
+worker:
+  execution_mode: generate-validate-run
+  max_attempts: 1
+  timeout_ms: 7200000
+  require_clean_worktree: true
+  require_human_review: true
+  create_worktree: false
+loop_agent:
+  profile_policy: mapped
+  strict_models: true
+  strict_governance: true
+  no_cursor: false
+  max_concurrent: 1
+outputs:
+  required:
+    - dag_json
+    - run_record
+    - shell_verification
+    - diff_patch
+    - closeout_or_failure_handoff
+failure_policy:
+  failed_run_promote: false
+  generate_closeout_draft: true
+  create_followup_task: true

package/docs/templates/product-line/test-plan.md

@@ -0,0 +1,7 @@
+# Test plan — <Feature title>
+
+| Test ID | Acceptance | Level | Scenario | Deterministic command |
+|---|---|---|---|---|
+| TC-001 | AC-FEATURE-001 | integration | happy path and primary failure | `<project-specific command>` |
+
+Include negative cases, regression scope, environment assumptions, and evidence locations. Commands must match the target project's real toolchain.

package/docs/verification-matrix.md

@@ -26,6 +26,14 @@ npm run dev -- --help
 npm pack --dry-run
 ```
 
+产品线 Feature/Task/QA 文档或 TaskSpec 约束变更还应运行：
+
+```bash
+bash scripts/check-product-line-docs.sh
+```
+
+该检查对仓库中的 feature packet 执行 `agent-worker task validate-feature`，覆盖 AC 唯一性、依赖/环、TaskSpec 路径与验证命令、QA verdict 与 success closeout 顺序。
+
 Windows 上通过 Git Bash 或已配置的兼容 Bash 运行 `scripts/*.sh`。跨平台 CLI 代码对真实文件操作用原生路径；`/` 仅用于稳定 repo 引用、JSON/Markdown 证据引用和 glob 约定。
 
 没有相关门禁的新鲜命令输出，不得声明完成。

package/harness.json

@@ -50,6 +50,7 @@
     "checkHarnessRuntimeClean": "scripts/check-harness-runtime-clean.sh",
     "checkInitEvolutionNeeded": "scripts/check-init-evolution-needed.sh",
     "checkInitSurface": "scripts/check-init-surface.sh",
+    "checkProductLineDocs": "scripts/check-product-line-docs.sh",
     "ci": "scripts/ci.sh"
   },
   "executors": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tea-agent/loop-agent",
-  "version": "0.7.3",
+  "version": "0.7.4",
   "type": "module",
   "bin": {
     "loop-agent": "bin/loop-agent.js",
@@ -25,6 +25,7 @@
     "examples/",
     "harness.json",
     "skills/",
+    "scripts/check-product-line-docs.sh",
     "README.md",
     "CHANGELOG.md"
   ],

package/scripts/check-product-line-docs.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "${ROOT_DIR}"
+
+feature_dirs=()
+while IFS= read -r acceptance; do
+  feature_dirs+=("$(dirname "$acceptance")")
+done < <(find dogfood/features -mindepth 2 -maxdepth 2 -name acceptance.yaml -type f | sort)
+
+if [[ ${#feature_dirs[@]} -eq 0 ]]; then
+  echo "product-line docs check skipped: no feature packets found"
+  exit 0
+fi
+
+for feature_dir in "${feature_dirs[@]}"; do
+  echo "==> validate product-line feature: ${feature_dir}"
+  node --import tsx/esm src/worker/cli.ts task validate-feature "${feature_dir}"
+done
+
+echo "product-line docs checks passed: ${#feature_dirs[@]} feature packet(s)"