evizi-cli 1.0.0 → 1.0.2

package/bin/evizi.js

@@ -6,8 +6,31 @@ import { upgradeCommand } from '../src/commands/upgrade.js';
 
 program
   .name('evizi')
-  .description('Install and manage agent kits from evizi-kit')
-  .version('1.0.0');
+  .description(
+    `Multi-agent development kit CLI
+
+  Install and manage agent kits (Claude Code, Cursor, GitHub Copilot, etc.)
+  into your project. Each kit provides agents and skills tailored for a
+  specific AI coding platform.
+
+  Available kits:
+    claude    Claude Code (.claude/)
+    cursor    Cursor (.cursor/)
+    github    GitHub Copilot (.github/)
+    agent     VS Code Agent (.agent/)
+    shared    Shared skills & docs (auto-included as dependency)
+
+  Examples:
+    $ evizi init                          Interactive kit selection
+    $ evizi init --agent claude           Install Claude Code kit
+    $ evizi init --agent claude,cursor    Install multiple kits
+    $ evizi init --all                    Install all kits
+    $ evizi upgrade                       Upgrade to latest version
+
+  After install, shared skills are automatically merged into each
+  agent's skills folder (e.g. .claude/skills/, .cursor/skills/).`,
+  )
+  .version('1.0.1');
 
 program
   .command('init')
@@ -15,12 +38,29 @@ program
   .option('--agent <kits>', 'Comma-separated kit names (e.g. claude,cursor,github)')
   .option('--all', 'Install all available kits')
   .option('--local <path>', 'Use local evizi-kit directory instead of npm')
+  .addHelpText(
+    'after',
+    `
+Examples:
+  $ evizi init                          Prompt to select kits interactively
+  $ evizi init --agent claude           Install only Claude Code kit
+  $ evizi init --agent claude,cursor    Install Claude Code and Cursor kits
+  $ evizi init --all                    Install all available kits
+  $ evizi init --local ./evizi-kit      Use a local evizi-kit directory (for dev)`,
+  )
   .action(initCommand);
 
 program
   .command('upgrade')
   .description('Upgrade installed agent kits to latest version')
   .option('--local <path>', 'Use local evizi-kit directory instead of npm')
