u1s1-cli 0.18.0 → 0.19.1

package/dist/agent-setup.js

@@ -328,7 +328,12 @@ First decide whether this task really needs a workflow. Good fit: many independe
 
 If it is a fit:
 
-1. Decompose the task, then write a JavaScript orchestration script. Top-level await and return are allowed. The script runs in a sandbox where ONLY these are available:
+0. **Prefer a built-in template** when one matches — call \`run_workflow\` with \`template\` + \`input\` instead of writing a script:
+   - \`i18n\` — translate locale file(s) to N languages: { "langs": ["en", "ja"], "source": "src/locales/zh.json" }
+   - \`review\` — per-file review + adversarial verification: { "files": [...] } or omit for git-diff files
+   - \`research\` — parallel investigation + synthesis: { "questions": ["..."], "context": "..." }
+   - \`refactor\` — rule-first batch refactor in isolated worktrees: { "instruction": "...", "files": [...] }
+1. Otherwise decompose the task and write a JavaScript orchestration script. Top-level await and return are allowed. The script runs in a sandbox where ONLY these are available:
    - \`subagent(task)\` or \`subagent({ task, model })\` — runs one sub-agent, resolves to its final output text
    - \`parallel([() => ..., ...])\` — concurrent fan-out; each thunk's error becomes \`null\`; barrier semantics
    - \`pipeline(items, [stage1, stage2, ...])\` — each item flows through all stages independently (prefer over parallel)
@@ -337,7 +342,7 @@ If it is a fit:
    - \`log(...)\`, \`setTimeout/clearTimeout\`, standard JS builtins (Promise/JSON/Math/...)
    - NO require/import/process/fetch/fs access — the static validator rejects scripts that try
 2. Every task string must be fully self-contained: which files to read/write, what "done" means, how to self-verify.
-3. Call the \`run_workflow\` tool with the full source as \`script\`. Read its report carefully; on failures fix the script, or rerun with \`script_path\` + \`resume: true\` to continue from saved progress.
+3. Call the \`run_workflow\` tool with the full source as \`script\`. Read its report carefully; on failures fix the script, or rerun with \`script_path\` + \`resume: true\` to continue from saved progress. For workflows worth rerunning (e.g. recurring i18n syncs), pass a memorable \`save_as\` name — rerun later with just \`script_path\`.
 
 Keep scripts deterministic (same order of subagent calls every run) so resume works. Summarize the outcome to the user afterwards in their language.
 `;

package/dist/workflow/templates.d.ts

@@ -0,0 +1,11 @@
+export interface WorkflowTemplate {
+    name: string;
+    description: string;
+    /** 生成脚本源码;input 已由调用方做过形状校验。 */
+    build: (input: Record<string, unknown>) => string;
+    /** 给模型看的 input 说明。 */
+    inputHint: string;
+}
+export declare const TEMPLATES: Record<string, WorkflowTemplate>;
+/** 按模板名生成脚本;生成后自检必须过静态校验(防模板本身写出不合规代码)。 */
+export declare function buildFromTemplate(template: string, input: Record<string, unknown>): string;

package/dist/workflow/templates.js

