@vibe-agent-toolkit/cli 0.1.11 → 0.1.13

package/dist/commands/skills/shared.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Shared utilities for skills commands
+ */
+import type { VatSkillMetadata } from '@vibe-agent-toolkit/agent-schema';
+import type { createLogger } from '../../utils/logger.js';
+/**
+ * Package.json with VAT skill metadata
+ */
+export interface PackageJson {
+    name?: string;
+    vat?: {
+        skills: VatSkillMetadata[];
+    };
+}
+/**
+ * Read and parse package.json from current directory
+ */
+export declare function readPackageJson(cwd: string): Promise<PackageJson>;
+/**
+ * Validate skill source exists
+ */
+export declare function validateSkillSource(skill: VatSkillMetadata, cwd: string, logger: ReturnType<typeof createLogger>): string;
+//# sourceMappingURL=shared.d.ts.map

package/dist/commands/skills/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/commands/skills/shared.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE;QACL,MAAM,EAAE,gBAAgB,EAAE,CAAC;KAC3B,CAAC;CACF;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAWvE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,gBAAgB,EACvB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,GACrC,MAAM,CAWR"}

package/dist/commands/skills/shared.js

@@ -0,0 +1,33 @@
+/**
+ * Shared utilities for skills commands
+ */
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+/**
+ * Read and parse package.json from current directory
+ */
+export async function readPackageJson(cwd) {
+    const packageJsonPath = join(cwd, 'package.json');
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- Reading from validated current directory
+    if (!existsSync(packageJsonPath)) {
+        throw new Error(`package.json not found in current directory: ${cwd}`);
+    }
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- Reading from validated current directory
+    const content = await readFile(packageJsonPath, 'utf-8');
+    return JSON.parse(content);
+}
+/**
+ * Validate skill source exists
+ */
+export function validateSkillSource(skill, cwd, logger) {
+    const sourcePath = resolve(cwd, skill.source);
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- Path resolved from package.json
+    if (!existsSync(sourcePath)) {
+        logger.error(`❌ Skill source not found: ${skill.source}`);
+        logger.error(`   Expected path: ${sourcePath}`);
+        process.exit(1);
+    }
+    return sourcePath;
+}
+//# sourceMappingURL=shared.js.map

package/dist/commands/skills/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/commands/skills/shared.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgB1C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW;IAChD,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAElD,+GAA+G;IAC/G,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,gDAAgD,GAAG,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,+GAA+G;IAC/G,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IACzD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAgB,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAClC,KAAuB,EACvB,GAAW,EACX,MAAuC;IAEvC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAE9C,sGAAsG;IACtG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,6BAA6B,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1D,MAAM,CAAC,KAAK,CAAC,qBAAqB,UAAU,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,UAAU,CAAC;AACnB,CAAC"}

package/dist/commands/skills/uninstall.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Uninstall skills from Claude's skills directory
+ *
+ * Supports:
+ * - Single skill by name: vat skills uninstall <name>
+ * - All skills from package: vat skills uninstall --all
+ * - Dry-run preview: --dry-run
+ */
+import { Command } from 'commander';
+export declare function createUninstallCommand(): Command;
+//# sourceMappingURL=uninstall.d.ts.map

package/dist/commands/skills/uninstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../../src/commands/skills/uninstall.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC,wBAAgB,sBAAsB,IAAI,OAAO,CA2ChD"}

package/dist/commands/skills/uninstall.js

