@vibe-agent-toolkit/agent-skills 0.1.33 → 0.1.34

package/dist/schemas/claude-plugin.js

@@ -1,79 +0,0 @@
-import { z } from 'zod';
-import { zodToJsonSchema } from 'zod-to-json-schema';
-/**
- * Schema for .claude-plugin/plugin.json manifest
- * Based on official Claude Code documentation
- * @see https://code.claude.com/docs/en/plugins-reference
- */
-/**
- * Component path schemas per official Claude Code plugin spec.
- * @see https://code.claude.com/docs/en/plugins-reference#component-path-fields
- *
- * Path-only fields (commands, agents, skills, outputStyles): string | string[]
- * Config-capable fields (hooks, mcpServers, lspServers): string | string[] | object
- */
-const ComponentPathsSchema = z.union([
-    z.string(),
-    z.array(z.string()),
-]);
-const ComponentPathsOrConfigSchema = z.union([
-    z.string(),
-    z.array(z.string()),
-    z.record(z.unknown()),
-]);
-export const ClaudePluginSchema = z
-    .object({
-    name: z
-        .string()
-        .min(1, 'Plugin name is required')
-        .max(64, 'Plugin name must be 64 characters or less')
-        .regex(/^[a-z0-9]+(-[a-z0-9]+)*$/, // eslint-disable-line security/detect-unsafe-regex -- Simple pattern with bounded length, safe from ReDoS
-    'Plugin name must be lowercase alphanumeric with hyphens')
-        .describe('Unique plugin identifier (required if manifest exists)'),
-    version: z
-        .string()
-        .regex(/^\d+\.\d+\.\d+(-[\w.]+)?$/, // eslint-disable-line security/detect-unsafe-regex -- Simple semver pattern, bounded, safe from ReDoS
-    'Version must follow semver format (e.g., 1.0.0 or 1.0.0-rc.1)')
-        .optional()
-        .describe('Semantic version with optional pre-release suffix'),
-    description: z
-        .string()
-        .min(1)
-        .max(1024, 'Description must be 1024 characters or less')
-        .optional()
-        .describe('Human-readable description of plugin functionality (optional)'),
-    author: z
-        .object({
-        name: z.string().optional(),
-        email: z.string().email().optional(),
-        url: z.string().url().optional(),
-    })
-        .optional()
-        .describe('Plugin author information'),
-    homepage: z.string().url().optional().describe('Plugin homepage URL'),
-    repository: z.string().url().optional().describe('Source repository URL'),
-    license: z.string().optional().describe('License identifier (e.g., MIT)'),
-    keywords: z
-        .array(z.string())
-        .optional()
-        .describe('Search keywords for plugin discovery'),
-    // Component paths (all optional) — per official spec, string | string[] or string | string[] | object
-    commands: ComponentPathsSchema.optional().describe('Command files or directories'),
-    skills: ComponentPathsSchema.optional().describe('Skill directories'),
-    agents: ComponentPathsSchema.optional().describe('Agent files or directories'),
-    hooks: ComponentPathsOrConfigSchema.optional().describe('Hook config path(s) or inline config'),
-    mcpServers: ComponentPathsOrConfigSchema.optional().describe('MCP server config path(s) or inline config'),
-    outputStyles: ComponentPathsSchema.optional().describe('Output style files or directories'),
-    lspServers: ComponentPathsOrConfigSchema.optional().describe('LSP server config path(s) or inline config'),
-})
-    .passthrough() // Accept unknown fields — official spec evolves
-    .describe('Claude Code plugin manifest structure');
-/**
- * JSON Schema representation of ClaudePluginSchema
- * For external tools and documentation
- */
-export const ClaudePluginJsonSchema = zodToJsonSchema(ClaudePluginSchema, {
-    name: 'ClaudePluginManifest',
-    $refStrategy: 'none',
-});
-//# sourceMappingURL=claude-plugin.js.map

package/dist/schemas/claude-plugin.js.map

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

package/dist/validators/plugin-validator.d.ts

@@ -1,12 +0,0 @@
-import type { ValidationResult } from './types.js';
-/**
- * Validate a plugin directory structure against the ClaudePluginSchema.
- *
- * @see https://code.claude.com/docs/en/plugins-reference — Official plugin manifest spec
- * @param pluginPath - Absolute path to plugin directory
- * @returns Validation result with issues
- */
-export declare function validatePlugin(pluginPath: string, options?: {
-    strict?: boolean;
-}): Promise<ValidationResult>;
-//# sourceMappingURL=plugin-validator.d.ts.map

