u-foo 1.7.5 → 1.8.0

package/src/group/templateValidation.js

@@ -0,0 +1,99 @@
+"use strict";
+
+const { loadPromptProfileRegistry } = require("./promptProfiles");
+const { resolveTemplateReference } = require("./templates");
+const { validateTemplate } = require("./validateTemplate");
+
+function asTrimmedString(value) {
+  if (typeof value !== "string") return "";
+  return value.trim();
+}
+
+function formatResolveErrors(errors = []) {
+  if (!Array.isArray(errors) || errors.length === 0) return "";
+  return errors
+    .map((item) => `${item.filePath}: ${item.error || item.message || "unknown error"}`)
+    .join("; ");
+}
+
+function resolveTemplateTarget(projectRoot, target, options = {}) {
+  const rawTarget = asTrimmedString(target);
+  if (!rawTarget) {
+    return {
+      ok: false,
+      error: "template target is required",
+      entry: null,
+      resolveErrors: [],
+    };
+  }
+
+  const resolved = resolveTemplateReference(projectRoot, rawTarget, {
+    allowPath: options.allowPath !== false,
+    cwd: options.cwd || projectRoot,
+    ...(options.templatesOptions || {}),
+  });
+  if (!resolved.entry) {
+    const details = formatResolveErrors(resolved.errors || []);
+    return {
+      ok: false,
+      error: details
+        ? `failed to load template "${rawTarget}": ${details}`
+        : `template not found: ${rawTarget}`,
+      entry: null,
+      resolveErrors: resolved.errors || [],
+    };
+  }
+
+  return {
+    ok: true,
+    error: "",
+    entry: resolved.entry,
+    resolveErrors: resolved.errors || [],
+  };
+}
+
+function validateTemplateEntry(projectRoot, entry, options = {}) {
+  const promptRegistry = loadPromptProfileRegistry(projectRoot, options.promptProfilesOptions || {});
+  if (promptRegistry.errors.length > 0) {
+    return {
+      ok: false,
+      error: "prompt profile registry invalid",
+      errors: promptRegistry.errors.slice(),
+      entry,
+      promptRegistry,
+      promptProfiles: [],
+    };
+  }
+
+  const result = validateTemplate(entry.data, { promptProfileRegistry: promptRegistry });
+  return {
+    ok: result.ok,
+    error: result.ok ? "" : "template validation failed",
+    errors: result.errors || [],
+    entry,
+    promptRegistry,
+    promptProfiles: result.promptProfiles || [],
+  };
+}
+
+function validateTemplateTarget(projectRoot, target, options = {}) {
+  const resolved = resolveTemplateTarget(projectRoot, target, options);
+  if (!resolved.ok || !resolved.entry) {
+    return {
+      ok: false,
+      error: resolved.error,
+      errors: resolved.resolveErrors || [],
+      entry: null,
+      promptRegistry: null,
+      promptProfiles: [],
+    };
+  }
+  return validateTemplateEntry(projectRoot, resolved.entry, options);
+}
+
+module.exports = {
+  formatResolveErrors,
+  resolveTemplateTarget,
+  validateTemplateEntry,
+  validateTemplateTarget,
+};

package/src/group/validateTemplate.js

@@ -1,6 +1,7 @@
 "use strict";
 
