kevlar-4u 1.0.0

package/dist/tools/reviewTool.js

@@ -0,0 +1,133 @@
+import { loadAllPersonas } from "../utils/parser.js";
+import { executeReview, loadPersonasForReview, MAX_PERSONAS } from "../execution/index.js";
+import { getErrorInfo } from "../utils/observability.js";
+// ── Resource limits ────────────────────────────────────────────────────────────
+const MAX_CONTENT_LENGTH = 100_000; // 100KB
+const MAX_CONTEXT_LENGTH = 5_000; // 5KB
+export async function handleReviewContent(skillsDir, input) {
+    // ── Resource limits validation ───────────────────────────────────────────
+    if (!input.content || typeof input.content !== "string") {
+        return {
+            content: [{ type: "text", text: "❌ 请提供要评测的文案内容" }],
+            isError: true,
+        };
+    }
+    if (input.content.length > MAX_CONTENT_LENGTH) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ 文案内容超出长度限制（${MAX_CONTENT_LENGTH}字符）。当前长度：${input.content.length}字符`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    if (input.context && input.context.length > MAX_CONTEXT_LENGTH) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ 上下文说明超出长度限制（${MAX_CONTEXT_LENGTH}字符）`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    // ── Load requested personas (or all of them) using unified helper ───────────
+    let personas;
+    if (input.persona_ids && input.persona_ids.length > 0) {
+        if (input.persona_ids.length > MAX_PERSONAS) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ 选择的评论员数量超出限制（最多${MAX_PERSONAS}个）`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    const loadResult = await loadPersonasForReview(skillsDir, input.persona_ids);
+    personas = loadResult.personas;
+    if (loadResult.missingIds && loadResult.missingIds.length > 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ 找不到以下评论员：${loadResult.missingIds.join(", ")}。请先查看可用评论员列表。`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    if (personas.length === 0) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "⚠️ 当前没有可用评论员。请先创建自定义评论员。",
+                },
+            ],
+            isError: true,
+        };
+    }
+    // ── Track unselected personas for continuation flow ─────────────────────
+    const allPersonas = await loadAllPersonas(skillsDir);
+    const activeIds = new Set(personas.map((p) => p.meta.id));
+    const remainingPersonas = allPersonas.filter((p) => !activeIds.has(p.meta.id));
+    // ── Execute review ─────────────────────────────────────────────────────
+    const mode = input.mode || "auto";
+    try {
+        const ctx = {
+            skillsDir,
+            personas,
+            content: input.content,
+            context: input.context,
+            samplingFn: input.samplingFn,
+        };
+        const result = await executeReview(mode, ctx);
+        // Add continuation prompt if there are remaining personas
+        const continuationNote = remainingPersonas.length > 0
+            ? buildContinuationNote(remainingPersonas)
+            : "";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: result.report + continuationNote,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        const info = getErrorInfo(err);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ 评测执行失败：${info.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+function buildContinuationNote(remainingPersonas) {
+    const names = remainingPersonas.map((p) => p.meta.name).join("、");
+    return `
+
+---
+
+## 🔄 延续测试
+
+本轮有 **${remainingPersonas.length} 个人设未参与评测**：${names}。
+
+**完成汇总报告后：**
+1. 向用户展示报告
+2. 询问是否要用剩余评论员（${names}）继续评测
+3. 用户同意则启动新一轮评测（复用本次内容）
+4. 用户拒绝则结束`;
+}
+//# sourceMappingURL=reviewTool.js.map

package/dist/tools/reviewTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewTool.js","sourceRoot":"","sources":["../../src/tools/reviewTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAW,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE3F,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,kFAAkF;AAElF,MAAM,kBAAkB,GAAG,OAAO,CAAC,CAAC,QAAQ;AAC5C,MAAM,kBAAkB,GAAG,KAAK,CAAC,CAAC,MAAM;AAExC,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,SAAiB,EACjB,KAMC;IAED,4EAA4E;IAC5E,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACxD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;YAClD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,kBAAkB,EAAE,CAAC;QAC9C,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,gBAAgB,kBAAkB,YAAY,KAAK,CAAC,OAAO,CAAC,MAAM,IAAI;iBAC7E;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,kBAAkB,EAAE,CAAC;QAC/D,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,iBAAiB,kBAAkB,KAAK;iBAC/C;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,+EAA+E;IAC/E,IAAI,QAAmB,CAAC;IAExB,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtD,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC;YAC5C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,oBAAoB,YAAY,IAAI;qBAC3C;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,qBAAqB,CAAC,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAC7E,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;IAE/B,IAAI,UAAU,CAAC,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9D,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,cAAc,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe;iBACpE;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,0BAA0B;iBACjC;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,MAAM,iBAAiB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAE/E,0EAA0E;IAC1E,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC;IAElC,IAAI,CAAC;QACH,MAAM,GAAG,GAAqB;YAC5B,SAAS;YACT,QAAQ;YACR,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,UAAU;SAC7B,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAE9C,0DAA0D;QAC1D,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,MAAM,GAAG,CAAC;YACnD,CAAC,CAAC,qBAAqB,CAAC,iBAAiB,CAAC;YAC1C,CAAC,CAAC,EAAE,CAAC;QAEP,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM,CAAC,MAAM,GAAG,gBAAgB;iBACvC;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAC/B,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,YAAY,IAAI,CAAC,OAAO,EAAE;iBACjC;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,iBAA4B;IACzD,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClE,OAAO;;;;;;QAMD,iBAAiB,CAAC,MAAM,eAAe,KAAK;;;;iBAInC,KAAK;;WAEX,CAAC;AACZ,CAAC"}

package/dist/tools/types.d.ts

@@ -0,0 +1,14 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import type { MultiTurnSamplingFunction } from "../execution/base.js";
+export type ToolHandler = (args: Record<string, unknown> | undefined) => Promise<any>;
+export interface ToolDependencies {
+    skillsDir: string;
+    tmpDir: string;
+    createMultiTurnSamplingFn: () => MultiTurnSamplingFunction;
+    updateClientSamplingSupport: () => boolean;
+}
+export interface ToolModule {
+    definition: Tool;
+    handler: (deps: ToolDependencies) => ToolHandler;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEtE,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAEtF,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;IAC3D,2BAA2B,EAAE,MAAM,OAAO,CAAC;CAC5C;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,IAAI,CAAC;IACjB,OAAO,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,WAAW,CAAC;CAClD"}

package/dist/tools/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":""}

package/dist/utils/errors.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Structured error types for Kevlar MCP Server
+ */
+export declare enum ErrorCode {
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    INVALID_INPUT = "INVALID_INPUT",
+    CONTENT_TOO_LONG = "CONTENT_TOO_LONG",
+    TOO_MANY_PERSONAS = "TOO_MANY_PERSONAS",
+    PERSONA_NOT_FOUND = "PERSONA_NOT_FOUND",
+    DUPLICATE_ID = "DUPLICATE_ID",
+    INVALID_ID_FORMAT = "INVALID_ID_FORMAT",
+    PATH_TRAVERSAL = "PATH_TRAVERSAL",
+    FILE_NOT_FOUND = "FILE_NOT_FOUND",
+    FILE_READ_ERROR = "FILE_READ_ERROR",
+    FILE_WRITE_ERROR = "FILE_WRITE_ERROR",
+    DIRECTORY_NOT_FOUND = "DIRECTORY_NOT_FOUND",
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    INTERNAL_ERROR = "INTERNAL_ERROR",
+    UNKNOWN_TOOL = "UNKNOWN_TOOL"
+}
+export interface KevlarError extends Error {
+    code: ErrorCode;
+    recoverable: boolean;
+    details?: Record<string, unknown>;
+}
+export declare function isKevlarError(err: unknown): err is KevlarError;
+export declare function getErrorMessage(err: unknown): string;
+import { ToolResult } from "./types.js";
+export declare function formatErrorResponse(err: unknown): ToolResult;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,SAAS;IAEnB,gBAAgB,qBAAqB;IACrC,aAAa,kBAAkB;IAC/B,gBAAgB,qBAAqB;IACrC,iBAAiB,sBAAsB;IACvC,iBAAiB,sBAAsB;IACvC,YAAY,iBAAiB;IAC7B,iBAAiB,sBAAsB;IACvC,cAAc,mBAAmB;IAGjC,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,gBAAgB,qBAAqB;IACrC,mBAAmB,wBAAwB;IAC3C,iBAAiB,sBAAsB;IAGvC,cAAc,mBAAmB;IACjC,YAAY,iBAAiB;CAC9B;AAED,MAAM,WAAW,WAAY,SAAQ,KAAK;IACxC,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW,CAE9D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAKpD;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAa5D"}

package/dist/utils/errors.js

@@ -0,0 +1,47 @@
+/**
+ * Structured error types for Kevlar MCP Server
+ */
+export var ErrorCode;
+(function (ErrorCode) {
+    // Validation errors (4xx)
+    ErrorCode["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+    ErrorCode["INVALID_INPUT"] = "INVALID_INPUT";
+    ErrorCode["CONTENT_TOO_LONG"] = "CONTENT_TOO_LONG";
+    ErrorCode["TOO_MANY_PERSONAS"] = "TOO_MANY_PERSONAS";
+    ErrorCode["PERSONA_NOT_FOUND"] = "PERSONA_NOT_FOUND";
+    ErrorCode["DUPLICATE_ID"] = "DUPLICATE_ID";
+    ErrorCode["INVALID_ID_FORMAT"] = "INVALID_ID_FORMAT";
+    ErrorCode["PATH_TRAVERSAL"] = "PATH_TRAVERSAL";
+    // Resource errors (5xx)
+    ErrorCode["FILE_NOT_FOUND"] = "FILE_NOT_FOUND";
+    ErrorCode["FILE_READ_ERROR"] = "FILE_READ_ERROR";
+    ErrorCode["FILE_WRITE_ERROR"] = "FILE_WRITE_ERROR";
+    ErrorCode["DIRECTORY_NOT_FOUND"] = "DIRECTORY_NOT_FOUND";
+    ErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    // Runtime errors
+    ErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+    ErrorCode["UNKNOWN_TOOL"] = "UNKNOWN_TOOL";
+})(ErrorCode || (ErrorCode = {}));
+export function isKevlarError(err) {
+    return err instanceof Error && "code" in err && "recoverable" in err;
+}
+export function getErrorMessage(err) {
+    if (err instanceof Error) {
+        return err.message;
+    }
+    return String(err);
+}
+export function formatErrorResponse(err) {
+    if (isKevlarError(err)) {
+        return {
+            content: [{ type: "text", text: `❌ [${err.code}] ${err.message}` }],
+            isError: true,
+        };
+    }
+    const message = getErrorMessage(err);
+    return {
+        content: [{ type: "text", text: `❌ 操作失败：${message}` }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAN,IAAY,SAqBX;AArBD,WAAY,SAAS;IACnB,0BAA0B;IAC1B,kDAAqC,CAAA;IACrC,4CAA+B,CAAA;IAC/B,kDAAqC,CAAA;IACrC,oDAAuC,CAAA;IACvC,oDAAuC,CAAA;IACvC,0CAA6B,CAAA;IAC7B,oDAAuC,CAAA;IACvC,8CAAiC,CAAA;IAEjC,wBAAwB;IACxB,8CAAiC,CAAA;IACjC,gDAAmC,CAAA;IACnC,kDAAqC,CAAA;IACrC,wDAA2C,CAAA;IAC3C,oDAAuC,CAAA;IAEvC,iBAAiB;IACjB,8CAAiC,CAAA;IACjC,0CAA6B,CAAA;AAC/B,CAAC,EArBW,SAAS,KAAT,SAAS,QAqBpB;AAQD,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,GAAG,YAAY,KAAK,IAAI,MAAM,IAAI,GAAG,IAAI,aAAa,IAAI,GAAG,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAID,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YACnE,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACrC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;QACtD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Structured logging module for Kevlar
+ * Uses pino for production-grade performance
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface LogContext {
+    event: string;
+    [key: string]: unknown;
+}
+interface Logger {
+    debug(msg: string, ctx?: LogContext): void;
+    info(msg: string, ctx?: LogContext): void;
+    warn(msg: string, ctx?: LogContext): void;
+    error(msg: string, ctx?: LogContext): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,MAAM;IACd,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CAC5C;AAgDD,eAAO,MAAM,MAAM,QAAiB,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,52 @@
+/**
+ * Structured logging module for Kevlar
+ * Uses pino for production-grade performance
+ */
+function createLogger() {
+    const level = process.env.LOG_LEVEL || "info";
+    const levels = {
+        debug: 0,
+        info: 1,
+        warn: 2,
+        error: 3,
+    };
+    const currentLevel = levels[level] ?? 1;
+    function shouldLog(level) {
+        return levels[level] >= currentLevel;
+    }
+    function formatTimestamp() {
+        return new Date().toISOString();
+    }
+    function formatCtx(ctx) {
+        if (!ctx || Object.keys(ctx).length === 0)
+            return "";
+        const { event, ...rest } = ctx;
+        if (Object.keys(rest).length === 0)
+            return ` event=${event}`;
+        return ` event=${event} ${JSON.stringify(rest)}`;
+    }
+    return {
+        debug(msg, ctx) {
+            if (!shouldLog("debug"))
+                return;
+            console.error(`[${formatTimestamp()}] DEBUG: ${msg}${formatCtx(ctx)}`);
+        },
+        info(msg, ctx) {
+            if (!shouldLog("info"))
+                return;
+            console.error(`[${formatTimestamp()}] INFO: ${msg}${formatCtx(ctx)}`);
+        },
+        warn(msg, ctx) {
+            if (!shouldLog("warn"))
+                return;
+            console.error(`[${formatTimestamp()}] WARN: ${msg}${formatCtx(ctx)}`);
+        },
+        error(msg, ctx) {
+            if (!shouldLog("error"))
+                return;
+            console.error(`[${formatTimestamp()}] ERROR: ${msg}${formatCtx(ctx)}`);
+        },
+    };
+}
+export const logger = createLogger();
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,SAAS,YAAY;IACnB,MAAM,KAAK,GAAI,OAAO,CAAC,GAAG,CAAC,SAAsB,IAAI,MAAM,CAAC;IAC5D,MAAM,MAAM,GAA6B;QACvC,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;KACT,CAAC;IAEF,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAExC,SAAS,SAAS,CAAC,KAAe;QAChC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC;IACvC,CAAC;IAED,SAAS,eAAe;QACtB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClC,CAAC;IAED,SAAS,SAAS,CAAC,GAA2B;QAC5C,IAAI,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACrD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,CAAC;QAC/B,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,UAAU,KAAK,EAAE,CAAC;QAC7D,OAAO,UAAU,KAAK,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;IACnD,CAAC;IAED,OAAO;QACL,KAAK,CAAC,GAAW,EAAE,GAAgB;YACjC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;gBAAE,OAAO;YAChC,OAAO,CAAC,KAAK,CAAC,IAAI,eAAe,EAAE,YAAY,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,CAAC,GAAW,EAAE,GAAgB;YAChC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;gBAAE,OAAO;YAC/B,OAAO,CAAC,KAAK,CAAC,IAAI,eAAe,EAAE,WAAW,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,CAAC,GAAW,EAAE,GAAgB;YAChC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;gBAAE,OAAO;YAC/B,OAAO,CAAC,KAAK,CAAC,IAAI,eAAe,EAAE,WAAW,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;QACD,KAAK,CAAC,GAAW,EAAE,GAAgB;YACjC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;gBAAE,OAAO;YAChC,OAAO,CAAC,KAAK,CAAC,IAAI,eAAe,EAAE,YAAY,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC"}

package/dist/utils/observability.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Lightweight observability utilities for local-first tools.
+ *
+ * Designed for MCP servers and CLI tools that don't need OTel.
+ * Provides structured error info, duration tracking, and logger re-export.
+ *
+ * ── Usage ─────────────────────────────────────────────────────────────
+ *
+ *   import { logger, getErrorInfo, withDuration } from "./observability.js";
+ *
+ *   // 1. Structured logging
+ *   logger.info("Review started", { event: "review_start", mode: "direct_api", personas: 5 });
+ *   logger.warn("Rate limit approaching", { event: "rate_limit_warning" });
+ *   logger.error("Execution failed", { event: "execute_error", error: "TIMEOUT" });
+ *
+ *   // 2. Extract structured error info (replaces ad-hoc instanceof checks)
+ *   try { ... } catch (err) {
+ *     const info = getErrorInfo(err);
+ *     // info.code → "VALIDATION_ERROR" | "INTERNAL_ERROR" | ...
+ *     // info.message → human-readable message
+ *     // info.recoverable → true | false
+ *     logger.error("Operation failed", { event: "op_failed", error: info.code, message: info.message, recoverable: info.recoverable });
+ *     return { content: [{ type: "text", text: `❌ ${info.message}` }], isError: true };
+ *   }
+ *
+ *   // 3. Measure duration
+ *   const { result, durationMs } = await withDuration(() => someAsyncWork());
+ *   logger.info("Work done", { event: "work_complete", durationMs });
+ */
+export { logger } from "./logger.js";
+export type { LogContext } from "./logger.js";
+export interface ErrorInfo {
+    /** Error code for programmatic filtering (e.g. "VALIDATION_ERROR", "FILE_NOT_FOUND"). */
+    code: string;
+    /** Human-readable error message. */
+    message: string;
+    /** Whether the operation can be retried safely. */
+    recoverable: boolean;
+    /** Optional structured context attached by the error source. */
+    details?: Record<string, unknown>;
+}
+/**
+ * Extract structured error info from any thrown value.
+ *
+ * - If the error is a KevlarError (has .code + .recoverable), those fields are preserved.
+ * - Otherwise, defaults to code="INTERNAL_ERROR", recoverable=false.
+ *
+ * Use this in every catch block instead of manual instanceof checks.
+ */
+export declare function getErrorInfo(err: unknown): ErrorInfo;
+/**
+ * Execute an async function and return its result alongside wall-clock duration.
+ *
+ *   const { result, durationMs } = await withDuration(() => api.call(params));
+ *   logger.info("API call completed", { event: "api_done", durationMs });
+ */
+export declare function withDuration<T>(fn: () => Promise<T>): Promise<{
+    result: T;
+    durationMs: number;
+}>;
+//# sourceMappingURL=observability.d.ts.map

package/dist/utils/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../src/utils/observability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9C,MAAM,WAAW,SAAS;IACxB,yFAAyF;IACzF,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,WAAW,EAAE,OAAO,CAAC;IACrB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CAcpD;AAID;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAI5C"}

package/dist/utils/observability.js

@@ -0,0 +1,69 @@
+/**
+ * Lightweight observability utilities for local-first tools.
+ *
+ * Designed for MCP servers and CLI tools that don't need OTel.
+ * Provides structured error info, duration tracking, and logger re-export.
+ *
+ * ── Usage ─────────────────────────────────────────────────────────────
+ *
+ *   import { logger, getErrorInfo, withDuration } from "./observability.js";
+ *
+ *   // 1. Structured logging
+ *   logger.info("Review started", { event: "review_start", mode: "direct_api", personas: 5 });
+ *   logger.warn("Rate limit approaching", { event: "rate_limit_warning" });
+ *   logger.error("Execution failed", { event: "execute_error", error: "TIMEOUT" });
+ *
+ *   // 2. Extract structured error info (replaces ad-hoc instanceof checks)
+ *   try { ... } catch (err) {
+ *     const info = getErrorInfo(err);
+ *     // info.code → "VALIDATION_ERROR" | "INTERNAL_ERROR" | ...
+ *     // info.message → human-readable message
+ *     // info.recoverable → true | false
+ *     logger.error("Operation failed", { event: "op_failed", error: info.code, message: info.message, recoverable: info.recoverable });
+ *     return { content: [{ type: "text", text: `❌ ${info.message}` }], isError: true };
+ *   }
+ *
+ *   // 3. Measure duration
+ *   const { result, durationMs } = await withDuration(() => someAsyncWork());
+ *   logger.info("Work done", { event: "work_complete", durationMs });
+ */
+export { logger } from "./logger.js";
+/**
+ * Extract structured error info from any thrown value.
+ *
+ * - If the error is a KevlarError (has .code + .recoverable), those fields are preserved.
+ * - Otherwise, defaults to code="INTERNAL_ERROR", recoverable=false.
+ *
+ * Use this in every catch block instead of manual instanceof checks.
+ */
+export function getErrorInfo(err) {
+    if (isKevlarError(err)) {
+        return {
+            code: err.code,
+            message: err.message,
+            recoverable: err.recoverable,
+            details: err.details,
+        };
+    }
+    return {
+        code: "INTERNAL_ERROR",
+        message: err instanceof Error ? err.message : String(err),
+        recoverable: false,
+    };
+}
+// ── Duration Wrapper ──────────────────────────────────────────────────────────
+/**
+ * Execute an async function and return its result alongside wall-clock duration.
+ *
+ *   const { result, durationMs } = await withDuration(() => api.call(params));
+ *   logger.info("API call completed", { event: "api_done", durationMs });
+ */
+export async function withDuration(fn) {
+    const start = Date.now();
+    const result = await fn();
+    return { result, durationMs: Date.now() - start };
+}
+function isKevlarError(err) {
+    return err instanceof Error && "code" in err && "recoverable" in err;
+}
+//# sourceMappingURL=observability.js.map

package/dist/utils/observability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.js","sourceRoot":"","sources":["../../src/utils/observability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAgBrC;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,IAAI,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QACzD,WAAW,EAAE,KAAK;KACnB,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,EAAoB;IAEpB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;AACpD,CAAC;AAUD,SAAS,aAAa,CAAC,GAAY;IACjC,OAAO,GAAG,YAAY,KAAK,IAAI,MAAM,IAAI,GAAG,IAAI,aAAa,IAAI,GAAG,CAAC;AACvE,CAAC"}

package/dist/utils/parser.d.ts

@@ -0,0 +1,27 @@
+export interface PersonaMeta {
+    id: string;
+    name: string;
+    name_en: string;
+    version: string;
+    author: string;
+    tags: string[];
+    description: string;
+    culturalContext?: string;
+    authorRelation?: string;
+    stance?: string;
+    blindSpot?: string;
+    gender?: string;
+}
+export interface Persona {
+    meta: PersonaMeta;
+    systemPrompt: string;
+    filePath: string;
+}
+export declare function invalidatePersonasCache(): void;
+export declare function validateWritePath(filePath: string, baseDir: string): boolean;
+export declare function parsePersonaFile(filePath: string): Promise<Persona | null>;
+export declare function loadAllPersonas(skillsDir: string): Promise<Persona[]>;
+export declare function loadPersonaById(skillsDir: string, id: string): Promise<Persona | null>;
+export declare function loadPersonasByIds(skillsDir: string, ids: string[]): Promise<Persona[]>;
+export declare function writePersonaFile(skillsDir: string, meta: PersonaMeta, personaDescription: string, subDir?: string): Promise<string>;
+//# sourceMappingURL=parser.d.ts.map

package/dist/utils/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/utils/parser.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAID,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAO5E;AAID,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAqDhF;AAeD,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CA0D3E;AAED,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CASzB;AAED,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EAAE,GACZ,OAAO,CAAC,OAAO,EAAE,CAAC,CAGpB;AAID,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,WAAW,EACjB,kBAAkB,EAAE,MAAM,EAC1B,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAmCjB"}