golutra-mcp 0.1.0

package/dist/lib/context.js

@@ -0,0 +1,109 @@
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+import { GOLUTRA_PROFILES } from "./types.js";
+const DEFAULT_TIMEOUT_MS = 30_000;
+const MAX_TIMEOUT_MS = 300_000;
+const DEFAULT_CLI_COMMAND = "golutra-cli";
+function normalizeNonEmptyString(value) {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed : undefined;
+}
+function normalizeTimeout(value) {
+    if (typeof value === "number" && Number.isInteger(value) && value > 0) {
+        return Math.min(value, MAX_TIMEOUT_MS);
+    }
+    if (typeof value === "string") {
+        const parsed = Number.parseInt(value, 10);
+        if (Number.isInteger(parsed) && parsed > 0) {
+            return Math.min(parsed, MAX_TIMEOUT_MS);
+        }
+    }
+    return DEFAULT_TIMEOUT_MS;
+}
+function normalizeProfile(value) {
+    const trimmed = normalizeNonEmptyString(value);
+    if (!trimmed) {
+        return undefined;
+    }
+    if (GOLUTRA_PROFILES.includes(trimmed)) {
+        return trimmed;
+    }
+    throw new Error(`Unsupported Golutra profile: ${trimmed}`);
+}
+function getDefaultCliCandidates(platform, homeDirectory) {
+    if (platform === "darwin") {
+        return [
+            "/Applications/Golutra.app/Contents/MacOS/golutra-cli",
+            path.join(homeDirectory, "Applications", "Golutra.app", "Contents", "MacOS", "golutra-cli"),
+            DEFAULT_CLI_COMMAND
+        ];
+    }
+    return [DEFAULT_CLI_COMMAND];
+}
+export function resolveDefaultCliPath(env, options = {}) {
+    const explicitCliPath = normalizeNonEmptyString(env.GOLUTRA_CLI_PATH);
+    if (explicitCliPath) {
+        return explicitCliPath;
+    }
+    const platform = options.platform ?? process.platform;
+    const homeDirectory = options.homeDirectory ?? homedir();
+    const pathExists = options.pathExists ?? existsSync;
+    const candidates = getDefaultCliCandidates(platform, homeDirectory);
+    return (candidates.find((candidatePath) => path.isAbsolute(candidatePath) && pathExists(candidatePath)) ?? DEFAULT_CLI_COMMAND);
+}
+export function createInitialContext(env) {
+    return {
+        cliPath: resolveDefaultCliPath(env),
+        profile: normalizeProfile(env.GOLUTRA_PROFILE),
+        workspacePath: normalizeNonEmptyString(env.GOLUTRA_WORKSPACE_PATH),
+        timeoutMs: normalizeTimeout(env.GOLUTRA_COMMAND_TIMEOUT_MS)
+    };
+}
+export class ContextStore {
+    initialContext;
+    context;
+    constructor(initialContext) {
+        this.initialContext = { ...initialContext };
+        this.context = { ...initialContext };
+    }
+    getSnapshot() {
+        return { ...this.context };
+    }
+    reset() {
+        this.context = { ...this.initialContext };
+        return this.getSnapshot();
+    }
+    update(nextValues) {
+        const nextContext = {
+            cliPath: normalizeNonEmptyString(nextValues.cliPath) ?? this.context.cliPath,
+            profile: nextValues.profile ?? this.context.profile,
+            workspacePath: normalizeNonEmptyString(nextValues.workspacePath) ??
+                this.context.workspacePath,
+            timeoutMs: typeof nextValues.timeoutMs === "number"
+                ? normalizeTimeout(nextValues.timeoutMs)
+                : this.context.timeoutMs
+        };
+        this.context = nextContext;
+        return this.getSnapshot();
+    }
+    resolveCommandContext(nextValues = {}) {
+        return {
+            cliPath: normalizeNonEmptyString(nextValues.cliPath) ?? this.context.cliPath,
+            profile: nextValues.profile ?? this.context.profile,
+            workspacePath: normalizeNonEmptyString(nextValues.workspacePath) ??
+                this.context.workspacePath,
+            timeoutMs: typeof nextValues.timeoutMs === "number"
+                ? normalizeTimeout(nextValues.timeoutMs)
+                : this.context.timeoutMs
+        };
+    }
+    requireWorkspacePath(nextValues = {}) {
+        const workspacePath = this.resolveCommandContext(nextValues).workspacePath;
+        if (!workspacePath) {
+            throw new Error("workspacePath is required. Pass it to the tool call or set a default with golutra-set-context.");
+        }
+        return workspacePath;
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/lib/context.js.map

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

package/dist/lib/errors.d.ts

@@ -0,0 +1,15 @@
+export declare class CliExecutionError extends Error {
+    readonly cliPath: string;
+    readonly args: string[];
+    readonly exitCode: number | null;
+    readonly stdout: string;
+    readonly stderr: string;
+    constructor(options: {
+        message: string;
+        cliPath: string;
+        args: string[];
+        exitCode: number | null;
+        stdout?: string;
+        stderr?: string;
+    });
+}

package/dist/lib/errors.js

@@ -0,0 +1,17 @@
+export class CliExecutionError extends Error {
+    cliPath;
+    args;
+    exitCode;
+    stdout;
+    stderr;
+    constructor(options) {
+        super(options.message);
+        this.name = "CliExecutionError";
+        this.cliPath = options.cliPath;
+        this.args = options.args;
+        this.exitCode = options.exitCode;
+        this.stdout = options.stdout ?? "";
+        this.stderr = options.stderr ?? "";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,OAAO,CAAS;IAChB,IAAI,CAAW;IACf,QAAQ,CAAgB;IACxB,MAAM,CAAS;IACf,MAAM,CAAS;IAExB,YAAY,OAOX;QACC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IACrC,CAAC;CACF"}

package/dist/lib/golutra-client.d.ts

@@ -0,0 +1,54 @@
+import type { CliJsonRunner } from "./cli-runner.js";
+import type { ChatConversationsListData, ChatMessagesListData, ChatSendData, CommandContextInput, ListSkillsResponse, RoadmapResultData, RuntimeContextSnapshot, SkillValidationResult, StructuredCommand } from "./types.js";
+declare function buildProfileArgs(profile: RuntimeContextSnapshot["profile"]): string[];
+declare function buildStructuredRunArgs(profile: RuntimeContextSnapshot["profile"], command: StructuredCommand): string[];
+declare function buildSkillsArgs(profile: RuntimeContextSnapshot["profile"], options: {
+    skillName?: string | undefined;
+    workspacePath?: string | undefined;
+}): string[];
+declare function buildSkillValidateArgs(profile: RuntimeContextSnapshot["profile"], skillPath: string): string[];
+export declare class GolutraCliGateway {
+    private readonly runner;
+    constructor(runner: CliJsonRunner);
+    private executeStructured;
+    listConversations(runtimeContext: RuntimeContextSnapshot, input: {
+        workspacePath: string;
+        userId: string;
+    }): Promise<ChatConversationsListData>;
+    listMessages(runtimeContext: RuntimeContextSnapshot, input: {
+        workspacePath: string;
+        conversationId: string;
+        limit?: number | undefined;
+        beforeId?: string | undefined;
+    }): Promise<ChatMessagesListData>;
+    sendMessage(runtimeContext: RuntimeContextSnapshot, input: {
+        workspacePath: string;
+        conversationId: string;
+        senderId: string;
+        text: string;
+        mentionIds: string[];
+    }): Promise<ChatSendData>;
+    readRoadmap(runtimeContext: RuntimeContextSnapshot, input: {
+        workspacePath: string;
+        conversationId?: string | undefined;
+    }): Promise<RoadmapResultData>;
+    updateRoadmap(runtimeContext: RuntimeContextSnapshot, input: {
+        workspacePath: string;
+        conversationId?: string | undefined;
+        readOnly?: boolean | undefined;
+        roadmap: {
+            objective: string;
+            tasks: Array<{
+                id: number;
+                number?: string | undefined;
+                title: string;
+                status: "pending" | "in-progress" | "done";
+                pinned?: boolean | undefined;
+            }>;
+        };
+    }): Promise<RoadmapResultData>;
+    listSkills(runtimeContext: RuntimeContextSnapshot, input: Pick<CommandContextInput, "workspacePath">): Promise<ListSkillsResponse>;
+    getSkill(runtimeContext: RuntimeContextSnapshot, skillName: string): Promise<Record<string, unknown>>;
+    validateSkill(runtimeContext: RuntimeContextSnapshot, skillPath: string): Promise<SkillValidationResult>;
+}
+export { buildProfileArgs, buildSkillValidateArgs, buildSkillsArgs, buildStructuredRunArgs };

package/dist/lib/golutra-client.js

@@ -0,0 +1,131 @@
+import { CliExecutionError } from "./errors.js";
+function buildProfileArgs(profile) {
+    return profile ? ["--profile", profile] : [];
+}
+function buildStructuredRunArgs(profile, command) {
+    return [
+        ...buildProfileArgs(profile),
+        "run",
+        "--command",
+        JSON.stringify(command)
+    ];
+}
+function buildSkillsArgs(profile, options) {
+    const args = [...buildProfileArgs(profile), "skills"];
+    if (options.workspacePath) {
+        args.push("--workspace", options.workspacePath);
+    }
+    if (options.skillName) {
+        args.push(options.skillName);
+    }
+    return args;
+}
+function buildSkillValidateArgs(profile, skillPath) {
+    return [...buildProfileArgs(profile), "skill-validate", skillPath];
+}
+export class GolutraCliGateway {
+    runner;
+    constructor(runner) {
+        this.runner = runner;
+    }
+    async executeStructured(command, runtimeContext) {
+        const response = await this.runner.executeJson({
+            cliPath: runtimeContext.cliPath,
+            args: buildStructuredRunArgs(runtimeContext.profile, command),
+            timeoutMs: runtimeContext.timeoutMs
+        });
+        if (!response.ok || response.result?.status !== "ok") {
+            throw new CliExecutionError({
+                message: response.error ??
+                    response.result?.message ??
+                    "golutra-cli returned an unsuccessful command result",
+                cliPath: runtimeContext.cliPath,
+                args: buildStructuredRunArgs(runtimeContext.profile, command),
+                exitCode: 1
+            });
+        }
+        return (response.result?.data ?? {});
+    }
+    async listConversations(runtimeContext, input) {
+        return this.executeStructured({
+            type: "chat.conversations.list",
+            payload: {
+                workspacePath: input.workspacePath,
+                userId: input.userId
+            }
+        }, runtimeContext);
+    }
+    async listMessages(runtimeContext, input) {
+        const payload = {
+            type: "chat.messages.list",
+            payload: {
+                workspacePath: input.workspacePath,
+                conversationId: input.conversationId,
+                ...(typeof input.limit === "number" ? { limit: input.limit } : {}),
+                ...(input.beforeId ? { beforeId: input.beforeId } : {})
+            }
+        };
+        return this.executeStructured(payload, runtimeContext);
+    }
+    async sendMessage(runtimeContext, input) {
+        return this.executeStructured({
+            type: "chat.send",
+            payload: {
+                workspacePath: input.workspacePath,
+                conversationId: input.conversationId,
+                senderId: input.senderId,
+                text: input.text,
+                mentionIds: input.mentionIds
+            }
+        }, runtimeContext);
+    }
+    async readRoadmap(runtimeContext, input) {
+        const payload = {
+            type: "roadmap.read",
+            payload: {
+                workspacePath: input.workspacePath,
+                ...(input.conversationId ? { conversationId: input.conversationId } : {})
+            }
+        };
+        return this.executeStructured(payload, runtimeContext);
+    }
+    async updateRoadmap(runtimeContext, input) {
+        const payload = {
+            type: "roadmap.update",
+            payload: {
+                workspacePath: input.workspacePath,
+                ...(input.conversationId ? { conversationId: input.conversationId } : {}),
+                ...(typeof input.readOnly === "boolean" ? { readOnly: input.readOnly } : {}),
+                roadmap: input.roadmap
+            }
+        };
+        return this.executeStructured(payload, runtimeContext);
+    }
+    async listSkills(runtimeContext, input) {
+        return this.runner.executeJson({
+            cliPath: runtimeContext.cliPath,
+            args: buildSkillsArgs(runtimeContext.profile, {
+                ...(input.workspacePath ? { workspacePath: input.workspacePath } : {})
+            }),
+            timeoutMs: runtimeContext.timeoutMs
+        });
+    }
+    async getSkill(runtimeContext, skillName) {
+        return this.runner.executeJson({
+            cliPath: runtimeContext.cliPath,
+            args: buildSkillsArgs(runtimeContext.profile, {
+                skillName
+            }),
+            timeoutMs: runtimeContext.timeoutMs
+        });
+    }
+    async validateSkill(runtimeContext, skillPath) {
+        return this.runner.executeJson({
+            cliPath: runtimeContext.cliPath,
+            args: buildSkillValidateArgs(runtimeContext.profile, skillPath),
+            timeoutMs: runtimeContext.timeoutMs
+        });
+    }
+}
+export { buildProfileArgs, buildSkillValidateArgs, buildSkillsArgs, buildStructuredRunArgs };
+//# sourceMappingURL=golutra-client.js.map

package/dist/lib/golutra-client.js.map

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

package/dist/lib/project-skills.d.ts

@@ -0,0 +1,6 @@
+import type { ListSkillsResponse, ProjectSkillDescriptor } from "./types.js";
+export interface ProjectSkillDocument extends ProjectSkillDescriptor {
+    content: string;
+}
+export declare function findProjectSkillByName(skillsResponse: ListSkillsResponse, skillName: string): ProjectSkillDescriptor;
+export declare function readProjectSkillDocument(projectSkill: ProjectSkillDescriptor): Promise<ProjectSkillDocument>;

package/dist/lib/project-skills.js

@@ -0,0 +1,22 @@
+import { readFile } from "node:fs/promises";
+export function findProjectSkillByName(skillsResponse, skillName) {
+    const projectSkills = skillsResponse.projectSkills ?? [];
+    if (projectSkills.length === 0) {
+        throw new Error("No project skills were found for this workspace. Run golutra-list-project-skills first to verify discovery.");
+    }
+    const matchedSkill = projectSkills.find((projectSkill) => projectSkill.name === skillName);
+    if (!matchedSkill) {
+        throw new Error(`Project skill "${skillName}" was not found. Available project skills: ${projectSkills
+            .map((projectSkill) => projectSkill.name)
+            .join(", ")}`);
+    }
+    return matchedSkill;
+}
+export async function readProjectSkillDocument(projectSkill) {
+    const content = await readFile(projectSkill.skillMdPath, "utf8");
+    return {
+        ...projectSkill,
+        content
+    };
+}
+//# sourceMappingURL=project-skills.js.map

package/dist/lib/project-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-skills.js","sourceRoot":"","sources":["../../src/lib/project-skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAW5C,MAAM,UAAU,sBAAsB,CACpC,cAAkC,EAClC,SAAiB;IAEjB,MAAM,aAAa,GAAG,cAAc,CAAC,aAAa,IAAI,EAAE,CAAC;IACzD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,6GAA6G,CAC9G,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAC3F,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,kBAAkB,SAAS,8CAA8C,aAAa;aACnF,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC;aACxC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAC;IACJ,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,YAAoC;IAEpC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACjE,OAAO;QACL,GAAG,YAAY;QACf,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/lib/tool-results.d.ts

@@ -0,0 +1,15 @@
+export declare function buildToolSuccess<T extends object>(summary: string, structuredContent: T): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    structuredContent: Record<string, unknown>;
+};
+export declare function buildToolError(error: unknown): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    structuredContent: Record<string, unknown>;
+    isError: true;
+};

package/dist/lib/tool-results.js

@@ -0,0 +1,58 @@
+import { CliExecutionError } from "./errors.js";
+function toPrettyJson(value) {
+    return JSON.stringify(value, null, 2);
+}
+export function buildToolSuccess(summary, structuredContent) {
+    const normalizedStructuredContent = {
+        ...structuredContent
+    };
+    return {
+        content: [
+            {
+                type: "text",
+                text: `${summary}\n\n${toPrettyJson(normalizedStructuredContent)}`
+            }
+        ],
+        structuredContent: normalizedStructuredContent
+    };
+}
+export function buildToolError(error) {
+    const structuredContent = buildErrorContent(error);
+    const message = typeof structuredContent.message === "string"
+        ? structuredContent.message
+        : String(error);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Error: ${message}\n\n${toPrettyJson(structuredContent)}`
+            }
+        ],
+        structuredContent,
+        isError: true
+    };
+}
+function buildErrorContent(error) {
+    if (error instanceof CliExecutionError) {
+        return {
+            type: error.name,
+            message: error.message,
+            cliPath: error.cliPath,
+            args: error.args,
+            exitCode: error.exitCode,
+            stdout: error.stdout,
+            stderr: error.stderr
+        };
+    }
+    if (error instanceof Error) {
+        return {
+            type: error.name,
+            message: error.message
+        };
+    }
+    return {
+        type: "UnknownError",
+        message: String(error)
+    };
+}
+//# sourceMappingURL=tool-results.js.map

package/dist/lib/tool-results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-results.js","sourceRoot":"","sources":["../../src/lib/tool-results.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,iBAAoB;IAKpB,MAAM,2BAA2B,GAAG;QAClC,GAAG,iBAAiB;KACM,CAAC;IAE7B,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,GAAG,OAAO,OAAO,YAAY,CAAC,2BAA2B,CAAC,EAAE;aACnE;SACF;QACD,iBAAiB,EAAE,2BAA2B;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAK3C,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,OAAO,GACX,OAAO,iBAAiB,CAAC,OAAO,KAAK,QAAQ;QAC3C,CAAC,CAAC,iBAAiB,CAAC,OAAO;QAC3B,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEpB,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,UAAU,OAAO,OAAO,YAAY,CAAC,iBAAiB,CAAC,EAAE;aAChE;SACF;QACD,iBAAiB;QACjB,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;QACvC,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC;KACvB,CAAC;AACJ,CAAC"}

package/dist/lib/toolkit.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ContextStore } from "./context.js";
+import type { GolutraCliGateway } from "./golutra-client.js";
+export declare function registerTools(server: McpServer, contextStore: ContextStore, gateway: GolutraCliGateway): void;