@tea-agent/loop-agent 0.40.0-next.9 → 0.41.0-beta.1

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

@@ -45,6 +45,60 @@ const CONSTRAINT_FILE = "执行约束.md";
 const REFERENCE_DIRECTORY = "references";
 const MAX_SOURCE_EXCERPT_CHARS = 2000;
 const MAX_INLINE_SOURCE_REFERENCE_DOCUMENTS = 8;
+/**
+ * Generation-time compiler for machine-declared structured artifacts. The
+ * frozen spec remains the sole runtime authority: this compiler never reads
+ * prompt/outputContract prose or workspace filenames, and historical specs
+ * loaded outside init-hybrid are left untouched.
+ */
+function stampGeneratedArtifactBindings(spec) {
+    const producedByNode = new Map();
+    for (const task of spec.tasks) {
+        if ((task.producesArtifacts?.length ?? 0) > 0) {
+            for (const artifact of task.producesArtifacts ?? []) {
+                producedByNode.set(task.id, artifact.artifactId);
+            }
+            continue;
+        }
+        const gate = task.shell?.jsonArtifactGate;
+        const structured = task.structuredContractOutput;
+        if (!gate && !structured)
+            continue;
+        const artifactId = `${task.id}.structured-output`;
+        const path = gate
+            ? `${gate.outputDir}/${gate.artifactName}`
+            : `contracts/candidates/${task.id}/canonical-contract.json`;
+        task.producesArtifacts = [
+            {
+                artifactId,
+                kind: "structured",
+                path,
+                mediaType: "application/json",
+                schemaId: gate?.schemaId ?? FRONTEND_IMPLEMENTATION_CONTRACT_SCHEMA_ID,
+                revisionPolicy: "replace-file",
+            },
+        ];
+        producedByNode.set(task.id, artifactId);
+    }
+    for (const task of spec.tasks) {
+        const existing = new Set((task.consumesArtifacts ?? []).map((binding) => binding.artifactId));
+        const generated = task.depends_on.flatMap((parentNodeId) => {
+            const artifactId = producedByNode.get(parentNodeId);
+            if (!artifactId || existing.has(artifactId))
+                return [];
+            existing.add(artifactId);
+            return [
+                {
+                    artifactId,
+                    required: task.dependsPolicy !== "all-or-condition-skip",
+                },
+            ];
+        });
+        if (generated.length > 0) {
+            task.consumesArtifacts = [...(task.consumesArtifacts ?? []), ...generated];
+        }
+    }
+}
 const INTERACTIVE_UI_DELIVERY_CONTRACT = [
     "[INTERACTIVE_UI_DELIVERY_CONTRACT]",
     "This is an interactive UI delivery task.",
@@ -2074,6 +2128,7 @@ export function buildStandardHybridDagFromTask(sources) {
     applySddEmbeddedEnhancements(spec, sources.sddEmbeddedSkills ?? new Set());
     stampTargetTemplateTransientRetryProfile(spec);
     applyDefaultReadOnlyRetryPolicy(spec);
+    stampGeneratedArtifactBindings(spec);
     parseDagSpec(spec);
     assertValidDagSpec(spec);
     return spec;
@@ -2279,6 +2334,7 @@ function buildBlockedFrontendMockDag(sources, readOnlyPaths, forbiddenPaths, glo
         ],
     };
     applyDefaultReadOnlyRetryPolicy(spec);
+    stampGeneratedArtifactBindings(spec);
     parseDagSpec(spec);
     assertValidDagSpec(spec);
     return spec;
@@ -3353,6 +3409,7 @@ async function buildFrontendHybridDagFromTask(sources) {
     };
     spec.tasks = pruneFrontendTasksForRisk(spec.tasks, frontendRisk);
     applyDefaultReadOnlyRetryPolicy(spec);
+    stampGeneratedArtifactBindings(spec);
     parseDagSpec(spec);
     assertValidDagSpec(spec);
     return spec;
@@ -4020,6 +4077,84 @@ const BACKEND_TEST_SKILLS_BY_ROLE = {
     verifier: ["verification-before-completion", "systematic-debugging"],
     closeout: ["loop-agent", "verification-before-completion"],
 };
+/**
+ * Read-only Worker workflow for producing a revision-eligible Backend Test
+ * Analysis v2 contract without crossing into test generation or execution.
+ * The explicit consumer keeps artifact lineage meaningful for safe
+ * continuation: replacing the contract reruns review + deterministic closeout
+ * only.
+ */
+function buildBackendTestAnalysisHybridDag(sources) {
+    const analysis = buildAnalyzeInputsNode(sources);
+    const contract = buildBackendTestAnalysisContractGateNode(sources);
+    const review = {
+        id: "review-backend-test-analysis-pi",
+        depends_on: [contract.id],
+        role: "reviewer",
+        executor: "pi",
+        complexity: "LOW",
+        writePolicy: "read-only",
+        allowedPaths: commonReadOnlyPaths(sources),
+        forbiddenPaths: commonForbiddenPaths(sources),
+        outputContract: "Concise Markdown review of the validated Backend Test Analysis v2 contract, covering source binding, explicit requirement coverage, evidence gaps, risks, and downstream readiness. No file writes.",
+        subtask_prompt: [
+            "Review the validated run-owned `contracts/backend-test-analysis.json` artifact.",
+            "Treat that structured artifact as the authoritative analysis contract; do not substitute the producer's assistant prose.",
+            "Check that every explicit AC/REQ/BR is represented by acceptanceCriteria or an evidenceGap, source references are precise, and unknown behavior remains an evidence gap rather than an invented requirement.",
+            "Summarize source-binding integrity, coverage, risks, evidence gaps, and whether the contract is ready for a later backend-test generation workflow.",
+            "Read-only: do not modify code, docs, artifacts, or repository files.",
+        ].join("\n\n"),
+    };
+    const closeout = {
+        id: "backend-test-analysis-closeout-static",
+        depends_on: [review.id],
+        role: "closeout",
+        executor: "static",
+        complexity: "LOW",
+        writePolicy: "none",
+        allowedPaths: [],
+        forbiddenPaths: commonForbiddenPaths(sources),
+        outputContract: "Deterministic handoff pointing to the validated analysis contract and its independent read-only review.",
+        subtask_prompt: "Close the read-only analysis workflow after the structured contract and review both succeed.",
+        static: {
+            resultMarkdown: [
+                "# Backend-test analysis closeout",
+                "",
+                "Validated contract: `contracts/backend-test-analysis.json`.",
+                "Independent review: `review-backend-test-analysis-pi`.",
+            ].join("\n"),
+        },
+    };
+    const spec = {
+        version: 3,
+        title: `Backend test analysis DAG: ${sources.taskConfig.title}`,
+        runtimeContract: GENERATED_DAG_RUNTIME_CONTRACT,
+        outputLanguage: sources.outputLanguage ?? DEFAULT_DAG_OUTPUT_LANGUAGE,
+        objective: extractObjective(sources.requirementMarkdown, sources.taskConfig.title),
+        successCriteria: [
+            "A strict Backend Test Analysis v2 contract is materialized with immutable source binding",
+            "Every explicit requirement is covered or preserved as an evidence gap",
+            "An independent read-only review consumes the validated structured artifact",
+        ],
+        globalConstraints: [
+            ...sources.taskConfig.hardConstraints,
+            "This workflow is analysis-only: no repository writer, dynamic expansion, test generation, or test execution is allowed.",
+        ],
+        defaults: {
+            ...BACKEND_TEST_DEFAULTS,
+            contextProfile: sources.taskConfig.contextProfile,
+        },
+        skillsByRole: BACKEND_TEST_SKILLS_BY_ROLE,
+        executorModels: sources.executorModelMatrix ?? DEFAULT_DAG_EXECUTOR_MODELS,
+        verifyStrategy: resolveDagVerifyStrategy(sources.taskConfig),
+        tasks: [analysis, contract, review, closeout],
+    };
+    applyDefaultReadOnlyRetryPolicy(spec);
+    stampGeneratedArtifactBindings(spec);
+    parseDagSpec(spec);
+    assertValidDagSpec(spec);
+    return spec;
+}
 /**
  * Plan D: gap-fill incremental DAG (mode=gap-fill).
  *
@@ -4421,6 +4556,7 @@ async function buildBackendTestGapFillDag(sources) {
         spec.backendTestSharedSetup = { ...sharedSetup };
     }
     applyDefaultReadOnlyRetryPolicy(spec);
+    stampGeneratedArtifactBindings(spec);
     parseDagSpec(spec);
     assertValidDagSpec(spec);
     return spec;
@@ -4520,7 +4656,7 @@ async function buildBackendTestHybridDag(sources) {
             "Coverage priority is strict inside the declared scope: P0 product requirements/task hard constraints always remain in scope; P1 exhaustively supplements documented operations, fields, business rules, statuses and errors only for Affected Operations; P2 adds bounded protocol robustness only when it is relevant to the change and does not invent product behavior. Coverage percentages describe the declared affected scope, never whole-API completeness unless every operation is explicitly listed. Conflicts or undefined expectations must stay visible as GAP/CONFLICT with precise source pointers, never guessed.",
             "For uniqueness/lifecycle rules cover absent, active-existing, deleted-existing, create-delete-recreate, restore-then-recreate and documented scope/case-normalization states. For every enum cover every valid value plus bounded invalid equivalence classes (unknown, case variant, whitespace, empty, null/missing and wrong types as applicable). For every length/number rule cover min-1, min, nominal, max and max+1. For format rules cover each allowed class separately plus a valid mixed value, and representative forbidden classes including uppercase, internal/leading/trailing whitespace, tab/newline, unsupported punctuation, slash, emoji or control characters when the source contract supports that expectation.",
             "Mandatory module index: include a `## Module Index` table in the plan artifact that lists every planned module as a canonical relative link of the exact form `[label](./<stem>.md)` plus a `testcase/md/<stem>.md` path cell, so a downstream deterministic manifest can parse the module list. Group by stable business resource/domain, not by CRUD operation: one resource's list/detail/create/update/delete cases belong in one module such as `resource_notes`; split only when a single module would exceed the per-child 16K output protocol, keep the total module count at the smallest safe value, and never exceed 8 modules. Name each module file with a stable lowercase business stem such as `health` or `resource_notes`. Pure hexadecimal/hash-like opaque stems such as `a401606` or `deadbeef` are forbidden. Do not use priority-only stems `p0`, `p1` or `p2`; Priority belongs only in the Coverage Matrix and never defines module files. Do not use Case-ID-like module filenames such as `BE-HEALTH.md` or `BE-NOTES.md`. The relative link target MUST equal the on-disk filename stem the sharded writer will create. For every automatable case, `自动化映射` must name exactly `testcase/test_<module>.py`, where <module> is that Markdown filename without `.md`, lowercased, with non-alphanumeric characters replaced by underscores. Example: `testcase/md/health.md` → `testcase/test_health.py`; `testcase/md/resource_notes.md` → `testcase/test_resource_notes.py`. Never invent a different pytest path in Markdown than the module stem implies.",
-            "Scenario Partitions (query/filter axes): for every affected GET/list operation, declare one row per enum or classification axis used for filtering (query/path parameters such as type/status/category). Add a mandatory machine-readable `## Scenario Partitions` section after the Coverage Matrix using exactly `| Partition ID | Operation | Axis | Domain | Required Slots | Expected by Slot | Bind Rule |` with the separator row. Partition ID is a stable `SP-<OPERATION>-<AXIS>` token; Domain must copy the legal values verbatim from the bound OpenAPI enum or requirement sentence (never guess), using bare semicolon-separated identifier values inside the single table cell (for example `ACTIVE; ARCHIVED`, with no Markdown backticks or prose); Required Slots writes `each-value` plus `omitted` only when the parameter is optional; Expected by Slot states the documented expectation per slot kind (`domain-value`, `default-behavior`, `empty-result`/`excluded-result` when documented, or `GAP` when the source does not document the complement expectation — never invent 空列表/400). POST/PUT body field-validation enums stay in the Coverage Matrix as `TP-<FIELD>-ENUM-*` and MUST NOT get a Scenario Partition row. Do not create partitions for axes without a documented legal-value domain. Only GET/list query or path parameters whose bound source documents a finite enum or classification set may become a Scenario Partition. Do not create partitions for free-form strings, primary keys, required-or-optional-only parameters, or boundary/format-only axes. If an axis has no finite legal-value domain, do not declare a Partition row and do not invent NOT-IN-SET cases. Cross-axis combinations stay as ONE nominal Case; never declare a cross-axis cartesian partition.",
+            "Scenario Partitions (query/filter axes): for every affected GET/list operation, declare one row per enum or classification axis used for filtering (query/path parameters such as type/status/category). Add a mandatory machine-readable `## Scenario Partitions` section after the Coverage Matrix using exactly `| Partition ID | Operation | Axis | Domain | Required Slots | Expected by Slot | Bind Rule |` with the separator row. Partition ID is a stable `SP-<OPERATION>-<AXIS>` token; Domain must copy the legal values verbatim from the bound OpenAPI enum or requirement sentence (never guess), using bare semicolon-separated identifier values inside the single table cell (for example `ACTIVE; ARCHIVED`, with no Markdown backticks or prose); Required Slots must contain `each-value` and exactly one `not-in-set`, plus `omitted` only when the parameter is optional. Before returning, expand every declared partition into its complete deterministic exact slot ID set: one `TP-<Partition ID>-<VALUE-TOKEN>` per Domain value, `TP-<Partition ID>-OMITTED` only for an optional axis, and exactly one `TP-<Partition ID>-NOT-IN-SET`. Every expanded slot ID must appear verbatim in the binding Rule's `Required Test Points` cell and be assigned to concrete Case IDs in that same Coverage Matrix row; ordinary alias/family Test Points do not replace this inventory. Expected by Slot states the documented expectation per slot kind (`domain-value`, `default-behavior`, `empty-result`/`excluded-result` when documented, or `GAP` when the source does not document the complement expectation — never invent 空列表/400). POST/PUT body field-validation enums stay in the Coverage Matrix as `TP-<FIELD>-ENUM-*` and MUST NOT get a Scenario Partition row. Do not create partitions for axes without a documented legal-value domain. Only GET/list query or path parameters whose bound source documents a finite enum or classification set may become a Scenario Partition. Do not create partitions for free-form strings, primary keys, required-or-optional-only parameters, or boundary/format-only axes. If an axis has no finite legal-value domain, do not declare a Partition row and do not invent NOT-IN-SET cases. Cross-axis combinations stay as ONE nominal Case; never declare a cross-axis cartesian partition.",
             "Before finalizing README, calculate the predicted collected-item count as `sum(max(1, number of variant Test Points in each Case))`. If the task declares an item budget, the prediction must not exceed it. Reduce excess only by removing duplicate execution and converting same-request checkpoints to assertions; never drop required rules, boundaries, enums, operation-specific inputs, or business states. Record the prediction in README. Use only environment-supported fixtures/targets/isolation, record evidence gaps in Chinese, and do not emit JSON, pytest, or execute commands.",
             ...(sharedSetupPrompt ? [sharedSetupPrompt] : []),
             intake.boundedSourceContext,
@@ -4603,7 +4739,7 @@ async function buildBackendTestHybridDag(sources) {
                     "Write human-readable content in Simplified Chinese by default. Keep English only for machine-readable IDs and technical literals such as Case/AC/REQ/BR IDs, HTTP methods, paths, field names, enum values, commands, filenames, code symbols and exact source citations.",
                     'Write the module {{item.stem}} as readable case cards covering every in-scope rule/Test Point the README Coverage Matrix assigns to this module. Every case starts with `## BE-<MODULE>-<NNN>｜<中文用例名称>`. `<NNN>` is exactly three zero-padded digits (`001`, `002`, ...), never two digits (`01`), a bare number, or an alphabetic suffix such as `011A`. Every case must include `### 覆盖规则`, `### 测试点`, `### 场景类型`, `### 前置条件`, `### 操作步骤`, `### 预期结果`, and `### 自动化映射` Do not group cases under "## 测试类 ..." (or any h2 grouping) headings that force Cases down to h3; each Case must be a direct h2 (`##`), and its seven sections must be h3 (`###`) children of that Case. If you need to convey a pytest class, state it inside the Case\'s `### 自动化映射` instead. Forbidden: `## 测试类 X` then `### BE-PD-001` and `### 覆盖规则` at the same h3 level. Required: `## BE-PD-001` then `### 覆盖规则`.; `覆盖规则` and `测试点` must reference exact Matrix Rule Keys/Test Points. Add `测试目的`, `验收标准`, `需求依据`, and `测试数据` for readable evidence. The `验收标准` section must list the exact applicable `AC-...` IDs, and every explicit task AC must appear in at least one Case. Every automatable case explicitly names its target pytest script and exactly one primary symbol so traceability scans only that script/symbol. Evidence-only meta cases that exist solely for non-executable assertion/cross-cutting process evidence may declare `脚本：无` and `primary symbol：无` with empty `变体测试点`, and must not invent a business pytest item.',
                     "Name this module file with the stable lowercase business stem `{{item.stem}}` (filename `testcase/md/{{item.stem}}.md`). Priority-only stems `p0`, `p1` and `p2` are forbidden and must never produce `p0.md` or `test_p0.py`. Pure hexadecimal/hash-like opaque stems such as `a401606` and `deadbeef` are also forbidden. Do not use Case-ID-like module filenames. For every automatable case, `自动化映射` must name exactly `testcase/test_{{item.stem}}.py`, where the module stem is this Markdown filename without `.md`, lowercased, with non-alphanumeric characters replaced by underscores. Example: `health` → `testcase/test_health.py`; `resource_notes` → `testcase/test_resource_notes.py`. Never invent a different pytest path in Markdown than the module stem implies.",
-                    "Scenario Partition slots: when README declares `## Scenario Partitions`, every slot of each declared partition MUST appear in this module's Cases as exactly one variant Test Point with the deterministic ID `TP-<Partition ID>-<VALUE-TOKEN>` (each-value), `TP-<Partition ID>-OMITTED` (optional axis only) and exactly one `TP-<Partition ID>-NOT-IN-SET` complement slot with `intent=enum-invalid`. Example: Partition ID `SP-GET-API-RESOURCE-NOTES-STATUS` → `TP-SP-GET-API-RESOURCE-NOTES-STATUS-ACTIVE`. Slot IDs copy the declared Partition ID exactly; never drop the HTTP method, invent, merge, renumber or split slot IDs. Prefer ONE Case per partition with a parameter table over duplicated Cases per value. The not-in-set slot value must be a concrete literal absent from the Domain (e.g. `UNKNOWN_TYPE`) and its expected result must come from the bound source — when Expected by Slot is GAP, the Case states the expectation as GAP evidence, never a guessed 空列表/400. Never create cross-axis combination variants beyond the single documented nominal.",
+                    "Scenario Partition slots: when README declares `## Scenario Partitions`, every slot of each declared partition MUST appear in this module's Cases as exactly one variant Test Point with the deterministic ID `TP-<Partition ID>-<VALUE-TOKEN>` (each-value), `TP-<Partition ID>-OMITTED` (optional axis only) and exactly one `TP-<Partition ID>-NOT-IN-SET` complement slot with `intent=enum-invalid`. Example: Partition ID `SP-GET-API-RESOURCE-NOTES-STATUS` → `TP-SP-GET-API-RESOURCE-NOTES-STATUS-ACTIVE`. Slot IDs copy the declared Partition ID exactly; never drop the HTTP method, invent, merge, renumber or split slot IDs. Before returning, derive the complete exact slot set from every applicable Scenario Partitions row and verify that the module Cases declare and bind every slot assigned by the Coverage Matrix; ordinary alias Test Points do not satisfy a partition slot, and aggregate aliases such as `SINGLE`/`MULTIPLE` are forbidden. Prefer ONE Case per partition with a parameter table over duplicated Cases per value. The not-in-set slot value must be a concrete literal absent from the Domain (e.g. `UNKNOWN_TYPE`) and its expected result must come from the bound source — when Expected by Slot is GAP, the Case states the expectation as GAP evidence, never a guessed 空列表/400. Never create cross-axis combination variants beyond the single documented nominal.",
                     "For every variant Test Point, write its machine-checkable `场景意图: <TP-ID>; operation=...; target=...; intent=...` line inside that same Case body/自动化映射. Never collect Scenario Intent lines in a file-level appendix, implementation-details block, or another Case; local TP ownership is mandatory.",
                     "Every Case must keep at least one numbered executable line under `### 操作步骤`; a compact variant/result table may follow but must not replace the numbered action anchor. Keep numbered/bulleted independently assertable results under `### 预期结果`. The exact `### 操作步骤` and `### 预期结果` headings must remain present for every Case, including compact/table-based Cases; never compress later Cases by dropping required headings. Every result must name the observable HTTP status, response field/value, state transition or membership condition, never vague wording such as ‘符合预期’.",
                     "In every `自动化映射`, use exactly these machine-readable list labels: `脚本`, `primary symbol`, `变体测试点`, `场景断言测试点`, `横切证据测试点`, plus a deterministic payload contract. For operations without a request body write `Payload Contract: none`. Otherwise write `Payload Required Paths`, `Payload Allowed Paths`, and `Payload Enum` (write `none` when there is no enum); nested fields use dot paths such as `approver.name`. Each Case describes exactly one target request payload contract: put every payload label on its own list line, never concatenate multiple operations or setup POST/PUT contracts into one label line, and never repeat a `Payload Contract:` token inside explanatory prose/details after the machine-readable line. Values must come only from bound API/DTO evidence, never guesses. Each Test Point from `### 测试点` must appear in exactly one binding list, and every Test Point named in any binding list must also be declared in that Case's `### 测试点`; write `无` for an empty list. A variant Test Point is atomic: one exact endpoint/input/precondition/outcome row equals one exact pytest item and one exact TP ID. If a parameter table has five rows, declare five distinct variant TP IDs in Markdown; never declare one family TP and append row suffixes only in pytest. Classify as `variant` only when endpoint, request input, precondition business state, or expected outcome genuinely changes and therefore needs an independent pytest parameter item. Classify CRUD checkpoints, status/body/header/schema assertions and multiple checks over the same response/journey as `assertion`; classify shared HTTP logging/redaction/truncation evidence as `cross-cutting`. Never create a Test Point merely to parameterize a checkpoint. Every non-cross-cutting TP ID is owned by exactly one Case; when the same response/schema/error assertion is needed in different Cases, use distinct Case-specific TP IDs instead of reusing one assertion TP across Cases. Keep the script path identical to the module one-to-one path and declare exactly one primary symbol named with the canonical Case prefix, for example `BE-RN-003` → `test_BE_RN_003_<description>`; non-Case-prefixed primary symbols are forbidden because parameterized item association must remain deterministic. For evidence-only meta Cases with no executable business journey, write `脚本：无` and `primary symbol：无`, keep `变体测试点：无`, and place process evidence only in assertion/cross-cutting lists. If the bound contract only says an identifier is returned/present, do not declare a concrete identifier type. If a 404 Case needs a nonexistent path identifier but its syntax/type is unspecified, define a create-delete-derived valid identifier journey instead of an arbitrary UUID/text placeholder. For redaction scenarios, list sensitive header/field key names only. Never write any header-name-and-value pair, credential placeholder, fake token, anti-example, or other secret-shaped literal in Markdown; state only that a test-only value is supplied at runtime and omitted. Put implementation-only restrictions in a concise `<details>` block rather than dominating the main case flow. Use only environment-supported fixtures/targets/isolation, record evidence gaps in Chinese, and do not emit JSON, pytest, or execute commands.",
@@ -4648,7 +4784,7 @@ async function buildBackendTestHybridDag(sources) {
             "Correct testcase/md/** directly: add documented omissions, remove unsupported cases, rename module files to stable lowercase stems when needed, normalize every Case ID to hyphen-separated module segments plus exactly three zero-padded digits (`BE-RESOURCE_NOTES-01` → `BE-RESOURCE-NOTES-001`; `BE-RN-011A` must be renumbered or merged) consistently across headings/index/mappings, fix automation mappings so each automatable case points at `testcase/test_<module>.py` derived from that module filename and declares exactly one primary symbol (evidence-only meta cases may keep `脚本/primary symbol=无` with empty variants), assign every Test Point exactly one of `变体测试点`/`场景断言测试点`/`横切证据测试点`, then perform an exact-set check: each Case's `### 测试点` set must equal (not merely contain) the union of those three binding lists; delete stale/legacy aliases and ensure every binding-list Test Point is present, expand every variant parameter row into its own atomic TP ID, make every non-cross-cutting TP Case-specific and owned by exactly one Case, require every primary symbol to start with the canonical Case prefix, ensure every explicit AC ID appears in an applicable Case `验收标准`, merge execution duplicates, improve navigation/tables/Chinese wording, or record gaps in Chinese. Remove every credential/header value, placeholder, fake token and anti-example from Markdown. Sensitive key names may remain only as a plain list; values must be described as runtime-only and omitted, with no colon/value pair or literal example anywhere, including details blocks and explanatory text. Keep Case IDs, AC/REQ/BR IDs, HTTP methods, paths, fields, enum values, filenames, code symbols and source citations as exact machine-readable identifiers; only normalize Case ID separator/sequence formatting as specified above. Recalculate predicted collected items as `sum(max(1, variant count per Case))`; when the task declares a budget, directly merge redundant journeys/reclassify same-request checkpoints until the prediction is within budget, while preserving all required coverage. The validator accepts Chinese and legacy English section aliases; retain or converge to the Chinese human-readable headings without losing structure.",
             "This is the single Markdown incremental synchronization round. Read every authoritative reference index entry whose role hints include acceptance-criteria, api-contract, data-contract or business-rule; do not rely on the derived PRD as a complete inventory. Preserve every explicit AC/REQ/BR ID, every documented HTTP/business error code, every DTO/JSON field, enum value, boundary, format, nested shape, transaction/state/idempotency/uniqueness/auth/tenant/cross-field rule. For each natural-language normative business rule preserved as required scope, include its exact source sentence without paraphrase together with source path and line/heading anchor so the deterministic ledger can verify quote/hash provenance. Ensure every Case declares exactly `Payload Contract: none` or the three labels `Payload Required Paths`, `Payload Allowed Paths`, and `Payload Enum`; every label must occupy its own machine-readable list line, and a Case must never concatenate target/setup operations or multiple `Payload Contract` tokens onto one line, and explanatory prose/details must not repeat any `Payload Contract:` token; never infer missing keys or enum values. A target GET/DELETE operation with no request body must remain `Payload Contract: none` even when its setup journey performs POST/PUT with a DTO; setup payloads never redefine the target Case payload contract. Add only missing Matrix rows/Test Points/Cases/assertions or repair exact drift; do not rewrite already-valid unrelated modules. Work gap-targeted: inspect source anchors and affected modules first, leave unrelated valid modules byte-stable, and return `already-satisfied` without restating the full suite when no gap exists.",
             "For affected API fields, use one valid nominal payload plus atomic required/missing/null/empty/wrong-type, every documented enum value plus bounded invalid classes, documented min-1/min/nominal/max/max+1, formats and nested object/array constraints. Do not generate a Cartesian product or invent undocumented constraints. Do not invent a concrete identifier type when the source only requires presence; for a missing-resource 404 path with unspecified identifier syntax/type, synchronize the Case to a create-delete-derived valid identifier journey rather than an arbitrary UUID/text placeholder.",
-            "Scenario Partitions synchronization: when the run-owned plan declares `## Scenario Partitions`, verify each declared partition's slots are fully materialized as variant Test Points with exact `TP-<Partition ID>-...` IDs (each-value per Domain value, OMITTED only for optional axes, exactly one NOT-IN-SET with intent=enum-invalid). Directly add missing slot rows/Cases. Record an illegal plan Partition row that has no source-backed finite domain as GAP/CONFLICT and remove only its derived `TP-SP-*` slots/Cases from target modules; never modify the immutable plan artifact. Never delete a legal source-backed partition or drop its complement slot to force coverage green. When the bound source does not document the complement expectation, keep the slot with GAP expected instead of guessing. Body-field validation enums (`TP-<FIELD>-ENUM-*`) are NOT partitions — do not add partition rows for them.",
+            "Scenario Partitions synchronization: when the run-owned plan declares `## Scenario Partitions`, verify each declared partition's slots are fully materialized as variant Test Points with exact `TP-<Partition ID>-...` IDs (each-value per Domain value, OMITTED only for optional axes, exactly one NOT-IN-SET with intent=enum-invalid). Before returning, derive the complete exact slot set from every legal Scenario Partitions row and compare it with both the binding Coverage Matrix Rule's Required Test Points and the final Case `### 测试点`/`变体测试点` sets; directly add every missing exact slot to the already-assigned Case IDs; ordinary alias Test Points do not satisfy a partition slot, and aggregate aliases such as `SINGLE`/`MULTIPLE` are forbidden. Directly add missing slot rows/Cases. Record an illegal plan Partition row that has no source-backed finite domain as GAP/CONFLICT and remove only its derived `TP-SP-*` slots/Cases from target modules; never modify the immutable plan artifact. Never delete a legal source-backed partition or drop its complement slot to force coverage green. When the bound source does not document the complement expectation, keep the slot with GAP expected instead of guessing. Body-field validation enums (`TP-<FIELD>-ENUM-*`) are NOT partitions — do not add partition rows for them.",
             "Before returning, verify that every explicit source AC/REQ/BR, error code and strong DTO field token appears in the run-owned plan or an applicable module Case. If a fact cannot be safely automated, retain it as GAP/CONFLICT with its exact source pointer instead of dropping it. Return already-satisfied only when no target file needs an incremental edit.",
             "Read only indexed source paths. Do not scan the repository, modify source/**, generate pytest, execute tests, or emit JSON.",
             ...(sharedSetupPrompt ? [sharedSetupPrompt] : []),
@@ -4776,6 +4912,7 @@ async function buildBackendTestHybridDag(sources) {
     // intentional repair as an out-of-bounds mutation.
     collectionAssess.writePolicy = "exclusive";
     collectionAssess.writeSet = [applyLayout("testcase/**/test_*.py")];
+    collectionAssess.allowedPaths = Array.from(new Set([...ro, ...collectionAssess.writeSet]));
     const repairPytest = {
         id: "repair-backend-pytest-collection-pi",
         depends_on: [collectionAssess.id],
@@ -4814,7 +4951,7 @@ async function buildBackendTestHybridDag(sources) {
         writerOutcomePolicy: { type: "implementation-outcome-v1", requireChangedFiles: true },
         outputContract: "First non-empty line is IMPLEMENTATION_OUTCOME: changed|blocked, followed by a concise repair summary. This node runs only for REPAIRABLE initial facts, so already-satisfied is invalid and a successful outcome requires a non-empty bounded diff. Modify only generated pytest scripts/helpers/factories and preserve every Markdown Case, Test Point, primary symbol and assertion meaning.",
         subtask_prompt: [
-            "Repair the generated backend pytest asset as one bounded program using the direct upstream collection assessment. This is the only repair attempt and happens before any business test body execution. Treat any upstream line such as `Repair paths: testcase/test_x.py` as complete authoritative repairPaths evidence. Directly read and edit that testcase path; do not search for separate root-level `contracts/**`, guess a DAG run directory, or require another report artifact. If the read tool successfully returns the testcase file, the path exists—continue the bounded repair and never later claim that file is absent.",
+            "Repair the generated backend pytest asset as one bounded program using the direct upstream collection assessment. This is the only repair attempt and happens before any business test body execution. The direct upstream JSON includes authoritative `repairPaths` and bounded `repairFindings`; treat both as the complete mandatory checklist without searching for a run directory or report file. Treat any upstream line such as `Repair paths: testcase/test_x.py` as equivalent authoritative repairPaths evidence. Directly read and edit that testcase path; do not search for separate root-level `contracts/**`, guess a DAG run directory, or require another report artifact. If the read tool successfully returns the testcase file, the path exists—continue the bounded repair and never later claim that file is absent.",
             "Initial status REPAIRABLE means at least one listed finding remains: `already-satisfied` is forbidden, and you must produce a non-empty bounded diff on repairPaths before returning `IMPLEMENTATION_OUTCOME: changed`. Fix only readiness-proven generated testcase-local defects on initial facts repairPaths: create exact safe missing mapped test_*.py paths, repair syntax/import/symbol/decorator/parameterization, close generated fixture dependencies/plugin registration, and repair initial Markdown-to-pytest correspondence findings. Use this deterministic repair map instead of reading analyzer implementation: findings about `Case-ID`, `Assertion-Test-Points`, or `Cross-Cutting-Test-Points` are fixed by editing the declared primary symbol docstring metadata lines; variant binding findings are fixed in the literal direct `pytest.param(..., id=\"TP-...\")` row; primary-symbol cardinality/name findings are fixed in the function name or duplicate primary symbols; script mismatch is fixed only on the authoritative assessment repairPaths; payload findings are fixed in request payload construction. Do not read controller `src/**` or inspect JS/TS analyzer code. Do not search for `testcase/**/README.md`. Never invent a business pytest symbol for evidence-only Markdown Cases that declare `脚本/primary symbol=无` with empty variants. For fixture defects inspect both provider and importer listed by repairPaths; fix ScopeMismatch by aligning fixture scopes or inlining request-scoped values so module fixtures never depend on function fixtures; when a shared fixture depends on sibling fixtures, register the whole provider module through an exact pytest_plugins declaration rather than importing only the outer fixture. Do not create unrelated pytest scripts.",
             "This is the single pytest incremental synchronization round. The `Findings` in `reports/backend-test-pytest-collection-initial.md` are the mandatory repair checklist: resolve every repairable listed finding on every authoritative `Repair paths` file before considering any other advisory evidence, and never substitute an unrelated scenario-param cleanup for a listed correspondence/collection defect. For every assessment-listed path, compare the effective Markdown Case/Test Points/test data and its `Payload Contract`/`Payload Required Paths`/`Payload Allowed Paths`/`Payload Enum` labels with the generated module. Incrementally add or repair only missing symbols, params, assertions and payload builders. Repair every assessment-listed missing nested path, unexpected key and enum mismatch; preserve exact DTO keys, nested shapes, enum/boundary literals, operation transport and business preconditions; remove guessed replacement keys only when the effective Markdown proves the exact contract. Keep path/query/header identifiers and scenario-control metadata separate from DTO patches and JSON bodies; an `id` used for a path target must be passed to the request path/helper, never inserted into a body patch unless `id` is explicitly listed in Payload Allowed Paths. Flatten every variant into a literal direct `pytest.param(..., id=\"TP-...\")` row; replace `_post_case`/`_put_case` or other parameter-row factories because correspondence and scenario readiness require the actual row values and IDs to be statically visible. Also repair helper call sites to match their defined return signatures; do not tuple-unpack a helper that returns one scalar value.",
             "Preserve final testcase/md/** semantics, every Case ID, Rule/Test Point binding, primary symbol, parameter ID, expected status/body/schema assertion, HTTP logging, redaction and truncation behavior.",
@@ -4922,6 +5059,7 @@ async function buildBackendTestHybridDag(sources) {
         spec.backendTestSharedSetup = { ...intake.sharedSetup };
     }
     applyDefaultReadOnlyRetryPolicy(spec);
+    stampGeneratedArtifactBindings(spec);
     parseDagSpec(spec);
     assertValidDagSpec(spec);
     return spec;
@@ -5676,6 +5814,7 @@ function buildFrontendTestHybridDag(sources) {
     };
     applyFrontendTestLayoutToDagSpec(spec, layout);
     applyDefaultReadOnlyRetryPolicy(spec);
+    stampGeneratedArtifactBindings(spec);
     parseDagSpec(spec);
     assertValidDagSpec(spec);
     return spec;
@@ -6178,6 +6317,7 @@ function buildKnowledgeSyncHybridDag(sources) {
             buildKnowledgeSyncPointerNode(sources, featureId),
         ],
     };
+    stampGeneratedArtifactBindings(spec);
     parseDagSpec(spec);
     assertValidDagSpec(spec);
     return spec;
@@ -6624,6 +6764,7 @@ function buildKnowledgeGraphBootstrapHybridDag(sources) {
             buildKgBootstrapMaterializeNode(sources),
         ],
     };
+    stampGeneratedArtifactBindings(spec);
     parseDagSpec(spec);
     assertValidDagSpec(spec);
     return spec;
@@ -6721,6 +6862,8 @@ async function buildHybridDagForTemplate(sources, template, options = {}) {
     }
     else if (template === "frontend-test-dag")
         spec = buildFrontendTestHybridDag(sources);
+    else if (template === "backend-test-analysis-dag")
+        spec = buildBackendTestAnalysisHybridDag(sources);
     else if (template === "backend-test-dag")
         spec = await buildBackendTestHybridDag(sources);
     else if (template === "knowledge-sync-dag")
@@ -6757,6 +6900,7 @@ async function buildHybridDagForTemplate(sources, template, options = {}) {
         template === "supervised-implementation") {
         stampTargetTemplateTransientRetryProfile(spec);
     }
+    stampGeneratedArtifactBindings(spec);
     spec = parseDagSpec(spec);
     assertValidDagSpec(spec);
     return spec;
@@ -6764,6 +6908,7 @@ async function buildHybridDagForTemplate(sources, template, options = {}) {
 const GOVERNANCE_DISALLOWED_TEMPLATES = new Set([
     "frontend-implementation",
     "frontend-test-dag",
+    "backend-test-analysis-dag",
     "backend-test-dag",
     "knowledge-sync-dag",
     "knowledge-graph-bootstrap-dag",
@@ -7124,6 +7269,7 @@ function buildReviewGatedHybridDag(standard, sources) {
     applySddEmbeddedEnhancements(spec, sources.sddEmbeddedSkills ?? new Set());
     stampTargetTemplateTransientRetryProfile(spec);
     applyDefaultReadOnlyRetryPolicy(spec);
+    stampGeneratedArtifactBindings(spec);
     parseDagSpec(spec);
     assertValidDagSpec(spec);
     return spec;
@@ -7629,6 +7775,7 @@ async function buildSupervisedHybridDag(standard, sources) {
     applySddEmbeddedEnhancements(spec, sources.sddEmbeddedSkills ?? new Set());
     stampTargetTemplateTransientRetryProfile(spec);
     applyDefaultReadOnlyRetryPolicy(spec);
+    stampGeneratedArtifactBindings(spec);
     parseDagSpec(spec);
     assertValidDagSpec(spec);
     return spec;

package/dist/workflows/dag/node-execution.js

@@ -10,6 +10,7 @@ import { writeNodeRecord, writeNodeSkillArtifacts } from "./run-store.js";
 import { resolveContextPolicy } from "./context-policy.js";
 import { buildDagNodePromptEnvelope, formatConvergenceFeedbackBlock, } from "./prompt.js";
 import { persistLongNodeOutputArtifacts } from "./upstream-artifacts.js";
+import { materializeDeclaredArtifactFacts } from "./artifact-bindings.js";
 import { buildOutputLimitRecoverySection, loadBackendTestWriterProgressForRetry, } from "./backend-test-writer-completeness.js";
 import { computeBackoffDelayMs, isCanonicalFinalVerifyShellRetryCandidate, isRetryablePiFailureCategory, isSafeReadOnlyPiRetryCandidate, isTargetTemplateTransientRetryNode, isWriterEmptyDiffRetryCandidate, isWriterTransportRetryCandidate, VERIFY_SHELL_RETRY_POLICY, } from "./retry-policy.js";
 import { applyNodeActivity, evaluateNodeLiveness, resolveLivenessPolicy, } from "./liveness-policy.js";
@@ -42,7 +43,11 @@ function canonicalApprovalJson(value) {
 export function parseAndValidateFinalWriteSetApproval(input) {
     const binding = input.task.finalWriteSetApproval;
     if (!binding) {
-        return { ok: false, reason: "missing final write-set approval binding", approvalSourceNodeId: "(missing)" };
+        return {
+            ok: false,
+            reason: "missing final write-set approval binding",
+            approvalSourceNodeId: "(missing)",
+        };
     }
     const source = input.state.nodes[binding.approvalSourceNodeId];
     if (source?.status !== "FINISHED" || parseProcessVerdict(source) !== "pass") {
@@ -53,20 +58,44 @@ export function parseAndValidateFinalWriteSetApproval(input) {
         };
     }
     const raw = canonicalNodeOutput(source);
-    const blocks = [...raw.matchAll(/```FINAL_WRITE_SET_APPROVAL_JSON\s*\r?\n([\s\S]*?)\r?\n```/g)];
+    const blocks = [
+        ...raw.matchAll(/```FINAL_WRITE_SET_APPROVAL_JSON\s*\r?\n([\s\S]*?)\r?\n```/g),
+    ];
     if (blocks.length !== 1) {
-        return { ok: false, reason: `expected exactly one FINAL_WRITE_SET_APPROVAL_JSON block, found ${blocks.length}`, approvalSourceNodeId: binding.approvalSourceNodeId };
+        return {
+            ok: false,
+            reason: `expected exactly one FINAL_WRITE_SET_APPROVAL_JSON block, found ${blocks.length}`,
+            approvalSourceNodeId: binding.approvalSourceNodeId,
+        };
     }
     let approval;
     try {
         approval = JSON.parse(blocks[0][1]);
     }
     catch {
-        return { ok: false, reason: "final write-set approval is not valid JSON", approvalSourceNodeId: binding.approvalSourceNodeId };
+        return {
+            ok: false,
+            reason: "final write-set approval is not valid JSON",
+            approvalSourceNodeId: binding.approvalSourceNodeId,
+        };
     }
-    const required = ["schemaVersion", "writerNodeId", "approvalSourceNodeId", "auditedPlanNodeId", "approvedWriteSet", "taskContractSha256", "auditedPlanSha256", "approvalDigest"];
-    if (Object.keys(approval).length !== required.length || required.some((key) => !(key in approval))) {
-        return { ok: false, reason: "final write-set approval has an invalid schema", approvalSourceNodeId: binding.approvalSourceNodeId };
+    const required = [
+        "schemaVersion",
+        "writerNodeId",
+        "approvalSourceNodeId",
+        "auditedPlanNodeId",
+        "approvedWriteSet",
+        "taskContractSha256",
+        "auditedPlanSha256",
+        "approvalDigest",
+    ];
+    if (Object.keys(approval).length !== required.length ||
+        required.some((key) => !(key in approval))) {
+        return {
+            ok: false,
+            reason: "final write-set approval has an invalid schema",
+            approvalSourceNodeId: binding.approvalSourceNodeId,
+        };
     }
     const approved = approval.approvedWriteSet;
     if (approval.schemaVersion !== 1 ||
@@ -79,12 +108,20 @@ export function parseAndValidateFinalWriteSetApproval(input) {
         typeof approval.taskContractSha256 !== "string" ||
         typeof approval.auditedPlanSha256 !== "string" ||
         typeof approval.approvalDigest !== "string") {
-        return { ok: false, reason: "final write-set approval binding or field types are invalid", approvalSourceNodeId: binding.approvalSourceNodeId };
+        return {
+            ok: false,
+            reason: "final write-set approval binding or field types are invalid",
+            approvalSourceNodeId: binding.approvalSourceNodeId,
+        };
     }
     if (!/^[a-f0-9]{64}$/.test(approval.taskContractSha256) ||
         !/^[a-f0-9]{64}$/.test(approval.auditedPlanSha256) ||
         !/^[a-f0-9]{64}$/.test(approval.approvalDigest)) {
-        return { ok: false, reason: "final write-set approval digest fields are invalid", approvalSourceNodeId: binding.approvalSourceNodeId };
+        return {
+            ok: false,
+            reason: "final write-set approval digest fields are invalid",
+            approvalSourceNodeId: binding.approvalSourceNodeId,
+        };
     }
     const canonicalPayload = { ...approval };
     delete canonicalPayload.approvalDigest;
@@ -92,33 +129,70 @@ export function parseAndValidateFinalWriteSetApproval(input) {
         .update(canonicalApprovalJson(canonicalPayload))
         .digest("hex");
     if (approval.approvalDigest !== expectedDigest) {
-        return { ok: false, reason: "final write-set approval digest mismatch", approvalSourceNodeId: binding.approvalSourceNodeId };
+        return {
+            ok: false,
+            reason: "final write-set approval digest mismatch",
+            approvalSourceNodeId: binding.approvalSourceNodeId,
+        };
     }
     const expectedTaskDigest = input.spec.taskContractBinding?.canonicalHash;
     const plan = input.state.nodes[binding.auditedPlanNodeId];
     const expectedPlanDigest = createHash("sha256")
         .update(canonicalNodeOutput(plan))
         .digest("hex");
-    if (!expectedTaskDigest || approval.taskContractSha256 !== expectedTaskDigest || approval.auditedPlanSha256 !== expectedPlanDigest) {
-        return { ok: false, reason: "final write-set approval is stale for the task contract or audited plan", approvalSourceNodeId: binding.approvalSourceNodeId };
+    if (!expectedTaskDigest ||
+        approval.taskContractSha256 !== expectedTaskDigest ||
+        approval.auditedPlanSha256 !== expectedPlanDigest) {
+        return {
+            ok: false,
+            reason: "final write-set approval is stale for the task contract or audited plan",
+            approvalSourceNodeId: binding.approvalSourceNodeId,
+        };
     }
     const effectiveWriteSet = approved;
-    if (effectiveWriteSet.length === 0 || new Set(effectiveWriteSet).size !== effectiveWriteSet.length) {
-        return { ok: false, reason: "final write-set approval must contain a non-empty ordered unique path set", approvalSourceNodeId: binding.approvalSourceNodeId };
+    if (effectiveWriteSet.length === 0 ||
+        new Set(effectiveWriteSet).size !== effectiveWriteSet.length) {
+        return {
+            ok: false,
+            reason: "final write-set approval must contain a non-empty ordered unique path set",
+            approvalSourceNodeId: binding.approvalSourceNodeId,
+        };
     }
     for (const entry of effectiveWriteSet) {
         const normalized = entry.replace(/\\/g, "/").replace(/^\.\//, "");
-        if (!normalized || normalized === "." || normalized === ".." || normalized.includes("*") || normalized.includes("?") || normalized.includes("REPLACE/") || normalized.includes("PLACEHOLDER")) {
-            return { ok: false, reason: `final write-set approval contains a broad or placeholder path: ${entry}`, approvalSourceNodeId: binding.approvalSourceNodeId };
+        if (!normalized ||
+            normalized === "." ||
+            normalized === ".." ||
+            normalized.includes("*") ||
+            normalized.includes("?") ||
+            normalized.includes("REPLACE/") ||
+            normalized.includes("PLACEHOLDER")) {
+            return {
+                ok: false,
+                reason: `final write-set approval contains a broad or placeholder path: ${entry}`,
+                approvalSourceNodeId: binding.approvalSourceNodeId,
+            };
         }
         if (!input.task.allowedPaths.some((allowed) => pathMatchesPattern(normalized, allowed))) {
-            return { ok: false, reason: `final write-set approval exceeds allowedPaths: ${entry}`, approvalSourceNodeId: binding.approvalSourceNodeId };
+            return {
+                ok: false,
+                reason: `final write-set approval exceeds allowedPaths: ${entry}`,
+                approvalSourceNodeId: binding.approvalSourceNodeId,
+            };
         }
         if (input.task.forbiddenPaths.some((forbidden) => pathMatchesPattern(normalized, forbidden))) {
-            return { ok: false, reason: `final write-set approval overlaps forbiddenPaths: ${entry}`, approvalSourceNodeId: binding.approvalSourceNodeId };
+            return {
+                ok: false,
+                reason: `final write-set approval overlaps forbiddenPaths: ${entry}`,
+                approvalSourceNodeId: binding.approvalSourceNodeId,
+            };
         }
     }
-    return { ok: true, effectiveWriteSet, approvalDigest: approval.approvalDigest };
+    return {
+        ok: true,
+        effectiveWriteSet,
+        approvalDigest: approval.approvalDigest,
+    };
 }
 export function buildNodePrompt(spec, task, upstream, options) {
     const policy = resolveContextPolicy(spec);
@@ -126,6 +200,7 @@ export function buildNodePrompt(spec, task, upstream, options) {
         spec,
         task,
         upstream,
+        runDir: options?.runDir,
         resolvedSkills: policy.resolveSkills(spec, task),
         maxUpstreamChars: policy.resolveMaxUpstreamChars(task),
         projectGovernanceContext: options?.projectGovernanceContext,
@@ -314,10 +389,7 @@ function promptRestartCandidateForAttempt(input) {
     }
     const appendedPrefix = `${input.baseRuntimePrompt}\n\n`;
     if (input.attemptPrompt.startsWith(appendedPrefix)) {
-        return [
-            input.taskPrompt,
-            input.attemptPrompt.slice(appendedPrefix.length),
-        ]
+        return [input.taskPrompt, input.attemptPrompt.slice(appendedPrefix.length)]
             .filter(Boolean)
             .join("\n\n");
     }
@@ -353,6 +425,7 @@ export async function buildNodePromptWithResolvedSkillInstructions(spec, task, u
             spec,
             task,
             upstream,
+            runDir: options?.runDir,
             resolvedSkills: skillNames,
             resolvedSkillInstructions,
             maxUpstreamChars: policy.resolveMaxUpstreamChars(task),
@@ -533,7 +606,11 @@ export async function executeDagNode(input) {
         await notifyNodeObserver(input.observer, "onNodeFinish", nodeId, state);
     };
     if (task.finalWriteSetApproval) {
-        const authorization = parseAndValidateFinalWriteSetApproval({ task, spec, state });
+        const authorization = parseAndValidateFinalWriteSetApproval({
+            task,
+            spec,
+            state,
+        });
         if (!authorization.ok) {
             node.runtimeWriteAuthorization = {
                 schemaVersion: 1,
@@ -622,6 +699,7 @@ export async function executeDagNode(input) {
                     spec,
                     task,
                     upstream: state.nodes,
+                    runDir,
                     snapshot: skillSnapshot,
                     projectGovernanceContext,
                 });
@@ -712,6 +790,7 @@ export async function executeDagNode(input) {
         else {
             ({ prompt, resolvedSkills } =
                 await buildNodePromptWithResolvedSkillInstructions(spec, task, state.nodes, cwd, {
+                    runDir,
                     projectGovernanceContext,
                     convergenceFeedback: deriveConvergenceFeedback(state),
                 }));
@@ -875,6 +954,7 @@ export async function executeDagNode(input) {
                 model,
                 ...(thinking ? { thinking } : {}),
                 prompt: attemptPrompt,
+                resolvedSkills: resolvedSkills.map((skill) => skill.name),
                 attempt: attemptNumber,
                 reportActivity,
                 timeoutMs: livenessPolicy.absoluteMaxWallClockMs,
@@ -912,9 +992,7 @@ export async function executeDagNode(input) {
                         ...result,
                         ok: false,
                         failureCategory: GOVERNANCE_BLOCKED_CATEGORY,
-                        stderr: [result.stderr, audit.reason]
-                            .filter(Boolean)
-                            .join("\n"),
+                        stderr: [result.stderr, audit.reason].filter(Boolean).join("\n"),
                     };
                 }
             }
@@ -1237,6 +1315,13 @@ export async function executeDagNode(input) {
             node.structuredArtifactSha256 = pendingStructuredArtifact.sha256;
             node.structuredArtifactSchemaId = pendingStructuredArtifact.schemaId;
         }
+        if ((task.producesArtifacts?.length ?? 0) > 0) {
+            node.declaredArtifacts = await materializeDeclaredArtifactFacts({
+                runDir,
+                task,
+                node,
+            });
+        }
     }
     const finishedAt = new Date().toISOString();
     node.finishedAt = finishedAt;

package/dist/workflows/dag/path-safety.js

@@ -0,0 +1 @@
+export { assertReadableRegularFile, assertRealPathInsideBoundary, readFileBoundarySafe, } from "../../shared/path-safety.js";