package/dist/validators/plugin-validator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-validator.d.ts","sourceRoot":"","sources":["../../src/validators/plugin-validator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAmB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAQpE;;;;;;GAMG;AACH,wBAAsB,cAAc,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CA8F3B"}

package/dist/validators/plugin-validator.js

@@ -1,99 +0,0 @@
-/* eslint-disable security/detect-non-literal-fs-filename -- File paths are validated before use */
-import { existsSync, readFileSync } from 'node:fs';
-import { safePath } from '@vibe-agent-toolkit/utils';
-import { ClaudePluginSchema } from '../schemas/claude-plugin.js';
-import { calculateValidationStatus, generateFixSuggestion, } from './validation-utils.js';
-const PLUGIN_TYPE = 'claude-plugin';
-/**
- * Validate a plugin directory structure against the ClaudePluginSchema.
- *
- * @see https://code.claude.com/docs/en/plugins-reference — Official plugin manifest spec
- * @param pluginPath - Absolute path to plugin directory
- * @returns Validation result with issues
- */
-export async function validatePlugin(pluginPath, options) {
-    const issues = [];
-    const pluginJsonPath = safePath.join(pluginPath, '.claude-plugin', 'plugin.json');
-    // Check plugin.json exists
-    if (!existsSync(pluginJsonPath)) {
-        issues.push({
-            severity: 'error',
-            code: 'PLUGIN_MISSING_MANIFEST',
-            message: 'Plugin manifest not found',
-            location: `${pluginPath}/.claude-plugin/plugin.json`,
-            fix: 'Create .claude-plugin/plugin.json with required fields (name, description, version)',
-        });
-        return {
-            path: pluginPath,
-            type: PLUGIN_TYPE,
-            status: 'error',
-            summary: 'Plugin manifest missing',
-            issues,
-        };
-    }
-    // Parse and validate plugin.json
-    let pluginData;
-    try {
-        const content = readFileSync(pluginJsonPath, 'utf-8');
-        pluginData = JSON.parse(content);
-    }
-    catch (error) {
-        issues.push({
-            severity: 'error',
-            code: 'PLUGIN_INVALID_JSON',
-            message: `Failed to parse plugin.json: ${error instanceof Error ? error.message : 'Unknown error'}`,
-            location: pluginJsonPath,
-            fix: 'Fix JSON syntax errors in plugin.json',
-        });
-        return {
-            path: pluginPath,
-            type: PLUGIN_TYPE,
-            status: 'error',
-            summary: 'Plugin manifest is invalid JSON',
-            issues,
-        };
-    }
-    // Validate against schema
-    const result = ClaudePluginSchema.safeParse(pluginData);
-    if (!result.success) {
-        for (const zodIssue of result.error.issues) {
-            issues.push({
-                severity: 'error',
-                code: 'PLUGIN_INVALID_SCHEMA',
-                message: zodIssue.message,
-                location: `${pluginJsonPath}:${zodIssue.path.join('.')}`,
-                fix: generateFixSuggestion(zodIssue),
-            });
-        }
-    }
-    const status = calculateValidationStatus(issues);
-    const validationResult = {
-        path: pluginPath,
-        type: PLUGIN_TYPE,
-        status,
-        summary: status === 'success' ? 'Valid plugin' : `Found ${issues.length} issue(s)`,
-        issues,
-    };
-    if (result.success) {
-        validationResult.metadata = {
-            name: result.data.name,
-            ...(result.data.version !== undefined && { version: result.data.version }),
-        };
-        // Warn when version is missing — Claude Code caches plugins by version,
-        // and without it the cache directory becomes "unknown/", causing stale
-        // skill resolution across upgrades.
-        if (result.data.version === undefined) {
-            issues.push({
-                severity: options?.strict ? 'error' : 'warning',
-                code: 'PLUGIN_MISSING_VERSION',
-                message: 'plugin.json missing version field — Claude Code will cache as "unknown/", causing stale skill resolution across upgrades',
-                location: pluginJsonPath,
-                fix: 'Add a "version" field to plugin.json (semver format, e.g. "1.0.0")',
-            });
-            validationResult.status = calculateValidationStatus(issues);
-            validationResult.summary = `Found ${issues.length} issue(s)`;
-        }
-    }
-    return validationResult;
-}
-//# sourceMappingURL=plugin-validator.js.map

package/dist/validators/plugin-validator.js.map

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