@tea-agent/loop-agent 0.10.0 → 0.11.0

package/dist/commands/instructions.js

@@ -153,23 +153,20 @@ export async function buildInstructions(repoRoot, stage, taskId) {
             ],
         }));
     }
-    const artifactSteps = [
-        "analyze",
-        "plan",
-        "implement",
-        "verify",
-        "retrospective",
-    ];
     return refreshInstructionBlockers(withMissingDependencies({
         ...base,
         outputPath: path.join(taskDir, "artifacts"),
         dependencies: [paths.taskConfigPath, paths.statePath],
         template: {
-            requiredHeadings: artifactSteps.map((step) => getArtifactRelativePath(step)),
+            requiredHeadings: [
+                getArtifactRelativePath("implement"),
+                getArtifactRelativePath("verify"),
+            ],
         },
         completionCriteria: [
-            "artifact content is substantive and not the new-task template",
-            "verification artifact names exact commands and pass/fail results",
+            "修改记录.md and 验证结果.md are promote-run bridge artifacts filled from completed DAG/one-shot evidence",
+            "do not hand-write L1 分析报告/实现计划/复盘报告; those are not seeded or required",
+            "verification artifact summarizes available completed-run evidence; inspect the run facts for exact shell commands and full output",
         ],
     }));
 }

package/dist/commands/loop.js

@@ -7,10 +7,9 @@ function usage() {
         "  loop status <task-id> [--json]",
         "  loop run <task-id> --action shell-verify [--command <cmd>]... [--timeout-ms N] [--cwd <repo-relative-dir>]",
         "  loop run <task-id> --action pi-review [--provider <id>] [--model <id>] [--timeout-ms N] [--cwd <repo-relative-dir>]",
-        "  loop run <task-id> --action cursor-fix [--model <id>] [--timeout-ms N] [--cwd <repo-relative-dir>]",
-        "  loop run <task-id> --action dag [--execute] [--dag <path>] [--run-id <id>] [--max-concurrent N] [--cwd <repo-relative-dir>] [--no-cursor]",
+        "  loop run <task-id> --action dag [--execute] [--dag <path>] [--run-id <id>] [--max-concurrent N] [--cwd <repo-relative-dir>]",
         "  loop run <task-id> --action workflow [--profile pr-review|--workflow <path>] [--execute] [--run-id <id>] [--changed-file <path>]... [--cwd <repo-relative-dir>]",
-        "  loop run <task-id> --auto [--max-rounds N] [--allow-cursor-fix]",
+        "  loop run <task-id> --auto [--max-rounds N] [--approval-granted]",
         "  loop record-round <task-id> --action <name> --result <summary> --lesson <summary> --next <summary> --decision <continue|pause|blocked|complete> [--verification <summary>] [--failure-category <category>] [--ref <path>]...",
         "  loop add-signal <task-id> --type <human_followup|approval|scope_changed|review_feedback> --message <text> [--urgent] [--ref <path>]...",
         "  loop closeout <task-id>",
@@ -144,7 +143,7 @@ export async function runLoop(repoRoot, args) {
             }
             const record = await runLoopAuto(repoRoot, taskId, {
                 maxRounds,
-                allowCursorFix: rest.includes("--allow-cursor-fix"),
+                approvalGranted: rest.includes("--approval-granted"),
             });
             console.log(JSON.stringify(record, null, 2));
             return;
@@ -174,20 +173,6 @@ export async function runLoop(repoRoot, args) {
             console.log(JSON.stringify(record, null, 2));
             return;
         }
-        if (action === "cursor-fix") {
-            const record = await runLoopAction({
-                action,
-                repoRoot,
-                taskId,
-                options: {
-                    timeoutMs,
-                    cwd: readFlag(rest, "--cwd"),
-                    model: readFlag(rest, "--model"),
-                },
-            });
-            console.log(JSON.stringify(record, null, 2));
-            return;
-        }
         if (action === "dag") {
             const maxConcurrentRaw = readFlag(rest, "--max-concurrent");
             let maxConcurrent;
@@ -208,7 +193,6 @@ export async function runLoop(repoRoot, args) {
                     dagPath: readFlag(rest, "--dag"),
                     runId: readFlag(rest, "--run-id"),
                     maxConcurrent,
-                    noCursor: rest.includes("--no-cursor"),
                 },
             });
             console.log(JSON.stringify(record, null, 2));