@@ -0,0 +1,142 @@
+/**
+ * Uninstall skills from Claude's skills directory
+ *
+ * Supports:
+ * - Single skill by name: vat skills uninstall <name>
+ * - All skills from package: vat skills uninstall --all
+ * - Dry-run preview: --dry-run
+ */
+import { lstatSync } from 'node:fs';
+import { rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { Command } from 'commander';
+import { getClaudeUserPaths } from '../../utils/claude-paths.js';
+import { handleCommandError } from '../../utils/command-error.js';
+import { createLogger } from '../../utils/logger.js';
+import { readPackageJsonVatMetadata, writeYamlHeader } from './install-helpers.js';
+export function createUninstallCommand() {
+    const command = new Command('uninstall');
+    command
+        .description('Uninstall skills from Claude Code skills directory')
+        .argument('[name]', 'Name of skill to uninstall')
+        .option('-s, --skills-dir <path>', 'Claude skills directory', getClaudeUserPaths().skillsDir)
+        .option('-a, --all', 'Uninstall all skills declared in package.json vat.skills[]', false)
+        .option('--dry-run', 'Preview uninstall without removing files', false)
+        .option('--debug', 'Enable debug logging')
+        .action(uninstallCommand)
+        .addHelpText('after', `
+Description:
+  Removes installed skills from Claude Code's skills directory.
+  Detects and handles both symlinks (dev installs) and copied directories.
+
+  Single skill: vat skills uninstall my-skill
+  All from package: vat skills uninstall --all (reads package.json vat.skills[])
+
+Output:
+  - status: success/error
+  - skillsRemoved: number of skills removed
+  - skills: array with name, path, wasSymlink for each
+
+Exit Codes:
+  0 - Uninstall successful
+  1 - Skill not found or not installed
+  2 - System error
+
+Example:
+  $ vat skills uninstall my-skill          # Remove single skill
+  $ vat skills uninstall --all             # Remove all package skills
+  $ vat skills uninstall --all --dry-run   # Preview removal
+`);
+    return command;
+}
+async function uninstallCommand(name, options) {
+    const logger = createLogger(options.debug ? { debug: true } : {});
+    const startTime = Date.now();
+    try {
+        // Determine which skills to uninstall
+        const skillNames = await resolveSkillNames(name, options, logger);
+        const skillsDir = options.skillsDir ?? getClaudeUserPaths().skillsDir;
+        const removed = [];
+        for (const skillName of skillNames) {
+            const result = await removeSkill(skillName, skillsDir, options.dryRun ?? false, logger);
+            if (result) {
+                removed.push(result);
+            }
+        }
+        if (removed.length === 0) {
+            logger.error('No skills were removed');
+            process.exit(1);
+        }
+        const duration = Date.now() - startTime;
+        outputUninstallSuccess(removed, duration, logger, options.dryRun);
+        process.exit(0);
+    }
+    catch (error) {
+        handleCommandError(error, logger, startTime, 'SkillsUninstall');
+    }
+}
+/**
+ * Resolve skill names from argument or --all flag
+ */
+async function resolveSkillNames(name, options, logger) {
+    if (options.all) {
+        const cwd = process.cwd();
+        const { packageJson, skills } = await readPackageJsonVatMetadata(cwd);
+        logger.info(`📦 Uninstalling all skills from ${packageJson.name}`);
+        return skills.map(s => s.name);
+    }
+    if (!name) {
+        throw new Error('Skill name required. Usage:\n' +
+            '  vat skills uninstall <name>       # Remove single skill\n' +
+            '  vat skills uninstall --all        # Remove all from package.json');
+    }
+    return [name];
+}
+/**
+ * Remove a single skill from the skills directory
+ * Uses lstatSync to detect symlinks (doesn't follow them)
+ */
+async function removeSkill(name, skillsDir, dryRun, logger) {
+    const skillPath = join(skillsDir, name);
+    // Check if installed (lstatSync detects broken symlinks)
+    let wasSymlink = false;
+    try {
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- Skills dir from config
+        const stat = lstatSync(skillPath);
+        wasSymlink = stat.isSymbolicLink();
+    }
+    catch {
+        logger.error(`   ⚠️  ${name}: not installed at ${skillPath}`);
+        return undefined;
+    }
+    const typeLabel = wasSymlink ? 'symlink' : 'directory';
+    if (dryRun) {
+        logger.info(`   Would remove ${typeLabel}: ${name} (${skillPath})`);
+    }
+    else {
+        await rm(skillPath, { recursive: true, force: true });
+        logger.info(`   Removed ${typeLabel}: ${name}`);
+    }
+    return { name, path: skillPath, wasSymlink };
+}
+/**
+ * Output success YAML for uninstall
+ */
+function outputUninstallSuccess(removed, duration, logger, dryRun) {
+    writeYamlHeader(dryRun);
+    process.stdout.write(`skillsRemoved: ${removed.length}\n`);
+    process.stdout.write(`skills:\n`);
+    for (const skill of removed) {
+        process.stdout.write(`  - name: ${skill.name}\n`);
+        process.stdout.write(`    path: ${skill.path}\n`);
+        process.stdout.write(`    wasSymlink: ${skill.wasSymlink}\n`);
+    }
+    process.stdout.write(`duration: ${duration}ms\n`);
+    if (dryRun) {
+        logger.info(`\n✅ Dry-run: ${removed.length} skill(s) would be removed`);
+    }
+    else {
+        logger.info(`\n✅ Removed ${removed.length} skill(s)`);
+    }
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/commands/skills/uninstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.js","sourceRoot":"","sources":["../../../src/commands/skills/uninstall.ts"],"names":[],"mappings":"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"}

package/dist/commands/skills/validate-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-command.d.ts","sourceRoot":"","sources":["../../../src/commands/skills/validate-command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,qBAAqB,IAAI,OAAO,CA0E/C"}
+{"version":3,"file":"validate-command.d.ts","sourceRoot":"","sources":["../../../src/commands/skills/validate-command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,qBAAqB,IAAI,OAAO,CAuF/C"}

package/dist/commands/skills/validate-command.js

@@ -6,50 +6,63 @@ import { validateCommand } from './validate.js';
 export function createValidateCommand() {
     const command = new Command('validate');
     command
-        .description('Validate SKILL.md files (links, frontmatter, skill rules)')
-        .argument('[path]', 'Path to validate (default: current directory)')
-        .option('-u, --user', 'Validate user-installed skills in ~/.claude')
+        .description('Validate skills for packaging (reads vat.skills from package.json)')
+        .argument('[path]', 'Path to directory with package.json (default: current directory)')
+        .option('--skill <name>', 'Validate specific skill only')
+        .option('-v, --verbose', 'Show full details including excluded reference paths')
         .option('-d, --debug', 'Enable debug logging')
         .action(validateCommand)
         .addHelpText('after', `
 Description:
-  Validates all SKILL.md files using both resource validation (markdown,
-  links, frontmatter) and skill-specific validation (reserved words, XML
-  tags, console compatibility). Reports all errors in a unified format.
+  Validates skills declared in package.json vat.skills field using
+  enhanced packaging validation. Checks size/complexity, link depth,
+  navigation patterns, and applies validation overrides.
 
-  Supports three modes:
-    - Project mode (default): Validate project skills with strict filename validation
-    - User mode (--user): Validate ~/.claude skills with permissive validation
-    - Path mode: Validate skills at specific path with strict validation
+  Reads skills from package.json vat.skills and runs validateSkillForPackaging()
+  for each skill. Supports validation overrides with expiration checking.
 
-Validation Modes:
-  Project mode (strict):
-    - Respects vibe-agent-toolkit.config.yaml boundaries
-    - Filename must be exactly "SKILL.md" (case-sensitive)
-    - Errors on non-standard filenames (skill.md, Skill.md)
+Validation Checks:
+  Required (non-overridable):
+    - Valid YAML frontmatter
+    - Skill has a name
+    - No reserved words (anthropic/claude)
+    - No broken internal links
+    - No circular references
+    - Links stay within package boundary
+    - No filename collisions
+    - Forward slashes in paths (not backslashes)
 
-  User mode (permissive):
-    - Scans ~/.claude/plugins and ~/.claude/skills
-    - Filename warnings for non-standard names (not errors)
-    - More tolerant for user-installed content
+  Best practices (overridable):
+    - SKILL.md ≤500 lines (recommended)
+    - Total skill size ≤2000 lines
+    - File count ≤6 files
+    - Reference depth ≤2 levels
+    - No links to navigation files (README.md, index.md)
+    - Description ≥50 characters
+    - Progressive disclosure pattern
 
-Validation Checks:
-  Resource validation:
-    - Internal file links (relative paths)
-    - Anchor links within files (#heading)
-    - Cross-file anchor links (file.md#heading)
-    - Frontmatter schema (if SKILL.md has frontmatter)
+Validation Overrides:
+  Configure overrides in package.json vat.skills:
 
-  Skill-specific validation:
-    - Reserved word checks (name field)
-    - XML tag detection (name/description fields)
-    - Console compatibility warnings
-    - Frontmatter required fields (name, description)
+  {
+    "vat": {
+      "skills": [{
+        "name": "my-skill",
+        "source": "./SKILL.md",
+        "path": "./dist/skills/my-skill",
+        "ignoreValidationErrors": {
+          "SKILL_LENGTH_EXCEEDS_RECOMMENDED": "Complex domain requires detailed examples",
+          "SKILL_TOO_MANY_FILES": {
+            "reason": "Migration in progress - will split skill",
+            "expires": "2026-06-01"
+          }
+        }
+      }]
+    }
+  }
 
-  Filename validation:
-    - Must be "SKILL.md" (uppercase)
-    - Strict mode: error on skill.md, Skill.md
-    - Permissive mode: warning only
+  Non-overridable rules (required for correctness) cannot be ignored.
+  Expired overrides are reported as errors.
 
 Output:
   YAML summary → stdout (for programmatic parsing)
@@ -57,19 +70,19 @@ Output:
 
   Output includes:
     - status: success/error
-    - skillsValidated: number of SKILL.md files found
-    - results: per-skill validation details
+    - skillsValidated: number of skills validated
+    - results: per-skill validation details (activeErrors, ignoredErrors, expiredOverrides)
     - durationSecs: validation time
 
 Exit Codes:
-  0 - All validations passed
-  1 - Validation errors found (warnings don't fail)
-  2 - System error (file not found, config invalid, etc.)
+  0 - All validations passed (or all errors ignored by valid overrides)
+  1 - Active validation errors found (or expired overrides)
+  2 - System error (file not found, invalid config, etc.)
 
 Examples:
-  $ vat skills validate                    # Project mode: validate all project skills
-  $ vat skills validate --user             # User mode: validate ~/.claude skills
-  $ vat skills validate packages/          # Path mode: validate specific directory
+  $ vat skills validate                    # Validate all skills in package.json
+  $ vat skills validate --skill my-skill   # Validate specific skill only
+  $ vat skills validate packages/my-pkg/   # Validate skills in specific directory
 `);
     return command;
 }

package/dist/commands/skills/validate-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate-command.js","sourceRoot":"","sources":["../../../src/commands/skills/validate-command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,UAAU,qBAAqB;IACnC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAExC,OAAO;SACJ,WAAW,CAAC,2DAA2D,CAAC;SACxE,QAAQ,CAAC,QAAQ,EAAE,+CAA+C,CAAC;SACnE,MAAM,CAAC,YAAY,EAAE,6CAA6C,CAAC;SACnE,MAAM,CAAC,aAAa,EAAE,sBAAsB,CAAC;SAC7C,MAAM,CAAC,eAAe,CAAC;SACvB,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2DL,CACI,CAAC;IAEJ,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"validate-command.js","sourceRoot":"","sources":["../../../src/commands/skills/validate-command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,UAAU,qBAAqB;IACnC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAExC,OAAO;SACJ,WAAW,CAAC,oEAAoE,CAAC;SACjF,QAAQ,CAAC,QAAQ,EAAE,kEAAkE,CAAC;SACtF,MAAM,CAAC,gBAAgB,EAAE,8BAA8B,CAAC;SACxD,MAAM,CAAC,eAAe,EAAE,sDAAsD,CAAC;SAC/E,MAAM,CAAC,aAAa,EAAE,sBAAsB,CAAC;SAC7C,MAAM,CAAC,eAAe,CAAC;SACvB,WAAW,CACV,OAAO,EACP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuEL,CACI,CAAC;IAEJ,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/commands/skills/validate.d.ts

@@ -1,24 +1,19 @@
 /**
- * Skills validate command - unified validation for SKILL.md files
+ * Skills validate command - validate skills for packaging
  *
- * Combines resource validation (markdown, links, frontmatter) with
- * skill-specific validation (reserved words, XML tags, console compatibility).
- *
- * Supports three modes:
- * 1. Project context (default): Validate project skills with strict filename validation
- * 2. User context (--user flag): Validate ~/.claude skills with permissive validation
- * 3. Path context (explicit path): Validate skills at specific path
+ * Validates skills declared in package.json vat.skills using validateSkillForPackaging.
+ * Supports validation overrides and expiration checking.
  */
 /**
  * Skills validate command options
  */
-interface SkillsValidateCommandOptions {
+export interface SkillsValidateCommandOptions {
+    skill?: string;
     debug?: boolean;
-    user?: boolean;
+    verbose?: boolean;
 }
 /**
  * Skills validate command implementation
  */
 export declare function validateCommand(pathArg: string | undefined, options: SkillsValidateCommandOptions): Promise<void>;
-export {};
 //# sourceMappingURL=validate.d.ts.map

package/dist/commands/skills/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/commands/skills/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAoSH;;GAEG;AACH,UAAU,4BAA4B;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CAkGf"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/commands/skills/validate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmBH;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA6LD;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CAoCf"}