aigent-team 0.3.0 → 0.4.0

package/dist/cli.js

@@ -5,17 +5,22 @@ import {
   PLATFORMS,
   PLUGIN_BUNDLE_DIRS,
   TEAM_ROLES,
+  assembleAsset,
+  assembleExample,
+  assembleOutputContract,
   assembleReference,
+  assembleScript,
   assembleSkill,
   assembleSkillIndex,
   configExists,
   loadAgents,
-  loadConfig
-} from "./chunk-RH4B2QFX.js";
+  loadConfig,
+  parseFrontmatter
+} from "./chunk-OMO7OMKB.js";
 
 // bin/cli.ts
 import { Command } from "commander";
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 
 // src/cli/init.ts
 import { writeFileSync } from "fs";
@@ -163,6 +168,10 @@ var BaseCompiler = class {
         normalized.add("agents");
         normalized.add("skills");
         normalized.add("references");
+        normalized.add("examples");
+        normalized.add("output-contracts");
+        normalized.add("scripts");
+        normalized.add("assets");
       } else {
         normalized.add(s);
       }
@@ -178,6 +187,18 @@ var BaseCompiler = class {
     if (normalized.has("references")) {
       outputs.push(...this.compileAllReferences(agents));
     }
+    if (normalized.has("examples")) {
+      outputs.push(...this.compileAllExamples(agents));
+    }
+    if (normalized.has("output-contracts")) {
+      outputs.push(...this.compileAllOutputContracts(agents));
+    }
+    if (normalized.has("scripts")) {
+      outputs.push(...this.compileAllScripts(agents));
+    }
+    if (normalized.has("assets")) {
+      outputs.push(...this.compileAllAssets(agents));
+    }
     return outputs;
   }
   /**
@@ -186,7 +207,7 @@ var BaseCompiler = class {
    */
   countArtifacts(outputs, rootDir) {
     const counts = {};
-    const categories = ["rules", "skills", "agents", "kb", "ai"];
+    const categories = ["rules", "skills", "agents", "kb", "examples", "contracts", "ai"];
     for (const cat of categories) {
       const prefix = `${rootDir}/${cat}/`;
       const count = outputs.filter((o) => o.filePath.startsWith(prefix)).length;
@@ -194,6 +215,30 @@ var BaseCompiler = class {
     }
     return counts;
   }
+  /**
+   * Compile all example files. Default no-op — override in subclasses.
+   */
+  compileAllExamples(_agents) {
+    return [];
+  }
+  /**
+   * Compile all output contract files. Default no-op — override in subclasses.
+   */
+  compileAllOutputContracts(_agents) {
+    return [];
+  }
+  /**
+   * Compile all script files. Default no-op — override in subclasses.
+   */
+  compileAllScripts(_agents) {
+    return [];
+  }
+  /**
+   * Compile all asset files. Default no-op — override in subclasses.
+   */
+  compileAllAssets(_agents) {
+    return [];
+  }
   // ---- Shared helpers ----
   /**
    * Compile reference files for an agent into a given directory.
@@ -219,6 +264,50 @@ var BaseCompiler = class {
       overwriteStrategy: "replace"
     }));
   }
+  /**
+   * Compile example files for an agent into a given directory.
+   */
+  compileExamples(agent, baseDir, extension = ".md") {
+    if (!agent.examples?.length) return [];
+    return agent.examples.map((example) => ({
+      filePath: `${baseDir}/${example.id}${extension}`,
+      content: assembleExample(example) + "\n",
+      overwriteStrategy: "replace"
+    }));
+  }
+  /**
+   * Compile output contract files for an agent into a given directory.
+   */
+  compileOutputContracts(agent, baseDir, extension = ".md") {
+    if (!agent.outputContracts?.length) return [];
+    return agent.outputContracts.map((contract) => ({
+      filePath: `${baseDir}/${contract.id}${extension}`,
+      content: assembleOutputContract(contract) + "\n",
+      overwriteStrategy: "replace"
+    }));
+  }
+  /**
+   * Compile script files for an agent into a given directory.
+   */
+  compileScriptFiles(agent, baseDir, extension = ".md") {
+    if (!agent.scripts?.length) return [];
+    return agent.scripts.map((script) => ({
+      filePath: `${baseDir}/${script.id}${extension}`,
+      content: assembleScript(script) + "\n",
+      overwriteStrategy: "replace"
+    }));
+  }
+  /**
+   * Compile asset files for an agent into a given directory.
+   */
+  compileAssetFiles(agent, baseDir, extension = ".md") {
+    if (!agent.assets?.length) return [];
+    return agent.assets.map((asset) => ({
+      filePath: `${baseDir}/${asset.id}${extension}`,
+      content: assembleAsset(asset) + "\n",
+      overwriteStrategy: "replace"
+    }));
+  }
   formatFrontmatter(data) {
     const lines = ["---"];
     for (const [key, value] of Object.entries(data)) {
@@ -306,6 +395,46 @@ ${body}
     }
     return outputs;
   }
+  compileAllExamples(agents) {
+    const outputs = [];
+    for (const agent of agents) {
+      outputs.push(...this.compileExamples(
+        agent,
+        `.claude/agents/${agent.id}-agent/examples`
+      ));
+    }
+    return outputs;
+  }
+  compileAllOutputContracts(agents) {
+    const outputs = [];
+    for (const agent of agents) {
+      outputs.push(...this.compileOutputContracts(
+        agent,
+        `.claude/agents/${agent.id}-agent/contracts`
+      ));
+    }
+    return outputs;
+  }
+  compileAllScripts(agents) {
+    const outputs = [];
+    for (const agent of agents) {
+      outputs.push(...this.compileScriptFiles(
+        agent,
+        `.claude/agents/${agent.id}-agent/scripts`
+      ));
+    }
+    return outputs;
+  }
+  compileAllAssets(agents) {
+    const outputs = [];
+    for (const agent of agents) {
+      outputs.push(...this.compileAssetFiles(
+        agent,
+        `.claude/agents/${agent.id}-agent/assets`
+      ));
+    }
+    return outputs;
+  }
   compilePluginBundle(agents, config, rootDir) {
     const outputs = [];
     const agentList = agents.map((a) => `- **${a.name}** (\`${a.id}\`): ${a.description.trim().split("\n")[0]}`).join("\n");
@@ -363,6 +492,46 @@ ${body}
         });
       }
     }