@@ -248,7 +232,7 @@ export async function runLoop(repoRoot, args) {
             return;
         }
         if (action !== "shell-verify") {
-            throw new Error("loop run currently supports --action shell-verify|pi-review|cursor-fix|dag|workflow");
+            throw new Error("loop run currently supports --action shell-verify|pi-review|dag|workflow");
         }
         const record = await runLoopAction({
             action: "shell-verify",

package/dist/commands/plan.js

@@ -0,0 +1,50 @@
+import { checkExecPlanIndex, completeExecPlan, createExecPlan, } from "../governance/exec-plans.js";
+import { repoRelativePath } from "../shared/path-refs.js";
+/**
+ * Create an active exec-plan and sync the active index.
+ *
+ * Usage: `loop-agent plan create <plan-id> "<title>"`
+ */
+export async function runPlanCreate(repoRoot, planId, title) {
+    const result = await createExecPlan(repoRoot, planId, title);
+    console.log(JSON.stringify({
+        planId: result.planId,
+        status: result.status,
+        created: repoRelativePath(repoRoot, result.planPath),
+    }, null, 2));
+}
+/**
+ * Move an active exec-plan to completed and sync both indexes.
+ *
+ * Usage: `loop-agent plan complete <plan-id> --summary "<summary>"`
+ */
+export async function runPlanComplete(repoRoot, planId, options) {
+    const result = await completeExecPlan(repoRoot, planId, options);
+    console.log(JSON.stringify({
+        planId: result.planId,
+        status: result.status,
+        from: repoRelativePath(repoRoot, result.fromPath),
+        to: repoRelativePath(repoRoot, result.toPath),
+        activeIndex: repoRelativePath(repoRoot, result.activeIndex),
+        completedIndex: repoRelativePath(repoRoot, result.completedIndex),
+    }, null, 2));
+}
+/**
+ * Check exec-plan index consistency and print the result as JSON.
+ *
+ * Usage: `loop-agent plan check`
+ */
+export async function runPlanCheck(repoRoot) {
+    const result = await checkExecPlanIndex(repoRoot);
+    console.log(JSON.stringify({
+        ok: result.ok,
+        issues: result.issues,
+        activeFiles: result.activeFiles,
+        completedFiles: result.completedFiles,
+    }, null, 2));
+    if (!result.ok) {
+        throw new Error(`exec-plan index check failed (${result.issues.length} issue(s)): ${result.issues
+            .map((issue) => issue.message)
+            .join("; ")}`);
+    }
+}

package/dist/executors/config-core.js

@@ -1,56 +1,5 @@
-import { DEFAULT_CURSOR_MODEL } from './cursor-executor.js';
-import { resolveExecutorModelMatrix } from './model-routing.js';
 export const TASK_COMPLEXITY_TO_DAG = {
     small: 'LOW',
     medium: 'MED',
     large: 'HIGH',
 };
-export function resolveCursorModel(overrides = {}, cursorConfig) {
-    return overrides.taskModel ?? cursorConfig?.defaultModel ?? DEFAULT_CURSOR_MODEL;
-}
-export function resolveCursorModelForTaskConfig(taskConfig, cursorConfig) {
-    if (taskConfig.cursorModel?.trim()) {
-        return taskConfig.cursorModel.trim();
-    }
-    const dagLevel = TASK_COMPLEXITY_TO_DAG[taskConfig.complexity ?? 'medium'];
-    const matrix = resolveExecutorModelMatrix('cursor', cursorConfig);
-    return matrix[dagLevel] ?? resolveCursorModel({}, cursorConfig);
-}
-export function resolveTaskExecutor(taskConfig, override) {
-    if (override)
-        return override;
-    return taskConfig.executor ?? 'pi';
-}
-export function resolveCursorExecutorConfig(manifest) {
-    const config = manifest.executors?.cursor;
-    if (config?.enabled === false)
-        return undefined;
-    return config;
-}
-export function assertCursorExecutorAvailable(manifest) {
-    const config = resolveCursorExecutorConfig(manifest);
-    if (!config) {
-        throw new Error('cursor executor is not registered in harness.json executors.cursor');
-    }
-    return config;
-}
-export function validateCursorTaskPreflight(taskConfig) {
-    if (taskConfig.executor !== 'cursor')
-        return;
-    const allowed = taskConfig.allowedPaths ?? [];
-    if (allowed.length === 0) {
-        // Read-only analysis tasks may omit allowedPaths; write tasks must declare scope explicitly.
-        return;
-    }
-}
-export function assertCursorWriteTaskScope(taskConfig, changedPaths) {
-    if (taskConfig.executor !== 'cursor')
-        return;
-    if ((taskConfig.allowedPaths ?? []).length > 0)
-        return;
-    const codeChanges = changedPaths.filter((filePath) => !filePath.startsWith('.harness/tasks/'));
-    if (codeChanges.length > 0) {
-        throw new Error('cursor write task refused: allowedPaths is empty but git diff contains code changes. ' +
-            'Declare allowedPaths explicitly or keep the task read-only.');
-    }
-}

package/dist/executors/dag-pi-executor.js

@@ -1,7 +1,7 @@
 import path from "node:path";
 import { writeTextArtifactFile } from "../infrastructure/harness/artifact-store.js";
 import { executePiStep, } from "./pi-executor.js";
-import { redactPromptForLog, truncateOutput } from "./cursor-executor.js";
+import { redactPromptForLog, truncateOutput, } from "../shared/output-truncation.js";
 import { readGitStatusPorcelain, runPostRunWriteGuard, } from "./shell-write-guard.js";
 export const DAG_PI_READONLY_TOOLS = ["read", "grep", "find", "ls"];
 export const DAG_PI_WRITE_TOOLS = [

package/dist/executors/dag.js

@@ -1,4 +1,3 @@
-export * from "./dag-cursor-executor.js";
 export * from "../workflows/dag/executor-registry.js";
 export * from "./dag-pi-executor.js";
 export * from "./dag-static-executor.js";

package/dist/executors/index.js

@@ -1,7 +1,5 @@
 export * from "./pi.js";
 export * from "./pi-sdk.js";
-export * from "./cursor.js";
-export * from "./cursor-worker.js";
 export * from "./shell.js";
 export * from "./static.js";
 export * from "./dag.js";

package/dist/executors/model-routing.js

@@ -1,22 +1,20 @@
 import { DEFAULT_DAG_EXECUTOR_MODELS, } from '../workflows/dag/types.js';
-export const DEFAULT_DAG_CURSOR_MODEL = "composer-2.5";
 export const DEFAULT_DAG_MODELS = {
     HIGH: "gpt-5.5",
-    MED: "composer-2.5",
-    LOW: "composer-2.5",
+    MED: "glm-5.2",
+    LOW: "gpt-5.3-codex-spark",
 };
 /**
  * DAG executor model tier keys that may carry a per-complexity override.
  */
 const EXECUTOR_MODEL_TIERS = ["LOW", "MED", "HIGH"];
 /**
- * Resolve the DAG executor model matrix for a single executor from its harness
- * `executors.<name>` config.
+ * Resolve the DAG executor model matrix for Pi from harness `executors.pi`.
  *
  * Priority per tier (LOW/MED/HIGH):
  *   1. execConfig[tier]  (truthy and !== "default" sentinel)
  *   2. execConfig.defaultModel (truthy and !== "default" sentinel)
- *   3. DEFAULT_DAG_EXECUTOR_MODELS[executor][tier]
+ *   3. DEFAULT_DAG_EXECUTOR_MODELS.pi[tier]
  *
  * The "default" literal (injected by the schema `.default("default")`) and
  * absent/undefined both mean "no override, fall through".
@@ -38,15 +36,17 @@ export function resolveExecutorModelMatrix(executor, execConfig) {
     };
 }
 /**
- * Resolve both pi and cursor DAG executor model matrices from a harness manifest.
- * Single entry point for DAG generation and --strict-models baseline resolution.
+ * Resolve the Pi DAG executor model matrix from a harness manifest.
  */
 export function resolveExecutorModelMatrices(manifest) {
     return {
         pi: resolveExecutorModelMatrix("pi", manifest.executors?.pi),
-        cursor: resolveExecutorModelMatrix("cursor", manifest.executors?.cursor),
     };
 }
+/** @deprecated Prefer resolveExecutorModelMatrices; alias kept for call-site clarity. */
+export function resolvePiModelMatrix(manifest) {
+    return resolveExecutorModelMatrices(manifest).pi;
+}
 export function resolveModelSelection(manifest, taskConfig, step, options) {
     const retryAttempt = options?.retryAttempt ?? 0;
     if (Object.keys(manifest.modelProfiles ?? {}).length === 0) {

package/dist/executors/shell-executor.js

@@ -2,7 +2,7 @@ import { spawn } from "node:child_process";
 import { appendFileSync, existsSync, mkdirSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { writeDagNodeTextArtifact } from "../infrastructure/harness/artifact-store.js";
-import { truncateOutput } from "./cursor-executor.js";
+import { truncateOutput } from "../shared/output-truncation.js";
 import { expandShellPreset, buildVerdictGateShellCommand } from "./shell-presets.js";
 import { pathsChangedDuringRun, snapshotGitStatusPorcelain, validateShellWriteGuard, } from "./shell-write-guard.js";
 import { buildShellProcessEnv } from "./shell-verification.js";

package/dist/governance/checks.js

@@ -3,7 +3,7 @@ import path from 'node:path';
 import { repoRelativePath } from '../shared/path-refs.js';
 import { loadHarnessManifest } from './harness.js';
 import { auditLoopAgentSkillSafety } from './skill-safety.js';
-import { getTaskPaths, getTaskStatus, loadTaskConfig, shouldRunRetrospective } from '../task/runtime.js';
+import { getTaskPaths, getTaskStatus, loadTaskConfig } from '../task/runtime.js';
 import { buildTaskReadModel } from '../task/read-model.js';
 const SKIP_DIRS = new Set([
     '.git',
@@ -244,12 +244,15 @@ export async function checkTaskHandoff(repoRoot, taskId) {
                     message: '任务已 completed，但验证工件未标记完成',
                 });
             }
-            if (state.status === 'completed' && shouldRunRetrospective(taskConfig) && !state.artifacts.retrospective) {
+            // Standard DAG tasks do not require a retrospective artifact. Preserve an
+            // explicit legacy task contract, however, so historical tasks that opted
+            // into requireRetrospective do not silently lose their handoff warning.
+            if (state.status === 'completed' && taskConfig.requireRetrospective && !state.artifacts.retrospective) {
                 issues.push({
                     type: 'missing-retrospective-artifact',
                     severity: 'warning',
                     file: toRepoRelative(repoRoot, path.join(taskPaths.taskDir, 'artifacts', '复盘报告.md')),
-                    message: '任务应包含 retrospective，但复盘工件未完成',
+                    message: '任务显式要求 retrospective，但复盘工件未完成',
                 });
             }
             if (readModel.promotion.required && !readModel.promotion.ready) {