@tea-agent/loop-agent 0.39.0-next.9 → 0.39.1

package/dist/application/dag/generate-task-dag.js

@@ -279,6 +279,7 @@ export async function generateTaskDagUseCase(input) {
     const candidateResult = await initHybridDagFromTask(repoRoot, parsed.taskId, {
         outputPath: parsed.outputPath,
         template: "standard-dag",
+        rerunFeedback: parsed.rerunFeedback,
     });
     const candidateValidateSummary = await validateDagUseCase(buildValidateInput(repoRoot, candidateResult.outputPath, parsed));
     const profileRouting = await resolveProfileRouting(repoRoot, parsed, candidateValidateSummary.governanceProfile ?? {
@@ -324,8 +325,16 @@ export async function generateTaskDagUseCase(input) {
         : await initHybridDagFromTask(repoRoot, parsed.taskId, {
             outputPath: parsed.outputPath,
             template: profileRouting.selectedTemplate,
+            rerunFeedback: parsed.rerunFeedback,
         });
     const outputPath = initResult.outputPath;
+    if (parsed.expectedRerunFeedbackDigest) {
+        const generatedSpec = parseDagSpec(JSON.parse(await readFile(outputPath, "utf8")));
+        if (generatedSpec.rerunFeedback?.digest !==
+            parsed.expectedRerunFeedbackDigest) {
+            throw new Error(`rerun feedback drift: expected ${parsed.expectedRerunFeedbackDigest}, got ${generatedSpec.rerunFeedback?.digest ?? "missing"}`);
+        }
+    }
     const validateSummary = profileRouting.selectedTemplate === candidateResult.template
         ? candidateValidateSummary
         : await validateDagUseCase(buildValidateInput(repoRoot, outputPath, parsed));

package/dist/application/task-lifecycle/advance.js

@@ -3,6 +3,7 @@ import path from "node:path";
 import { createTask, getTaskPaths, loadTaskConfig, } from "../../task/runtime.js";
 import { importPrdDocument } from "../../task/source-references.js";
 import { prepareTaskSource } from "../../task/source-prepare/index.js";
+import { resolveProductionSourceFidelityPi } from "../../task/source-prepare/source-fidelity-pi.js";
 import { isIntakeSoftGapCode, resolvePrdImportRole, } from "../../task/source-prepare/artifact-meta.js";
 import { sanitizeDraftPlaceholders } from "../../task/source-prepare/placeholder-paths.js";
 import { evaluateSemanticIntakeEligibility, isSemanticIntakeDisabled, readSemanticIntakeAttempted, runSemanticIntake, } from "../../task/source-prepare/semantic-intake.js";
@@ -38,6 +39,7 @@ function hasEngineeringBoundary(input) {
     return Boolean((input.allowedPaths && input.allowedPaths.length > 0) ||
         (input.forbiddenPaths && input.forbiddenPaths.length > 0) ||
         (input.verifyCommands && input.verifyCommands.length > 0) ||
+        input.backendTest !== undefined ||
         input.fromText ||
         input.fromDraftPath);
 }
@@ -584,6 +586,15 @@ export async function advanceTaskLifecycle(input) {
             continue;
         }
         if (action.type === "prepare-contract") {
+            // 生产 source fidelity Pi 接线（AC-PROD-001/005）：仅 frontend-implementation
+            // 任务注入 reconcile executor + 独立 reviewer；ineligible 返回 undefined 不接线。
+            // 主路径与 semantic-intake retry 路径共用同一接线，保证任意一条生产路径都实际
+            // 触发 reconciliation executor（修复前两处均缺省导致生产路径从不调用 Pi）。
+            const sourceFidelity = await resolveProductionSourceFidelityPi({
+                repoRoot: input.repoRoot,
+                taskId: input.taskId,
+                taskKind: input.taskKind,
+            });
             let draftIntent = null;
             if (input.fromDraftPath) {
                 try {
@@ -632,7 +643,9 @@ export async function advanceTaskLifecycle(input) {
                     allowedPaths: effectiveInput.allowedPaths,
                     forbiddenPaths: input.forbiddenPaths,
                     verifyCommands: effectiveInput.verifyCommands,
+                    backendTest: input.backendTest,
                 },
+                ...(sourceFidelity ? { sourceFidelity } : {}),
             });
             if (!prepareResult.ok) {
                 const gapCodes = (prepareResult.gaps ?? [])
@@ -687,6 +700,7 @@ export async function advanceTaskLifecycle(input) {
                                 allowedPaths: effectiveInput.allowedPaths,
                                 forbiddenPaths: input.forbiddenPaths,
                                 verifyCommands: effectiveInput.verifyCommands,
+                                backendTest: input.backendTest,
                             },
                         });
                         if (semantic.ok) {
@@ -707,7 +721,9 @@ export async function advanceTaskLifecycle(input) {
                                     allowedPaths: effectiveInput.allowedPaths,
                                     forbiddenPaths: input.forbiddenPaths,
                                     verifyCommands: effectiveInput.verifyCommands,
+                                    backendTest: input.backendTest,
                                 },
+                                ...(sourceFidelity ? { sourceFidelity } : {}),
                             });
                             if (retry.ok) {
                                 warnings.push({

package/dist/build-stamp.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "version": "0.37.0",
-  "gitSha": "aaa51e1fe0a1b8731731152ae34de25ed4c8ff0d",
-  "builtAt": "2026-08-18T06:52:28.616Z"
+  "version": "0.39.1",
+  "gitSha": "0111f8b7ae21df3ec1c46c7b520d92db16cf44a6",
+  "builtAt": "2026-08-25T09:12:07.381Z"
 }

package/dist/cli/command-definitions.js

@@ -7,6 +7,7 @@ import { runCoverageReport } from "../commands/coverage-report.js";
 import { runExamples } from "../commands/examples.js";
 import { runHandoffCheck } from "../commands/handoff-check.js";
 import { runInspect } from "../commands/inspect.js";
+import { runInspectNext } from "../commands/inspect-next.js";
 import { runInstructions } from "../commands/instructions.js";
 import { runTaskAdvance } from "../commands/task-advance.js";
 import { runTaskStatus } from "../commands/task-status.js";
@@ -74,6 +75,7 @@ export function parseSummaryFlag(tokens) {
 const DOCS_SUBCOMMANDS = ["audit", "archive"];
 const INIT_SUBCOMMANDS = [
     "instructions",
+    "model-catalog",
     "doctor",
     "check-update",
     "update",
@@ -162,10 +164,19 @@ export const COMMAND_DEFINITIONS = [
         name: "inspect",
         adapter: "required",
         tier: "operator",
-        intent: "Inspect the target repo harness manifest.",
-        usage: "inspect",
-        handler: async ({ adapter, repoRoot }) => {
-            await runInspect(adapter, repoRoot);
+        intent: "Inspect the target repo harness manifest, or report the current npm next binding.",
+        usage: "inspect | inspect next [--json]",
+        subcommands: ["next"],
+        handler: async ({ adapter, repoRoot, subcommand, rest }) => {
+            if (subcommand === "next") {
+                await runInspectNext(repoRoot, rest.filter((arg) => Boolean(arg)));
+                return;
+            }
+            if (subcommand === undefined || subcommand.startsWith("-")) {
+                await runInspect(adapter, repoRoot);
+                return;
+            }
+            throw new Error("usage: inspect | inspect next [--json]");
         },
     },
     {
@@ -205,7 +216,7 @@ export const COMMAND_DEFINITIONS = [
         adapter: "none",
         tier: "primary",
         intent: "Initialize a target repository with loop-agent harness capabilities.",
-        usage: "init [instructions|doctor|check-update|update|reconcile|upgrade] [--profile full|minimal] [--merge] [--json|--markdown] [--bootstrap-surface|--apply-safe] [--client-recovery=auto|project|user|off] [--run-id <id> --status|--continue|--report]",
+        usage: "init [instructions|model-catalog|doctor|check-update|update|reconcile|upgrade] [--profile full|minimal] [--merge] [--model provider/model | --low-model provider/model --med-model provider/model --high-model provider/model] [--json|--markdown] [--bootstrap-surface|--apply-safe] [--client-recovery=auto|project|user|off] [--run-id <id> --status|--continue|--report]",
         subcommands: [...INIT_SUBCOMMANDS],
         handler: async ({ repoRoot, subcommand, rest }) => {
             await runInit(repoRoot, [subcommand, ...rest].filter(Boolean), { readRuntimeActivity: readInitRuntimeActivity });

package/dist/cli/program.js

@@ -33,6 +33,7 @@ import { runHarvest } from "../commands/harvest.js";
 import { runInit } from "../commands/init.js";
 import { readInitRuntimeActivity } from "./update/runtime-activity.js";
 import { runInspect } from "../commands/inspect.js";
+import { runInspectNext } from "../commands/inspect-next.js";
 import { runInstructions } from "../commands/instructions.js";
 import { runKnowledge } from "../commands/knowledge.js";
 import { runLoop } from "../commands/loop.js";
@@ -97,6 +98,9 @@ async function dispatchRegisteredCommand(commandObject, defaultRepoRoot, rawArgs
         [...rest, ...rawArgs].some((token) => token === "--json")) ||
         (command === "stats" &&
             subcommand === "context" &&
+            [...rest, ...rawArgs].some((token) => token === "--json")) ||
+        (command === "inspect" &&
+            subcommand === "next" &&
             [...rest, ...rawArgs].some((token) => token === "--json"));
     const repoRoot = resolveRepoRootOnly(commandObject, defaultRepoRoot, {
         quiet,
@@ -125,8 +129,15 @@ async function runTaskCommand(repoRoot, subcommand, rest) {
 async function runCommanderAction(ctx, command, subcommand, rest) {
     switch (command) {
         case "inspect":
-            await runInspect(ctx.adapter, ctx.repoRoot);
-            return;
+            if (subcommand === "next") {
+                await runInspectNext(ctx.repoRoot, rest);
+                return;
+            }
+            if (subcommand === undefined || subcommand.startsWith("-")) {
+                await runInspect(ctx.adapter, ctx.repoRoot);
+                return;
+            }
+            throw new Error("usage: inspect | inspect next [--json]");
         case "doctor":
             await runDoctor(ctx.adapter, ctx.repoRoot, compactArgs([subcommand, ...rest]));
             return;
@@ -595,6 +606,9 @@ export function buildLoopAgentProgram(options) {
                 .option("--no-merge", "skip existing files")
                 .option("--provider <provider>", "provider paired with a bare --model (otherwise use provider/model)")
                 .option("--model <model>", "qualified provider/model, or a bare model paired with --provider")
+                .option("--low-model <provider/model>", "credential-ready Pi model for LOW")
+                .option("--med-model <provider/model>", "credential-ready Pi model for MED")
+                .option("--high-model <provider/model>", "credential-ready Pi model for HIGH")
                 .option("--json", "print JSON")
                 .option("--markdown", "print Markdown")
                 .option("--bootstrap-surface", "write an inferred .harness/init-surface.json baseline")

package/dist/cli/update/notifier.js

@@ -1,6 +1,6 @@
 import { createInterface } from "node:readline/promises";
 import { evaluateLatestVersion, shouldCheckForUpdates } from "./policy.js";
-import { acquireUpdateLock, readUpdateState, updateLockPath, updateStatePath, writeUpdateState, } from "./state.js";
+import { acquireUpdateLock, readUpdateState, updateLockPath, updateStatePath, writeUpdateState, } from "../../shared/update/state.js";
 const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
 const FAILURE_COOLDOWN_MS = 10 * 60 * 1000;
 export async function runSelfUpdateNotifier(options) {
@@ -69,7 +69,7 @@ export async function runSelfUpdateNotifier(options) {
             }
             writeStderr(`loop-agent 已更新到 ${decision.targetVersion}；新版本将在下一次调用时生效。\n`);
             await safeWriteState(statePath, {
-                schemaVersion: 1,
+                ...state,
                 lastCheckedAt: now().toISOString(),
                 latestVersion: decision.targetVersion,
             });

package/dist/cli/update/runtime-activity.js

@@ -1,29 +1 @@
-import { readdir } from "node:fs/promises";
-import path from "node:path";
-import { buildGlobalSnapshot } from "../../worker/observability/read-model.js";
-/**
- * Read-only runtime guard for init-surface writes.
- *
- * DAG activeness is anchored to real directories in the canonical active
- * lifecycle root. Worker activeness reuses the Observe read model so Task Pool
- * status precedence and composite identity stay owned by the Worker adapter.
- * Projection failures block writes because liveness cannot be proven safely.
- */
-export async function readInitRuntimeActivity(repoRoot) {
-    const resolvedRoot = path.resolve(repoRoot);
-    const activeDagRoot = path.join(resolvedRoot, ".harness", "dag-runs", "active");
-    const entries = await readdir(activeDagRoot, { withFileTypes: true }).catch(() => []);
-    const activeDagRunIds = entries
-        .filter((entry) => entry.isDirectory() && entry.name !== ".gitkeep")
-        .map((entry) => entry.name)
-        .sort();
-    const snapshot = await buildGlobalSnapshot({ repoRoot: resolvedRoot });
-    return {
-        activeDagRunIds,
-        activeWorkerBatches: snapshot.health.worker.activeBatches,
-        activeWorkerTasks: snapshot.health.worker.activeTasks,
-        ...(snapshot.projectionError
-            ? { workerProjectionError: snapshot.projectionError.message }
-            : {}),
-    };
-}
+export { readInitRuntimeActivity } from "../../worker/observability/init-runtime-activity.js";

package/dist/cli.js

@@ -4,7 +4,7 @@ import os from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { buildLoopAgentProgram } from "./cli/program.js";
-import { createNpmUpdateClient } from "./cli/update/npm-client.js";
+import { createNpmUpdateClient } from "./shared/update/npm-client.js";
 import { runSelfUpdateNotifier } from "./cli/update/notifier.js";
 import { resolveInitSurfaceRepoRoot, runInitSurfaceNotifier, } from "./cli/update/init-surface-notifier.js";
 async function main() {
@@ -29,6 +29,7 @@ async function main() {
         client: createNpmUpdateClient({
             currentVersion,
             packageRoot,
+            cwd: defaultRepoRoot,
             env: process.env,
         }),
     });

package/dist/commands/dag-rerun.js

@@ -1,3 +1,5 @@
+import { readFile } from "node:fs/promises";
+import { isDagRerunPromptOverrideEnabled } from "../shared/dag-prompt-override.js";
 import { executeDagRerun, planDagRerun, } from "../workflows/dag/rerun-run.js";
 export function parseDagRerunArgs(args) {
     if (args.length === 0) {
@@ -9,6 +11,8 @@ export function parseDagRerunArgs(args) {
     let planHash;
     let requestId;
     let reason;
+    const promptOverrideSpecs = [];
+    const promptOverrideAppendSpecs = [];
     for (let index = 0; index < args.length; index += 1) {
         const arg = args[index];
         if (arg === "--run-id")
@@ -33,6 +37,14 @@ export function parseDagRerunArgs(args) {
             reason = args[++index];
         else if (arg.startsWith("--reason="))
             reason = arg.slice("--reason=".length);
+        else if (arg === "--prompt-override")
+            promptOverrideSpecs.push(args[++index] ?? "");
+        else if (arg.startsWith("--prompt-override="))
+            promptOverrideSpecs.push(arg.slice("--prompt-override=".length));
+        else if (arg === "--prompt-override-append")
+            promptOverrideAppendSpecs.push(args[++index] ?? "");
+        else if (arg.startsWith("--prompt-override-append="))
+            promptOverrideAppendSpecs.push(arg.slice("--prompt-override-append=".length));
         else if (arg === "--json")
             continue;
         else if (arg.startsWith("-"))
@@ -50,7 +62,13 @@ export function parseDagRerunArgs(args) {
         if (planHash || requestId || reason) {
             throw new Error("dag rerun --plan cannot be combined with execute flags");
         }
-        return { parentRunId, selectedNodeId, planOnly: true };
+        return {
+            parentRunId,
+            selectedNodeId,
+            planOnly: true,
+            promptOverrideSpecs,
+            promptOverrideAppendSpecs,
+        };
     }
     if (!planHash?.trim()) {
         throw new Error("dag rerun execute requires --plan-hash <hash>");
@@ -68,15 +86,50 @@ export function parseDagRerunArgs(args) {
         planHash: planHash.trim(),
         requestId: requestId.trim(),
         reason: reason.trim(),
+        promptOverrideSpecs,
+        promptOverrideAppendSpecs,
     };
 }
+async function loadPromptOverrides(specs, mode) {
+    const overrides = [];
+    for (const spec of specs) {
+        const separator = spec.indexOf("@");
+        if (separator <= 0 || separator >= spec.length - 1) {
+            throw new Error(`dag rerun --prompt-override${mode === "append" ? "-append" : ""} expects <nodeId>@<filePath>, got: ${spec}`);
+        }
+        const nodeId = spec.slice(0, separator);
+        const filePath = spec.slice(separator + 1);
+        let prompt;
+        try {
+            prompt = await readFile(filePath, "utf-8");
+        }
+        catch (error) {
+            throw new Error(`cannot read prompt override file for node ${nodeId} (${filePath}): ${error instanceof Error ? error.message : String(error)}`);
+        }
+        overrides.push(mode === "append" ? { nodeId, prompt, mode } : { nodeId, prompt });
+    }
+    return overrides;
+}
 export async function runDagRerun(repoRoot, rawArgs) {
     const parsed = parseDagRerunArgs(rawArgs);
+    let promptOverrides;
+    const hasOverrides = parsed.promptOverrideSpecs.length > 0 ||
+        parsed.promptOverrideAppendSpecs.length > 0;
+    if (hasOverrides) {
+        if (!isDagRerunPromptOverrideEnabled()) {
+            throw new Error("prompt override rerun is disabled by HARNESS_DAG_RERUN_PROMPT_OVERRIDE; unset it or use a value other than 0, false, or off to enable this experimental capability");
+        }
+        promptOverrides = [
+            ...(await loadPromptOverrides(parsed.promptOverrideSpecs, "replace")),
+            ...(await loadPromptOverrides(parsed.promptOverrideAppendSpecs, "append")),
+        ];
+    }
     if (parsed.planOnly) {
         const plan = await planDagRerun({
             cwd: repoRoot,
             parentRunId: parsed.parentRunId,
             selectedNodeId: parsed.selectedNodeId,
+            promptOverrides,
         });
         const result = {
             ok: plan.eligible,
@@ -95,6 +148,7 @@ export async function runDagRerun(repoRoot, rawArgs) {
         planHash: parsed.planHash,
         requestId: parsed.requestId,
         reason: parsed.reason,
+        promptOverrides,
     });
     console.log(JSON.stringify(result, null, 2));
     if (!result.ok) {