+    for (const agent of agents) {
+      if (!agent.examples?.length) continue;
+      for (const example of agent.examples) {
+        outputs.push({
+          filePath: `${rootDir}/examples/${agent.id}/${example.id}.md`,
+          content: assembleExample(example) + "\n",
+          overwriteStrategy: "replace"
+        });
+      }
+    }
+    for (const agent of agents) {
+      if (!agent.outputContracts?.length) continue;
+      for (const contract of agent.outputContracts) {
+        outputs.push({
+          filePath: `${rootDir}/contracts/${agent.id}/${contract.id}.md`,
+          content: assembleOutputContract(contract) + "\n",
+          overwriteStrategy: "replace"
+        });
+      }
+    }
+    for (const agent of agents) {
+      if (!agent.scripts?.length) continue;
+      for (const script of agent.scripts) {
+        outputs.push({
+          filePath: `${rootDir}/scripts/${agent.id}/${script.id}.md`,
+          content: assembleScript(script) + "\n",
+          overwriteStrategy: "replace"
+        });
+      }
+    }
+    for (const agent of agents) {
+      if (!agent.assets?.length) continue;
+      for (const asset of agent.assets) {
+        outputs.push({
+          filePath: `${rootDir}/assets/${agent.id}/${asset.id}.md`,
+          content: assembleAsset(asset) + "\n",
+          overwriteStrategy: "replace"
+        });
+      }
+    }
     const sharedKnowledge = agents.flatMap((a) => a.sharedKnowledge).filter((v, i, arr) => arr.indexOf(v) === i && v);
     for (let i = 0; i < sharedKnowledge.length; i++) {
       outputs.push({
@@ -491,6 +660,50 @@ ${ref.content}
     }
     return outputs;
   }
+  compileAllExamples(agents) {
+    const outputs = [];
+    for (const agent of agents) {
+      outputs.push(...this.compileExamples(
+        agent,
+        `.cursor/rules/${agent.id}-examples`,
+        ".mdc"
+      ));
+    }
+    return outputs;
+  }
+  compileAllOutputContracts(agents) {
+    const outputs = [];
+    for (const agent of agents) {
+      outputs.push(...this.compileOutputContracts(
+        agent,
+        `.cursor/rules/${agent.id}-contracts`,
+        ".mdc"
+      ));
+    }
+    return outputs;
+  }
+  compileAllScripts(agents) {
+    const outputs = [];
+    for (const agent of agents) {
+      outputs.push(...this.compileScriptFiles(
+        agent,
+        `.cursor/rules/${agent.id}-scripts`,
+        ".mdc"
+      ));
+    }
+    return outputs;
+  }
+  compileAllAssets(agents) {
+    const outputs = [];
+    for (const agent of agents) {
+      outputs.push(...this.compileAssetFiles(
+        agent,
+        `.cursor/rules/${agent.id}-assets`,
+        ".mdc"
+      ));
+    }
+    return outputs;
+  }
   compilePluginBundle(agents, config, rootDir) {
     const outputs = [];
     const pluginId = toKebabCursorPluginId(config.projectName);
@@ -576,6 +789,82 @@ ${assembleSkill(skill)}
           content: `${refFrontmatter}
 
 ${assembleReference(ref)}
+`,
+          overwriteStrategy: "replace"
+        });
+      }
+    }
+    for (const agent of agents) {
+      if (!agent.examples?.length) continue;
+      const globs = agent.globs?.length ? agent.globs.join(", ") : void 0;
+      for (const example of agent.examples) {
+        const exFrontmatter = this.formatFrontmatter({
+          description: `${agent.name} example: ${example.name}`,
+          alwaysApply: false,
+          globs: globs || void 0
+        });
+        outputs.push({
+          filePath: `${rootDir}/examples/${agent.id}/${example.id}.mdc`,
+          content: `${exFrontmatter}
+
+${assembleExample(example)}
+`,
+          overwriteStrategy: "replace"
+        });
+      }
+    }
+    for (const agent of agents) {
+      if (!agent.outputContracts?.length) continue;
+      const globs = agent.globs?.length ? agent.globs.join(", ") : void 0;
+      for (const contract of agent.outputContracts) {
+        const cFrontmatter = this.formatFrontmatter({
+          description: `${agent.name} contract: ${contract.name}`,
+          alwaysApply: false,
+          globs: globs || void 0
+        });
+        outputs.push({
+          filePath: `${rootDir}/contracts/${agent.id}/${contract.id}.mdc`,
+          content: `${cFrontmatter}
+
+${assembleOutputContract(contract)}
+`,
+          overwriteStrategy: "replace"
+        });
+      }
+    }
+    for (const agent of agents) {
+      if (!agent.scripts?.length) continue;
+      const globs = agent.globs?.length ? agent.globs.join(", ") : void 0;
+      for (const script of agent.scripts) {
+        const sFrontmatter = this.formatFrontmatter({
+          description: `${agent.name} script: ${script.name}`,
+          alwaysApply: false,
+          globs: globs || void 0
+        });
+        outputs.push({
+          filePath: `${rootDir}/scripts/${agent.id}/${script.id}.mdc`,
+          content: `${sFrontmatter}
+
+${assembleScript(script)}
+`,
+          overwriteStrategy: "replace"
+        });
+      }
+    }
+    for (const agent of agents) {
+      if (!agent.assets?.length) continue;
+      const globs = agent.globs?.length ? agent.globs.join(", ") : void 0;
+      for (const asset of agent.assets) {
+        const aFrontmatter = this.formatFrontmatter({
+          description: `${agent.name} asset: ${asset.name}`,
+          alwaysApply: false,
+          globs: globs || void 0
+        });
+        outputs.push({
+          filePath: `${rootDir}/assets/${agent.id}/${asset.id}.mdc`,
+          content: `${aFrontmatter}
+
+${assembleAsset(asset)}
 `,
           overwriteStrategy: "replace"
         });
@@ -669,6 +958,46 @@ ${body}
     }
     return outputs;
   }
