@tlog/mcp 0.1.3

package/dist/utils.d.ts

@@ -0,0 +1,14 @@
+import type { LogLevel, PromptExtraction, ToolResult } from "./types.js";
+export declare function logEvent(level: LogLevel, event: string, detail: Record<string, unknown>): void;
+export declare function toToolResult(payload: Record<string, unknown>): ToolResult;
+export declare function toToolError(message: string, code: string, details?: Record<string, unknown>): ToolResult;
+export declare function asObject(input: unknown): Record<string, unknown>;
+export declare function extractPromptMetadata(instruction: string, prefix: "suite" | "case"): PromptExtraction;
+export declare function resolvePathInsideWorkspace(workspaceRoot: string, targetPath: string): string;
+export declare function toRelativePath(workspaceRoot: string, absolutePath: string): string;
+export declare function assertNoOverwrite(path: string): void;
+export declare function listYamlFiles(rootDir: string): Promise<string[]>;
+export declare function summarizeDiff(before: unknown, after: unknown): string[];
+export declare function selectAppliedMode(mode: "replace" | "append" | "auto", instruction: string): "replace" | "append";
+export declare function findAvailablePath(basePath: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAE9F;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAKzE;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,UAAU,CAwB5G;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMhE;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,gBAAgB,CAyBrG;AAED,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAU5F;AAED,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAElF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIpD;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAyBtE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAevE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAWhH;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAY1D"}

package/dist/utils.js

@@ -0,0 +1,146 @@
+import { existsSync } from "node:fs";
+import { readdir } from "node:fs/promises";
+import { basename, dirname, join, relative, resolve, sep } from "node:path";
+import { stderr } from "node:process";
+import { ensureUniqueSlug, slugifyTitle } from "@tlog/shared";
+import { DEFAULT_DATE } from "./constants.js";
+export function logEvent(level, event, detail) {
+    stderr.write(`${JSON.stringify({ level, event, at: new Date().toISOString(), ...detail })}\n`);
+}
+export function toToolResult(payload) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        structuredContent: payload
+    };
+}
+export function toToolError(message, code, details = {}) {
+    const causeText = typeof details.cause === "string" ? details.cause : "";
+    let resolvedCode = code;
+    if (causeText.includes("validation:")) {
+        resolvedCode = "validation";
+    }
+    else if (causeText.includes("security:")) {
+        resolvedCode = "security";
+    }
+    else if (causeText.includes("conflict:")) {
+        resolvedCode = "conflict";
+    }
+    else if (code === "missing_required_context") {
+        resolvedCode = "missing_required_context";
+    }
+    return {
+        content: [{ type: "text", text: message }],
+        structuredContent: {
+            error: {
+                code: resolvedCode,
+                message,
+                details
+            }
+        },
+        isError: true
+    };
+}
+export function asObject(input) {
+    if (!input || typeof input !== "object" || Array.isArray(input)) {
+        return {};
+    }
+    return input;
+}
+export function extractPromptMetadata(instruction, prefix) {
+    const warnings = [];
+    const idMatch = instruction.match(/\bid\s*[:=]\s*([a-zA-Z0-9._-]+)/i);
+    const titleMatch = instruction.match(/\btitle\s*[:=]\s*([^\n;]+)/i);
+    let id = idMatch?.[1]?.trim() ?? "";
+    let title = titleMatch?.[1]?.trim() ?? "";
+    if (!id) {
+        id = `${prefix}-${slugifyTitle(title)}`;
+        warnings.push("id was inferred from title");
+    }
+    if (!title) {
+        if (id) {
+            title = id;
+            warnings.push("title was inferred from id");
+        }
+        else {
+            const firstSentence = instruction.split(/[\n。.!?]/)[0]?.trim() ?? "";
+            title = firstSentence.length > 0 ? firstSentence.slice(0, 64) : `${prefix} generated ${DEFAULT_DATE}`;
+            warnings.push("title was inferred from instruction");
+        }
+    }
+    return { id, title, warnings };
+}
+export function resolvePathInsideWorkspace(workspaceRoot, targetPath) {
+    const root = resolve(workspaceRoot);
+    const resolvedPath = resolve(root, targetPath);
+    const rel = relative(root, resolvedPath);
+    if (rel.startsWith("..") || rel.includes(`..${sep}`)) {
+        throw new Error(`security: path outside workspace is not allowed (${targetPath})`);
+    }
+    return resolvedPath;
+}
+export function toRelativePath(workspaceRoot, absolutePath) {
+    return relative(resolve(workspaceRoot), absolutePath).split(sep).join("/");
+}
+export function assertNoOverwrite(path) {
+    if (existsSync(path)) {
+        throw new Error(`conflict: target file already exists (${path})`);
+    }
+}
+export async function listYamlFiles(rootDir) {
+    const queue = [rootDir];
+    const files = [];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (!current) {
+            continue;
+        }
+        const entries = await readdir(current, { withFileTypes: true });
+        for (const entry of entries) {
+            const path = join(current, entry.name);
+            if (entry.isDirectory()) {
+                queue.push(path);
+                continue;
+            }
+            if (entry.isFile() && entry.name.endsWith(".yaml")) {
+                files.push(path);
+            }
+        }
+    }
+    return files;
+}
+export function summarizeDiff(before, after) {
+    const beforeObj = asObject(before);
+    const afterObj = asObject(after);
+    const keys = new Set([...Object.keys(beforeObj), ...Object.keys(afterObj)]);
+    const changes = [];
+    for (const key of keys) {
+        const beforeVal = JSON.stringify(beforeObj[key]);
+        const afterVal = JSON.stringify(afterObj[key]);
+        if (beforeVal !== afterVal) {
+            changes.push(`${key} changed`);
+        }
+    }
+    return changes.length > 0 ? changes : ["no structural changes"];
+}
+export function selectAppliedMode(mode, instruction) {
+    if (mode === "replace" || mode === "append") {
+        return mode;
+    }
+    const lowered = instruction.toLowerCase();
+    if (lowered.includes("replace") || lowered.includes("置換") || lowered.includes("入れ替")) {
+        return "replace";
+    }
+    return "append";
+}
+export function findAvailablePath(basePath) {
+    if (!existsSync(basePath)) {
+        return basePath;
+    }
+    const used = new Set();
+    const ext = basePath.endsWith(".yaml") ? ".yaml" : "";
+    const stem = ext ? basePath.slice(0, -ext.length) : basePath;
+    used.add(basename(stem));
+    const nextSlug = ensureUniqueSlug(basename(stem), used);
+    return join(dirname(basePath), `${nextSlug}${ext}`);
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@tlog/mcp",
+  "version": "0.1.3",
+  "description": "tlog MCP server",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tlog-dev/tlog.git",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://github.com/tlog-dev/tlog/tree/main/packages/mcp",
+  "bugs": {
+    "url": "https://github.com/tlog-dev/tlog/issues"
+  },
+  "keywords": [
+    "tlog",
+    "mcp",
+    "model-context-protocol",
+    "test-management",
+    "yaml"
+  ],
+  "type": "module",
+  "bin": {
+    "tlog-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage --coverage.reporter=lcov --coverage.reporter=text"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "@tlog/shared": "0.1.0"
+  }
+}