@optima-chat/optima-agent 0.4.29 → 0.4.30

package/dist/src/validation/yaml-validator.d.ts

@@ -1,25 +0,0 @@
-import type { Validator, ValidationResult } from "./types.js";
-import { type SkillYamlFrontmatter } from "./schema.js";
-export declare class YamlValidator implements Validator<SkillYamlFrontmatter> {
-    /**
-     * 从内容中提取 YAML frontmatter
-     */
-    private extractFrontmatter;
-    /**
-     * 解析 YAML 内容
-     */
-    private parseYaml;
-    /**
-     * 从 YAML 错误中提取行号
-     */
-    private extractLineNumber;
-    /**
-     * 验证 YAML frontmatter
-     */
-    validate(content: string, filePath: string): ValidationResult;
-    /**
-     * 解析配置（验证成功后调用）
-     */
-    parse(content: string): SkillYamlFrontmatter | null;
-}
-//# sourceMappingURL=yaml-validator.d.ts.map

package/dist/src/validation/yaml-validator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"yaml-validator.d.ts","sourceRoot":"","sources":["../../../src/validation/yaml-validator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAmB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAA8B,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAQpF,qBAAa,aAAc,YAAW,SAAS,CAAC,oBAAoB,CAAC;IACnE;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAW1B;;OAEG;IACH,OAAO,CAAC,SAAS;IASjB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IASzB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB;IAmH7D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;CAiBpD"}

package/dist/src/validation/yaml-validator.js

@@ -1,177 +0,0 @@
-/**
- * YAML 配置验证器
- */
-import yaml from "js-yaml";
-import { ZodError } from "zod";
-import { SkillYamlFrontmatterSchema } from "./schema.js";
-import { generateSuggestionsFromZodError, generateYamlSyntaxSuggestions, generateSkillConfigSuggestions, } from "./suggestions.js";
-export class YamlValidator {
-    /**
-     * 从内容中提取 YAML frontmatter
-     */
-    extractFrontmatter(content) {
-        const match = content.match(/^---\n([\s\S]*?)\n---/);
-        if (!match) {
-            return null;
-        }
-        return {
-            yaml: match[1],
-            line: 1, // frontmatter 从第一行开始
-        };
-    }
-    /**
-     * 解析 YAML 内容
-     */
-    parseYaml(yamlContent) {
-        try {
-            const data = yaml.load(yamlContent);
-            return { data };
-        }
-        catch (error) {
-            return { data: null, error: error };
-        }
-    }
-    /**
-     * 从 YAML 错误中提取行号
-     */
-    extractLineNumber(error) {
-        // js-yaml 的错误消息通常包含 "at line X, column Y"
-        const match = error.message.match(/at line (\d+)/);
-        if (match) {
-            return parseInt(match[1], 10);
-        }
-        return undefined;
-    }
-    /**
-     * 验证 YAML frontmatter
-     */
-    validate(content, filePath) {
-        const errors = [];
-        const warnings = [];
-        // 1. 检查是否存在 frontmatter
-        const frontmatter = this.extractFrontmatter(content);
-        if (!frontmatter) {
-            errors.push({
-                type: "syntax",
-                filePath,
-                message: "未找到 YAML frontmatter",
-                details: "SKILL.md 文件应该以 YAML frontmatter 开头（用 --- 包裹）",
-                suggestions: [
-                    "在文件开头添加 YAML frontmatter",
-                    "格式应为: ---\\n配置内容\\n---",
-                    "参考示例: .claude/skills/planning-with-files/SKILL.md",
-                ],
-                examplePath: ".claude/skills/planning-with-files/SKILL.md",
-            });
-            return { valid: false, errors, warnings };
-        }
-        // 2. 解析 YAML
-        const { data, error: yamlError } = this.parseYaml(frontmatter.yaml);
-        if (yamlError) {
-            const line = this.extractLineNumber(yamlError);
-            errors.push({
-                type: "syntax",
-                filePath,
-                message: "YAML 语法错误",
-                details: yamlError.message,
-                line,
-                suggestions: generateYamlSyntaxSuggestions(yamlError.message),
-                examplePath: ".claude/skills/planning-with-files/SKILL.md",
-            });
-            return { valid: false, errors, warnings };
-        }
-        // 3. 使用 Zod 验证 schema
-        try {
-            SkillYamlFrontmatterSchema.parse(data);
-        }
-        catch (error) {
-            if (error instanceof ZodError) {
-                for (const issue of error.issues) {
-                    const zodSuggestions = generateSuggestionsFromZodError(error);
-                    const skillSuggestions = generateSkillConfigSuggestions(issue.path.map(String));
-                    errors.push({
-                        type: "schema",
-                        filePath,
-                        message: issue.message,
-                        path: issue.path.map(String),
-                        suggestions: [...zodSuggestions, ...skillSuggestions],
-                        examplePath: ".claude/skills/planning-with-files/SKILL.md",
-                    });
-                }
-            }
-            else {
-                errors.push({
-                    type: "schema",
-                    filePath,
-                    message: "未知的验证错误",
-                    details: String(error),
-                    suggestions: ["请检查配置文件格式"],
-                });
-            }
-            return { valid: false, errors, warnings };
-        }
-        // 4. 语义检查和警告
-        if (!data.description) {
-            warnings.push({
-                type: "semantic",
-                filePath,
-                message: "建议添加 description 字段",
-                suggestions: ["description 可以帮助用户理解 skill 的功能", "建议填写清晰的功能描述"],
-            });
-        }
-        // 检查 hooks 中的命令
-        if (data.hooks) {
-            for (const [eventType, configs] of Object.entries(data.hooks)) {
-                if (Array.isArray(configs)) {
-                    for (const config of configs) {
-                        if (config.hooks) {
-                            for (const hook of config.hooks) {
-                                if (hook.command && hook.command.includes("${CLAUDE_PLUGIN_ROOT}")) {
-                                    // 检查命令中的路径引用
-                                    const scriptPath = hook.command.match(/\$\{CLAUDE_PLUGIN_ROOT\}\/(.+?)(?:\s|$)/)?.[1];
-                                    if (scriptPath) {
-                                        warnings.push({
-                                            type: "semantic",
-                                            filePath,
-                                            message: `确保脚本文件存在: ${scriptPath}`,
-                                            path: ["hooks", eventType, "hooks", "command"],
-                                            suggestions: [
-                                                "检查脚本文件是否在 skill 目录中",
-                                                "确保脚本文件有执行权限（chmod +x）",
-                                            ],
-                                        });
-                                    }
-                                }
-                            }
-                        }
-                    }
-                }
-            }
-        }
-        return {
-            valid: errors.length === 0,
-            errors,
-            warnings,
-        };
-    }
-    /**
-     * 解析配置（验证成功后调用）
-     */
-    parse(content) {
-        const frontmatter = this.extractFrontmatter(content);
-        if (!frontmatter) {
-            return null;
-        }
-        const { data, error } = this.parseYaml(frontmatter.yaml);
-        if (error) {
-            return null;
-        }
-        try {
-            return SkillYamlFrontmatterSchema.parse(data);
-        }
-        catch {
-            return null;
-        }
-    }
-}
-//# sourceMappingURL=yaml-validator.js.map

package/dist/src/validation/yaml-validator.js.map

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