+  compileAllExamples(agents) {
+    const outputs = [];
+    for (const agent of agents) {
+      outputs.push(...this.compileExamples(
+        agent,
+        `.codex/agents/${agent.id}-agent/examples`
+      ));
+    }
+    return outputs;
+  }
+  compileAllOutputContracts(agents) {
+    const outputs = [];
+    for (const agent of agents) {
+      outputs.push(...this.compileOutputContracts(
+        agent,
+        `.codex/agents/${agent.id}-agent/contracts`
+      ));
+    }
+    return outputs;
+  }
+  compileAllScripts(agents) {
+    const outputs = [];
+    for (const agent of agents) {
+      outputs.push(...this.compileScriptFiles(
+        agent,
+        `.codex/agents/${agent.id}-agent/scripts`
+      ));
+    }
+    return outputs;
+  }
+  compileAllAssets(agents) {
+    const outputs = [];
+    for (const agent of agents) {
+      outputs.push(...this.compileAssetFiles(
+        agent,
+        `.codex/agents/${agent.id}-agent/assets`
+      ));
+    }
+    return outputs;
+  }
   compilePluginBundle(agents, _config, rootDir) {
     const outputs = [];
     const sections = agents.map((agent) => {
@@ -729,6 +1058,46 @@ ${body}
         });
       }
     }