+  .addHelpText(
+    'after',
+    `
+Examples:
+  $ evizi upgrade                       Upgrade all installed kits from npm
+  $ evizi upgrade --local ./evizi-kit   Upgrade from a local directory`,
+  )
   .action(upgradeCommand);
 
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evizi-cli",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Install and manage agent kits from evizi-kit",
   "type": "module",
   "bin": {

package/src/commands/init.js

@@ -7,7 +7,7 @@ import {
   loadManifest,
 } from '../lib/manifest.js';
 import { loadIgnorePatterns } from '../lib/ignore.js';
-import { copyKit } from '../lib/copier.js';
+import { copyKit, copyDependencyFiles } from '../lib/copier.js';
 import { readLockfile, writeLockfile } from '../lib/lockfile.js';
 
 export async function initCommand(options) {
@@ -96,9 +96,13 @@ export async function initCommand(options) {
     // Copy kits
     const kitsData = {};
     let totalFiles = 0;
+    const manifests = {};
 
+    // First pass: copy each kit's own files
     for (const kitName of resolvedNames) {
       const manifest = loadManifest(kitsDir, kitName);
+      manifests[kitName] = manifest;
+
       const copiedFiles = copyKit(
         kitsDir,
         kitName,
@@ -111,9 +115,32 @@ export async function initCommand(options) {
         version: manifest.version,
         files: copiedFiles,
       };
+    }
 
-      totalFiles += copiedFiles.length;
-      console.log(`  ✓ ${manifest.displayName} (${copiedFiles.length} files)`);
+    // Second pass: copy shared dependency files into each agent kit's folder
+    for (const kitName of resolvedNames) {
+      const manifest = manifests[kitName];
+      for (const depName of manifest.dependencies) {
+        const depManifest = manifests[depName];
+        if (!depManifest) continue;
+
+        const depFiles = copyDependencyFiles(
+          kitsDir,
+          depName,
+          depManifest,
+          manifest,
+          targetDir,
+          ignorePatterns,
+        );
+
+        kitsData[kitName].files.push(...depFiles);
+      }
+    }
+
+    for (const kitName of resolvedNames) {
+      const fileCount = kitsData[kitName].files.length;
+      totalFiles += fileCount;
+      console.log(`  ✓ ${manifests[kitName].displayName} (${fileCount} files)`);
     }
 
     // Write lockfile

package/src/commands/upgrade.js

@@ -3,7 +3,7 @@ import { join } from 'node:path';
 import { resolveKitSource } from '../lib/resolver.js';
 import { loadManifest } from '../lib/manifest.js';
 import { loadIgnorePatterns } from '../lib/ignore.js';
-import { copyKit } from '../lib/copier.js';
+import { copyKit, copyDependencyFiles } from '../lib/copier.js';
 import { readLockfile, writeLockfile } from '../lib/lockfile.js';
 
 export async function upgradeCommand(options) {
@@ -58,7 +58,7 @@ export async function upgradeCommand(options) {
         }
       }
 
-      // Remove orphaned files (in old lockfile but not in new copy)
+      // Copy kit's own files
       const copiedFiles = copyKit(
         kitsDir,
         kitName,
@@ -67,6 +67,26 @@ export async function upgradeCommand(options) {
         ignorePatterns,
       );
 
+      // Copy shared dependency files into agent kit's folder
+      for (const depName of manifest.dependencies) {
+        let depManifest;
+        try {
+          depManifest = loadManifest(kitsDir, depName);
+        } catch {
+          continue;
+        }
+        const depFiles = copyDependencyFiles(
+          kitsDir,
+          depName,
+          depManifest,
+          manifest,
+          targetDir,
+          ignorePatterns,
+        );
+        copiedFiles.push(...depFiles);
+      }
+
+      // Remove orphaned files (in old lockfile but not in new copy)
       const newFileSet = new Set(copiedFiles);
       for (const oldFile of oldKit.files || []) {
         if (!newFileSet.has(oldFile)) {

package/src/lib/copier.js

@@ -32,6 +32,47 @@ export function copyKit(kitsDir, kitName, manifest, targetDir, ignorePatterns) {
   return copiedFiles;
 }
 
+/**
+ * Copy shared dependency files into an agent kit's folder using dependencyMappings.
+ * e.g., shared skills/ → .claude/skills/
+ */
+export function copyDependencyFiles(
+  kitsDir,
+  depName,
+  depManifest,
+  agentManifest,
+  targetDir,
+  ignorePatterns,
+) {
+  const mappings = agentManifest.dependencyMappings[depName];
+  if (!mappings) return [];
+
+  const copiedFiles = [];
+  const depDir = join(kitsDir, depName);
+
+  for (const depFileMapping of depManifest.files) {
+    const destOverride = mappings[depFileMapping.src];
+    if (!destOverride) continue;
+
+    const srcPath = join(depDir, depFileMapping.src);
+    const destPath = join(targetDir, destOverride);
+
+    const stat = statSync(srcPath, { throwIfNoEntry: false });
+    if (!stat) continue;
+
+    if (stat.isDirectory()) {
+      walkAndCopy(srcPath, destPath, destOverride, ignorePatterns, copiedFiles);
+    } else {
+      if (isIgnored(destOverride, ignorePatterns)) continue;
+      mkdirSync(join(targetDir, destOverride, '..'), { recursive: true });
+      copyFileSync(srcPath, destPath);
+      copiedFiles.push(destOverride);
+    }
+  }
+
+  return copiedFiles;
+}
+
 function walkAndCopy(srcDir, destDir, baseRelPath, ignorePatterns, copiedFiles) {
   const entries = readdirSync(srcDir, { withFileTypes: true });
 

package/src/lib/manifest.js

@@ -16,6 +16,7 @@ export function loadManifest(kitsDir, kitName) {
     description: manifest.description || '',
     files: manifest.files || [],
     dependencies: manifest.dependencies || [],
+    dependencyMappings: manifest.dependencyMappings || {},
     deletions: manifest.deletions || [],
   };
 }