@optima-chat/optima-agent 0.4.30 → 0.4.32

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

@@ -0,0 +1,173 @@
+/**
+ * JSON 配置验证器
+ */
+import { ZodError } from "zod";
+import { OptimaConfigSchema } from "./schema.js";
+import { generateSuggestionsFromZodError, generateJsonSyntaxSuggestions, generateOptimaConfigSuggestions, } from "./suggestions.js";
+export class JsonValidator {
+    /**
+     * 解析 JSON 内容
+     */
+    parseJson(content) {
+        try {
+            const data = JSON.parse(content);
+            return { data };
+        }
+        catch (error) {
+            const position = this.extractErrorPosition(error);
+            return { data: null, error: error, position };
+        }
+    }
+    /**
+     * 从 JSON 错误中提取位置信息
+     */
+    extractErrorPosition(error) {
+        // JSON.parse 错误通常包含 "at position X"
+        const match = error.message.match(/position (\d+)/);
+        if (match) {
+            return parseInt(match[1], 10);
+        }
+        return undefined;
+    }
+    /**
+     * 将字符位置转换为行号和列号
+     */
+    positionToLineColumn(content, position) {
+        const lines = content.substring(0, position).split("\n");
+        return {
+            line: lines.length,
+            column: lines[lines.length - 1].length + 1,
+        };
+    }
+    /**
+     * 验证 JSON 配置
+     */
+    validate(content, filePath) {
+        const errors = [];
+        const warnings = [];
+        // 1. 检查是否为空
+        if (!content.trim()) {
+            errors.push({
+                type: "syntax",
+                filePath,
+                message: "配置文件为空",
+                suggestions: [
+                    "添加配置内容",
+                    "如果不需要配置，可以删除该文件",
+                    "最小配置示例: {}",
+                ],
+            });
+            return { valid: false, errors, warnings };
+        }
+        // 2. 解析 JSON
+        const { data, error: jsonError, position } = this.parseJson(content);
+        if (jsonError) {
+            let line;
+            let column;
+            if (position !== undefined) {
+                const loc = this.positionToLineColumn(content, position);
+                line = loc.line;
+                column = loc.column;
+            }
+            errors.push({
+                type: "syntax",
+                filePath,
+                message: "JSON 语法错误",
+                details: jsonError.message,
+                line,
+                column,
+                suggestions: generateJsonSyntaxSuggestions(jsonError.message),
+            });
+            return { valid: false, errors, warnings };
+        }
+        // 3. 检查是否为对象
+        if (typeof data !== "object" || data === null || Array.isArray(data)) {
+            errors.push({
+                type: "schema",
+                filePath,
+                message: "配置文件必须是一个 JSON 对象",
+                suggestions: ["配置应该用大括号 {} 包裹", "示例: { \"model\": \"...\", \"theme\": \"dark\" }"],
+            });
+            return { valid: false, errors, warnings };
+        }
+        // 4. 使用 Zod 验证 schema
+        try {
+            OptimaConfigSchema.parse(data);
+        }
+        catch (error) {
+            if (error instanceof ZodError) {
+                for (const issue of error.issues) {
+                    const zodSuggestions = generateSuggestionsFromZodError(error);
+                    const optimaSuggestions = generateOptimaConfigSuggestions(issue.path.map(String));
+                    errors.push({
+                        type: "schema",
+                        filePath,
+                        message: issue.message,
+                        path: issue.path.map(String),
+                        suggestions: [...zodSuggestions, ...optimaSuggestions],
+                    });
+                }
+            }
+            else {
+                errors.push({
+                    type: "schema",
+                    filePath,
+                    message: "未知的验证错误",
+                    details: String(error),
+                    suggestions: ["请检查配置文件格式"],
+                });
+            }
+            return { valid: false, errors, warnings };
+        }
+        // 5. 语义检查和警告
+        // 检查未知字段
+        const knownFields = ["model", "theme", "ui", "server"];
+        const unknownFields = Object.keys(data).filter((key) => !knownFields.includes(key));
+        if (unknownFields.length > 0) {
+            warnings.push({
+                type: "semantic",
+                filePath,
+                message: `发现未知字段: ${unknownFields.join(", ")}`,
+                suggestions: [
+                    "这些字段会被忽略",
+                    "检查是否拼写错误",
+                    `已知字段: ${knownFields.join(", ")}`,
+                ],
+            });
+        }
+        // 检查服务器配置
+        if (data.server?.port) {
+            const commonPorts = [3000, 8080, 8000, 5000];
+            if (!commonPorts.includes(data.server.port)) {
+                warnings.push({
+                    type: "semantic",
+                    filePath,
+                    message: `使用非常见端口: ${data.server.port}`,
+                    path: ["server", "port"],
+                    suggestions: ["确保该端口未被占用", `常用端口: ${commonPorts.join(", ")}`],
+                });
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * 解析配置（验证成功后调用）
+     */
+    parse(content) {
+        const { data, error } = this.parseJson(content);
+        if (error) {
+            return null;
+        }
+        try {
+            return OptimaConfigSchema.parse(data);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=json-validator.js.map

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

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

package/dist/src/validation/schema.d.ts

@@ -0,0 +1,353 @@
+/**
+ * 配置文件 Zod Schema 定义
+ */
+import { z } from "zod";
+export declare const SkillYamlFrontmatterSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    "user-invocable": z.ZodOptional<z.ZodBoolean>;
+    "allowed-tools": z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    hooks: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        SessionStart: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodOptional<z.ZodString>;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+            }, {
+                type: "command";
+                command: string;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }>, "many">>;
+        PreToolUse: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodOptional<z.ZodString>;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+            }, {
+                type: "command";
+                command: string;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }>, "many">>;
+        PostToolUse: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodOptional<z.ZodString>;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+            }, {
+                type: "command";
+                command: string;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }>, "many">>;
+        Stop: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            matcher: z.ZodOptional<z.ZodString>;
+            hooks: z.ZodArray<z.ZodObject<{
+                type: z.ZodLiteral<"command">;
+                command: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: "command";
+                command: string;
+            }, {
+                type: "command";
+                command: string;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }, {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        SessionStart?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+        PreToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+        PostToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+        Stop?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+    }, {
+        SessionStart?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+        PreToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+        PostToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+        Stop?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+    }>, {
+        SessionStart?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+        PreToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+        PostToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+        Stop?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+    }, {
+        SessionStart?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+        PreToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+        PostToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+        Stop?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    hooks?: {
+        SessionStart?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+        PreToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+        PostToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+        Stop?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+    } | undefined;
+    description?: string | undefined;
+    version?: string | undefined;
+    "user-invocable"?: boolean | undefined;
+    "allowed-tools"?: string[] | undefined;
+}, {
+    name: string;
+    hooks?: {
+        SessionStart?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+        PreToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+        PostToolUse?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+        Stop?: {
+            hooks: {
+                type: "command";
+                command: string;
+            }[];
+            matcher?: string | undefined;
+        }[] | undefined;
+    } | undefined;
+    description?: string | undefined;
+    version?: string | undefined;
+    "user-invocable"?: boolean | undefined;
+    "allowed-tools"?: string[] | undefined;
+}>;
+export type SkillYamlFrontmatter = z.infer<typeof SkillYamlFrontmatterSchema>;
+/**
+ * OPTIMA.json / settings.json Schema
+ */
+export declare const OptimaConfigSchema: z.ZodObject<{
+    model: z.ZodOptional<z.ZodString>;
+    theme: z.ZodOptional<z.ZodEnum<["dark", "light"]>>;
+    ui: z.ZodOptional<z.ZodObject<{
+        showTokens: z.ZodOptional<z.ZodBoolean>;
+        showSkills: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        showTokens?: boolean | undefined;
+        showSkills?: boolean | undefined;
+    }, {
+        showTokens?: boolean | undefined;
+        showSkills?: boolean | undefined;
+    }>>;
+    server: z.ZodOptional<z.ZodObject<{
+        port: z.ZodOptional<z.ZodNumber>;
+        token: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        port?: number | undefined;
+        token?: string | undefined;
+    }, {
+        port?: number | undefined;
+        token?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    model?: string | undefined;
+    theme?: "dark" | "light" | undefined;
+    ui?: {
+        showTokens?: boolean | undefined;
+        showSkills?: boolean | undefined;
+    } | undefined;
+    server?: {
+        port?: number | undefined;
+        token?: string | undefined;
+    } | undefined;
+}, {
+    model?: string | undefined;
+    theme?: "dark" | "light" | undefined;
+    ui?: {
+        showTokens?: boolean | undefined;
+        showSkills?: boolean | undefined;
+    } | undefined;
+    server?: {
+        port?: number | undefined;
+        token?: string | undefined;
+    } | undefined;
+}>;
+export type OptimaConfig = z.infer<typeof OptimaConfigSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/src/validation/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/validation/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA+BxB,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;GAEG;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/src/validation/schema.js

@@ -0,0 +1,57 @@
+/**
+ * 配置文件 Zod Schema 定义
+ */
+import { z } from "zod";
+/**
+ * SKILL.md YAML Frontmatter Schema
+ */
+// Hook 配置
+const HookConfigSchema = z.object({
+    type: z.literal("command"),
+    command: z.string().min(1, "command 不能为空"),
+});
+// Skill Hook 配置（单个事件的钩子配置）
+const SkillHookConfigSchema = z.object({
+    matcher: z.string().optional(),
+    hooks: z.array(HookConfigSchema).min(1, "hooks 数组至少需要一个元素"),
+});
+// Hooks 配置
+const HooksSchema = z
+    .object({
+    SessionStart: z.array(SkillHookConfigSchema).optional(),
+    PreToolUse: z.array(SkillHookConfigSchema).optional(),
+    PostToolUse: z.array(SkillHookConfigSchema).optional(),
+    Stop: z.array(SkillHookConfigSchema).optional(),
+})
+    .refine((hooks) => Object.keys(hooks).length > 0, {
+    message: "hooks 至少需要定义一个事件（SessionStart/PreToolUse/PostToolUse/Stop）",
+});
+// SKILL.md Frontmatter
+export const SkillYamlFrontmatterSchema = z.object({
+    name: z.string().min(1, "name 字段不能为空"),
+    description: z.string().optional(),
+    version: z.string().optional(),
+    "user-invocable": z.boolean().optional(),
+    "allowed-tools": z.array(z.string()).optional(),
+    hooks: HooksSchema.optional(),
+});
+/**
+ * OPTIMA.json / settings.json Schema
+ */
+export const OptimaConfigSchema = z.object({
+    model: z.string().optional(),
+    theme: z.enum(["dark", "light"]).optional(),
+    ui: z
+        .object({
+        showTokens: z.boolean().optional(),
+        showSkills: z.boolean().optional(),
+    })
+        .optional(),
+    server: z
+        .object({
+        port: z.number().int().min(1).max(65535).optional(),
+        token: z.string().optional(),
+    })
+        .optional(),
+});
+//# sourceMappingURL=schema.js.map

package/dist/src/validation/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/validation/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AAEH,UAAU;AACV,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC;CAC3C,CAAC,CAAC;AAEH,2BAA2B;AAC3B,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,CAAC;CAC5D,CAAC,CAAC;AAEH,WAAW;AACX,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE;IACvD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE;IACrD,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE;IACtD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE;CAChD,CAAC;KACD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE;IAChD,OAAO,EAAE,4DAA4D;CACtE,CAAC,CAAC;AAEL,uBAAuB;AACvB,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC;IACtC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACxC,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC/C,KAAK,EAAE,WAAW,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAIH;;GAEG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3C,EAAE,EAAE,CAAC;SACF,MAAM,CAAC;QACN,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAClC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KACnC,CAAC;SACD,QAAQ,EAAE;IACb,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;QACnD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC7B,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC"}

package/dist/src/validation/suggestions.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 修复建议生成器
+ */
+import type { ZodError } from "zod";
+/**
+ * 从 Zod 错误生成修复建议
+ */
+export declare function generateSuggestionsFromZodError(zodError: ZodError): string[];
+/**
+ * 为 YAML 语法错误生成建议
+ */
+export declare function generateYamlSyntaxSuggestions(errorMessage: string): string[];
+/**
+ * 为 JSON 语法错误生成建议
+ */
+export declare function generateJsonSyntaxSuggestions(errorMessage: string): string[];
+/**
+ * 为 Skill 配置生成特定建议
+ */
+export declare function generateSkillConfigSuggestions(path: string[]): string[];
+/**
+ * 为 Optima 配置生成特定建议
+ */
+export declare function generateOptimaConfigSuggestions(path: string[]): string[];
+//# sourceMappingURL=suggestions.d.ts.map

package/dist/src/validation/suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.d.ts","sourceRoot":"","sources":["../../../src/validation/suggestions.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAEpC;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,EAAE,CAiD5E;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CA8B5E;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAuB5E;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CA6BvE;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAmBxE"}