@vibe-agent-toolkit/cli 0.1.9 → 0.1.12

package/dist/commands/skills/list.js

@@ -0,0 +1,124 @@
+/**
+ * List skills in project or user installation
+ *
+ * By default, lists project skills. Use --user flag to list user-installed skills.
+ */
+import * as path from 'node:path';
+import { scan } from '@vibe-agent-toolkit/discovery';
+import { loadConfig } from '../../utils/config-loader.js';
+import { createLogger } from '../../utils/logger.js';
+import { discoverSkills, validateSkillFilename } from '../../utils/skill-discovery.js';
+import { scanUserContext } from '../../utils/user-context-scanner.js';
+/**
+ * Extract skill name from SKILL.md path
+ */
+function extractSkillName(skillPath) {
+    // Extract skill name from path (directory name containing SKILL.md)
+    const dir = path.dirname(skillPath);
+    return path.basename(dir);
+}
+/**
+ * Convert discovered skills to DiscoveredSkill format with validation
+ */
+function processDiscoveredSkills(discoveredSkills) {
+    return discoveredSkills.map(s => {
+        const filenameCheck = validateSkillFilename(s.path);
+        const skill = {
+            path: s.path,
+            name: extractSkillName(s.path),
+            valid: filenameCheck.valid,
+        };
+        // Only add warning if it exists (exactOptionalPropertyTypes)
+        if (filenameCheck.message !== undefined) {
+            skill.warning = filenameCheck.message;
+        }
+        return skill;
+    });
+}
+/**
+ * Output skills as YAML
+ */
+function outputSkillsYaml(skills, context) {
+    process.stdout.write('---\n');
+    process.stdout.write(`status: success\n`);
+    process.stdout.write(`context: ${context}\n`);
+    process.stdout.write(`skillsFound: ${skills.length}\n`);
+    process.stdout.write(`skills:\n`);
+    for (const skill of skills) {
+        process.stdout.write(`  - name: ${skill.name}\n`);
+        process.stdout.write(`    path: ${skill.path}\n`);
+        process.stdout.write(`    valid: ${skill.valid}\n`);
+        if (skill.warning) {
+            process.stdout.write(`    warning: "${skill.warning}"\n`);
+        }
+    }
+}
+/**
+ * Output human-readable skill list
+ */
+function outputSkillsHuman(skills, logger, options) {
+    if (skills.length === 0) {
+        logger.info(`\n   No skills found`);
+        return;
+    }
+    logger.info(`\n   Found ${skills.length} skill${skills.length === 1 ? '' : 's'}:\n`);
+    for (const skill of skills) {
+        const statusIcon = skill.valid ? '✅' : '⚠️';
+        const displayName = skill.name;
+        if (options.verbose) {
+            logger.info(`   ${statusIcon} ${displayName}`);
+            if (skill.warning) {
+                logger.info(`      Warning: ${skill.warning}`);
+            }
+            logger.info(`      Path: ${skill.path}\n`);
+        }
+        else if (skill.warning) {
+            logger.info(`   ${statusIcon} ${displayName} (${skill.warning})`);
+        }
+        else {
+            logger.info(`   ${statusIcon} ${displayName}`);
+        }
+    }
+}
+export async function listCommand(pathArg, options) {
+    const logger = createLogger(options.debug ? { debug: true } : {});
+    try {
+        let skills;
+        let context;
+        if (options.user) {
+            // User context: scan ~/.claude
+            logger.info('📋 Listing user-installed skills');
+            const { plugins, skills: standaloneSkills } = await scanUserContext();
+            const allResources = [...plugins, ...standaloneSkills];
+            const discoveredSkills = discoverSkills(allResources);
+            skills = processDiscoveredSkills(discoveredSkills);
+            context = 'user';
+        }
+        else {
+            // Project context: use resources config
+            const rootDir = pathArg ?? process.cwd();
+            logger.info(`📋 Listing skills in: ${rootDir}`);
+            const config = loadConfig(rootDir);
+            const scanResult = await scan({
+                path: rootDir,
+                recursive: true,
+                include: config.resources?.include ?? [],
+                exclude: config.resources?.exclude ?? [],
+            });
+            const discoveredSkills = discoverSkills(scanResult.results);
+            skills = processDiscoveredSkills(discoveredSkills);
+            context = 'project';
+        }
+        // Output YAML to stdout
+        outputSkillsYaml(skills, context);
+        // Human-friendly output to stderr
+        outputSkillsHuman(skills, logger, options);
+        process.exit(0);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.error(`Failed to list skills: ${errorMessage}`);
+        process.exit(2);
+    }
+}
+//# sourceMappingURL=list.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * Package a skill for distribution
+ *
+ * Creates distributable artifacts (directory, ZIP, npm) from a SKILL.md file
+ */
+import { Command } from 'commander';
+export interface SkillsPackageCommandOptions {
+    output: string;
+    formats?: string;
+    'no-rewrite-links'?: boolean;
+    'base-path'?: string;
+    dryRun?: boolean;
+    debug?: boolean;
+}
+export declare function createPackageCommand(): Command;
+//# sourceMappingURL=package.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../../src/commands/skills/package.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAkD9C"}

