@tea-agent/loop-agent 0.24.3 → 0.24.4

package/AGENTS.md

@@ -64,13 +64,21 @@
 
 ## 验证
 
-权威源：`docs/governance/verification-matrix.md`。常用：
+权威源：`docs/governance/verification-matrix.md`。
+
+默认节奏：编辑中只跑矩阵「最低验证」（typecheck + 定向 Vitest）；`git commit` 的 `pre-commit` 只做 `check-repo`；`git push` 的 `pre-push` 跑 `bash scripts/ci.sh`（全量 typecheck + `npm test`）。每个 clone 安装一次 hooks：`bash scripts/install-git-hooks.sh`。
+
+常用：
 
 ```bash
-npm run typecheck && npm test && npm run build
-node bin/loop-agent.js --help
-bash scripts/check-repo.sh
+# 编辑中
+npm run typecheck
+npx vitest run <相关测试路径>
+
+# push / 交付前（或依赖 pre-push）
 bash scripts/ci.sh
+npm run build
+node bin/loop-agent.js --help
 ```
 
 文档站变更：`npm run docs:build`。init / architecture / skill entry / pack 定向验证见 verification-matrix。

package/CHANGELOG.md

@@ -2,14 +2,29 @@
 
 ## [Unreleased]
 
-## [0.24.3] - 2026-07-28
+## [0.24.4] - 2026-07-28
 
 ### 重点更新
 
-- 发布工作流改为发布已通过完整门禁并经 SHA-256 校验的 npm tarball，避免 `npm publish` 再次触发全量测试、类型检查与构建。
+- 控制台「导入需求」支持多文件批量导入，自动合成可编辑正文后创建任务
+- 后端测试移除重复运行稳定性门槛，每次执行同时生成用户可读的 HTML 与 Markdown 报告
+- 本地 pre-push 钩子升级为执行完整 CI 流程，覆盖治理检查、类型检查与全量测试
+
+### 新增
+
+- 控制台「导入需求」支持选择或拖入一份或多份 Markdown/TXT 文档（严格 UTF-8，单文件 ≤8 MiB，最多 8 个），多文件分卷归档并合成可编辑正文后创建任务
 
 ### 改进
 
+- 后端测试 L-5 结论不再将重复运行稳定性作为门槛，每次执行同时产出用户可读的 HTML 与 Markdown 报告，内部 facts 文件保留用于审计
+- 本地 pre-push 钩子改为执行完整 CI 流程（治理检查 + 类型检查 + 全量测试），pre-commit 保持仅执行 check-repo
+- harness 中等复杂度（MED）模型调整为 grok-4.5，并同步对齐相关 smoke/init 断言
+- 归档已完成的设计文档与执行计划，刷新 0.24.x 六个月规划与能力摘要，并同步验证与 hooks 文档
+
+## [0.24.3] - 2026-07-28
+
+### 重点更新
+
 - 发布工作流改为发布已通过完整门禁并经 SHA-256 校验的 npm tarball，避免 `npm publish` 再次触发全量测试、类型检查与构建。
 
 ## [0.24.2] - 2026-07-28

package/dist/worker/console/operator-actions.js

@@ -1490,9 +1490,14 @@ async function allocateUniqueTaskId(repoRoot, preferredId) {
 }
 async function dispatchBootstrapFromPrd(ctx, p) {
     const content = str(p.content) ?? str(p.fileText);
-    if (!content) {
+    if (!content?.trim()) {
         return invalid("bootstrapFromPrd", "content is required");
     }
+    const parsedDocs = parseBootstrapDocuments(p.documents);
+    if (!parsedDocs.ok) {
+        return invalid("bootstrapFromPrd", parsedDocs.message);
+    }
+    const documents = parsedDocs.documents;
     const taskKind = normalizeConsoleWorkflowKind(str(p.taskKind), "standard");
     const identity = deriveTaskIdentityFromPrd(content);
     let taskId;
@@ -1539,28 +1544,86 @@ async function dispatchBootstrapFromPrd(ctx, p) {
             }),
         };
     }