-const ALLOWED_AGENT_TYPES = new Set(["codex", "claude", "ucode"]);
+const ALLOWED_AGENT_TYPES = new Set(["auto", "codex", "claude", "ucode"]);
+const { resolvePromptProfileReference } = require("./promptProfiles");
 
 function isPlainObject(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
@@ -93,12 +94,14 @@ function detectDependsCycle(agents = []) {
   return null;
 }
 
-function validateTemplate(doc) {
+function validateTemplate(doc, options = {}) {
   const errors = [];
+  const promptProfiles = [];
+  const promptProfileRegistry = options.promptProfileRegistry || null;
 
   if (!isPlainObject(doc)) {
     addError(errors, "$", "template document must be a JSON object");
-    return { ok: false, errors };
+    return { ok: false, errors, promptProfiles };
   }
 
   if (!Number.isInteger(doc.schema_version) || doc.schema_version < 1) {
@@ -121,7 +124,7 @@ function validateTemplate(doc) {
 
   if (!Array.isArray(doc.agents) || doc.agents.length === 0) {
     addError(errors, "agents", "agents must be a non-empty array");
-    return { ok: false, errors };
+    return { ok: false, errors, promptProfiles };
   }
 
   const knownNicknames = new Set();
@@ -156,6 +159,34 @@ function validateTemplate(doc) {
     if (!Number.isInteger(agent.startup_order) || agent.startup_order < 0) {
       addError(errors, `${basePath}.startup_order`, "startup_order must be an integer >= 0");
     }
+
+    if (agent.prompt_profile !== undefined) {
+      const requestedProfile = asTrimmedString(agent.prompt_profile);
+      if (!requestedProfile) {
+        addError(errors, `${basePath}.prompt_profile`, "prompt_profile must be a non-empty string");
+      } else if (promptProfileRegistry) {
+        const resolvedProfile = resolvePromptProfileReference(promptProfileRegistry, requestedProfile);
+        if (!resolvedProfile) {
+          addError(
+            errors,
+            `${basePath}.prompt_profile`,
+            `unknown prompt_profile "${requestedProfile}"`
+          );
+        } else {
+          promptProfiles.push({
+            index: i,
+            agent_id: asTrimmedString(agent.id),
+            nickname,
+            requested_profile: requestedProfile,
+            resolved_profile: resolvedProfile.id,
+            display_name: resolvedProfile.display_name || resolvedProfile.id,
+            short_name: resolvedProfile.short_name || "",
+            profile_source: resolvedProfile.source || "",
+            deprecated: resolvedProfile.deprecated === true,
+          });
+        }
+      }
+    }
   }
 
   for (let i = 0; i < doc.agents.length; i += 1) {
@@ -225,7 +256,7 @@ function validateTemplate(doc) {
     );
   }
 
-  return { ok: errors.length === 0, errors };
+  return { ok: errors.length === 0, errors, promptProfiles };
 }
 
 module.exports = {

package/src/init/index.js

@@ -19,20 +19,25 @@ class UfooInit {
   async init(options = {}) {
     const modules = (options.modules || "context").split(",");
     const project = options.project || process.cwd();
+    const controllerMode = options.controllerMode === true;
 
     console.log("=== ufoo init ===");
     console.log(`Project directory: ${project}`);
     console.log(`Modules: ${modules.join(", ")}`);
     console.log();
 
-    // 确保 AGENTS.md 和 CLAUDE.md 存在
-    this.ensureAgentsFiles(project);
+    if (!controllerMode) {
+      // 确保 AGENTS.md 和 CLAUDE.md 存在
+      this.ensureAgentsFiles(project);
+    }
 
     // 初始化核心
-    this.initCore(project);
+    this.initCore(project, { controllerMode });
 
-    // 初始化 AGENTS.md 模板
-    this.injectAgentsTemplate(project);
+    if (!controllerMode) {
+      // 初始化 AGENTS.md 模板
+      this.injectAgentsTemplate(project);
+    }
 
     // 初始化各模块
     for (const module of modules) {
@@ -82,8 +87,9 @@ class UfooInit {
   /**
    * 初始化核心 .ufoo 目录
    */
-  initCore(project) {
+  initCore(project, options = {}) {
     console.log("[core] Initializing .ufoo core...");
+    const controllerMode = options.controllerMode === true;
 
     const ufooDir = path.join(project, ".ufoo");
     if (!fs.existsSync(ufooDir)) {
@@ -94,7 +100,7 @@ class UfooInit {
     const docsLink = path.join(ufooDir, "docs");
     const projectDocs = path.join(project, "docs");
 
-    if (fs.existsSync(projectDocs)) {
+    if (!controllerMode && fs.existsSync(projectDocs)) {
       const linkStat = this.safeLstat(docsLink);
       if (linkStat) {
         fs.unlinkSync(docsLink);

package/src/report/store.js

@@ -216,6 +216,11 @@ function listControllerInboxEntries(projectRoot, controllerId = "ufoo-agent", op
   return rows.slice(rows.length - num);
 }
 
+function countControllerInboxEntries(projectRoot, controllerId = "ufoo-agent") {
+  const file = getControllerInboxFile(projectRoot, controllerId);
+  return parseJsonLines(file).length;
+}
+
 function clearControllerInbox(projectRoot, controllerId = "ufoo-agent") {
   const file = getControllerInboxFile(projectRoot, controllerId);
   try {
@@ -326,6 +331,7 @@ module.exports = {
   getControllerInboxFile,
   appendControllerInboxEntry,
   listControllerInboxEntries,
+  countControllerInboxEntries,
   clearControllerInbox,
   consumeControllerInboxEntries,
 };

package/src/shared/eventContract.js

@@ -17,6 +17,7 @@ const IPC_REQUEST_TYPES = {
   REGISTER_AGENT: "register_agent",
   AGENT_READY: "agent_ready",
   AGENT_REPORT: "agent_report",
+  ASSIGN_ROLE: "assign_role",
 };
 
 const IPC_RESPONSE_TYPES = {

package/templates/groups/{dev-basic.json → build-lane.json}

@@ -1,9 +1,9 @@
 {
   "schema_version": 1,
   "template": {
-    "id": "software-dev-basic",
-    "alias": "dev-basic",
-    "name": "Software Dev Basic"
+    "id": "build-lane",
+    "alias": "build-lane",
+    "name": "Build Lane"
   },
   "defaults": {
     "launch_mode": "auto",
@@ -11,68 +11,72 @@
   },
   "agents": [
     {
-      "id": "pm",
-      "nickname": "pm",
-      "type": "codex",
-      "role": "task coordinator",
-      "prompt_profile": "task-breakdown",
+      "id": "architect",
+      "nickname": "architect",
+      "type": "auto",
+      "role": "define slices and architecture constraints",
+      "prompt_profile": "system-architect",
       "accept_from": [],
-      "report_to": [],
+      "report_to": [
+        "builder",
+        "reviewer"
+      ],
       "startup_order": 1,
       "depends_on": []
     },
     {
-      "id": "architect",
-      "nickname": "architect",
-      "type": "claude",
-      "role": "system architect",
-      "prompt_profile": "architecture-review",
+      "id": "builder",
+      "nickname": "builder",
+      "type": "auto",
+      "role": "implement approved slices",
+      "prompt_profile": "implementation-lead",
       "accept_from": [
-        "pm"
+        "architect",
+        "reviewer"
       ],
       "report_to": [
-        "pm"
+        "reviewer"
       ],
       "startup_order": 2,
       "depends_on": [
-        "pm"
+        "architect"
       ]
     },
     {
-      "id": "builder",
-      "nickname": "builder",
-      "type": "codex",
-      "role": "implementation engineer",
-      "prompt_profile": "code-implement",
+      "id": "reviewer",
+      "nickname": "reviewer",
+      "type": "auto",
+      "role": "review correctness and risk",
+      "prompt_profile": "review-critic",
       "accept_from": [
-        "pm",
-        "architect"
+        "architect",
+        "builder"
       ],
       "report_to": [
-        "pm"
+        "builder"
       ],
       "startup_order": 3,
       "depends_on": [
-        "pm",
-        "architect"
+        "architect",
+        "builder"
       ]
     }
   ],
   "edges": [
     {
-      "from": "pm",
-      "to": "architect",
+      "from": "architect",
+      "to": "builder",
       "kind": "task"
     },
     {
-      "from": "pm",
-      "to": "builder",
-      "kind": "task"
+      "from": "builder",
+      "to": "reviewer",
+      "kind": "review"
     },
     {
-      "from": "architect",
+      "from": "reviewer",
       "to": "builder",
-      "kind": "review"
+      "kind": "task"
     }
   ]
 }

package/templates/groups/product-discovery.json

@@ -0,0 +1,79 @@
+{
+  "schema_version": 1,
+  "template": {
+    "id": "product-discovery",
+    "alias": "product-discovery",
+    "name": "Product Discovery"
+  },
+  "defaults": {
+    "launch_mode": "auto",
+    "start_timeout_ms": 15000
+  },
+  "agents": [
+    {
+      "id": "facilitator",
+      "nickname": "facilitator",
+      "type": "auto",
+      "role": "clarify the real problem and define a narrow wedge",
+      "prompt_profile": "discovery-facilitator",
+      "accept_from": [],
+      "report_to": [
+        "challenger",
+        "architect"
+      ],
+      "startup_order": 1,
+      "depends_on": []
+    },
+    {
+      "id": "challenger",
+      "nickname": "challenger",
+      "type": "auto",
+      "role": "challenge scope and leverage",
+      "prompt_profile": "scope-challenger",
+      "accept_from": [
+        "facilitator"
+      ],
+      "report_to": [
+        "architect"
+      ],
+      "startup_order": 2,
+      "depends_on": [
+        "facilitator"
+      ]
+    },
+    {
+      "id": "architect",
+      "nickname": "architect",
+      "type": "auto",
+      "role": "translate approved scope into a technical plan",
+      "prompt_profile": "system-architect",
+      "accept_from": [
+        "facilitator",
+        "challenger"
+      ],
+      "report_to": [],
+      "startup_order": 3,
+      "depends_on": [
+        "facilitator",
+        "challenger"
+      ]
+    }
+  ],
+  "edges": [
+    {
+      "from": "facilitator",
+      "to": "challenger",
+      "kind": "task"
+    },
+    {
+      "from": "facilitator",
+      "to": "architect",
+      "kind": "task"
+    },
+    {
+      "from": "challenger",
+      "to": "architect",
+      "kind": "review"
+    }
+  ]
+}

package/templates/groups/ui-polish.json

@@ -0,0 +1,87 @@
+{
+  "schema_version": 1,
+  "template": {
+    "id": "ui-polish",
+    "alias": "ui-polish",
+    "name": "UI Polish"
+  },
+  "defaults": {
+    "launch_mode": "auto",
+    "start_timeout_ms": 15000
+  },
+  "agents": [
+    {
+      "id": "designer",
+      "nickname": "designer",
+      "type": "auto",
+      "role": "audit the interface and rank design polish issues",
+      "prompt_profile": "design-critic",
+      "accept_from": [],
+      "report_to": [
+        "refiner",
+        "qa"
+      ],
+      "startup_order": 1,
+      "depends_on": []
+    },
+    {
+      "id": "refiner",
+      "nickname": "refiner",
+      "type": "auto",
+      "role": "implement focused UI and interaction refinements",
+      "prompt_profile": "frontend-refiner",
+      "accept_from": [
+        "designer",
+        "qa"
+      ],
+      "report_to": [
+        "qa"
+      ],
+      "startup_order": 2,
+      "depends_on": [
+        "designer"
+      ]
+    },
+    {
+      "id": "qa",
+      "nickname": "qa",
+      "type": "auto",
+      "role": "validate polish changes and catch UX regressions",
+      "prompt_profile": "qa-driver",
+      "accept_from": [
+        "designer",
+        "refiner"
+      ],
+      "report_to": [
+        "refiner"
+      ],
+      "startup_order": 3,
+      "depends_on": [
+        "designer",
+        "refiner"
+      ]
+    }
+  ],
+  "edges": [
+    {
+      "from": "designer",
+      "to": "refiner",
+      "kind": "task"
+    },
+    {
+      "from": "designer",
+      "to": "qa",
+      "kind": "review"
+    },
+    {
+      "from": "refiner",
+      "to": "qa",
+      "kind": "task"
+    },
+    {
+      "from": "qa",
+      "to": "refiner",
+      "kind": "review"
+    }
+  ]
+}

package/templates/groups/verify-ship.json

@@ -0,0 +1,79 @@
+{
+  "schema_version": 1,
+  "template": {
+    "id": "verify-ship",
+    "alias": "verify-ship",
+    "name": "Verify and Ship"
+  },
+  "defaults": {
+    "launch_mode": "auto",
+    "start_timeout_ms": 15000
+  },
+  "agents": [
+    {
+      "id": "qa",
+      "nickname": "qa",
+      "type": "auto",
+      "role": "validate user flows and capture defects",
+      "prompt_profile": "qa-driver",
+      "accept_from": [],
+      "report_to": [
+        "debugger",
+        "release"
+      ],
+      "startup_order": 1,
+      "depends_on": []
+    },
+    {
+      "id": "debugger",
+      "nickname": "debugger",
+      "type": "auto",
+      "role": "identify root cause for hard failures",
+      "prompt_profile": "debug-investigator",
+      "accept_from": [
+        "qa"
+      ],
+      "report_to": [
+        "release"
+      ],
+      "startup_order": 2,
+      "depends_on": [
+        "qa"
+      ]
+    },
+    {
+      "id": "release",
+      "nickname": "release",
+      "type": "auto",
+      "role": "judge release readiness and blockers",
+      "prompt_profile": "release-coordinator",
+      "accept_from": [
+        "qa",
+        "debugger"
+      ],
+      "report_to": [],
+      "startup_order": 3,
+      "depends_on": [
+        "qa",
+        "debugger"
+      ]
+    }
+  ],
+  "edges": [
+    {
+      "from": "qa",
+      "to": "debugger",
+      "kind": "task"
+    },
+    {
+      "from": "qa",
+      "to": "release",
+      "kind": "task"
+    },
+    {
+      "from": "debugger",
+      "to": "release",
+      "kind": "review"
+    }
+  ]
+}

package/templates/groups/research-quick.json

@@ -1,49 +0,0 @@
-{
-  "schema_version": 1,
-  "template": {
-    "id": "research-quick",
-    "alias": "research-quick",
-    "name": "Research Quick"
-  },
-  "defaults": {
-    "launch_mode": "auto",
-    "start_timeout_ms": 10000
-  },
-  "agents": [
-    {
-      "id": "researcher",
-      "nickname": "researcher",
-      "type": "claude",
-      "role": "collect references and summarize findings",
-      "prompt_profile": "research-scan",
-      "accept_from": [],
-      "report_to": [],
-      "startup_order": 1,
-      "depends_on": []
-    },
-    {
-      "id": "coder",
-      "nickname": "coder",
-      "type": "codex",
-      "role": "prototype and verify implementation",
-      "prompt_profile": "rapid-prototype",
-      "accept_from": [
-        "researcher"
-      ],
-      "report_to": [
-        "researcher"
-      ],
-      "startup_order": 2,
-      "depends_on": [
-        "researcher"
-      ]
-    }
-  ],
-  "edges": [
-    {
-      "from": "researcher",
-      "to": "coder",
-      "kind": "task"
-    }
-  ]
-}