@@ -0,0 +1,175 @@
+import { execFileSync } from "node:child_process";
+import { validateScript } from "./runner.js";
+function str(v, fallback = "") {
+    return typeof v === "string" && v.trim() ? v.trim() : fallback;
+}
+function strArray(v) {
+    return Array.isArray(v)
+        ? v.filter((x) => typeof x === "string" && !!x.trim()).map((x) => x.trim())
+        : [];
+}
+/** JSON.stringify 后内插进脚本;保证引号安全。 */
+function lit(v) {
+    return JSON.stringify(v ?? null);
+}
+/** git 改动文件列表(模板构建期在主进程执行,不进沙箱)。
+ * 剔除已删除文件(评审/重构 agent 没法打开),并入未跟踪的新文件。 */
+function gitDiffFiles() {
+    const run = (args) => {
+        const out = execFileSync("git", args, { encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] });
+        return out.split("\n").map((s) => s.trim()).filter(Boolean);
+    };
+    try {
+        const changed = run(["diff", "--name-only", "--diff-filter=d", "HEAD"]);
+        const untracked = run(["ls-files", "--others", "--exclude-standard"]);
+        return [...new Set([...changed, ...untracked])];
+    }
+    catch {
+        return [];
+    }
+}
+export const TEMPLATES = {
+    i18n: {
+        name: "i18n",
+        description: "批量多语言翻译:每个语言一个子 agent 并行翻译,完成后统一校验 key 对齐并自动修复",
+        inputHint: '{ "langs": ["en", "ja", "de"], "source": "src/locales/zh.json", "dir": "src/locales" } — source/dir 可省略(默认 src/locales/zh.json 与同目录)',
+        build(input) {
+            const langs = strArray(input.langs);
+            if (langs.length === 0)
+                throw new Error('i18n 模板需要 langs 数组,例如 { "langs": ["en", "ja"] }');
+            const source = str(input.source, "src/locales/zh.json");
+            const dir = str(input.dir, source.includes("/") ? source.slice(0, source.lastIndexOf("/")) : "src/locales");
+            // 用户输入一律经 lit() 进脚本,再在运行期拼接——裸内插遇到引号/反斜杠/换行会把生成的脚本弄成语法错误
+            return `
+const langs = ${lit(langs)};
+const source = ${lit(source)};
+const dir = ${lit(dir)};
+log("i18n:翻译 " + langs.length + " 个语言,源文件 " + source);
+const results = await parallel(langs.map(lang => () =>
+  subagent({
+    task: "读取 " + source + ",把所有文案翻译成对应语言(保持所有 key 不变、输出合法 JSON、译文自然地道)," +
+      "写入 " + dir + "/" + lang + ".json。写完后重新读一遍文件,确认是合法 JSON 且 key 与源文件完全一致。" +
+      "目标语言代码:" + lang
+  })
+));
+const okLangs = langs.filter((_, i) => results[i] !== null);
+if (okLangs.length > 0) {
+  await subagent({
+    task: "对照 " + source + " 检查 " + dir + "/ 目录下这些语言的翻译文件:" + okLangs.join(",") + "." +
+      "逐个核对 key 是否与源文件完全一致、JSON 是否合法、译文是否有明显机翻痕迹,发现问题直接修复。最后汇报每个语言的状态"
+  });
+}
+return { translated: okLangs, failed: langs.filter(l => !okLangs.includes(l)) };
+`;
+        },
+    },
+    review: {
+        name: "review",
+        description: "全面代码审查:每个文件一个评审 agent 并行审查,发现项再交独立 agent 对抗性验证,只保留核实为真的问题",
+        inputHint: '{ "files": ["src/a.ts", "src/b.ts"] } — files 可省略,默认取 git diff --name-only HEAD 的改动文件',
+        build(input) {
+            let files = strArray(input.files);
+            if (files.length === 0)
+                files = gitDiffFiles();
+            if (files.length === 0)
+                throw new Error("review 模板需要 files 数组,或当前仓库有未提交改动");
+            return `
+const files = ${lit(files)};
+log("review:评审 " + files.length + " 个文件,发现项将做对抗性验证");
+const reports = await parallel(files.map(f => () =>
+  subagent({
+    task: "通读 " + f + " 及其直接依赖,做代码审查:正确性 bug、安全漏洞、明显的性能问题。" +
+      "只报告有把握的问题,每条给出文件、行号、严重程度(高/中/低)、问题描述和建议修法。没有问题就明确说无发现。"
+  })
+));
+const findings = reports.filter(Boolean).join("\\n\\n---\\n\\n");
+if (!findings.trim()) return { verified: "(所有文件均无发现)" };
+const verified = await subagent({
+  task: "下面是一份代码审查发现列表。逐条对抗性验证:打开涉及的文件核对,剔除不成立、夸大或已过时的条目," +
+    "只保留核实为真的问题,按严重程度排序输出完整清单。\\n\\n" + findings
+});
+return { verified };
+`;
+        },
+    },
+    research: {
+        name: "research",
+        description: "并行研究:每个方向一个子 agent 独立调查(可联网),最后汇总成一份综合报告",
+        inputHint: '{ "questions": ["方向一", "方向二"], "context": "可选背景" }',
+        build(input) {
+            const questions = strArray(input.questions);
+            if (questions.length === 0)
+                throw new Error('research 模板需要 questions 数组,例如 { "questions": ["竞品A的定价", "竞品B的功能"] }');
+            const context = str(input.context);
+            const contextLine = context ? `调查背景:${context}。` : "";
+            return `
+const questions = ${lit(questions)};
+const contextLine = ${lit(contextLine)};
+log("research:并行调查 " + questions.length + " 个方向");
+const reports = await parallel(questions.map(q => () =>
+  subagent({
+    task: "调查以下问题,可以用 web_search/web_fetch 联网,也可以读本地代码和文档。" +
+      "输出:关键事实(带来源)、不同观点、你的结论。" + contextLine + "问题:" + q
+  })
+));
+const merged = reports
+  .map((r, i) => (r ? "## 方向 " + (i + 1) + ":" + questions[i] + "\\n\\n" + r : null))
+  .filter(Boolean)
+  .join("\\n\\n");
+if (!merged.trim()) return { synthesis: "(所有方向都失败了)", failed: questions.length };
+const synthesis = await subagent({
+  task: "把以下几份调查报告综合成一份结论性报告:先给核心结论(不超过 5 条),再给分方向要点," +
+    "最后列分歧点和待确认项。不要编造报告里没有的信息。\\n\\n" + merged
+});
+return { synthesis };
+`;
+        },
+    },
+    refactor: {
+        name: "refactor",
+        description: "批量重构/迁移:先由一个 agent 读代表文件制定统一规则,然后每个文件一个子 agent 在独立 worktree 里套用规则,互不冲突",
+        inputHint: '{ "instruction": "把所有 var 改为 const", "files": ["src/a.ts", ...] } — files 省略时用 git diff 改动文件',
+        build(input) {
+            const instruction = str(input.instruction);
+            if (!instruction)
+                throw new Error('refactor 模板需要 instruction,例如 { "instruction": "把 var 全部改为 const" }');
+            // 与 review 模板一致:构建期取 git 改动文件,不花一个 subagent 在沙箱里跑 git
+            let files = strArray(input.files);
+            if (files.length === 0)
+                files = gitDiffFiles();
+            if (files.length === 0)
+                throw new Error("refactor 模板需要 files 数组,或当前仓库有未提交改动");
+            return `
+const instruction = ${lit(instruction)};
+const targetFiles = ${lit(files)};
+log("refactor:共 " + targetFiles.length + " 个文件,先制定统一规则");
+const rule = await subagent({
+  task: "我们要对一批文件做统一重构:" + instruction + "。" +
+    "先读其中 1-2 个代表性文件了解现状,然后输出一份精确的重构规则清单(每条:什么模式改成什么、边界情况怎么处理)。" +
+    "规则要具体到可以直接照做,不要空话。涉及文件:" + targetFiles.slice(0, 10).join(",")
+});
+const results = await parallel(targetFiles.map(f => () =>
+  subagent({
+    task: "按以下重构规则处理文件 " + f + ",改完检查该文件语法正确(必要时运行 tsc 或构建验证)。\\n\\n重构规则:\\n" + rule,
+    worktree: true
+  })
+));
+const done = targetFiles.filter((_, i) => results[i] !== null);
+return { applied: done, failed: targetFiles.filter(f => !done.includes(f)), rule };
+`;
+        },
+    },
+};
+/** 按模板名生成脚本;生成后自检必须过静态校验(防模板本身写出不合规代码)。 */
+export function buildFromTemplate(template, input) {
+    const t = TEMPLATES[template];
+    if (!t) {
+        throw new Error(`未知模板 "${template}",可用:${Object.keys(TEMPLATES).join(", ")}`);
+    }
+    const code = t.build(input ?? {});
+    const errors = validateScript(code);
+    if (errors.length > 0) {
+        throw new Error(`模板 ${template} 生成的脚本未通过静态校验(模板 bug,请反馈):${errors.join(";")}`);
+    }
+    return code;
+}