-    const staged = await stageUtf8Text(ctx.appData, content, {
-        extension: ".md",
-    });
-    const imported = await run(["import-prd", taskId, "--file", staged.path, "--json"], {
-        cwd: ctx.repoRoot,
-        artifactName: "bootstrap-import-prd",
-        expectJson: true,
-        timeoutMs: 60_000,
-    });
-    if (!imported.ok || imported.exitCode !== 0) {
-        return {
-            kind: "error",
-            status: 400,
-            body: operatorFailed({
-                command: "bootstrapFromPrd",
-                outcome: "rejected",
-                code: "INTERNAL_ERROR",
-                message: imported.stderr?.trim() ||
-                    `import-prd failed with exit ${imported.exitCode}`,
-                details: { exitCode: imported.exitCode, taskId },
-            }),
-        };
+    const succeededImports = [];
+    const importResults = [];
+    const runImportPrd = async (label, text, name) => {
+        const staged = await stageUtf8Text(ctx.appData, text, {
+            extension: ".md",
+        });
+        const imported = await run([
+            "import-prd",
+            taskId,
+            "--file",
+            staged.path,
+            "--name",
+            name,
+            "--role",
+            "requirement",
+            "--json",
+        ], {
+            cwd: ctx.repoRoot,
+            artifactName: `bootstrap-import-prd-${label}`,
+            expectJson: true,
+            timeoutMs: 60_000,
+        });
+        if (!imported.ok || imported.exitCode !== 0) {
+            return {
+                kind: "error",
+                status: 400,
+                body: operatorFailed({
+                    command: "bootstrapFromPrd",
+                    outcome: "rejected",
+                    code: "INTERNAL_ERROR",
+                    message: imported.stderr?.trim() ||
+                        `import-prd failed for "${name}" with exit ${imported.exitCode}. 任务已创建但不完整，请用 CLI 补 import-prd 或换 taskId 重试。`,
+                    details: {
+                        exitCode: imported.exitCode,
+                        taskId,
+                        failedName: name,
+                        succeededImports: [...succeededImports],
+                    },
+                }),
+            };
+        }
+        succeededImports.push(name);
+        importResults.push(imported.json ?? null);
+        return null;
+    };
+    if (documents && documents.length > 0) {
+        for (const doc of documents) {
+            const failure = await runImportPrd(doc.name, doc.content, doc.name);
+            if (failure)
+                return failure;
+        }
+        const composedFailure = await runImportPrd("composed", content, "composed");
+        if (composedFailure)
+            return composedFailure;
+    }
+    else {
+        const staged = await stageUtf8Text(ctx.appData, content, {
+            extension: ".md",
+        });
+        const imported = await run(["import-prd", taskId, "--file", staged.path, "--json"], {
+            cwd: ctx.repoRoot,
+            artifactName: "bootstrap-import-prd",
+            expectJson: true,
+            timeoutMs: 60_000,
+        });
+        if (!imported.ok || imported.exitCode !== 0) {
+            return {
+                kind: "error",
+                status: 400,
+                body: operatorFailed({
+                    command: "bootstrapFromPrd",
+                    outcome: "rejected",
+                    code: "INTERNAL_ERROR",
+                    message: imported.stderr?.trim() ||
+                        `import-prd failed with exit ${imported.exitCode}`,
+                    details: { exitCode: imported.exitCode, taskId },
+                }),
+            };
+        }
+        importResults.push(imported.json ?? null);
     }
     const draftSaved = await ctx.drafts.save({
         ...emptyDraft(taskId, title, { taskKind }),
@@ -1578,10 +1641,58 @@ async function dispatchBootstrapFromPrd(ctx, p) {
             identitySource: identity.source,
             preferredTaskId: identity.taskId,
             draftSha256: draftSaved.draftSha256,
-            import: imported.json ?? null,
+            import: importResults.length === 1 ? importResults[0] : null,
+            imports: importResults,
+            documentNames: documents && documents.length > 0
+                ? [...documents.map((d) => d.name), "composed"]
+                : undefined,
         }),
     };
 }
+const MAX_BOOTSTRAP_DOCUMENTS = 8;
+function parseBootstrapDocuments(raw) {
+    if (raw === undefined || raw === null) {
+        return { ok: true, documents: null };
+    }
+    if (!Array.isArray(raw)) {
+        return { ok: false, message: "documents must be an array" };
+    }
+    if (raw.length === 0) {
+        return { ok: true, documents: null };
+    }
+    if (raw.length > MAX_BOOTSTRAP_DOCUMENTS) {
+        return {
+            ok: false,
+            message: `documents supports at most ${MAX_BOOTSTRAP_DOCUMENTS} entries`,
+        };
+    }
+    const documents = [];
+    for (let i = 0; i < raw.length; i += 1) {
+        const entry = raw[i];
+        if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+            return { ok: false, message: `documents[${i}] must be an object` };
+        }
+        const rec = entry;
+        const name = str(rec.name)?.trim();
+        const content = str(rec.content);
+        const fileName = str(rec.fileName)?.trim();
+        if (!name) {
+            return { ok: false, message: `documents[${i}].name is required` };
+        }
+        if (!content?.trim()) {
+            return {
+                ok: false,
+                message: `documents[${i}].content is required`,
+            };
+        }
+        documents.push({
+            name,
+            content,
+            ...(fileName ? { fileName } : {}),
+        });
+    }
+    return { ok: true, documents };
+}
 async function ensureDraft(ctx, taskId, title, options) {
     const existing = await ctx.drafts.get(taskId);
     if (existing) {