package/dist/commands/skills/package.js

@@ -0,0 +1,293 @@
+/**
+ * Package a skill for distribution
+ *
+ * Creates distributable artifacts (directory, ZIP, npm) from a SKILL.md file
+ */
+import { existsSync, statSync } from 'node:fs';
+import { basename, dirname, relative, resolve } from 'node:path';
+import { packageSkill, validateSkill, } from '@vibe-agent-toolkit/agent-skills';
+import { parseMarkdown } from '@vibe-agent-toolkit/resources';
+import { Command } from 'commander';
+import { handleCommandError } from '../../utils/command-error.js';
+import { createLogger } from '../../utils/logger.js';
+export function createPackageCommand() {
+    const command = new Command('package');
+    command
+        .description('Package a skill for distribution (creates directory + ZIP artifacts)')
+        .argument('<skill-path>', 'Path to SKILL.md file')
+        .requiredOption('-o, --output <path>', 'Output directory for packaged skill')
+        .option('-f, --formats <formats>', 'Package formats (comma-separated: directory,zip,npm,marketplace)', 'directory,zip')
+        .option('--no-rewrite-links', 'Skip rewriting relative links in copied files')
+        .option('-b, --base-path <path>', 'Base path for resolving relative links (default: dirname of SKILL.md)')
+        .option('--dry-run', 'Preview packaging without creating files')
+        .option('--debug', 'Enable debug logging')
+        .action(packageCommand)
+        .addHelpText('after', `
+Description:
+  Packages a SKILL.md file and all linked resources into distributable
+  formats. Recursively collects all markdown files linked from SKILL.md,
+  rewrites links to maintain correctness after relocation, and creates
+  artifacts for distribution.
+
+  Default formats: directory (ready-to-use) + ZIP (single file)
+
+  REQUIRED: --output flag must specify where to create the package
+
+Output:
+  - outputPath: Where the packaged skill was created
+  - skill.name: Skill name (from frontmatter or H1 title)
+  - files.dependencies: List of files included in package
+  - artifacts: Map of format → file path
+  - dryRun: true if --dry-run was used (no files created)
+
+Exit Codes:
+  0 - Packaging successful (or dry-run preview)
+  1 - Invalid skill path or packaging error
+  2 - System error
+
+Examples:
+  $ vat skills package SKILL.md -o dist/my-skill
+  $ vat skills package SKILL.md -o /tmp/skill --dry-run
+  $ vat skills package SKILL.md -o dist -f zip,npm
+`);
+    return command;
+}
+/**
+ * Validate skill and exit if errors found
+ */
+async function validateSkillOrExit(skillPath, basePath, logger) {
+    logger.info(`\n🔍 Validating skill...`);
+    const validationResult = await validateSkill({
+        skillPath,
+        rootDir: basePath,
+    });
+    if (validationResult.status === 'error') {
+        displayValidationErrors(validationResult, logger);
+        process.exit(1);
+    }
+    logger.info(`✅ Validation passed`);
+}
+/**
+ * Display a single validation issue
+ */
+function displayIssue(issue, logger, useErrorLevel) {
+    const logFn = useErrorLevel ? logger.error : logger.info;
+    logFn(`  [${issue.code}] ${issue.message}`);
+    if (issue.location) {
+        logFn(`    Location: ${issue.location}`);
+    }
+    if (issue.fix) {
+        logFn(`    Fix: ${issue.fix}`);
+    }
+}
+/**
+ * Format and display validation errors
+ */
+function displayValidationErrors(validationResult, logger) {
+    logger.error(`\n❌ Skill validation failed`);
+    logger.error(`   Status: ${validationResult.status}`);
+    logger.error(`   Summary: ${validationResult.summary}\n`);
+    // Group issues by severity
+    const errors = validationResult.issues.filter(i => i.severity === 'error');
+    const warnings = validationResult.issues.filter(i => i.severity === 'warning');
+    // Display errors
+    if (errors.length > 0) {
+        logger.error(`Errors:`);
+        for (const issue of errors) {
+            displayIssue(issue, logger, true);
+        }
+        logger.error('');
+    }
+    // Display warnings
+    if (warnings.length > 0) {
+        logger.info(`Warnings:`);
+        for (const issue of warnings) {
+            displayIssue(issue, logger, false);
+        }
+        logger.info('');
+    }
+}
+/**
+ * Recursively collect linked markdown files
+ */
+async function collectLinkedFiles(markdownPath, basePath, visited) {
+    const normalizedPath = resolve(markdownPath);
+    if (visited.has(normalizedPath)) {
+        return [];
+    }
+    visited.add(normalizedPath);
+    const parseResult = await parseMarkdown(markdownPath);
+    const linkedFiles = [];
+    for (const link of parseResult.links) {
+        if (link.type !== 'local_file')
+            continue;
+        const hrefWithoutAnchor = link.href.split('#')[0] ?? link.href;
+        if (hrefWithoutAnchor === '')
+            continue;
+        const resolvedPath = resolve(dirname(markdownPath), hrefWithoutAnchor);
+        // Only include markdown files (no basePath filtering - collect all valid linked files)
+        if (!resolvedPath.endsWith('.md'))
+            continue;
+        // Skip missing files
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- Path resolved from validated markdown links
+        if (!existsSync(resolvedPath))
+            continue;
+        linkedFiles.push(resolvedPath);
+        // Recursively collect from this file
+        const transitive = await collectLinkedFiles(resolvedPath, basePath, visited);
+        linkedFiles.push(...transitive);
+    }
+    // Deduplicate
+    return [...new Set(linkedFiles)];
+}
+/**
+ * Extract skill name from parse result
+ */
+function extractSkillName(parseResult) {
+    if (parseResult.frontmatter?.['name']) {
+        return parseResult.frontmatter['name'];
+    }
+    // Try to extract H1
+    const lines = parseResult.content.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith('# ')) {
+            return trimmed.slice(2).trim();
+        }
+    }
+    return 'unknown';
+}
+/**
+ * Calculate estimated ZIP size for files
+ */
+function calculateZipSize(skillPath, linkedFiles) {
+    let totalSize = 0;
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- User-provided path, validated
+    totalSize += statSync(skillPath).size;
+    for (const file of linkedFiles) {
+        // eslint-disable-next-line security/detect-non-literal-fs-filename -- Collected from validated markdown links
+        if (existsSync(file)) {
+            // eslint-disable-next-line security/detect-non-literal-fs-filename -- Collected from validated markdown links
+            totalSize += statSync(file).size;
+        }
+    }
+    // Rough estimate: 60% compression for markdown
+    return Math.round((totalSize * 0.6) / 1024);
+}
+/**
+ * Output dry-run results as YAML
+ */
+function outputDryRunYaml(skillName, outputPath, fileCount, formats, duration) {
+    process.stdout.write('---\n');
+    process.stdout.write(`status: success\n`);
+    process.stdout.write(`dryRun: true\n`);
+    process.stdout.write(`skill: ${skillName}\n`);
+    process.stdout.write(`outputPath: ${outputPath}\n`);
+    process.stdout.write(`filesPackaged: ${fileCount}\n`);
+    process.stdout.write(`formats:\n`);
+    for (const format of formats) {
+        process.stdout.write(`  - ${format}\n`);
+    }
+    process.stdout.write(`duration: ${duration}ms\n`);
+}
+/**
+ * Perform dry-run preview of packaging operation
+ */
+async function performDryRun(skillPath, options, logger) {
+    const startTime = Date.now();
+    // Validate skill path exists
+    // eslint-disable-next-line security/detect-non-literal-fs-filename -- User-provided CLI argument, validated
+    if (!existsSync(skillPath)) {
+        throw new Error(`SKILL.md not found: ${skillPath}`);
+    }
+    logger.info(`🔍 Dry-run: Analyzing skill packaging...`);
+    logger.info(`   Source: ${skillPath}`);
+    logger.info(`   Output: ${options.output}`);
+    // VALIDATE FIRST - shift left to catch errors early
+    await validateSkillOrExit(skillPath, options['base-path'] ?? dirname(skillPath), logger);
+    // Parse SKILL.md and extract metadata
+    const parseResult = await parseMarkdown(skillPath);
+    const skillName = extractSkillName(parseResult);
+    logger.info(`   Skill: ${skillName}`);
+    // Collect linked files (recursively)
+    const basePath = options['base-path'] ?? dirname(skillPath);
+    const linkedFiles = await collectLinkedFiles(skillPath, basePath, new Set());
+    logger.info(`\n📁 Files to be packaged:`);
+    logger.info(`   - SKILL.md (root)`);
+    for (const file of linkedFiles) {
+        const relPath = relative(basePath, file);
+        logger.info(`   - ${relPath}`);
+    }
+    logger.info(`\n   Total: ${linkedFiles.length + 1} files`);
+    // Parse and display formats
+    const formats = options.formats?.split(',').map(f => f.trim()) ?? ['directory', 'zip'];
+    logger.info(`\n📦 Formats to create:`);
+    for (const format of formats) {
+        logger.info(`   - ${format}`);
+    }
+    // Estimate ZIP size if needed
+    if (formats.includes('zip')) {
+        const estimatedZipSize = calculateZipSize(skillPath, linkedFiles);
+        logger.info(`\n📊 Estimated ZIP size: ~${estimatedZipSize}KB`);
+    }
+    const duration = Date.now() - startTime;
+    // Output YAML results
+    outputDryRunYaml(skillName, options.output, linkedFiles.length + 1, formats, duration);
+    logger.info(`\n✅ Dry-run complete (no files created)`);
+    logger.info(`   Run without --dry-run to create the package`);
+}
+async function packageCommand(skillPath, options) {
+    const logger = createLogger(options.debug ? { debug: true } : {});
+    const startTime = Date.now();
+    try {
+        logger.info(`📦 Packaging skill: ${skillPath}`);
+        // Parse formats
+        const formats = options.formats
+            ?.split(',')
+            .map(f => f.trim()) ?? ['directory', 'zip'];
+        // Build package options
+        const packageOptions = {
+            formats,
+            rewriteLinks: options['no-rewrite-links'] !== true,
+            outputPath: options.output,
+        };
+        if (options['base-path']) {
+            packageOptions.basePath = options['base-path'];
+        }
+        // Handle dry-run mode
+        if (options.dryRun) {
+            await performDryRun(skillPath, options, logger);
+            process.exit(0);
+        }
+        // VALIDATE FIRST - shift left to catch errors early
+        await validateSkillOrExit(skillPath, options['base-path'] ?? dirname(skillPath), logger);
+        logger.info('');
+        // Package the skill
+        const result = await packageSkill(skillPath, packageOptions);
+        const duration = Date.now() - startTime;
+        // Output YAML to stdout
+        process.stdout.write('---\n');
+        process.stdout.write(`status: success\n`);
+        process.stdout.write(`skill: ${result.skill.name}\n`);
+        process.stdout.write(`version: ${result.skill.version ?? 'unspecified'}\n`);
+        process.stdout.write(`outputPath: ${result.outputPath}\n`);
+        process.stdout.write(`filesPackaged: ${result.files.dependencies.length + 1}\n`);
+        if (result.artifacts) {
+            process.stdout.write(`artifacts:\n`);
+            for (const [format, path] of Object.entries(result.artifacts)) {
+                process.stdout.write(`  ${format}: ${path}\n`);
+            }
+        }
+        process.stdout.write(`duration: ${duration}ms\n`);
+        logger.info(`✅ Packaged skill: ${result.skill.name}`);
+        logger.info(`   Output: ${result.outputPath}`);
+        if (result.artifacts?.['zip']) {
+            logger.info(`   ZIP: ${basename(result.artifacts['zip'])}`);
+        }
+        process.exit(0);
+    }
+    catch (error) {
+        handleCommandError(error, logger, startTime, 'SkillsPackage');
+    }
+}
+//# sourceMappingURL=package.js.map

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

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

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/validate-command.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Skills validate command - Commander.js wrapper
+ */
+import { Command } from 'commander';
+export declare function createValidateCommand(): Command;
+//# sourceMappingURL=validate-command.d.ts.map

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

