@tea-agent/loop-agent 0.39.0-next.31 → 0.39.0-next.32

package/dist/workflows/dag/frontend-test-layout.js

@@ -0,0 +1,159 @@
+import path from "node:path";
+/**
+ * Frontend-test artifact layout (configurable testRoot).
+ *
+ * Resolved once from `task.frontendTest.testRoot` at DAG compile time and
+ * frozen on the spec for the whole run. Writers, gates, Playwright fences
+ * and TaskSpec allowedPaths all derive from this single object.
+ *
+ * Default layout keeps the historical frozen contract:
+ *   testcase/frontend/rag/**
+ *   testcase/frontend/cases/**
+ *   testcase/frontend/evidence/**
+ *   testcase/frontend/reports/**
+ *   testcase/frontend/fixtures/**
+ */
+export const FRONTEND_TEST_DEFAULT_TEST_ROOT = "testcase/frontend";
+const FORBIDDEN_TEST_ROOT_PREFIXES = [
+    "src",
+    "app",
+    "lib",
+    "apps",
+    "packages",
+    ".harness",
+    ".git",
+    "node_modules",
+    "dist",
+    "build",
+    "docs",
+    "website",
+    "scripts",
+    "test",
+    "smoke",
+    "knowledge",
+    "features",
+    "dogfood",
+    "examples",
+    "bin",
+];
+function normalizeRelPosix(value, label) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        throw new Error(`frontendTest.${label} must not be empty`);
+    if (trimmed.includes("\\")) {
+        throw new Error(`frontendTest.${label} must use forward slashes: ${value}`);
+    }
+    if (path.isAbsolute(trimmed) || /^[A-Za-z]:/.test(trimmed)) {
+        throw new Error(`frontendTest.${label} must be a repository-relative path: ${value}`);
+    }
+    const segments = trimmed.split("/").filter((segment) => segment.length > 0);
+    if (segments.some((segment) => segment === ".." || segment === ".")) {
+        throw new Error(`frontendTest.${label} must not contain "." or ".." segments: ${value}`);
+    }
+    if (segments.some((segment) => segment.startsWith("."))) {
+        throw new Error(`frontendTest.${label} must not target hidden directories: ${value}`);
+    }
+    if (segments.some((segment) => !/^[A-Za-z0-9][A-Za-z0-9_.-]*$/.test(segment))) {
+        throw new Error(`frontendTest.${label} contains unsafe path segments: ${value}`);
+    }
+    return segments.join("/");
+}
+function assertTestRootAllowed(testRoot) {
+    const topSegment = testRoot.split("/")[0];
+    if (FORBIDDEN_TEST_ROOT_PREFIXES.some((forbidden) => topSegment === forbidden || topSegment.startsWith(`${forbidden}.`))) {
+        throw new Error(`frontendTest.testRoot must not target production/governance trees: ${testRoot}`);
+    }
+    if (topSegment.startsWith(".")) {
+        throw new Error(`frontendTest.testRoot must not target hidden directories: ${testRoot}`);
+    }
+}
+/**
+ * Resolve the frozen frontend-test artifact layout from task config.
+ * Throws on unsafe or ambiguous configuration (fail-closed).
+ */
+export function resolveFrontendTestLayout(config) {
+    const testRoot = config?.testRoot === undefined || config?.testRoot === null
+        ? FRONTEND_TEST_DEFAULT_TEST_ROOT
+        : normalizeRelPosix(config.testRoot, "testRoot");
+    assertTestRootAllowed(testRoot);
+    const isDefault = testRoot === FRONTEND_TEST_DEFAULT_TEST_ROOT;
+    return {
+        testRoot,
+        ragDir: `${testRoot}/rag`,
+        casesDir: `${testRoot}/cases`,
+        evidenceDir: `${testRoot}/evidence`,
+        reportsDir: `${testRoot}/reports`,
+        fixturesDir: `${testRoot}/fixtures`,
+        isDefault,
+    };
+}
+/** Historical default layout. Old DAGs without frontendTestLayout use this. */
+export function defaultFrontendTestLayout() {
+    return resolveFrontendTestLayout(undefined);
+}
+export function frontendTestLayoutFromSpec(spec) {
+    const frozen = spec?.frontendTestLayout;
+    if (!frozen)
+        return defaultFrontendTestLayout();
+    return resolveFrontendTestLayout({ testRoot: frozen.testRoot });
+}
+const DEFAULT_PREFIX = `${FRONTEND_TEST_DEFAULT_TEST_ROOT}/`;
+/**
+ * Longest-prefix rewrite of historical `testcase/frontend/` paths.
+ * No-op when layout.isDefault so default DAGs stay byte-identical.
+ * Never replaces the short token `testcase/` (would collide with backend-test).
+ */
+export function applyFrontendTestLayoutToText(text, layout) {
+    if (layout.isDefault)
+        return text;
+    const replacement = `${layout.testRoot}/`;
+    let output = "";
+    for (let i = 0; i < text.length;) {
+        if (text.startsWith(replacement, i)) {
+            output += replacement;
+            i += replacement.length;
+            continue;
+        }
+        if (text.startsWith(DEFAULT_PREFIX, i)) {
+            output += replacement;
+            i += DEFAULT_PREFIX.length;
+            continue;
+        }
+        output += text[i];
+        i += 1;
+    }
+    return output;
+}
+export function frontendTestCasePath(layout, caseId) {
+    return `${layout.casesDir}/${caseId}.md`;
+}
+export function frontendTestEvidenceDir(layout, caseId) {
+    return `${layout.evidenceDir}/${caseId}/`;
+}
+export function frontendTestEvidencePrefix(layout, caseId) {
+    return `${layout.evidenceDir}/${caseId}`;
+}
+export function frontendTestManifestPath(layout) {
+    return `${layout.casesDir}/manifest.json`;
+}
+export function frontendTestManifestDraftPath(layout) {
+    return `${layout.casesDir}/manifest.draft.json`;
+}
+export function frontendTestContextRel(layout) {
+    return `${layout.ragDir}/context.md`;
+}
+export function frontendTestCoverageMapRel(layout) {
+    return `${layout.ragDir}/coverage-map.md`;
+}
+export function frontendTestProbeRel(layout) {
+    return `${layout.ragDir}/environment-probe.json`;
+}
+export function frontendTestStandardScenariosRel(layout) {
+    return `${layout.ragDir}/standard-scenarios.v1.json`;
+}
+export function frontendTestUiAnchorsRel(layout) {
+    return `${layout.ragDir}/ui-anchors.md`;
+}
+export function escapeRegexLiteral(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}