+    for (const agent of agents) {
+      if (!agent.examples?.length) continue;
+      for (const example of agent.examples) {
+        outputs.push({
+          filePath: `${rootDir}/examples/${agent.id}/${example.id}.md`,
+          content: assembleExample(example) + "\n",
+          overwriteStrategy: "replace"
+        });
+      }
+    }
+    for (const agent of agents) {
+      if (!agent.outputContracts?.length) continue;
+      for (const contract of agent.outputContracts) {
+        outputs.push({
+          filePath: `${rootDir}/contracts/${agent.id}/${contract.id}.md`,
+          content: assembleOutputContract(contract) + "\n",
+          overwriteStrategy: "replace"
+        });
+      }
+    }
+    for (const agent of agents) {
+      if (!agent.scripts?.length) continue;
+      for (const script of agent.scripts) {
+        outputs.push({
+          filePath: `${rootDir}/scripts/${agent.id}/${script.id}.md`,
+          content: assembleScript(script) + "\n",
+          overwriteStrategy: "replace"
+        });
+      }
+    }
+    for (const agent of agents) {
+      if (!agent.assets?.length) continue;
+      for (const asset of agent.assets) {
+        outputs.push({
+          filePath: `${rootDir}/assets/${agent.id}/${asset.id}.md`,
+          content: assembleAsset(asset) + "\n",
+          overwriteStrategy: "replace"
+        });
+      }
+    }
     return outputs;
   }
   validate(outputs) {
@@ -817,6 +1186,46 @@ ${body}
     }
     return outputs;
   }
+  compileAllExamples(agents) {
+    const outputs = [];
+    for (const agent of agents) {
+      outputs.push(...this.compileExamples(
+        agent,
+        `.agents/skills/${agent.id}-agent/examples`
+      ));
+    }
+    return outputs;
+  }
+  compileAllOutputContracts(agents) {
+    const outputs = [];
+    for (const agent of agents) {
+      outputs.push(...this.compileOutputContracts(
+        agent,
+        `.agents/skills/${agent.id}-agent/contracts`
+      ));
+    }
+    return outputs;
+  }
+  compileAllScripts(agents) {
+    const outputs = [];
+    for (const agent of agents) {
+      outputs.push(...this.compileScriptFiles(
+        agent,
+        `.agents/skills/${agent.id}-agent/scripts`
+      ));
+    }
+    return outputs;
+  }
+  compileAllAssets(agents) {
+    const outputs = [];
+    for (const agent of agents) {
+      outputs.push(...this.compileAssetFiles(
+        agent,
+        `.agents/skills/${agent.id}-agent/assets`
+      ));
+    }
+    return outputs;
+  }
   compilePluginBundle(agents, _config, rootDir) {
     const outputs = [];
     const agentList = agents.map((a) => `- **${a.name}** (\`${a.id}\`): ${a.description.trim().split("\n")[0]}`).join("\n");
@@ -872,6 +1281,46 @@ ${body}
         });
       }
     }