package/dist/workflow/tool.d.ts

@@ -6,7 +6,10 @@ import type { ParentModelRef } from "../subagent.js";
  */
 export declare function createRunWorkflowTool(getParentModel: () => ParentModelRef): import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
     script: Type.TOptional<Type.TString>;
+    template: Type.TOptional<Type.TString>;
+    input: Type.TOptional<Type.TRecord<"^.*$", Type.TUnknown>>;
     script_path: Type.TOptional<Type.TString>;
+    save_as: Type.TOptional<Type.TString>;
     resume: Type.TOptional<Type.TBoolean>;
     timeout_minutes: Type.TOptional<Type.TNumber>;
     budget_tokens: Type.TOptional<Type.TNumber>;

package/dist/workflow/tool.js

@@ -1,10 +1,11 @@
-import { readFileSync } from "node:fs";
-import { resolve } from "node:path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
 import { defineTool } from "@earendil-works/pi-coding-agent";
 import { Text } from "@earendil-works/pi-tui";
 import { Type } from "typebox";
 import { compactResultRender, truncate } from "../tools.js";
 import { runWorkflow, saveWorkflowScript, validateScript, workflowsDir, WORKFLOW_DEFAULT_BUDGET_TOKENS, WORKFLOW_TIMEOUT_MS, } from "./runner.js";
