@the-aico/cli 1.0.0 → 1.0.2

package/dist/index.js

@@ -16,12 +16,12 @@ var defaultSuggestions = {
   REGISTRY_UNAVAILABLE: "The registry server is unavailable. Try again later.",
   // Resource errors
   NOT_FOUND: "The requested resource was not found.",
-  SKILL_NOT_FOUND: "Use `npx aico list --skills` to see available skills.",
-  EMPLOYEE_NOT_FOUND: "Use `npx aico list` to see available employees.",
+  SKILL_NOT_FOUND: "Use `aico list --skills` to see available skills.",
+  EMPLOYEE_NOT_FOUND: "Use `aico list` to see available employees.",
   // Configuration errors
-  NOT_INITIALIZED: "Run `npx aico init` to initialize the project.",
-  CONFIG_INVALID: "Check your aico.json for syntax errors or run `npx aico init --force`.",
-  CONFIG_EXISTS: "Use `npx aico init --force` to overwrite existing config.",
+  NOT_INITIALIZED: "Run `aico init` to initialize the project.",
+  CONFIG_INVALID: "Check your aico.json for syntax errors or run `aico init --force`.",
+  CONFIG_EXISTS: "Use `aico init --force` to overwrite existing config.",
   CONFIG_PARSE_ERROR: "Your aico.json contains invalid JSON. Check for syntax errors.",
   // Dependency errors
   DEPENDENCY_MISSING: "Install the missing dependency first, or use `--no-deps` to skip.",
@@ -95,8 +95,8 @@ function handleError(error, options = {}) {
     console.error(kleur.red("\u2716 Validation Error:"));
     console.error("");
     for (const issue of error.issues) {
-      const path9 = issue.path.length > 0 ? issue.path.join(".") : "value";
-      console.error(`  ${kleur.yellow(path9)}: ${issue.message}`);
+      const path10 = issue.path.length > 0 ? issue.path.join(".") : "value";
+      console.error(`  ${kleur.yellow(path10)}: ${issue.message}`);
     }
     console.error("");
     console.error(kleur.cyan("  Suggestion:"));
@@ -238,15 +238,15 @@ var DEFAULT_PLATFORMS = {
     skills: ".claude/skills",
     commands: ".claude/commands"
   },
-  // Codex 平台配置：
-  // - skills: 项目目录 .codex/skills/（Codex 原生支持项目级 skills）
-  // - commands (prompts): 全局 ~/.codex/prompts/（一次安装所有项目可用）
-  // 调用方式：/prompts:aico.{employee}.{command}
-  // 用户可在 aico.json 中覆盖路径
+  // Codex platform configuration:
+  // - skills: project directory .codex/skills/ (Codex natively supports project-level skills)
+  // - commands (prompts): global ~/.codex/prompts/ (install once, available for all projects)
+  // Invocation: /prompts:aico.{employee}.{command}
+  // Users can override paths in aico.json
   codex: {
     skills: ".codex/skills",
     commands: "~/.codex/prompts"
-    // Codex custom prompts (全局)
+    // Codex custom prompts (global)
   }
 };
 function createDefaultConfig(defaultPlatform = "claude-code") {
@@ -512,10 +512,8 @@ async function runInit(options) {
   logger.dim(`Default platform: ${platform}`);
   logger.break();
   logger.info("Next steps:");
-  logger.log(`  ${logger.highlight("npx aico add pm")}  Add the PM employee`);
-  logger.log(
-    `  ${logger.highlight("npx aico list")}   View available employees`
-  );
+  logger.log(`  ${logger.highlight("aico add pm")}  Add the PM employee`);
+  logger.log(`  ${logger.highlight("aico list")}   View available employees`);
 }
 var init = new Command().name("init").description("Initialize aico in your project").option(
   "-p, --default-platform <platform>",
@@ -1226,9 +1224,9 @@ var DependencyResolver = class {
   /**
    * Recursively fetch a skill and all its dependencies
    */
-  async fetchWithDependencies(skillName, visited = /* @__PURE__ */ new Set(), path9 = []) {
-    if (path9.includes(skillName)) {
-      const cycle = [...path9, skillName].join(" \u2192 ");
+  async fetchWithDependencies(skillName, visited = /* @__PURE__ */ new Set(), path10 = []) {
+    if (path10.includes(skillName)) {
+      const cycle = [...path10, skillName].join(" \u2192 ");
       throw new AicoError(
         `Circular dependency detected: ${cycle}`,
         "CIRCULAR_DEPENDENCY",
@@ -1249,7 +1247,7 @@ var DependencyResolver = class {
       const depSkills = await this.fetchWithDependencies(
         dep,
         visited,
-        [...path9, skillName]
+        [...path10, skillName]
       );
       allSkills.push(...depSkills);
     }
@@ -2031,12 +2029,8 @@ var remove = new Command3().name("remove").description("Remove employees or skil
         "Please specify at least one employee or skill to remove."
       );
       logger.dim("Examples:");
-      logger.dim(
-        "  npx aico remove pm                     # Remove employee"
-      );
-      logger.dim(
-        "  npx aico remove @the-aico/pm/brainstorming # Remove skill"
-      );
+      logger.dim("  aico remove pm                     # Remove employee");
+      logger.dim("  aico remove @the-aico/pm/brainstorming # Remove skill");
       process.exit(1);
     }
     const options = removeOptionsSchema.parse({
@@ -2070,7 +2064,7 @@ async function runList(options) {
     const employees = Object.entries(config.employees);
     if (employees.length === 0) {
       logger.info("No employees installed.");
-      logger.dim("Run `npx aico add <employee>` to add an employee.");
+      logger.dim("Run `aico add <employee>` to add an employee.");
       return;
     }
     logger.bold("Installed employees:");
@@ -2101,8 +2095,8 @@ async function runList(options) {
         );
       }
       logger.break();
-      logger.dim("Use `npx aico add <employee>` to add an employee.");
-      logger.dim("Use `npx aico list --installed` to see installed employees.");
+      logger.dim("Use `aico add <employee>` to add an employee.");
+      logger.dim("Use `aico list --installed` to see installed employees.");
     } catch {
       logger.warn(
         "Could not fetch registry. Showing installed employees only."
@@ -2135,14 +2129,370 @@ var list = new Command4().name("list").description("List available or installed
 
 // src/commands/build.ts
 import { Command as Command5 } from "commander";
-import fs6 from "fs-extra";
-import path7 from "path";
+import fs7 from "fs-extra";
+import path8 from "path";
 import glob from "fast-glob";
 import { z as z9 } from "zod";
+
+// src/commands/build-schema.ts
+import fs6 from "fs-extra";
+import path7 from "path";
+var CONFIG_SCHEMA = {
+  $schema: "http://json-schema.org/draft-07/schema#",
+  $id: "https://the-aico.com/schema/config.json",
+  title: "aico Configuration",
+  description: "Configuration file schema for aico.json",
+  type: "object",
+  required: ["defaultPlatform", "platforms"],
+  properties: {
+    $schema: {
+      type: "string",
+      description: "JSON Schema reference"
+    },
+    language: {
+      type: "string",
+      description: "Default language for documentation",
+      default: "en"
+    },
+    defaultPlatform: {
+      type: "string",
+      enum: ["claude-code", "codex"],
+      description: "Default platform for installation"
+    },
+    platforms: {
+      type: "object",
+      description: "Platform-specific path configurations",
+      additionalProperties: {
+        type: "object",
+        required: ["skills", "commands"],
+        properties: {
+          skills: {
+            type: "string",
+            description: "Path to skills directory"
+          },
+          commands: {
+            type: "string",
+            description: "Path to commands directory"
+          }
+        }
+      }
+    },
+    employees: {
+      type: "object",
+      description: "Installed employees state",
+      additionalProperties: {
+        type: "object",
+        required: ["platforms", "installedAt"],
+        properties: {
+          platforms: {
+            type: "array",
+            items: {
+              type: "string",
+              enum: ["claude-code", "codex"]
+            },
+            description: "Platforms this employee is installed on"
+          },
+          installedAt: {
+            type: "string",
+            format: "date-time",
+            description: "Installation timestamp"
+          },
+          version: {
+            type: "string",
+            description: "Installed version"
+          },
+          skills: {
+            type: "array",
+            items: { type: "string" },
+            description: "Installed skill names"
+          },
+          commands: {
+            type: "array",
+            items: { type: "string" },
+            description: "Installed command names"
+          }
+        }
+      }
+    },
+    skills: {
+      type: "object",
+      description: "Standalone installed skills",
+      additionalProperties: {
+        type: "object",
+        required: ["version", "installedAt", "source", "platforms"],
+        properties: {
+          version: {
+            type: "string",
+            description: "Skill version"
+          },
+          installedAt: {
+            type: "string",
+            format: "date-time",
+            description: "Installation timestamp"
+          },
+          source: {
+            type: "string",
+            enum: ["standalone", "employee"],
+            description: "Installation source"
+          },
+          platforms: {
+            type: "array",
+            items: {
+              type: "string",
+              enum: ["claude-code", "codex"]
+            }
+          }
+        }
+      }
+    },
+    sharedSkills: {
+      type: "object",
+      description: "Shared skills with reference tracking",
+      additionalProperties: {
+        type: "object",
+        required: ["version", "installedAt", "platforms", "usedBy"],
+        properties: {
+          version: {
+            type: "string",
+            description: "Skill version"
+          },
+          installedAt: {
+            type: "string",
+            format: "date-time",
+            description: "Installation timestamp"
+          },
+          platforms: {
+            type: "array",
+            items: {
+              type: "string",
+              enum: ["claude-code", "codex"]
+            }
+          },
+          usedBy: {
+            type: "array",
+            items: { type: "string" },
+            description: "Employees that depend on this shared skill"
+          }
+        }
+      }
+    },
+    registries: {
+      type: "object",
+      description: "Custom registry configurations",
+      propertyNames: {
+        pattern: "^@"
+      },
+      additionalProperties: {
+        oneOf: [
+          {
+            type: "string",
+            description: "Registry URL with {name} placeholder"
+          },
+          {
+            type: "object",
+            required: ["url"],
+            properties: {
+              url: {
+                type: "string",
+                description: "Registry URL with {name} placeholder"
+              },
+              headers: {
+                type: "object",
+                additionalProperties: { type: "string" },
+                description: "Custom HTTP headers"
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+};
+var EMPLOYEE_SCHEMA = {
+  $schema: "http://json-schema.org/draft-07/schema#",
+  $id: "https://the-aico.com/schema/employee.json",
+  title: "aico Employee",
+  description: "Employee definition schema for employee.json",
+  type: "object",
+  required: ["name", "role"],
+  properties: {
+    $schema: {
+      type: "string",
+      description: "JSON Schema reference"
+    },
+    name: {
+      type: "string",
+      pattern: "^[a-z0-9-]+$",
+      description: "Employee name (hyphen-case)"
+    },
+    namespace: {
+      type: "string",
+      pattern: "^@[a-z0-9-]+$",
+      description: "Registry namespace (@registry format)"
+    },
+    fullName: {
+      type: "string",
+      pattern: "^@[a-z0-9-]+/[a-z0-9-]+$",
+      description: "Full name (@registry/employee format)"
+    },
+    role: {
+      type: "string",
+      minLength: 1,
+      description: "Employee role title"
+    },
+    description: {
+      type: "string",
+      description: "Employee description"
+    },
+    version: {
+      type: "string",
+      pattern: "^\\d+\\.\\d+\\.\\d+$",
+      description: "Semantic version"
+    },
+    category: {
+      type: "string",
+      enum: ["pm", "frontend", "backend", "devops", "general"],
+      description: "Employee category"
+    },
+    skills: {
+      type: "array",
+      description: "Employee skills",
+      items: {
+        oneOf: [
+          {
+            type: "string",
+            description: "Skill fullName reference"
+          },
+          {
+            type: "object",
+            required: ["name", "files"],
+            properties: {
+              name: {
+                type: "string",
+                pattern: "^[a-z0-9-]+$",
+                description: "Skill name (hyphen-case)"
+              },
+              files: {
+                type: "array",
+                minItems: 1,
+                items: {
+                  $ref: "#/definitions/fileSource"
+                }
+              }
+            }
+          }
+        ]
+      }
+    },
+    commands: {
+      type: "array",
+      description: "Employee commands",
+      items: {
+        type: "object",
+        required: ["name", "files"],
+        properties: {
+          name: {
+            type: "string",
+            pattern: "^[a-z0-9-]+$",
+            description: "Command name (hyphen-case)"
+          },
+          files: {
+            type: "array",
+            minItems: 1,
+            items: {
+              $ref: "#/definitions/file"
+            }
+          }
+        }
+      }
+    },
+    docs: {
+      type: "array",
+      description: "Employee documentation",
+      items: {
+        type: "object",
+        required: ["name", "files"],
+        properties: {
+          name: {
+            type: "string",
+            description: "Document name"
+          },
+          files: {
+            type: "array",
+            minItems: 1,
+            items: {
+              $ref: "#/definitions/file"
+            }
+          }
+        }
+      }
+    },
+    dependencies: {
+      type: "array",
+      description: "Shared skill dependencies",
+      items: {
+        type: "string",
+        description: "Dependency reference (@registry/_shared/skill)"
+      }
+    }
+  },
+  definitions: {
+    fileSource: {
+      type: "object",
+      required: ["path", "type"],
+      properties: {
+        path: {
+          type: "string",
+          minLength: 1,
+          description: "Relative file path"
+        },
+        type: {
+          type: "string",
+          enum: ["skill", "command", "doc"],
+          description: "File type"
+        }
+      }
+    },
+    file: {
+      type: "object",
+      required: ["path", "type"],
+      properties: {
+        path: {
+          type: "string",
+          minLength: 1,
+          description: "Relative file path"
+        },
+        type: {
+          type: "string",
+          enum: ["skill", "command", "doc"],
+          description: "File type"
+        },
+        content: {
+          type: "string",
+          description: "File content (populated at build time)"
+        }
+      }
+    }
+  }
+};
+async function buildSchemas(outputDir) {
+  const schemaDir = path7.join(outputDir, "schema");
+  await fs6.ensureDir(schemaDir);
+  await fs6.writeJson(path7.join(schemaDir, "config.json"), CONFIG_SCHEMA, {
+    spaces: 2
+  });
+  await fs6.writeJson(path7.join(schemaDir, "employee.json"), EMPLOYEE_SCHEMA, {
+    spaces: 2
+  });
+  logger.success("Built JSON schemas to schema/");
+}
+
+// src/commands/build.ts
 var buildOptionsSchema = z9.object({
   cwd: z9.string(),
   employeesDir: z9.string(),
   outputDir: z9.string(),
+  schemaDir: z9.string().optional(),
   registry: z9.string(),
   version: z9.string()
 });
@@ -2157,8 +2507,8 @@ function inferCategory(employeeName) {
   return categoryMap[employeeName] ?? "general";
 }
 async function buildSharedSkills(employeesPath, outputPath, registry, version, skillsIndex) {
-  const sharedDir = path7.join(employeesPath, "_shared", "skills");
-  if (!await fs6.pathExists(sharedDir)) {
+  const sharedDir = path8.join(employeesPath, "_shared", "skills");
+  if (!await fs7.pathExists(sharedDir)) {
     return 0;
   }
   const skillDirs = await glob("*/SKILL.md", {
@@ -2169,10 +2519,10 @@ async function buildSharedSkills(employeesPath, outputPath, registry, version, s
   }
   const namespace = `${registry}/_shared`;
   for (const skillPath of skillDirs) {
-    const skillName = path7.dirname(skillPath);
+    const skillName = path8.dirname(skillPath);
     const skillFullName = `${namespace}/${skillName}`;
-    const skillFilePath = path7.join(sharedDir, skillPath);
-    const content = await fs6.readFile(skillFilePath, "utf-8");
+    const skillFilePath = path8.join(sharedDir, skillPath);
+    const content = await fs7.readFile(skillFilePath, "utf-8");
     const frontmatter = parseSkillFrontmatter(content);
     if (!frontmatter) {
       logger.warn(`Shared skill ${skillName} missing frontmatter, skipping`);
@@ -2195,15 +2545,15 @@ async function buildSharedSkills(employeesPath, outputPath, registry, version, s
         }
       ]
     };
-    const skillOutputDir = path7.join(
+    const skillOutputDir = path8.join(
       outputPath,
       "skills",
       registry.replace("@", ""),
       "_shared"
     );
-    await fs6.ensureDir(skillOutputDir);
-    await fs6.writeJson(
-      path7.join(skillOutputDir, `${skillName}.json`),
+    await fs7.ensureDir(skillOutputDir);
+    await fs7.writeJson(
+      path8.join(skillOutputDir, `${skillName}.json`),
       fullSkill,
       { spaces: 2 }
     );
@@ -2220,11 +2570,12 @@ async function buildSharedSkills(employeesPath, outputPath, registry, version, s
   return skillDirs.length;
 }
 async function runBuild(options) {
-  const { cwd, employeesDir, outputDir, registry, version } = options;
-  const employeesPath = path7.resolve(cwd, employeesDir);
-  const outputPath = path7.resolve(cwd, outputDir);
-  if (await fs6.pathExists(outputPath)) {
-    await fs6.emptyDir(outputPath);
+  const { cwd, employeesDir, outputDir, schemaDir, registry, version } = options;
+  const employeesPath = path8.resolve(cwd, employeesDir);
+  const outputPath = path8.resolve(cwd, outputDir);
+  const schemaPath = schemaDir ? path8.resolve(cwd, schemaDir) : outputPath;
+  if (await fs7.pathExists(outputPath)) {
+    await fs7.emptyDir(outputPath);
   }
   const employeeFiles = await glob("*/employee.json", {
     cwd: employeesPath,
@@ -2236,19 +2587,17 @@ async function runBuild(options) {
   }
   const s = spinner(`Building ${employeeFiles.length} employee(s)...`).start();
   const skillsIndex = [];
-  const employeesIndex = [];
   const legacyIndex = [];
   for (const employeeFile of employeeFiles) {
-    const employeeName = path7.dirname(employeeFile);
-    const employeeDir = path7.join(employeesPath, employeeName);
+    const employeeName = path8.dirname(employeeFile);
+    const employeeDir = path8.join(employeesPath, employeeName);
     try {
-      const employeeJson = await fs6.readJson(
-        path7.join(employeeDir, "employee.json")
+      const employeeJson = await fs7.readJson(
+        path8.join(employeeDir, "employee.json")
       );
       const employeeSource = employeeSourceSchema.parse(employeeJson);
       const category = inferCategory(employeeName);
       const namespace = `${registry}/${employeeName}`;
-      const employeeFullName = `${registry}/${employeeName}`;
       const employee = {
         ...employeeSource,
         skills: employeeSource.skills.map((sk) => ({
@@ -2264,16 +2613,14 @@ async function runBuild(options) {
           files: d.files.map((f) => ({ ...f, content: "" }))
         }))
       };
-      const skillFullNames = [];
       for (const skill of employee.skills) {
         const skillFullName = `${namespace}/${skill.name}`;
-        skillFullNames.push(skillFullName);
         const skillFiles = [];
         let skillDescription = "";
         for (const file of skill.files) {
-          const filePath = path7.join(employeeDir, file.path);
-          if (await fs6.pathExists(filePath)) {
-            const content = await fs6.readFile(filePath, "utf-8");
+          const filePath = path8.join(employeeDir, file.path);
+          if (await fs7.pathExists(filePath)) {
+            const content = await fs7.readFile(filePath, "utf-8");
             file.content = content;
             if (file.path.endsWith("SKILL.md")) {
               const frontmatter = parseSkillFrontmatter(content);
@@ -2282,7 +2629,7 @@ async function runBuild(options) {
               }
             }
             skillFiles.push({
-              path: path7.basename(file.path),
+              path: path8.basename(file.path),
               type: file.type === "skill" ? "skill" : "reference",
               content
             });
@@ -2301,15 +2648,15 @@ async function runBuild(options) {
           dependencies: [],
           files: skillFiles
         };
-        const skillOutputDir = path7.join(
+        const skillOutputDir = path8.join(
           outputPath,
           "skills",
           registry.replace("@", ""),
           employeeName
         );
-        await fs6.ensureDir(skillOutputDir);
-        await fs6.writeJson(
-          path7.join(skillOutputDir, `${skill.name}.json`),
+        await fs7.ensureDir(skillOutputDir);
+        await fs7.writeJson(
+          path8.join(skillOutputDir, `${skill.name}.json`),
           fullSkill,
           { spaces: 2 }
         );
@@ -2325,9 +2672,9 @@ async function runBuild(options) {
       }
       for (const command of employee.commands) {
         for (const file of command.files) {
-          const filePath = path7.join(employeeDir, file.path);
-          if (await fs6.pathExists(filePath)) {
-            file.content = await fs6.readFile(filePath, "utf-8");
+          const filePath = path8.join(employeeDir, file.path);
+          if (await fs7.pathExists(filePath)) {
+            file.content = await fs7.readFile(filePath, "utf-8");
           } else {
             throw new Error(`Command file not found: ${file.path}`);
           }
@@ -2335,48 +2682,17 @@ async function runBuild(options) {
       }
       for (const doc of employee.docs) {
         for (const file of doc.files) {
-          const filePath = path7.join(employeeDir, file.path);
-          if (await fs6.pathExists(filePath)) {
-            file.content = await fs6.readFile(filePath, "utf-8");
+          const filePath = path8.join(employeeDir, file.path);
+          if (await fs7.pathExists(filePath)) {
+            file.content = await fs7.readFile(filePath, "utf-8");
           } else {
             throw new Error(`Doc file not found: ${file.path}`);
           }
         }
       }
-      const legacyOutputPath = path7.join(outputPath, `${employee.name}.json`);
-      await fs6.ensureDir(outputPath);
-      await fs6.writeJson(legacyOutputPath, employee, { spaces: 2 });
-      const employeeExtended = {
-        $schema: "https://the-aico.com/schema/employee.json",
-        name: employee.name,
-        namespace: registry,
-        fullName: employeeFullName,
-        role: employee.role,
-        description: employee.description,
-        version,
-        category,
-        skills: skillFullNames,
-        commands: employee.commands,
-        docs: employee.docs
-      };
-      const employeesOutputDir = path7.join(outputPath, "employees");
-      await fs6.ensureDir(employeesOutputDir);
-      await fs6.writeJson(
-        path7.join(employeesOutputDir, `${employee.name}.json`),
-        employeeExtended,
-        { spaces: 2 }
-      );
-      employeesIndex.push({
-        name: employee.name,
-        namespace: registry,
-        fullName: employeeFullName,
-        role: employee.role,
-        description: employee.description,
-        version,
-        skillCount: employee.skills.length,
-        commandCount: employee.commands.length,
-        category
-      });
+      const legacyOutputPath = path8.join(outputPath, `${employee.name}.json`);
+      await fs7.ensureDir(outputPath);
+      await fs7.writeJson(legacyOutputPath, employee, { spaces: 2 });
       legacyIndex.push({
         name: employee.name,
         role: employee.role,
@@ -2399,38 +2715,41 @@ async function runBuild(options) {
   if (sharedSkillCount > 0) {
     s.text = `Built ${sharedSkillCount} shared skill(s)`;
   }
-  const skillsIndexPath = path7.join(outputPath, "skills", "index.json");
-  await fs6.ensureDir(path7.dirname(skillsIndexPath));
-  await fs6.writeJson(skillsIndexPath, skillsIndex, { spaces: 2 });
-  const employeesIndexPath = path7.join(outputPath, "employees", "index.json");
-  await fs6.ensureDir(path7.dirname(employeesIndexPath));
-  await fs6.writeJson(employeesIndexPath, employeesIndex, { spaces: 2 });
-  const legacyIndexPath = path7.join(outputPath, "index.json");
-  await fs6.writeJson(
+  const skillsIndexPath = path8.join(outputPath, "skills", "index.json");
+  await fs7.ensureDir(path8.dirname(skillsIndexPath));
+  await fs7.writeJson(skillsIndexPath, skillsIndex, { spaces: 2 });
+  const legacyIndexPath = path8.join(outputPath, "index.json");
+  await fs7.writeJson(
     legacyIndexPath,
     { employees: legacyIndex },
     { spaces: 2 }
   );
+  s.text = "Building JSON schemas...";
+  await buildSchemas(schemaPath);
   s.succeed(`Built ${employeeFiles.length} employee(s) to ${outputDir}/`);
   logger.break();
   logger.success("Registry build complete!");
   logger.dim(`  Skills: ${skillsIndex.length} (${sharedSkillCount} shared)`);
-  logger.dim(`  Employees: ${employeesIndex.length}`);
+  logger.dim(`  Employees: ${legacyIndex.length}`);
   logger.break();
-  for (const emp of employeesIndex) {
-    logger.dim(`  - ${emp.name}: ${emp.role} (${emp.skillCount} skills)`);
+  for (const emp of legacyIndex) {
+    logger.dim(`  - ${emp.name}: ${emp.role}`);
   }
 }
 var build = new Command5().name("build").description("Build registry from employees directory").option(
   "-e, --employees-dir <dir>",
   "Employees source directory",
   "employees"
-).option("-o, --output-dir <dir>", "Output directory", "registry").option("-r, --registry <name>", "Registry namespace", "@the-aico").option("-v, --version <version>", "Version number", "1.0.0").option("-c, --cwd <cwd>", "Working directory", process.cwd()).action(async (opts) => {
+).option("-o, --output-dir <dir>", "Output directory", "registry").option(
+  "-s, --schema-dir <dir>",
+  "Schema output directory (defaults to output-dir)"
+).option("-r, --registry <name>", "Registry namespace", "@the-aico").option("-v, --version <version>", "Version number", "1.0.0").option("-c, --cwd <cwd>", "Working directory", process.cwd()).action(async (opts) => {
   try {
     const options = buildOptionsSchema.parse({
       cwd: opts.cwd,
       employeesDir: opts.employeesDir,
       outputDir: opts.outputDir,
+      schemaDir: opts.schemaDir,
       registry: opts.registry,
       version: opts.version
     });
@@ -2441,8 +2760,8 @@ var build = new Command5().name("build").description("Build registry from employ
 });
 
 // src/commands/diff.ts
-import fs7 from "fs-extra";
-import path8 from "path";
+import fs8 from "fs-extra";
+import path9 from "path";
 import { Command as Command6 } from "commander";
 import { diffLines } from "diff";
 import { z as z10 } from "zod";
@@ -2455,10 +2774,10 @@ var diffOptionsSchema = z10.object({
   cwd: z10.string()
 });
 async function compareFile(localPath, registryContent) {
-  if (!await fs7.pathExists(localPath)) {
+  if (!await fs8.pathExists(localPath)) {
     return null;
   }
-  const localContent = await fs7.readFile(localPath, "utf-8");
+  const localContent = await fs8.readFile(localPath, "utf-8");
   const patch = diffLines(localContent, registryContent);
   const hasChanges = patch.some((part) => part.added || part.removed);
   return hasChanges ? patch : null;
@@ -2502,10 +2821,10 @@ async function diffEmployee(employeeName, cwd, config) {
   for (const skill of registryEmployee.skills) {
     const skillDirName = adapter.getSkillDirName(employeeName, skill.name);
     for (const file of skill.files) {
-      const localPath = path8.join(
+      const localPath = path9.join(
         skillsDir,
         skillDirName,
-        path8.basename(file.path)
+        path9.basename(file.path)
       );
       let registryContent = file.content;
       if (file.path.endsWith("SKILL.md")) {
@@ -2514,7 +2833,7 @@ async function diffEmployee(employeeName, cwd, config) {
           `$1${skillDirName}`
         );
       }
-      if (!await fs7.pathExists(localPath)) {
+      if (!await fs8.pathExists(localPath)) {
         if (!skillsAdded.includes(skill.name)) {
           fileChanges.push({
             filePath: localPath,
@@ -2539,8 +2858,8 @@ async function diffEmployee(employeeName, cwd, config) {
       command.name
     );
     for (const file of command.files) {
-      const localPath = path8.join(commandsDir, commandFileName);
-      if (!await fs7.pathExists(localPath)) {
+      const localPath = path9.join(commandsDir, commandFileName);
+      if (!await fs8.pathExists(localPath)) {
         if (!commandsAdded.includes(command.name)) {
           fileChanges.push({
             filePath: localPath,
@@ -2561,8 +2880,8 @@ async function diffEmployee(employeeName, cwd, config) {
   }
   for (const skillName of skillsRemoved) {
     const skillDirName = adapter.getSkillDirName(employeeName, skillName);
-    const skillPath = path8.join(skillsDir, skillDirName);
-    if (await fs7.pathExists(skillPath)) {
+    const skillPath = path9.join(skillsDir, skillDirName);
+    if (await fs8.pathExists(skillPath)) {
       fileChanges.push({
         filePath: skillPath,
         type: "removed"
@@ -2574,8 +2893,8 @@ async function diffEmployee(employeeName, cwd, config) {
       employeeName,
       commandName
     );
-    const commandPath = path8.join(commandsDir, commandFileName);
-    if (await fs7.pathExists(commandPath)) {
+    const commandPath = path9.join(commandsDir, commandFileName);
+    if (await fs8.pathExists(commandPath)) {
       fileChanges.push({
         filePath: commandPath,
         type: "removed"
@@ -2647,7 +2966,7 @@ async function runDiff(options) {
       logger.warn(`  Removed commands: ${diff2.commandsRemoved.join(", ")}`);
     }
     for (const change of diff2.fileChanges) {
-      const relativePath = path8.relative(cwd, change.filePath);
+      const relativePath = path9.relative(cwd, change.filePath);
       if (change.type === "modified") {
         logger.info(`  Modified: ${relativePath}`);
         if (change.patch) {
@@ -2970,7 +3289,7 @@ function formatJSON(items) {
       category: item.category,
       description: item.description,
       tags: item.tags,
-      install: item.type === "employee" ? `npx aico add ${item.name}` : `npx aico add ${item.fullName}`
+      install: item.type === "employee" ? `aico add ${item.name}` : `aico add ${item.fullName}`
     }))
   };
   return JSON.stringify(output, null, 2);
@@ -3016,7 +3335,7 @@ var search = new Command8().name("search").description("Search for skills and em
       logger.log(formatTable(results));
       logger.break();
       if (results.length > 0) {
-        logger.dim("Install: npx aico add <name>");
+        logger.dim("Install: aico add <name>");
       }
     }
   } catch (error) {
@@ -3287,7 +3606,7 @@ var check = new Command9().name("check").description("Check environment and conf
       const hasWarn = results.some((r) => r.status === "warn");
       if (hasError) {
         logger.log(
-          kleur5.red("\u2716 Some checks failed. Run `npx aico init` to fix.")
+          kleur5.red("\u2716 Some checks failed. Run `aico init` to fix.")
         );
       } else if (hasWarn) {
         logger.log(