+    for (const agent of agents) {
+      if (!agent.examples?.length) continue;
+      for (const example of agent.examples) {
+        outputs.push({
+          filePath: `${rootDir}/examples/${agent.id}/${example.id}.md`,
+          content: assembleExample(example) + "\n",
+          overwriteStrategy: "replace"
+        });
+      }
+    }
+    for (const agent of agents) {
+      if (!agent.outputContracts?.length) continue;
+      for (const contract of agent.outputContracts) {
+        outputs.push({
+          filePath: `${rootDir}/contracts/${agent.id}/${contract.id}.md`,
+          content: assembleOutputContract(contract) + "\n",
+          overwriteStrategy: "replace"
+        });
+      }
+    }
+    for (const agent of agents) {
+      if (!agent.scripts?.length) continue;
+      for (const script of agent.scripts) {
+        outputs.push({
+          filePath: `${rootDir}/scripts/${agent.id}/${script.id}.md`,
+          content: assembleScript(script) + "\n",
+          overwriteStrategy: "replace"
+        });
+      }
+    }
+    for (const agent of agents) {
+      if (!agent.assets?.length) continue;
+      for (const asset of agent.assets) {
+        outputs.push({
+          filePath: `${rootDir}/assets/${agent.id}/${asset.id}.md`,
+          content: assembleAsset(asset) + "\n",
+          overwriteStrategy: "replace"
+        });
+      }
+    }
     const sharedKnowledge = agents.flatMap((a) => a.sharedKnowledge).filter((v, i, arr) => arr.indexOf(v) === i && v);
     for (let i = 0; i < sharedKnowledge.length; i++) {
       outputs.push({
@@ -951,10 +1400,30 @@ var PluginCompiler = class {
       files: {
         agents: agents.length,
         skills: agents.reduce((sum, a) => sum + a.skills.length, 0),
-        references: agents.reduce((sum, a) => sum + a.references.length, 0)
+        references: agents.reduce((sum, a) => sum + a.references.length, 0),
+        examples: agents.reduce((sum, a) => sum + (a.examples?.length ?? 0), 0),
+        outputContracts: agents.reduce((sum, a) => sum + (a.outputContracts?.length ?? 0), 0),
+        scripts: agents.reduce((sum, a) => sum + (a.scripts?.length ?? 0), 0),
+        assets: agents.reduce((sum, a) => sum + (a.assets?.length ?? 0), 0)
       },
       bundles
     };
+    const governanceEntries = [];
+    for (const agent of agents) {
+      for (const skill of agent.skills) {
+        if (skill.governance) {
+          governanceEntries.push({
+            skillId: skill.id,
+            agentId: agent.id,
+            name: skill.name,
+            governance: skill.governance
+          });
+        }
+      }
+    }
+    if (governanceEntries.length) {
+      manifest.governance = governanceEntries;
+    }
     outputs.push({
       filePath: `${pluginDir}/manifest.json`,
       content: JSON.stringify(manifest, null, 2) + "\n",
@@ -1017,7 +1486,11 @@ async function promptGenerateOptions(configTeams, configPlatforms) {
       choices: [
         { name: "Agents", value: "agents", checked: true },
         { name: "Skills", value: "skills", checked: true },
-        { name: "References", value: "references", checked: true }
+        { name: "References", value: "references", checked: true },
+        { name: "Examples", value: "examples", checked: true },
+        { name: "Output Contracts", value: "output-contracts", checked: true },
+        { name: "Scripts", value: "scripts", checked: true },
+        { name: "Assets", value: "assets", checked: true }
       ]
     },
     {
@@ -1165,6 +1638,10 @@ function loadPlugin(pluginPath) {
     const skillContent = readFileSync3(agentFilePath, "utf-8").trim();
     const skills = loadSkillFiles(resolve5(bundleDir, "skills", meta.id));
     const references = loadReferenceFiles(resolve5(bundleDir, "kb", meta.id));
+    const examples = loadExampleFiles(resolve5(bundleDir, "examples", meta.id));
+    const outputContracts = loadOutputContractFiles(resolve5(bundleDir, "contracts", meta.id));
+    const scripts = loadScriptFilesFromPlugin(resolve5(bundleDir, "scripts", meta.id));
+    const assets = loadAssetFilesFromPlugin(resolve5(bundleDir, "assets", meta.id));
     const sharedKnowledge = loadSharedKnowledge(resolve5(bundleDir, "kb", "shared"));
     agents.push({
       id: meta.id,
@@ -1180,6 +1657,10 @@ function loadPlugin(pluginPath) {
       rulesContent: "",
       skills,
       references,
+      examples,
+      outputContracts,
+      scripts,
+      assets,
       sharedKnowledge,
       // Unused during install — compilers only need the fields above
       systemPrompt: "",
@@ -1207,13 +1688,16 @@ function loadSkillFiles(dir) {
   if (!existsSync4(dir)) return [];
   return readdirSync(dir).filter((f) => f.endsWith(".md")).map((f) => {
     const id = basename(f, ".md");
-    const content = readFileSync3(resolve5(dir, f), "utf-8").trim();
+    const raw = readFileSync3(resolve5(dir, f), "utf-8").trim();
+    const { data, content } = parseFrontmatter(raw);
     return {
       id,
-      name: id.replace(/-/g, " "),
-      description: "",
-      trigger: "",
-      content
+      name: data.name || id.replace(/-/g, " "),
+      description: data.description || "",
+      trigger: data.trigger || "",
+      content,
+      useCases: data.useCases || void 0,
+      tags: data.tags || void 0
     };
   });
 }
@@ -1221,13 +1705,80 @@ function loadReferenceFiles(dir) {
   if (!existsSync4(dir)) return [];
   return readdirSync(dir).filter((f) => f.endsWith(".md")).map((f) => {
     const id = basename(f, ".md");
-    const content = readFileSync3(resolve5(dir, f), "utf-8").trim();
+    const raw = readFileSync3(resolve5(dir, f), "utf-8").trim();
+    const { data, content } = parseFrontmatter(raw);
+    return {
+      id,
+      title: data.title || id.replace(/-/g, " "),
+      description: data.description || "",
+      whenToRead: data.whenToRead || "",
+      content,
+      tags: data.tags || void 0
+    };
+  });
+}
+function loadExampleFiles(dir) {
+  if (!existsSync4(dir)) return [];
+  return readdirSync(dir).filter((f) => f.endsWith(".md")).map((f) => {
+    const id = basename(f, ".md");
+    const raw = readFileSync3(resolve5(dir, f), "utf-8").trim();
+    const { data, content } = parseFrontmatter(raw);
+    return {
+      id,
+      name: data.name || id.replace(/-/g, " "),
+      description: data.description || "",
+      skillRef: data.skillRef || void 0,
+      content,
+      tags: data.tags || void 0
+    };
+  });
+}
+function loadOutputContractFiles(dir) {
+  if (!existsSync4(dir)) return [];
+  return readdirSync(dir).filter((f) => f.endsWith(".md")).map((f) => {
+    const id = basename(f, ".md");
+    const raw = readFileSync3(resolve5(dir, f), "utf-8").trim();
+    const { data, content } = parseFrontmatter(raw);
+    return {
+      id,
+      name: data.name || id.replace(/-/g, " "),
+      description: data.description || "",
+      skillRef: data.skillRef || void 0,
+      format: data.format || void 0,
+      content,
+      tags: data.tags || void 0
+    };
+  });
+}
+function loadScriptFilesFromPlugin(dir) {
+  if (!existsSync4(dir)) return [];
+  return readdirSync(dir).filter((f) => f.endsWith(".md")).map((f) => {
+    const id = basename(f, ".md");
+    const raw = readFileSync3(resolve5(dir, f), "utf-8").trim();
+    const { data, content } = parseFrontmatter(raw);
     return {
       id,
-      title: id.replace(/-/g, " "),
-      description: "",
-      whenToRead: "",
-      content
+      name: data.name || id.replace(/-/g, " "),
+      description: data.description || "",
+      language: data.language || "unknown",
+      content,
+      tags: data.tags || void 0
+    };
+  });
+}
+function loadAssetFilesFromPlugin(dir) {
+  if (!existsSync4(dir)) return [];
+  return readdirSync(dir).filter((f) => f.endsWith(".md")).map((f) => {
+    const id = basename(f, ".md");
+    const raw = readFileSync3(resolve5(dir, f), "utf-8").trim();
+    const { data, content } = parseFrontmatter(raw);
+    return {
+      id,
+      name: data.name || id.replace(/-/g, " "),
+      description: data.description || "",
+      format: data.format || "unknown",
+      content,
+      tags: data.tags || void 0
     };
   });
 }
@@ -1428,30 +1979,137 @@ function tryRemoveEmptyDir(dir) {
   }
 }
 
+// src/cli/audit.ts
+import chalk6 from "chalk";
+function auditSkill(agent, skill) {
+  const entries = [];
+  const base = { agentId: agent.id, agentName: agent.name, skillId: skill.id, skillName: skill.name };
+  if (!skill.governance) {
+    entries.push({ ...base, issue: "No governance metadata", severity: "warning" });
+    return entries;
+  }
+  const gov = skill.governance;
+  if (gov.status === "deprecated") {
+    entries.push({
+      ...base,
+      issue: `Deprecated${gov.deprecatedReason ? `: ${gov.deprecatedReason}` : ""}`,
+      severity: "error"
+    });
+  }
+  if (gov.status === "review-needed") {
+    entries.push({ ...base, issue: "Marked for review", severity: "warning" });
+  }
+  if (gov.status === "draft") {
+    entries.push({ ...base, issue: "Still in draft", severity: "info" });
+  }
+  if (!gov.version) {
+    entries.push({ ...base, issue: "Missing version", severity: "info" });
+  }
+  if (!gov.owner) {
+    entries.push({ ...base, issue: "Missing owner", severity: "info" });
+  }
+  if (!skill.description) {
+    entries.push({ ...base, issue: "Missing skill description", severity: "warning" });
+  }
+  if (!skill.trigger) {
+    entries.push({ ...base, issue: "Missing skill trigger", severity: "info" });
+  }
+  return entries;
+}
+async function runAudit(cwd = process.cwd()) {
+  const config = await loadConfig(cwd);
+  const agents = loadAgents(config, cwd);
+  const allEntries = [];
+  let totalSkills = 0;
+  let withGovernance = 0;
+  for (const agent of agents) {
+    for (const skill of agent.skills) {
+      totalSkills++;
+      if (skill.governance) withGovernance++;
+      allEntries.push(...auditSkill(agent, skill));
+    }
+  }
+  console.log(chalk6.bold("\nSkill Governance Audit"));
+  console.log(chalk6.dim("\u2500".repeat(50)));
+  console.log(`Total skills: ${totalSkills}`);
+  console.log(`With governance metadata: ${withGovernance}/${totalSkills}`);
+  const statusCounts = {
+    "active": 0,
+    "draft": 0,
+    "review-needed": 0,
+    "deprecated": 0,
+    "none": 0
+  };
+  for (const agent of agents) {
+    for (const skill of agent.skills) {
+      const status = skill.governance?.status ?? "none";
+      statusCounts[status]++;
+    }
+  }
+  console.log(`
+Status breakdown:`);
+  if (statusCounts.active) console.log(chalk6.green(`  active: ${statusCounts.active}`));
+  if (statusCounts.draft) console.log(chalk6.blue(`  draft: ${statusCounts.draft}`));
+  if (statusCounts["review-needed"]) console.log(chalk6.yellow(`  review-needed: ${statusCounts["review-needed"]}`));
+  if (statusCounts.deprecated) console.log(chalk6.red(`  deprecated: ${statusCounts.deprecated}`));
+  if (statusCounts.none) console.log(chalk6.dim(`  no status: ${statusCounts.none}`));
+  const errors = allEntries.filter((e) => e.severity === "error");
+  const warnings = allEntries.filter((e) => e.severity === "warning");
+  const infos = allEntries.filter((e) => e.severity === "info");
+  if (errors.length) {
+    console.log(chalk6.red(`
+\u2717 Errors (${errors.length}):`));
+    for (const e of errors) {
+      console.log(chalk6.red(`  ${e.agentId}/${e.skillId}: ${e.issue}`));
+    }
+  }
+  if (warnings.length) {
+    console.log(chalk6.yellow(`
+\u26A0 Warnings (${warnings.length}):`));
+    for (const e of warnings) {
+      console.log(chalk6.yellow(`  ${e.agentId}/${e.skillId}: ${e.issue}`));
+    }
+  }
+  if (infos.length) {
+    console.log(chalk6.blue(`
+\u2139 Info (${infos.length}):`));
+    for (const e of infos) {
+      console.log(chalk6.blue(`  ${e.agentId}/${e.skillId}: ${e.issue}`));
+    }
+  }
+  if (!allEntries.length) {
+    console.log(chalk6.green("\n\u2713 All skills pass governance checks"));
+  }
+  console.log();
+  if (errors.length) {
+    process.exit(1);
+  }
+}
+
 // bin/cli.ts
 var program = new Command();
-program.name("aigent-team").description("Cross-platform AI agent team plugin for Claude Code, Cursor, Codex, and Antigravity").version("0.2.0");
+program.name("aigent-team").description("Cross-platform AI agent team plugin for Claude Code, Cursor, Codex, and Antigravity").version("0.4.0");
 program.command("init").description("Initialize aigent-team in your project (interactive)").action(async () => {
   await runInit(process.cwd());
 });
 program.command("generate").description("Generate platform-specific config files from aigent-team config").option("-p, --platform <platform>", "Generate for a specific platform only").option("-s, --scope <scopes>", "Output scope(s), comma-separated: all | agents | skills | references | plugin", "all").option("-t, --team <teams>", "Team roles to generate, comma-separated (overrides config)").action(async (options) => {
   if (options.platform && !PLATFORMS.includes(options.platform)) {
-    console.log(chalk6.red(`Unknown platform: ${options.platform}. Valid: ${PLATFORMS.join(", ")}`));
+    console.log(chalk7.red(`Unknown platform: ${options.platform}. Valid: ${PLATFORMS.join(", ")}`));
     process.exit(1);
   }
   const scopes = options.scope.split(",");
   for (const s of scopes) {
     if (!GENERATE_SCOPES.includes(s)) {
-      console.log(chalk6.red(`Unknown scope: ${s}. Valid: ${GENERATE_SCOPES.join(", ")}`));
+      console.log(chalk7.red(`Unknown scope: ${s}. Valid: ${GENERATE_SCOPES.join(", ")}`));
       process.exit(1);
     }
   }
   if (scopes.includes("plugin") && scopes.length > 1) {
-    console.log(chalk6.red(`Scope 'plugin' is exclusive and cannot be combined with other scopes.`));
+    console.log(chalk7.red(`Scope 'plugin' is exclusive and cannot be combined with other scopes.`));
     process.exit(1);
   }
   if (scopes.includes("all") && scopes.length > 1) {
-    console.log(chalk6.red(`Scope 'all' is exclusive and cannot be combined with other scopes.`));
+    console.log(chalk7.red(`Scope 'all' is exclusive and cannot be combined with other scopes.`));
     process.exit(1);
   }
   let teams;
@@ -1459,7 +2117,7 @@ program.command("generate").description("Generate platform-specific config files
     teams = options.team.split(",");
     for (const t of teams) {
       if (!TEAM_ROLES.includes(t)) {
-        console.log(chalk6.red(`Unknown team role: ${t}. Valid: ${TEAM_ROLES.join(", ")}`));
+        console.log(chalk7.red(`Unknown team role: ${t}. Valid: ${TEAM_ROLES.join(", ")}`));
         process.exit(1);
       }
     }
@@ -1478,7 +2136,7 @@ program.command("install").description("Install a plugin bundle into the current
   "Install Cursor IDE bundle from plugin cursor-ide-plugin/ to ~/.cursor/plugins/local/ (see cursor.com/docs/plugins)"
 ).action(async (pluginPath, options) => {
   if (options.platform && !PLATFORMS.includes(options.platform)) {
-    console.log(chalk6.red(`Unknown platform: ${options.platform}. Valid: ${PLATFORMS.join(", ")}`));
+    console.log(chalk7.red(`Unknown platform: ${options.platform}. Valid: ${PLATFORMS.join(", ")}`));
     process.exit(1);
   }
   await runInstall(pluginPath, process.cwd(), {
@@ -1490,4 +2148,7 @@ program.command("install").description("Install a plugin bundle into the current
 program.command("uninstall").description("Uninstall a previously installed plugin").argument("<plugin-name>", "Name of the plugin to uninstall").action(async (pluginName) => {
   await runUninstall(pluginName, process.cwd());
 });
+program.command("audit").description("Audit skill governance metadata \u2014 report deprecated, review-needed, and missing metadata").action(async () => {
+  await runAudit(process.cwd());
+});
 program.parse();