ai-team 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+# [1.3.0](https://github.com/seanwuapps/ai-team/compare/v1.2.0...v1.3.0) (2026-02-23)
+
+
+### Features
+
+* ensure mandatory agents are included in profiles and templates ([f48c99c](https://github.com/seanwuapps/ai-team/commit/f48c99c3953303dfee9e552c56dffe36979a692c))
+* update mandatory agents to include product-team-orchestrator ([16bbc8e](https://github.com/seanwuapps/ai-team/commit/16bbc8e5a1292f6c68a00e01be68d14073817741))
+
 # [1.2.0](https://github.com/seanwuapps/ai-team/compare/v1.1.0...v1.2.0) (2026-02-23)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-team",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "AI agent team management CLI tool",
   "type": "module",
   "main": "src/cli.js",

package/src/lib/prompts.js

@@ -4,6 +4,10 @@ import { fileURLToPath } from "node:url";
 import { readdir, readFile } from "node:fs/promises";
 import { confirm, select, checkbox } from "@inquirer/prompts";
 import YAML from "yaml";
+import {
+  MANDATORY_AGENTS,
+  ensureMandatoryAgents,
+} from "./template-registry.js";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const definitionsDir = path.resolve(__dirname, "../agents/definitions");
@@ -47,7 +51,7 @@ export async function collectInteractiveProfile({
       ide: ide ?? "vscode",
       team: team ?? "web-product",
       includeMcp: includeMcp ?? true,
-      agents: agents ?? null,
+      agents: ensureMandatoryAgents(agents),
     };
   }
 
@@ -80,6 +84,7 @@ export async function collectInteractiveProfile({
         name: def.emoji ? `${def.emoji}  ${def.name}` : def.name,
         value: def.name,
         checked: true,
+        disabled: MANDATORY_AGENTS.includes(def.name) ? "required" : undefined,
         description: def.description,
       })),
     });
@@ -87,6 +92,8 @@ export async function collectInteractiveProfile({
       selected.length > 0 ? selected : definitions.map((d) => d.name);
   }
 
+  agentsAnswer = ensureMandatoryAgents(agentsAnswer);
+
   let includeMcpAnswer = includeMcp;
   if (includeMcpAnswer === undefined) {
     includeMcpAnswer = await confirm({

package/src/lib/sync-engine.js

@@ -7,6 +7,7 @@ import {
   createManifest,
   bumpManifest,
 } from "./manifest.js";
+import { ensureMandatoryAgents } from "./template-registry.js";
 import { readTextIfExists, writeText } from "./fs-utils.js";
 import { hashText } from "./hash.js";
 import { detectLegacyLayout, applyLegacyMigration } from "./migration.js";
@@ -102,11 +103,16 @@ export async function planSync({
   force = false,
   command = "plan",
 }) {
+  const normalizedProfile = {
+    ...profile,
+    agents: ensureMandatoryAgents(profile.agents),
+  };
+
   const { templateVersion, schemaVersion, entries } =
     await collectTemplateEntries({
-      ide: profile.ide,
-      includeMcp: profile.includeMcp,
-      agents: profile.agents ?? null,
+      ide: normalizedProfile.ide,
+      includeMcp: normalizedProfile.includeMcp,
+      agents: normalizedProfile.agents,
     });
 
   const installedManifest = await loadInstalledManifest(targetDir);
@@ -176,7 +182,7 @@ export async function planSync({
   return {
     command,
     targetDir,
-    profile,
+    profile: normalizedProfile,
     schemaVersion,
     templateVersion,
     hasManifest: Boolean(installedManifest),

package/src/lib/template-registry.js

@@ -8,6 +8,26 @@ import { generateAgentEntriesForIde } from "../agents/generate.js";
 
 const dirname = path.dirname(fileURLToPath(import.meta.url));
 export const TEMPLATE_ROOT = path.resolve(dirname, "../../templates/bootstrap");
+export const MANDATORY_AGENTS = ["agent-manager", "product-team-orchestrator"];
+
+export function ensureMandatoryAgents(agents) {
+  if (!Array.isArray(agents) || agents.length === 0) {
+    return null;
+  }
+
+  const normalized = new Set(
+    agents
+      .filter((value) => typeof value === "string")
+      .map((value) => value.trim())
+      .filter(Boolean),
+  );
+
+  for (const mandatoryAgent of MANDATORY_AGENTS) {
+    normalized.add(mandatoryAgent);
+  }
+
+  return Array.from(normalized);
+}
 
 export async function loadTemplateManifest() {
   const filePath = path.join(TEMPLATE_ROOT, "manifest.json");
@@ -87,8 +107,8 @@ export async function collectTemplateEntries({ ide, includeMcp, agents }) {
   const entries = [];
 
   // Normalise agent filter to a Set for fast lookup (null/undefined = include all)
-  const agentFilter =
-    Array.isArray(agents) && agents.length > 0 ? new Set(agents) : null;
+  const normalizedAgents = ensureMandatoryAgents(agents);
+  const agentFilter = normalizedAgents ? new Set(normalizedAgents) : null;
 
   for (const absolutePath of baseFiles) {
     const relative = path.relative(baseRoot, absolutePath);

package/tests/sync-engine.test.js

@@ -105,3 +105,26 @@ test("json merge keeps local MCP servers in safe mode", async () => {
   const updated = JSON.parse(await fs.readFile(mcpPath, "utf8"));
   assert.ok(updated.servers["custom-local"]);
 });
+
+test("applySync persists mandatory agent-manager in manifest profile", async () => {
+  const targetDir = await makeTempDir();
+  const profile = {
+    ide: "vscode",
+    team: "web-product",
+    includeMcp: true,
+    agents: ["planning-agent"],
+  };
+
+  const plan = await planSync({ targetDir, profile });
+  const result = await applySync(plan);
+
+  assert.deepEqual(result.manifest.profile.agents, [
+    "planning-agent",
+    "agent-manager",
+  ]);
+  assert.ok(
+    plan.actions.some(
+      (action) => action.targetPath === ".github/agents/agent-manager.agent.md",
+    ),
+  );
+});

package/tests/template-registry.test.js

@@ -30,6 +30,21 @@ test("collectTemplateEntries omits MCP output when includeMcp is false", async (
   assert.ok(result.entries.every((entry) => entry.targetPath !== ".mcp.json"));
 });
 
+test("collectTemplateEntries always includes agent-manager", async () => {
+  const result = await collectTemplateEntries({
+    ide: "vscode",
+    includeMcp: false,
+    agents: ["planning-agent"],
+  });
+
+  const generatedAgents = result.entries
+    .filter((entry) => entry.targetPath.startsWith(".github/agents/"))
+    .map((entry) => entry.targetPath);
+
+  assert.ok(generatedAgents.includes(".github/agents/planning-agent.agent.md"));
+  assert.ok(generatedAgents.includes(".github/agents/agent-manager.agent.md"));
+});
+
 test("getIdePack supports legacy packs.overlays manifest shape", () => {
   const legacyManifest = {
     packs: {