@@ -0,0 +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,CAuF/C"}

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

@@ -0,0 +1,89 @@
+/**
+ * Skills validate command - Commander.js wrapper
+ */
+import { Command } from 'commander';
+import { validateCommand } from './validate.js';
+export function createValidateCommand() {
+    const command = new Command('validate');
+    command
+        .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 skills declared in package.json vat.skills field using
+  enhanced packaging validation. Checks size/complexity, link depth,
+  navigation patterns, and applies validation overrides.
+
+  Reads skills from package.json vat.skills and runs validateSkillForPackaging()
+  for each skill. Supports validation overrides with expiration checking.
+
+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)
+
+  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 Overrides:
+  Configure overrides in package.json vat.skills:
+
+  {
+    "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"
+          }
+        }
+      }]
+    }
+  }
+
+  Non-overridable rules (required for correctness) cannot be ignored.
+  Expired overrides are reported as errors.
+
+Output:
+  YAML summary → stdout (for programmatic parsing)
+  Detailed errors → stderr (for human reading)
+
+  Output includes:
+    - status: success/error
+    - skillsValidated: number of skills validated
+    - results: per-skill validation details (activeErrors, ignoredErrors, expiredOverrides)
+    - durationSecs: validation time
+
+Exit Codes:
+  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                    # 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;
+}
+//# sourceMappingURL=validate-command.js.map

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

@@ -0,0 +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,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

@@ -0,0 +1,19 @@
+/**
+ * Skills validate command - validate skills for packaging
+ *
+ * Validates skills declared in package.json vat.skills using validateSkillForPackaging.
+ * Supports validation overrides and expiration checking.
+ */
+/**
+ * Skills validate command options
+ */
+export interface SkillsValidateCommandOptions {
+    skill?: string;
+    debug?: boolean;
+    verbose?: boolean;
+}
+/**
+ * Skills validate command implementation
+ */
+export declare function validateCommand(pathArg: string | undefined, options: SkillsValidateCommandOptions): Promise<void>;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"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"}