package/dist/workflows/dag/frontend-test-result-contract.js

@@ -6,6 +6,7 @@ import { writeDagRunJsonArtifact } from "../../infrastructure/harness/artifact-s
 import { readPlaywrightCliReceipts, summarizePlaywrightCliReceipts, } from "../../executors/pi-playwright-cli-tool.js";
 import { validateFrontendCaseContent } from "./frontend-test-case-quality.js";
 import { markdownH1Title, markdownList, markdownSection, } from "./frontend-test-markdown.js";
+import { defaultFrontendTestLayout, frontendTestEvidencePrefix, frontendTestManifestPath, } from "./frontend-test-layout.js";
 export const FRONTEND_TEST_RESULT_SCHEMA_ID = "frontend-test-result-v1";
 /**
  * Truncated acceptance-id shapes observed in generator output: a bare
@@ -124,12 +125,14 @@ function isSafeEvidenceShellPath(value) {
  * backslash interpretation for the former long `node -e` command.
  */
 export async function validateFrontendCaseEvidence(input) {
-    const manifestPath = path.join(input.workspaceRoot, "testcase/frontend/cases/manifest.json");
+    const layout = input.layout ?? defaultFrontendTestLayout();
+    const manifestRel = frontendTestManifestPath(layout);
+    const manifestPath = path.join(input.workspaceRoot, manifestRel);
     try {
         await stat(manifestPath);
     }
     catch {
-        throw new Error("missing testcase/frontend/cases/manifest.json");
+        throw new Error(`missing ${manifestRel}`);
     }
     let manifest;
     try {
@@ -147,7 +150,7 @@ export async function validateFrontendCaseEvidence(input) {
         const item = rawCase;
         const id = typeof item?.caseId === "string" ? item.caseId : "?";
         const dir = item?.evidenceDir;
-        const prefix = `testcase/frontend/evidence/${id}`;
+        const prefix = frontendTestEvidencePrefix(layout, id);
         if (!item ||
             typeof item.caseId !== "string" ||
             typeof dir !== "string" ||
@@ -191,12 +194,15 @@ export async function validateFrontendCaseEvidence(input) {
                     continue;
                 }
                 const currentPrefix = `${prefix}/`;
-                if (evidencePath.startsWith("testcase/frontend/evidence/") && !evidencePath.startsWith(currentPrefix)) {
+                if ((evidencePath.startsWith(`${layout.evidenceDir}/`) ||
+                    evidencePath.startsWith("testcase/frontend/evidence/")) &&
+                    !evidencePath.startsWith(currentPrefix)) {
                     hardFail = true;
                     issues.push({ ruleId: "cross-case-evidence-path", caseId: id, detail: evidencePath });
                     continue;
                 }
-                const target = evidencePath.startsWith("testcase/")
+                const target = evidencePath.startsWith(`${layout.testRoot}/`) ||
+                    evidencePath.startsWith("testcase/")
                     ? path.join(input.workspaceRoot, evidencePath)
                     : path.join(input.workspaceRoot, dir, evidencePath);
                 if (!(await isNonEmptyFile(target))) {
@@ -343,8 +349,10 @@ function sha256(content) {
  * headings. Numbered and bulleted lists are extracted; a missing 测试目的
  * falls back to the case H1 title.
  */
-async function readFrontendCaseContent(workspaceRoot, casePath) {
-    if (!safeRelativePathSchema.safeParse(casePath).success || !casePath.startsWith("testcase/frontend/cases/")) {
+async function readFrontendCaseContent(workspaceRoot, casePath, layout) {
+    if (!safeRelativePathSchema.safeParse(casePath).success ||
+        !(casePath.startsWith(`${layout.casesDir}/`) ||
+            casePath.startsWith("testcase/frontend/cases/"))) {
         throw new Error(`unsafe frontend case path: ${casePath}`);
     }
     const body = await readFile(path.resolve(workspaceRoot, casePath), "utf8");
@@ -397,7 +405,7 @@ function assertInside(root, candidate, label) {
         throw new Error(`${label} escapes its allowed root`);
     }
 }
-async function readEvidenceFile(repoRoot, evidenceRoot, relative) {
+async function readEvidenceFile(repoRoot, evidenceRoot, relative, layout) {
     if (!safeRelativePathSchema.safeParse(relative).success) {
         throw new Error(`unsafe evidence path: ${relative}`);
     }
@@ -409,12 +417,16 @@ async function readEvidenceFile(repoRoot, evidenceRoot, relative) {
     const normalized = relative;
     const evidenceRootRel = path.relative(repoRootResolved, evidenceRootResolved).replaceAll("\\", "/");
     const isCurrentCaseRepoPath = normalized === evidenceRootRel || normalized.startsWith(`${evidenceRootRel}/`);
-    const isRepoRelative = normalized.startsWith("testcase/") && !isCurrentCaseRepoPath;
+    const isRepoRelative = (normalized.startsWith(`${layout.testRoot}/`) ||
+        normalized.startsWith("testcase/")) &&
+        !isCurrentCaseRepoPath;
     const absolute = isRepoRelative
         ? path.resolve(repoRootResolved, normalized)
         : path.resolve(evidenceRootResolved, normalized);
     assertInside(repoRootResolved, absolute, "evidence path");
-    if (isRepoRelative && normalized.startsWith("testcase/frontend/evidence/")) {
+    if (isRepoRelative &&
+        (normalized.startsWith(`${layout.evidenceDir}/`) ||
+            normalized.startsWith("testcase/frontend/evidence/"))) {
         throw new Error(`evidence path escapes evidence root: ${relative}`);
     }
     if (!isRepoRelative)
@@ -437,7 +449,8 @@ export async function materializeFrontendTestResult(input) {
     if (!sourceBinding?.taskId || !sourceBinding.sources?.length) {
         throw new Error("frontend-test result requires frozen sourceBinding");
     }
-    const manifestPath = "testcase/frontend/cases/manifest.json";
+    const layout = input.layout ?? defaultFrontendTestLayout();
+    const manifestPath = frontendTestManifestPath(layout);
     const manifestAbsolute = path.resolve(input.workspaceRoot, manifestPath);
     let manifest;
     try {
@@ -453,6 +466,7 @@ export async function materializeFrontendTestResult(input) {
     const contentQuality = await validateFrontendCaseContent({
         workspaceRoot: input.workspaceRoot,
         requiredAcIds: sourceBinding.requirementIds ?? [],
+        layout,
     });
     advisoryFindings.push(...contentQuality.findings);
     const requiredIds = new Set(sourceBinding.requirementIds ?? []);
@@ -464,7 +478,7 @@ export async function materializeFrontendTestResult(input) {
             advisoryFindings.push({ ruleId: "invalid-manifest-case", detail: "manifest case is missing caseId, acIds, or evidenceDir" });
             continue;
         }
-        const evidencePrefix = `testcase/frontend/evidence/${item.caseId}`;
+        const evidencePrefix = frontendTestEvidencePrefix(layout, item.caseId);
         if (!(item.evidenceDir === evidencePrefix || item.evidenceDir.startsWith(`${evidencePrefix}/`))) {
             throw new Error(`unsafe evidenceDir for ${item.caseId}`);
         }
@@ -495,7 +509,7 @@ export async function materializeFrontendTestResult(input) {
             if (typeof evidencePath !== "string" || evidencePath === "execution.md" && evidence.some((entry) => entry.path.endsWith("/execution.md")))
                 continue;
             try {
-                evidence.push(await readEvidenceFile(input.workspaceRoot, evidenceRoot, evidencePath));
+                evidence.push(await readEvidenceFile(input.workspaceRoot, evidenceRoot, evidencePath, layout));
             }
             catch (error) {
                 const message = error instanceof Error ? error.message : String(error);
@@ -541,7 +555,7 @@ export async function materializeFrontendTestResult(input) {
                 }
             }
         }
-        const { caseContent, testPoints } = await readFrontendCaseContent(input.workspaceRoot, item.casePath);
+        const { caseContent, testPoints } = await readFrontendCaseContent(input.workspaceRoot, item.casePath, layout);
         // Parse bounded fixed sections from execution.md. Missing optional
         // summary/steps are advisory only and never downgrade a passed status.
         let executionSummary = "";

package/dist/workflows/dag/frontend-test-standard-scenarios.js

@@ -1,5 +1,6 @@
 import { copyFile, mkdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
+import { defaultFrontendTestLayout, frontendTestStandardScenariosRel, } from "./frontend-test-layout.js";
 export const FRONTEND_TEST_STANDARD_SCENARIOS_FILENAME = "frontend-test-standard-scenarios.v1.json";
 export const FRONTEND_TEST_STANDARD_SCENARIOS_DEST = "testcase/frontend/rag/standard-scenarios.v1.json";
 const MINIMAL_STANDARD_SCENARIOS = {
@@ -47,7 +48,8 @@ async function readGovernanceRoot(workspaceRoot) {
     }
 }
 export async function copyFrontendTestStandardScenarios(input) {
-    const destRel = FRONTEND_TEST_STANDARD_SCENARIOS_DEST;
+    const layout = input.layout ?? defaultFrontendTestLayout();
+    const destRel = frontendTestStandardScenariosRel(layout);
     const destAbs = path.join(input.workspaceRoot, destRel);
     const candidates = listFrontendTestStandardScenarioCandidates({
         governanceRoot: await readGovernanceRoot(input.workspaceRoot),

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

@@ -28,6 +28,7 @@ import { resolveExecutorModelMatrices } from "../../executors/model-routing.js";
 import { normalizeTaskRequirementText, resolveTaskDagTemplateSelection, } from "./task-demand-routing.js";
 import { BACKEND_TEST_EXECUTION_DEFAULT_TEST_ROOT, buildBackendTestExecutionPreflightShellSnippet, } from "./backend-test-execution-contract.js";
 import { resolveBackendTestLayout, } from "./backend-test-layout.js";
+import { applyFrontendTestLayoutToText, resolveFrontendTestLayout, } from "./frontend-test-layout.js";
 import { buildBackendTestOutcomeGateShellSnippet } from "./backend-test-result-contract.js";
 import { buildBackendTestIntakeContext } from "./backend-test-intake-context.js";
 import { buildFrontendTestOutcomeGateShellSnippet } from "./frontend-test-result-contract.js";
@@ -4798,11 +4799,57 @@ function applyBackendTestLayoutToDagSpec(spec, layout) {
     spec.successCriteria = spec.successCriteria?.map(rewrite);
     spec.backendTestLayout = layout;
 }
+/** Rewrite layout-dependent strings across a compiled frontend-test DAG spec. */
+function applyFrontendTestLayoutToDagSpec(spec, layout) {
+    if (layout.isDefault) {
+        spec.frontendTestLayout = layout;
+        return;
+    }
+    const rewrite = (value) => applyFrontendTestLayoutToText(value, layout);
+    for (const task of spec.tasks) {
+        task.subtask_prompt = rewrite(task.subtask_prompt);
+        if (task.outputContract)
+            task.outputContract = rewrite(task.outputContract);
+        task.writeSet = task.writeSet?.map(rewrite);
+        task.allowedPaths = task.allowedPaths?.map(rewrite);
+        task.forbiddenPaths = task.forbiddenPaths?.map(rewrite);
+        if (task.dynamicExpansion?.childTask) {
+            const child = task.dynamicExpansion.childTask;
+            if (typeof child.subtaskPromptTemplate === "string") {
+                child.subtaskPromptTemplate = rewrite(child.subtaskPromptTemplate);
+            }
+            if (typeof child.outputContract === "string") {
+                child.outputContract = rewrite(child.outputContract);
+            }
+            if (Array.isArray(child.allowedPaths)) {
+                child.allowedPaths = child.allowedPaths.map((entry) => typeof entry === "string" ? rewrite(entry) : entry);
+            }
+            if (Array.isArray(child.writeSet)) {
+                child.writeSet = child.writeSet.map((entry) => typeof entry === "string" ? rewrite(entry) : entry);
+            }
+            if (Array.isArray(child.forbiddenPaths)) {
+                child.forbiddenPaths = child.forbiddenPaths.map((entry) => typeof entry === "string" ? rewrite(entry) : entry);
+            }
+        }
+        if (task.shell?.commands) {
+            task.shell.commands = task.shell.commands.map(rewrite);
+        }
+    }
+    spec.globalConstraints = spec.globalConstraints?.map(rewrite);
+    spec.successCriteria = spec.successCriteria?.map(rewrite);
+    spec.frontendTestLayout = layout;
+}
+function allowedPathsCoverFrontendTestRoot(allowedPaths, testRoot) {
+    const probe = `${testRoot}/_layout_probe_`;
+    return allowedPaths.some((pattern) => pathMatchesPattern(testRoot, pattern) ||
+        pathMatchesPattern(probe, pattern));
+}
 // ---------------------------------------------------------------------------
 // Frontend browser-test RAG DAG template
 // ---------------------------------------------------------------------------
 function buildFrontendTestHybridDag(sources) {
     const rawFrontendTest = sources.taskConfig.frontendTest;
+    const layout = resolveFrontendTestLayout(rawFrontendTest);
     const config = {
         // Default 32: common FE suites cover ~24 AC with multi-dimension cases; 20 caused map maxExpandedNodes failures.
         maxCasesPerBatch: rawFrontendTest?.maxCasesPerBatch ?? 32,
@@ -4827,9 +4874,9 @@ function buildFrontendTestHybridDag(sources) {
     // Optional project-local UI anchor ledger: only mention it in prompts when it
     // exists so ledger-less projects keep generating without noise.
     const hasUiAnchorsLedger = Boolean(sources.repoRoot &&
-        existsSync(path.join(sources.repoRoot, "testcase/frontend/rag/ui-anchors.md")));
+        existsSync(path.join(sources.repoRoot, layout.ragDir, "ui-anchors.md")));
     const uiAnchorsLedgerInstruction = hasUiAnchorsLedger
-        ? "Also read testcase/frontend/rag/ui-anchors.md (UI anchor ledger). Every passing find assertion in generated cases must quote a ledger row whose 状态 is 有效 for the matching page x state section; rows marked 不可断言/失效 must not be used as passing assertions. When an AC names a control absent from the ledger section for that state, emit a blocked case note (blockedReason unique-control-unavailable) instead of exploratory find steps, and follow ledger 备注 alternatives (split-node short literals) exactly."
+        ? `Also read ${layout.ragDir}/ui-anchors.md (UI anchor ledger). Every passing find assertion in generated cases must quote a ledger row whose 状态 is 有效 for the matching page x state section; rows marked 不可断言/失效 must not be used as passing assertions. When an AC names a control absent from the ledger section for that state, emit a blocked case note (blockedReason unique-control-unavailable) instead of exploratory find steps, and follow ledger 备注 alternatives (split-node short literals) exactly.`
         : "";
     const reviewMode = config.reviewMode;
     const blockingReview = reviewMode === "blocking";
@@ -4837,22 +4884,19 @@ function buildFrontendTestHybridDag(sources) {
     const maxRerunAttempts = config.maxRerunAttempts;
     const enableRetrospect = config.reports?.retrospect === true;
     const enableL5Report = config.reports?.l5 !== false;
-    const hasFrontendTestWriteScope = sources.taskConfig.allowedPaths.some((pattern) => pattern === "testcase/frontend/**" ||
-        pattern === "testcase/**" ||
-        pattern === "**");
-    if (!hasFrontendTestWriteScope) {
-        throw new Error('frontend-test requires task.json allowedPaths to include "testcase/frontend/**" (or an explicit containing glob).');
+    if (!allowedPathsCoverFrontendTestRoot(sources.taskConfig.allowedPaths, layout.testRoot)) {
+        throw new Error(`frontend-test requires task.json allowedPaths to cover "${layout.testRoot}/**" (or an explicit containing glob).`);
     }
     const forbidden = commonForbiddenPaths(sources);
-    const ragWriteSet = ["testcase/frontend/rag/**"];
+    const ragWriteSet = [`${layout.ragDir}/**`];
     const caseDraftWriteSet = [
-        "testcase/frontend/cases/FE-*.md",
-        "testcase/frontend/cases/index.md",
-        "testcase/frontend/cases/manifest.draft.json",
+        `${layout.casesDir}/FE-*.md`,
+        `${layout.casesDir}/index.md`,
+        `${layout.casesDir}/manifest.draft.json`,
     ];
     // The shell materializer alone owns the final manifest boundary.
-    const casesWriteSet = ["testcase/frontend/cases/**"];
-    const evidenceRoot = "testcase/frontend/evidence";
+    const casesWriteSet = [`${layout.casesDir}/**`];
+    const evidenceRoot = layout.evidenceDir;
     const declaredAcIdsLiteral = JSON.stringify(declaredAcIds);
     const maxCasesPerBatchLiteral = String(config.maxCasesPerBatch);
     const checklistScript = [
@@ -5444,6 +5488,7 @@ function buildFrontendTestHybridDag(sources) {
         verifyStrategy: resolveDagVerifyStrategy(sources.taskConfig),
         tasks,
     };
+    applyFrontendTestLayoutToDagSpec(spec, layout);
     applyDefaultReadOnlyRetryPolicy(spec);
     parseDagSpec(spec);
     assertValidDagSpec(spec);

package/dist/workflows/dag/types.js

@@ -978,6 +978,18 @@ export const dagSpecSchema = z
         isDefault: z.boolean(),
     })
         .optional(),
+    /** Frozen frontend-test artifact layout; absent = historical testcase/frontend/ layout. */
+    frontendTestLayout: z
+        .object({
+        testRoot: z.string(),
+        ragDir: z.string(),
+        casesDir: z.string(),
+        evidenceDir: z.string(),
+        reportsDir: z.string(),
+        fixturesDir: z.string(),
+        isDefault: z.boolean(),
+    })
+        .optional(),
     /** Bound user shared-setup document (plan B); absent = no shared setup references expected. */
     backendTestSharedSetup: z
         .object({

package/dist/workflows/dag/validate.js

@@ -5,6 +5,7 @@ import { resolveRepairTaskForGate } from "./repair-artifact.js";
 import { topoSortToRanks } from "./topo.js";
 import { isSafeReadOnlyPiRetryCandidate, isWriterEmptyDiffRetryCandidate, isWriterTransportRetryCandidate, INCOMPLETE_WRITE_SET_RETRY_CATEGORY, WRITER_CLEAN_TIMEOUT_RETRY_CATEGORY, WRITER_EMPTY_DIFF_RETRY_CATEGORY, } from "./retry-policy.js";
 import { isBackendTestCompletenessRetryCandidate } from "./backend-test-writer-completeness.js";
+import { defaultFrontendTestLayout, frontendTestLayoutFromSpec, } from "./frontend-test-layout.js";
 const GOVERNANCE_WARNING_TYPES = new Set([
     "read-only-missing-artifacts-forbidden",
     "read-only-prompt-mentions-artifact-writes",
@@ -680,22 +681,23 @@ function validateWriterOutcomePolicyTaskConfig(task, issues) {
         });
     }
 }
-function isFrontendEvidenceWriteSet(writeSet) {
+function isFrontendEvidenceWriteSet(writeSet, layout = defaultFrontendTestLayout()) {
     const entries = writeSet ?? [];
     if (entries.length === 0)
         return false;
+    const prefix = `${layout.evidenceDir}/`;
+    const glob = `${layout.evidenceDir}/**`;
     return entries.every((entry) => {
         const normalized = entry.trim().replace(/\\/g, "/").replace(/^\.\//, "");
-        return (normalized === "testcase/frontend/evidence/**" ||
-            normalized.startsWith("testcase/frontend/evidence/"));
+        return normalized === glob || normalized.startsWith(prefix);
     });
 }
-function isFrontendBrowserExecutorTask(task) {
+function isFrontendBrowserExecutorTask(task, layout = defaultFrontendTestLayout()) {
     const skills = task.skills ?? [];
     return (task.executor === "pi" &&
         task.toolProfile === "write" &&
         skills.includes("playwright-cli") &&
-        isFrontendEvidenceWriteSet(task.writeSet));
+        isFrontendEvidenceWriteSet(task.writeSet, layout));
 }
 function taskMentionsPlaywrightCliContract(task) {
     const prompt = `${task.subtask_prompt}\n${task.outputContract ?? ""}`;
@@ -707,10 +709,11 @@ function taskMentionsPlaywrightCliContract(task) {
  * - capability is granted without skill/prompt contract or outside evidence writeSet
  * - non-browser nodes receive command capability
  */
-function validateCommandPolicyTaskConfig(task, issues) {
+function validateCommandPolicyTaskConfig(task, issues, spec) {
+    const layout = frontendTestLayoutFromSpec(spec);
     const policy = resolveDagCommandPolicy(task.commandPolicy);
     const allowsPlaywright = dagCommandPolicyAllows(task.commandPolicy, "playwright-cli");
-    const isBrowserExecutor = isFrontendBrowserExecutorTask(task);
+    const isBrowserExecutor = isFrontendBrowserExecutorTask(task, layout);
     if (isBrowserExecutor && !allowsPlaywright) {
         issues.push({
             type: "invalid-command-policy",
@@ -741,10 +744,10 @@ function validateCommandPolicyTaskConfig(task, issues) {
                 message: `task ${task.id} playwright-cli command capability requires prompt/outputContract to reference playwright_cli`,
             });
         }
-        if (!isFrontendEvidenceWriteSet(task.writeSet)) {
+        if (!isFrontendEvidenceWriteSet(task.writeSet, layout)) {
             issues.push({
                 type: "invalid-command-policy",
-                message: `task ${task.id} playwright-cli command capability requires frontend evidence writeSet under testcase/frontend/evidence/`,
+                message: `task ${task.id} playwright-cli command capability requires frontend evidence writeSet under ${layout.evidenceDir}/`,
             });
         }
         if (task.toolProfile !== "write") {
@@ -755,7 +758,7 @@ function validateCommandPolicyTaskConfig(task, issues) {
         }
     }
 }
-function validateDynamicChildCommandPolicy(task, issues) {
+function validateDynamicChildCommandPolicy(task, issues, spec) {
     const expansion = task.dynamicExpansion;
     if (!expansion)
         return;
@@ -776,7 +779,7 @@ function validateDynamicChildCommandPolicy(task, issues) {
         writeSet: child.writeSet,
         outputContract: child.outputContract,
     };
-    validateCommandPolicyTaskConfig(synthetic, issues);
+    validateCommandPolicyTaskConfig(synthetic, issues, spec);
 }
 function validateDecisionGateTaskConfig(task, issues) {
     if (!task.decisionGate?.enabled) {
@@ -883,12 +886,13 @@ export function collectForbiddenExecutorIssues(spec, forbiddenExecutors) {
     }));
 }
 /** Revalidate a rendered dynamic child before it enters state or executes. */
-export function assertValidMaterializedDagTask(task) {
+export function assertValidMaterializedDagTask(task, parentSpec) {
     const issues = [];
-    // A minimal v2 carrier makes write-policy validation strict while avoiding
-    // unrelated parent graph/rank checks.  Dynamic templates are validated at
-    // init; this guards values introduced by {{item}} rendering.
-    const spec = { version: 2, tasks: [task] };
+    const spec = {
+        version: 2,
+        tasks: [task],
+        frontendTestLayout: parentSpec?.frontendTestLayout,
+    };
     validateTaskWritePolicy(task, spec, issues);
     validateShellTaskConfig(task, spec, issues);
     validateStaticTaskConfig(task, issues);
@@ -896,7 +900,7 @@ export function assertValidMaterializedDagTask(task) {
     validateRetryPolicyTaskConfig(task, issues);
     validateOutputProtocolTaskConfig(task, issues);
     validateWriterOutcomePolicyTaskConfig(task, issues);
-    validateCommandPolicyTaskConfig(task, issues);
+    validateCommandPolicyTaskConfig(task, issues, spec);
     if (issues.length > 0) {
         throw new Error(`invalid materialized dynamic child ${task.id}: ${issues.map((issue) => issue.message).join("; ")}`);
     }
@@ -952,8 +956,8 @@ export function validateDagSpec(spec) {
         validateRetryPolicyTaskConfig(task, issues);
         validateOutputProtocolTaskConfig(task, issues);
         validateWriterOutcomePolicyTaskConfig(task, issues);
-        validateCommandPolicyTaskConfig(task, issues);
-        validateDynamicChildCommandPolicy(task, issues);
+        validateCommandPolicyTaskConfig(task, issues, spec);
+        validateDynamicChildCommandPolicy(task, issues, spec);
         validateProjectGovernanceTaskConfig(task, spec, issues);
         validatePiExtensionsTaskConfig(task, issues);
         validateFailureAwareDependsOn(task, spec, issues);

package/docs/templates/frontend-test-case-checklist.md

@@ -15,7 +15,7 @@ LLM review (when `frontendTest.reviewMode=blocking`) must not invent blocking ru
 | `unknown-ac` | When task `sourceBinding.requirementIds` lists ACs, every `acIds` entry must be in that set |
 | `case-id-shape` | `caseId` matches `FE-<FEATURE>-<NNN>-...` (never `AC-FE-*`) |
 | `case-id-is-ac` | Do not use acceptance id as `caseId` / filename |
-| `case-path-mismatch` | `casePath === testcase/frontend/cases/{caseId}.md` |
+| `case-path-mismatch` | `casePath === {casesDir}/{caseId}.md`（默认 `testcase/frontend/cases/{caseId}.md`） |
 | `case-file-missing` | `casePath` exists |
 
 ## Tool guidance (non-blocking)
@@ -40,5 +40,5 @@ LLM review (when `frontendTest.reviewMode=blocking`) must not invent blocking ru
 
 ## Pipeline vs quality
 
-- **Pipeline acceptance**: final `testcase/frontend/reports/frontend-test-retrospect-*.md` exists after result materialize
+- **Pipeline acceptance**: final `{reportsDir}/frontend-test-retrospect-*.md` exists after result materialize (default `testcase/frontend/reports/`)
 - **Quality**: `frontend-test-result-v1.outcome=passed` with 0 blocked/failed (opt-in via `frontendTest.strictOutcomeGate`)

package/harness.json

@@ -82,9 +82,9 @@
   "executors": {
     "pi": {
       "description": "Pi 负责规划、评审、诊断；当 DAG toolProfile=write 时也可做有界写入。模型按复杂度三档配置，支持 provider/model 字符串或带 thinking 的对象；斜杠前为 Pi provider，后为 modelId，勿只写裸 modelId。",
-      "LOW": "wizard-local/minimax-m3",
-      "MED": "wizard-local/minimax-m3",
-      "HIGH": "wizard-local/minimax-m3"
+      "LOW": "deepseek/deepseek-v4-flash",
+      "MED": "deepseek/deepseek-v4-flash",
+      "HIGH": "deepseek/deepseek-v4-flash"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tea-agent/loop-agent",
-  "version": "0.39.0-next.31",
+  "version": "0.39.0-next.32",
   "type": "module",
   "bin": {
     "loop-agent": "bin/loop-agent.js",

package/skills/fe-test-ui-scout/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: fe-test-ui-scout
-description: 在写 frontend-test Wave PRD/回归目录之前，对真实运行的被测页面做只读锚点侦察，产出并维护 testcase/frontend/rag/ui-anchors.md 锚点台账。用 playwright-cli snapshot/find 逐字面验证命中数与唯一性，防止 PRD 验收标准引用不存在或不唯一的文案。触发词：frontend-test、锚点、台账、ui-anchors、侦察、写 PRD 前、snapshot/find 校准、Wave PRD。
+description: 在写 frontend-test Wave PRD/回归目录之前，对真实运行的被测页面做只读锚点侦察，产出并维护 {testRoot}/rag/ui-anchors.md 锚点台账（默认 testcase/frontend/rag/ui-anchors.md）。用 playwright-cli snapshot/find 逐字面验证命中数与唯一性，防止 PRD 验收标准引用不存在或不唯一的文案。触发词：frontend-test、锚点、台账、ui-anchors、侦察、写 PRD 前、snapshot/find 校准、Wave PRD。
 references:
   - path: references/ledger-schema.md
     required: true
@@ -13,7 +13,7 @@ references:
 ## 定位
 
 写 Wave PRD / 校准回归目录 AC **之前**的前置侦察。产出锚点台账
-`testcase/frontend/rag/ui-anchors.md`：每个「页面 × 状态」下真实可见、
+`{testRoot}/rag/ui-anchors.md`（默认 `testcase/frontend/rag/ui-anchors.md`）：每个「页面 × 状态」下真实可见、
 `find` 可命中的字面清单。PRD 的每条 `find "..."` 断言必须能在台账找到对应行；
 台账没有的字面禁止写进验收标准。
 
@@ -23,7 +23,7 @@ references:
 
 ## 输入
 
-- 被测 baseUrl（来自 `testcase/frontend/rag/context.md` 的 `environmentProbe=reachable` URL）
+- 被测 baseUrl（来自 `{testRoot}/rag/context.md` 的 `environmentProbe=reachable` URL；默认 `testcase/frontend/rag/context.md`）
 - 目标 Wave 的 AC 清单（回归目录中本 Wave 范围的行）
 - 既有台账（增量更新，不整表重写）
 
@@ -56,7 +56,7 @@ references:
 
 ## 输出
 
-- `testcase/frontend/rag/ui-anchors.md`（增量更新）
+- `{testRoot}/rag/ui-anchors.md`（增量更新；默认 `testcase/frontend/rag/ui-anchors.md`）
 - 侦察小结（对话内输出，不落盘；结论回写 PRD 草稿的锚点引用）
 
 ## References

package/skills/fe-test-ui-scout/references/ledger-schema.md

@@ -2,7 +2,7 @@
 
 ## 文件位置与命名
 
-- 路径：`testcase/frontend/rag/ui-anchors.md`
+- 路径：`{testRoot}/rag/ui-anchors.md`（默认 `testcase/frontend/rag/ui-anchors.md`）
 - 编码：UTF-8，LF；表格用 GitHub Flavored Markdown。
 - 台账是**增量账本**：修订不删除历史行；失效行改状态列并注明原因。