+import { buildFromTemplate, TEMPLATES } from "./templates.js";
 /**
  * run_workflow 工具:主 agent 把模型生成的编排脚本交给 WorkflowRunner 执行。
  * 脚本在 vm 沙箱里跑,只能用注入的 subagent/parallel/pipeline 原语。
@@ -27,9 +28,20 @@ export function createRunWorkflowTool(getParentModel) {
         ],
         parameters: Type.Object({
             script: Type.Optional(Type.String({ description: "Full JavaScript source of the orchestration script (top-level await allowed)." })),
+            template: Type.Optional(Type.String({
+                description: `Use a built-in template instead of writing a script: ${Object.keys(TEMPLATES).join(" / ")}. ` +
+                    "Provide `input` to parametrize it. Prefer this over hand-writing a script when a template fits.",
+            })),
+            input: Type.Optional(Type.Record(Type.String(), Type.Unknown(), {
+                description: 'Parameters for `template`, e.g. i18n: { "langs": ["en", "ja"] }; review/refactor: { "files": [...] } or omit for git-diff files; research: { "questions": [...] }.',
+            })),
             script_path: Type.Optional(Type.String({
                 description: "Path to an existing workflow script under .u1s1/workflows/ — rerun it instead of passing `script`.",
             })),
+            save_as: Type.Optional(Type.String({
+                description: 'Save this run\'s script as .u1s1/workflows/<name>.mjs (letters/digits/-/_) for easy reuse; rerun later via script_path. Fails if the name already exists. Only valid with `script` or `template`, not `script_path`.',
+                pattern: "^[a-zA-Z0-9_-]+$",
+            })),
             resume: Type.Optional(Type.Boolean({
                 description: "Skip sub-tasks already recorded as succeeded in the progress file (for crash/interrupt recovery).",
             })),
@@ -61,12 +73,27 @@ export function createRunWorkflowTool(getParentModel) {
         async execute(_toolCallId, params, signal, onUpdate) {
             let code = params.script?.trim();
             let scriptPath;
+            const named = params.save_as?.trim();
+            if (named && !/^[a-zA-Z0-9_-]+$/.test(named)) {
+                throw new Error("save_as 只允许字母、数字、横线和下划线");
+            }
+            if (named && params.script_path?.trim()) {
+                throw new Error("script_path 指向的脚本已经落盘,不能再配 save_as;要另存新名字请用 script 传入源码");
+            }
             if (code) {
                 const errors = validateScript(code);
                 if (errors.length > 0) {
                     throw new Error(`脚本未通过静态校验,请修复后重试:\n- ${errors.join("\n- ")}`);
                 }
-                scriptPath = saveWorkflowScript(code);
+            }
+            else if (params.template?.trim()) {
+                // 内置模板:模型只填参数,脚本由模板生成(生成后自检过静态校验)
+                try {
+                    code = buildFromTemplate(params.template.trim(), (params.input ?? {}));
+                }
+                catch (e) {
+                    throw new Error(`${e.message}\n模板 input 说明:${TEMPLATES[params.template.trim()]?.inputHint ?? "—"}`);
+                }
             }
             else if (params.script_path?.trim()) {
                 scriptPath = resolve(params.script_path.trim());
@@ -78,7 +105,22 @@ export function createRunWorkflowTool(getParentModel) {
                 }
             }
             else {
-                throw new Error("script 和 script_path 至少填一个");
+                throw new Error("script、template、script_path 至少填一个");
+            }
+            // 落盘:save_as 用语义化名字(同名报错防覆盖进度配对),否则时间戳名;
+            // script_path 分支上面已读入,不重复落盘
+            if (!scriptPath) {
+                if (named) {
+                    scriptPath = resolve(workflowsDir(), `${named}.mjs`);
+                    if (existsSync(scriptPath)) {
+                        throw new Error(`工作流 "${named}" 已存在(${scriptPath})。要重跑它请用 script_path 指向该文件(可加 resume:true 续跑);要新建请换个名字`);
+                    }
+                    mkdirSync(dirname(scriptPath), { recursive: true });
+                    writeFileSync(scriptPath, code ?? "");
+                }
+                else {
+                    scriptPath = saveWorkflowScript(code ?? "");
+                }
             }
             const progressPath = scriptPath.replace(/\.mjs$/, ".progress.jsonl");
             // 流式进度:onProgress 高频触发,节流到 ≥2s 一次才推给 TUI

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "u1s1-cli",
-  "version": "0.18.0",
+  "version": "0.19.1",
   "description": "u1s1 — 有一说一,最省心的 AI 编程搭子。终端里用中文说需求,AI 帮你读文件、改代码、跑命令。",
   "type": "module",
   "bin": {