@vibe-agent-toolkit/cli 0.1.8 → 0.1.11

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/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,CA0E/C"}

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

@@ -0,0 +1,76 @@
+/**
+ * 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 SKILL.md files (links, frontmatter, skill rules)')
+        .argument('[path]', 'Path to validate (default: current directory)')
+        .option('-u, --user', 'Validate user-installed skills in ~/.claude')
+        .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.
+
+  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
+
+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)
+
+  User mode (permissive):
+    - Scans ~/.claude/plugins and ~/.claude/skills
+    - Filename warnings for non-standard names (not errors)
+    - More tolerant for user-installed content
+
+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)
+
+  Skill-specific validation:
+    - Reserved word checks (name field)
+    - XML tag detection (name/description fields)
+    - Console compatibility warnings
+    - Frontmatter required fields (name, description)
+
+  Filename validation:
+    - Must be "SKILL.md" (uppercase)
+    - Strict mode: error on skill.md, Skill.md
+    - Permissive mode: warning only
+
+Output:
+  YAML summary → stdout (for programmatic parsing)
+  Detailed errors → stderr (for human reading)
+
+  Output includes:
+    - status: success/error
+    - skillsValidated: number of SKILL.md files found
+    - results: per-skill validation details
+    - 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.)
+
+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
+`);
+    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,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"}

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

@@ -0,0 +1,24 @@
+/**
+ * Skills validate command - unified validation for SKILL.md files
+ *
+ * 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
+ */
+/**
+ * Skills validate command options
+ */
+interface SkillsValidateCommandOptions {
+    debug?: boolean;
+    user?: 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

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