@agentstorm/server 0.2.6 → 0.2.8

package/dist/template-library.d.ts

@@ -80,6 +80,19 @@ export declare class GlobalTemplateLibrary {
     private ensureSeedTemplates;
     private migrateGeneralWorkflowId;
     private retireLegacySeedTemplates;
+    /**
+     * v5 was the last product-specific SONiC/TCSGW seed. Replace only the exact
+     * checked-in semantic document; any graph, layout, Prompt, or composition
+     * edit changes the fingerprint and remains user-owned. Canonicalization
+     * intentionally ignores JSON property order and per-Agent runtime settings,
+     * which are preserved during the upgrade.
+     * The internal ID stays stable because deletion records and package sources
+     * may already reference it.
+     */
+    private upgradeLegacyDevelopmentWorkflowSeed;
+    private upgradeBuiltinTemplateNames;
+    private upgradeBuiltinTemplateName;
+    private replaceWithCurrentSeed;
     private normalizeLegacyManifest;
     private templateDir;
     private writeDocument;

package/dist/template-library.js

@@ -12,6 +12,9 @@ const MAX_ASSET_BYTES = 8 * 1024 * 1024;
 const TEMPLATE_ID_PATTERN = /^[a-z0-9][a-z0-9._-]{0,63}$/;
 const BUILTIN_TEMPLATE_IDS = ["general-workflow", "sonic-pipeline"];
 const BUILTIN_TEMPLATE_ROOT = resolveBuiltinTemplateRoot();
+const LEGACY_SONIC_PIPELINE_SEED_FINGERPRINT = "5e88fd35e66dcea3a6ad17f250cc6415df68d66b524680d18ece8267e0ff3456";
+const LEGACY_GENERAL_WORKFLOW_NAME_FINGERPRINT = "6e0fbfbb5c98ac15bccb348a1132b87d1b625ad7befe35d8049328340dfd6cbb";
+const LEGACY_DEVELOPMENT_WORKFLOW_NAME_FINGERPRINT = "f4672d3ccaf29d42d5ee9573ee74381c71327ee90d5e785f89d7187f00b8f0e8";
 const RETIRED_SEED_TEMPLATES = {
     "grpc-migration": "gRPC migration 示例",
     "review-loop": "审核循环",
@@ -76,6 +79,8 @@ export class GlobalTemplateLibrary {
         }
         this.migrateGeneralWorkflowId();
         this.retireLegacySeedTemplates();
+        this.upgradeLegacyDevelopmentWorkflowSeed();
+        this.upgradeBuiltinTemplateNames();
         this.ensureSeedTemplates();
     }
     list() {
@@ -247,7 +252,7 @@ export class GlobalTemplateLibrary {
         catch {
             return;
         }
-        if (manifest.name !== "通用work flow")
+        if (manifest.name !== "通用work flow" && manifest.name !== "通用workflow")
             return;
         fs.renameSync(legacyDir, currentDir);
         writeJsonAtomic(path.join(currentDir, "manifest.json"), {
@@ -272,6 +277,81 @@ export class GlobalTemplateLibrary {
             }
         }
     }
+    /**
+     * v5 was the last product-specific SONiC/TCSGW seed. Replace only the exact
+     * checked-in semantic document; any graph, layout, Prompt, or composition
+     * edit changes the fingerprint and remains user-owned. Canonicalization
+     * intentionally ignores JSON property order and per-Agent runtime settings,
+     * which are preserved during the upgrade.
+     * The internal ID stays stable because deletion records and package sources
+     * may already reference it.
+     */
+    upgradeLegacyDevelopmentWorkflowSeed() {
+        const id = "sonic-pipeline";
+        if (!fs.existsSync(this.templateDir(id)))
+            return;
+        let current;
+        try {
+            current = this.get(id);
+        }
+        catch {
+            return;
+        }
+        if (current.name !== "SONiC TCSGW 开发流水线" ||
+            current.version !== 5 ||
+            legacyBuiltinTemplateFingerprint(current.spec, current.layout, current.assets) !==
+                LEGACY_SONIC_PIPELINE_SEED_FINGERPRINT) {
+            return;
+        }
+        this.replaceWithCurrentSeed(id, current);
+    }
+    upgradeBuiltinTemplateNames() {
+        this.upgradeBuiltinTemplateName({
+            id: "general-workflow",
+            previousName: "通用work flow",
+            previousVersion: 20,
+            fingerprint: LEGACY_GENERAL_WORKFLOW_NAME_FINGERPRINT,
+        });
+        this.upgradeBuiltinTemplateName({
+            id: "sonic-pipeline",
+            previousName: "开发流水线",
+            previousVersion: 6,
+            fingerprint: LEGACY_DEVELOPMENT_WORKFLOW_NAME_FINGERPRINT,
+        });
+    }
+    upgradeBuiltinTemplateName(options) {
+        if (!fs.existsSync(this.templateDir(options.id)))
+            return;
+        let current;
+        try {
+            current = this.get(options.id);
+        }
+        catch {
+            return;
+        }
+        if (current.name !== options.previousName ||
+            current.version !== options.previousVersion ||
+            legacyBuiltinTemplateFingerprint(current.spec, current.layout, current.assets) !==
+                options.fingerprint) {
+            return;
+        }
+        this.replaceWithCurrentSeed(options.id, current);
+    }
+    replaceWithCurrentSeed(id, current) {
+        const seed = DEFAULT_TEMPLATES.find((candidate) => candidate.id === id);
+        if (!seed)
+            return;
+        const parsed = parseInput(seed);
+        this.writeDocument({
+            schemaVersion: 1,
+            id,
+            name: parsed.name,
+            description: parsed.description,
+            version: seed.seedVersion,
+            seeded: true,
+            updatedAt: seed.seedUpdatedAt || nowBeijing(),
+        }, preserveAgentRuntimeSettings(parsed.spec, current.spec), parsed.layout, parsed.assets);
+    }
     normalizeLegacyManifest(id) {
         const manifestPath = path.join(this.templateDir(id), "manifest.json");
         if (!fs.existsSync(manifestPath) ||
@@ -475,6 +555,49 @@ function templateEtag(manifest, spec, layout, assets) {
 function etagOf(raw) {
     return `"${createHash("sha256").update(raw).digest("hex").slice(0, 16)}"`;
 }
+function templateContentFingerprint(spec, layout, assets) {
+    const canonical = canonicalizeJson({ spec, layout, assets });
+    return createHash("sha256").update(JSON.stringify(canonical)).digest("hex");
+}
+function legacyBuiltinTemplateFingerprint(spec, layout, assets) {
+    const normalizedSpec = {
+        ...spec,
+        agents: Object.fromEntries(Object.entries(spec.agents).map(([id, config]) => [
+            id,
+            {
+                backend: "paseo",
+                provider: "<runtime>",
+                model: "<runtime>",
+                ...(config.prompt === undefined ? {} : { prompt: config.prompt }),
+                ...(config.promptComposition === undefined
+                    ? {}
+                    : { promptComposition: config.promptComposition }),
+            },
+        ])),
+    };
+    return templateContentFingerprint(normalizedSpec, layout, assets);
+}
+function preserveAgentRuntimeSettings(seed, current) {
+    return {
+        ...seed,
+        agents: Object.fromEntries(Object.entries(seed.agents).map(([id, seedConfig]) => {
+            const currentConfig = current.agents[id];
+            if (!currentConfig)
+                return [id, seedConfig];
+            const { prompt: _currentPrompt, promptComposition: _currentComposition, ...runtimeSettings } = currentConfig;
+            return [id, { ...seedConfig, ...runtimeSettings }];
+        })),
+    };
+}
+function canonicalizeJson(value) {
+    if (Array.isArray(value))
+        return value.map(canonicalizeJson);
+    if (!value || typeof value !== "object")
+        return value;
+    return Object.fromEntries(Object.keys(value)
+        .sort()
+        .map((key) => [key, canonicalizeJson(value[key])]));
+}
 function readJson(filePath, fallback) {
     if (!fs.existsSync(filePath)) {
         if (fallback !== undefined)

package/dist/templates/general-workflow/manifest.json

@@ -1,9 +1,9 @@
 {
   "schemaVersion": 1,
   "id": "general-workflow",
-  "name": "通用work flow",
+  "name": "通用workflow",
   "description": "通用 Plan → 审批 → Execute 流水线。",
-  "version": 20,
+  "version": 21,
   "seeded": true,
-  "updatedAt": "2026-08-09T16:15:02.000+08:00"
+  "updatedAt": "2026-08-21T10:38:16+08:00"
 }

package/dist/templates/general-workflow/workflow.json

@@ -1,6 +1,6 @@
 {
   "version": "1",
-  "name": "通用work flow",
+  "name": "通用workflow",
   "vars": {
     "goal": "Inspect this workspace, plan the requested migration, implement it, review it, and run relevant tests."
   },

package/dist/templates/sonic-pipeline/manifest.json

@@ -1,9 +1,9 @@
 {
   "schemaVersion": 1,
   "id": "sonic-pipeline",
-  "name": "SONiC TCSGW 开发流水线",
-  "description": "需求与项目分析 → 人工审核 PRD → 任务拆分 → 人工审核计划 → 逐任务开发与 Code Review。",
-  "version": 5,
+  "name": "开发workflow",
+  "description": "通用需求与项目分析 → 人工审核 PRD → 任务拆分 → 人工审核计划 → 逐任务开发与 Code Review。",
+  "version": 7,
   "seeded": true,
-  "updatedAt": "2026-08-10T16:53:00+08:00"
+  "updatedAt": "2026-08-21T10:38:16+08:00"
 }

package/dist/templates/sonic-pipeline/prompts/analysis.md

@@ -1,12 +1,12 @@
 ---
 name: analysis
-description: 分析用户需求与 SONiC/TCSGW 真实项目，形成可审核的需求分析报告和 PRD
+description: 分析用户需求与当前真实项目，形成可审核的需求分析报告和 PRD
 role: analyst
 ---
 
-# SONiC/TCSGW Analysis
+# Analysis
 
-你负责流水线的需求分析阶段。先理解用户目标，再调查真实工作区和 SONiC/TCSGW 项目，形成供人审核的需求分析报告与 PRD。本阶段不拆分执行任务、不修改业务代码，也不提交 PlanResult。
+你负责流水线的需求分析阶段。先理解用户目标，再调查真实工作区与当前项目，形成供人审核的需求分析报告与 PRD。本阶段不拆分执行任务、不修改业务代码，也不提交 PlanResult。该流程适用于功能开发、缺陷修复、重构和迁移，不假定固定业务或技术栈。
 
 ## 输入与调查
 

package/dist/templates/sonic-pipeline/prompts/code-reviewer.md

@@ -1,10 +1,10 @@
 ---
 name: code-reviewer
-description: 逐条验证 SONiC/TCSGW 任务验收标准并审查实际改动
+description: 逐条验证当前任务验收标准并审查实际改动
 role: reviewer
 ---
 
-# SONiC/TCSGW Code Reviewer
+# Code Reviewer
 
 你负责当前子任务的最终代码审查。读取任务描述、验收标准、Worker Summary 与 `resources`、PRD、实际 diff 和相关源码；不能只依据 Worker 的自述作出结论。
 

package/dist/templates/sonic-pipeline/prompts/planner.md

@@ -1,10 +1,10 @@
 ---
 name: planner
-description: 根据已批准的需求分析与 PRD，将 SONiC/TCSGW 需求拆分为可独立验收的执行任务
+description: 根据已批准的需求分析与 PRD，将目标拆分为可独立验收的执行任务
 role: planner
 ---
 
-# SONiC/TCSGW Planner
+# Planner
 
 你的职责是把已经通过人工审批的需求分析报告和 PRD 转换为可执行、可再次审批、可独立验收的任务计划。规划阶段不修改业务代码，不重新发明需求。
 
@@ -13,7 +13,7 @@ role: planner
 1. 优先读取 Analysis 节点通过 `resources` 交付的 `requirements-analysis.md`、`prd.md`、节点 Summary 和关键证据。若这些审批输入缺失或相互矛盾，不得猜测，应明确报告阻塞点。
 2. 结合当前工作区复核任务涉及的源码、组件边界、构建与测试入口。已批准 PRD 是需求基线，真实代码是现状基线。
 3. 阅读上一轮计划审批意见；重新规划时逐条回应，保留仍然有效的任务，只修订需要变化的部分。
-4. 如果项目存在 `.agentstorm/knowledge/sonic-pipeline.md`，可将其中经过验证的经验作为补充，但代码与已批准 PRD 始终优先。
+4. 按需读取 `.agentstorm/knowledge/` 下与当前任务相关的 Markdown 经验；只采纳与真实代码和已批准 PRD 一致的内容。
 
 ## 任务切分规则
 
@@ -29,9 +29,9 @@ role: planner
 
 ## 计划产物
 
-- 在当前节点的 `resourceRoot` 下生成 `sonic-plan.md`，包含需求覆盖关系、任务与依赖、验收标准、风险、验证策略和人工介入点。
+- 在当前节点的 `resourceRoot` 下生成 `implementation-plan.md`，包含需求覆盖关系、任务与依赖、验收标准、风险、验证策略和人工介入点。
 - 提交完整 PlanResult：`revision`、`summary`、`tasks`、`removedTaskDisplayIds`、`resources`。每个任务使用稳定且唯一的 `displayId`，并填写 `title`、`description`、`acceptanceCriteria`、`dependencyDisplayIds`；任务相关输入或交付文件放入任务级 `resources`。仅在重新规划时，才把明确需要删除且尚未启动的 pending 任务写入 `removedTaskDisplayIds`；正常规划使用空数组。
-- 计划级 `resources` 必须包含节点 Summary、`sonic-plan.md`、已批准的 `requirements-analysis.md` 与 `prd.md`，以及审批者需要查看的关键证据。正文和结构化 PlanResult 必须一致。
+- 计划级 `resources` 必须包含节点 Summary、`implementation-plan.md`、已批准的 `requirements-analysis.md` 与 `prd.md`，以及审批者需要查看的关键证据。正文和结构化 PlanResult 必须一致。
 - 不创建旧版任务清单，不写死 Summary 路径，也不手工推进节点；AgentStorm 负责保存计划、创建任务、发起第二次人工审批和后续调度。
 
 提交前自检：已批准需求是否全部映射到任务或非目标，任务是否真正垂直且大小合理，路径与命令是否存在，依赖是否无环，验收是否可以由 Execute Agent 直接验证。

package/dist/templates/sonic-pipeline/prompts/worker.md

@@ -1,17 +1,17 @@
 ---
 name: worker
-description: 按当前任务的验收标准实现并验证 SONiC/TCSGW 垂直切片
+description: 按当前任务的验收标准实现并验证一个完整垂直切片
 role: worker
 ---
 
-# SONiC/TCSGW Worker
+# Worker
 
 一次只处理当前子任务。读取任务描述、验收标准、依赖任务交付的 `resources`、PRD 以及审查反馈；不得自行扩大到其他计划任务。
 
 ## 工作方式
 
 1. 先检查工作区状态并保护用户已有修改。读取目标文件及 1–2 个相近实现，理解项目约定后再动手。
-2. 如存在 `.agentstorm/knowledge/sonic-pipeline.md`，只采纳与当前代码和 PRD 一致的经验。任务强调的 Skills 应优先使用；未列出的 Provider 可用 Skills 仍可按需使用。
+2. 按需读取 `.agentstorm/knowledge/` 下与当前任务相关的 Markdown 经验，只采纳与当前代码和 PRD 一致的内容。任务强调的 Skills 应优先使用；未列出的 Provider 可用 Skills 仍可按需使用。
 3. 先思考最小完整方案，保持实现简单、改动聚焦、符合现有结构。不要顺手重构无关代码，不清理或覆盖用户文件。
 4. 实现当前垂直切片，并逐条验证验收标准。优先使用任务指定及项目已有的检查；使用等价或更强验证时说明替代原因和证据。
 5. 对本地可修复失败最多进行 5 轮有依据的诊断与修改；仍失败时报告真实错误、复现命令、已尝试方案和剩余风险，不伪造成功。
@@ -21,5 +21,5 @@ role: worker
 
 - 在节点 Summary 中按验收标准逐项记录实现位置、实际命令、结果和遗留风险。Summary 的路径由 AgentStorm 统一提供，不要自行创建第二份固定 Summary。
 - `resources` 应包含下一节点需要读取的 Summary 和其他关键文件/证据；不要只给口头结论。
-- 只有确实可复用且不明显的 SONiC/TCSGW 知识才可追加到 `.agentstorm/knowledge/sonic-pipeline.md`，不得把任务进度或一次性故障写成知识。
+- 只有确实可复用且不明显的经验才可写入 `.agentstorm/knowledge/` 下合适的 Markdown 文件；不得把任务进度、敏感信息或一次性故障写成共享经验。
 - 不创建旧版 `worker-result.json`，不执行 git commit 或 push，也不手工推进流水线。

package/dist/templates/sonic-pipeline/workflow.json

@@ -1,8 +1,8 @@
 {
   "version": "1",
-  "name": "SONiC TCSGW 开发流水线",
+  "name": "开发workflow",
   "vars": {
-    "goal": "先分析用户需求与 SONiC/TCSGW 代码库并形成需求分析报告和 PRD；需求审批通过后拆分执行任务，计划再次审批通过后逐任务实现、自测并进行严格 Code Review。"
+    "goal": "先分析用户需求与当前项目并形成需求分析报告和 PRD；需求审批通过后拆分执行任务，计划再次审批通过后逐任务实现、自测并进行严格 Code Review。"
   },
   "agents": {
     "analysis": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentstorm/server",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "AgentStorm resident Pipeline service",
   "files": [
     "dist"
@@ -19,9 +19,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@agentstorm/agent-runtime": "0.2.6",
-    "@agentstorm/kernel": "0.2.6",
-    "@agentstorm/protocol": "0.2.6",
+    "@agentstorm/agent-runtime": "0.2.8",
+    "@agentstorm/kernel": "0.2.8",
+    "@agentstorm/protocol": "0.2.8",
     "express": "^4.21.0"
   },
   "license": "AGPL-3.0-or-later",