waymark-engine 1.0.0

package/dist/src/mcp/capnIndex.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { CAPN_RESOURCES, McpServer } from "./server.js";
+import { CAPN_TOOLS } from "./capnTools.js";
+const server = new McpServer({
+    name: "capn-mcp",
+    version: "1.3.0",
+    tools: CAPN_TOOLS,
+    resources: CAPN_RESOURCES,
+    prompts: [],
+});
+server.runStdio().catch((error) => {
+    process.stderr.write(`Capn MCP server error: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=capnIndex.js.map

package/dist/src/mcp/capnIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capnIndex.js","sourceRoot":"","sources":["../../../src/mcp/capnIndex.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,UAAU;IACjB,SAAS,EAAE,cAAc;IACzB,OAAO,EAAE,EAAE;CACZ,CAAC,CAAC;AAEH,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/src/mcp/capnTools.d.ts

@@ -0,0 +1,5 @@
+import { McpToolHandler } from "./types.js";
+export declare const capnAskTool: McpToolHandler;
+export declare const capnChartTool: McpToolHandler;
+export declare const discoverSymbolsTool: McpToolHandler;
+export declare const CAPN_TOOLS: McpToolHandler[];

package/dist/src/mcp/capnTools.js

@@ -0,0 +1,190 @@
+import { repoRoot } from "../paths.js";
+import { ask, publish } from "../capnAdapter.js";
+import { discoverSymbolsInFile } from "../astExtractor.js";
+import { WaymarkError } from "../types.js";
+function jsonResult(value, isError = false) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(value, null, 2) }],
+        isError,
+    };
+}
+function errorResult(error) {
+    if (error instanceof WaymarkError) {
+        return jsonResult({ waymark: 1, kind: "error", ok: false, code: error.code, message: error.message }, true);
+    }
+    const message = error instanceof Error ? error.message : "Unexpected error";
+    return jsonResult({ waymark: 1, kind: "error", ok: false, code: "UNEXPECTED_ERROR", message }, true);
+}
+function resolveRoot(args) {
+    const custom = typeof args.root === "string" && args.root.trim() ? args.root.trim() : process.cwd();
+    return repoRoot(custom);
+}
+function resolveProfile(args) {
+    const value = typeof args.profile === "string" && args.profile ? args.profile : process.env.WAYMARK_CAPN_PROFILE;
+    return value === "none" ? "none" : "capn-cli";
+}
+function resolveExecutable(args) {
+    return (typeof args.capn_executable === "string" && args.capn_executable.trim()) || process.env.WAYMARK_CAPN_EXECUTABLE || "capn";
+}
+export const capnAskTool = {
+    definition: {
+        name: "capn_ask",
+        description: "Query Capn's charted repository memory to check if an answer to the question already exists.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                question: {
+                    type: "string",
+                    description: "The question to look up in Capn's charted memory.",
+                },
+                capn_executable: {
+                    type: "string",
+                    description: "Optional custom path to the Capn executable.",
+                },
+                profile: {
+                    type: "string",
+                    enum: ["capn-cli", "none"],
+                    description: "Optional adapter profile; defaults to capn-cli.",
+                },
+                root: {
+                    type: "string",
+                    description: "Optional repository root path. Defaults to current working directory.",
+                },
+            },
+            required: ["question"],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const root = resolveRoot(args);
+            const question = typeof args.question === "string" ? args.question.trim() : "";
+            if (!question)
+                throw new WaymarkError("MISSING_ARGUMENT", "question is required");
+            const result = await ask(root, resolveProfile(args), resolveExecutable(args), question);
+            const payload = {
+                waymark: 1,
+                kind: "ask",
+                provider: result.provider,
+                status: result.status,
+            };
+            if (result.status === "hit") {
+                payload.result = result.result;
+            }
+            else if (result.status === "error") {
+                payload.error = result.error;
+            }
+            else {
+                payload.matches = result.matches ?? [];
+            }
+            return jsonResult(payload);
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    },
+};
+export const capnChartTool = {
+    definition: {
+        name: "capn_chart",
+        description: "Directly chart a question, answer, and associated file references into Capn's long-term memory.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                question: {
+                    type: "string",
+                    description: "The question or topic charted.",
+                },
+                answer: {
+                    type: "string",
+                    description: "The conclusive charted answer.",
+                },
+                files: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Array of repository-relative file paths referenced in the answer.",
+                },
+                capn_executable: {
+                    type: "string",
+                    description: "Optional custom path to the Capn executable.",
+                },
+                profile: {
+                    type: "string",
+                    enum: ["capn-cli", "none"],
+                    description: "Optional adapter profile; defaults to capn-cli.",
+                },
+                root: {
+                    type: "string",
+                    description: "Optional repository root path. Defaults to current working directory.",
+                },
+            },
+            required: ["question", "answer"],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const root = resolveRoot(args);
+            const question = typeof args.question === "string" ? args.question.trim() : "";
+            const answer = typeof args.answer === "string" ? args.answer.trim() : "";
+            const files = Array.isArray(args.files) ? args.files.filter((f) => typeof f === "string") : [];
+            if (!question)
+                throw new WaymarkError("MISSING_ARGUMENT", "question is required");
+            if (!answer)
+                throw new WaymarkError("MISSING_ARGUMENT", "answer is required");
+            const result = await publish(root, resolveProfile(args), resolveExecutable(args), question, answer, files);
+            const payload = {
+                waymark: 1,
+                kind: "chart",
+                published: result.published,
+                adapter: result.adapter,
+                output: result.output,
+            };
+            if (!result.published && result.error) {
+                payload.error = result.error;
+            }
+            return jsonResult(payload);
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    },
+};
+export const discoverSymbolsTool = {
+    definition: {
+        name: "waymark_discover_symbols",
+        description: "Discover syntax symbols in one repository-relative file without changing any state.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                path: {
+                    type: "string",
+                    description: "Repository-relative source file path.",
+                },
+                language: {
+                    type: "string",
+                    enum: ["typescript", "python"],
+                    description: "Optional source language when the file extension is not sufficient.",
+                },
+                root: {
+                    type: "string",
+                    description: "Optional repository root path. Defaults to current working directory.",
+                },
+            },
+            required: ["path"],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const root = resolveRoot(args);
+            const storedPath = typeof args.path === "string" ? args.path.trim() : "";
+            const language = typeof args.language === "string" ? args.language : undefined;
+            if (!storedPath)
+                throw new WaymarkError("MISSING_ARGUMENT", "path is required");
+            return jsonResult(await discoverSymbolsInFile(root, storedPath, language));
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    },
+};
+export const CAPN_TOOLS = [capnAskTool, capnChartTool, discoverSymbolsTool];
+//# sourceMappingURL=capnTools.js.map

package/dist/src/mcp/capnTools.js.map

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

package/dist/src/mcp/server.d.ts

@@ -0,0 +1,22 @@
+import { McpPromptDefinition, McpResourceDefinition, McpToolHandler } from "./types.js";
+export declare const CAPN_RESOURCES: McpResourceDefinition[];
+export interface McpServerOptions {
+    name?: string;
+    version?: string;
+    tools?: McpToolHandler[];
+    resources?: McpResourceDefinition[];
+    prompts?: McpPromptDefinition[];
+}
+export declare class McpServer {
+    private readonly toolMap;
+    private readonly serverName;
+    private readonly serverVersion;
+    private readonly resources;
+    private readonly prompts;
+    constructor(optionsOrHandlers?: McpServerOptions | McpToolHandler[]);
+    getToolDefinitions(): import("./types.js").McpToolDefinition[];
+    handleMessage(rawMessage: string): Promise<string | null>;
+    private handleNotification;
+    private handleRequest;
+    runStdio(): Promise<void>;
+}

package/dist/src/mcp/server.js

@@ -0,0 +1,241 @@
+import { CAPN_TOOLS } from "./capnTools.js";
+export const CAPN_RESOURCES = [
+    {
+        uri: "capn://status",
+        name: "Capn Memory Status",
+        description: "Current Capn adapter profile and executable configuration",
+        mimeType: "application/json",
+    },
+];
+export class McpServer {
+    toolMap = new Map();
+    serverName;
+    serverVersion;
+    resources;
+    prompts;
+    constructor(optionsOrHandlers = CAPN_TOOLS) {
+        if (Array.isArray(optionsOrHandlers)) {
+            this.serverName = "waymark-discovery-mcp";
+            this.serverVersion = "2.0.0";
+            this.resources = CAPN_RESOURCES;
+            this.prompts = [];
+            for (const item of optionsOrHandlers) {
+                this.toolMap.set(item.definition.name, item);
+            }
+        }
+        else {
+            this.serverName = optionsOrHandlers.name ?? "waymark-discovery-mcp";
+            this.serverVersion = optionsOrHandlers.version ?? "2.0.0";
+            const tools = optionsOrHandlers.tools ?? CAPN_TOOLS;
+            this.resources = optionsOrHandlers.resources ?? CAPN_RESOURCES;
+            this.prompts = optionsOrHandlers.prompts ?? [];
+            for (const item of tools) {
+                this.toolMap.set(item.definition.name, item);
+            }
+        }
+    }
+    getToolDefinitions() {
+        return Array.from(this.toolMap.values()).map((h) => h.definition);
+    }
+    async handleMessage(rawMessage) {
+        const trimmed = rawMessage.trim();
+        if (!trimmed)
+            return null;
+        let parsed;
+        try {
+            parsed = JSON.parse(trimmed);
+        }
+        catch {
+            return JSON.stringify({
+                jsonrpc: "2.0",
+                id: null,
+                error: { code: -32700, message: "Parse error" },
+            });
+        }
+        if (!parsed || typeof parsed !== "object") {
+            return JSON.stringify({
+                jsonrpc: "2.0",
+                id: null,
+                error: { code: -32600, message: "Invalid Request" },
+            });
+        }
+        const message = parsed;
+        const isNotification = message.id === undefined || message.id === null;
+        if (isNotification) {
+            await this.handleNotification(message);
+            return null;
+        }
+        const response = await this.handleRequest(message);
+        return JSON.stringify(response);
+    }
+    async handleNotification(notification) {
+        if (notification.method === "notifications/initialized") {
+            return;
+        }
+    }
+    async handleRequest(request) {
+        const { id, method, params } = request;
+        if (method === "initialize") {
+            return {
+                jsonrpc: "2.0",
+                id,
+                result: {
+                    protocolVersion: "2024-11-05",
+                    serverInfo: {
+                        name: this.serverName,
+                        version: this.serverVersion,
+                    },
+                    capabilities: {
+                        tools: {},
+                        resources: {},
+                        prompts: {},
+                    },
+                },
+            };
+        }
+        if (method === "ping") {
+            return {
+                jsonrpc: "2.0",
+                id,
+                result: {},
+            };
+        }
+        if (method === "tools/list") {
+            return {
+                jsonrpc: "2.0",
+                id,
+                result: {
+                    tools: this.getToolDefinitions(),
+                },
+            };
+        }
+        if (method === "tools/call") {
+            const toolName = typeof params?.name === "string" ? params.name : "";
+            const toolArgs = (params?.arguments && typeof params.arguments === "object" ? params.arguments : {});
+            const handler = this.toolMap.get(toolName);
+            if (!handler) {
+                return {
+                    jsonrpc: "2.0",
+                    id,
+                    error: {
+                        code: -32601,
+                        message: `Tool not found: ${toolName}`,
+                    },
+                };
+            }
+            try {
+                const result = await handler.handler(toolArgs);
+                return {
+                    jsonrpc: "2.0",
+                    id,
+                    result,
+                };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : "Internal error";
+                return {
+                    jsonrpc: "2.0",
+                    id,
+                    result: {
+                        content: [{ type: "text", text: JSON.stringify({ error: message }) }],
+                        isError: true,
+                    },
+                };
+            }
+        }
+        if (method === "resources/list") {
+            return {
+                jsonrpc: "2.0",
+                id,
+                result: {
+                    resources: this.resources,
+                },
+            };
+        }
+        if (method === "resources/read") {
+            const uri = typeof params?.uri === "string" ? params.uri : "";
+            if (uri === "capn://status") {
+                const capnObj = {
+                    waymark: 1,
+                    kind: "capn-status",
+                    profile: process.env.WAYMARK_CAPN_PROFILE === "none" ? "none" : "capn-cli",
+                    capnExecutable: process.env.WAYMARK_CAPN_EXECUTABLE || "capn",
+                };
+                return {
+                    jsonrpc: "2.0",
+                    id,
+                    result: {
+                        contents: [
+                            {
+                                uri,
+                                mimeType: "application/json",
+                                text: JSON.stringify(capnObj, null, 2),
+                            },
+                        ],
+                    },
+                };
+            }
+            return {
+                jsonrpc: "2.0",
+                id,
+                error: {
+                    code: -32602,
+                    message: `Resource not found: ${uri}`,
+                },
+            };
+        }
+        if (method === "prompts/list") {
+            return {
+                jsonrpc: "2.0",
+                id,
+                result: {
+                    prompts: this.prompts,
+                },
+            };
+        }
+        if (method === "prompts/get") {
+            return {
+                jsonrpc: "2.0",
+                id,
+                error: {
+                    code: -32602,
+                    message: `Prompt not found: ${String(params?.name ?? "")}`,
+                },
+            };
+        }
+        return {
+            jsonrpc: "2.0",
+            id,
+            error: {
+                code: -32601,
+                message: `Method not found: ${method}`,
+            },
+        };
+    }
+    async runStdio() {
+        process.stdin.setEncoding("utf8");
+        let buffer = "";
+        process.stdin.on("data", async (chunk) => {
+            buffer += chunk;
+            const lines = buffer.split(/\r?\n/u);
+            buffer = lines.pop() ?? "";
+            for (const line of lines) {
+                if (!line.trim())
+                    continue;
+                const response = await this.handleMessage(line);
+                if (response) {
+                    process.stdout.write(`${response}\n`);
+                }
+            }
+        });
+        process.stdin.on("end", async () => {
+            if (buffer.trim()) {
+                const response = await this.handleMessage(buffer);
+                if (response) {
+                    process.stdout.write(`${response}\n`);
+                }
+            }
+        });
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/src/mcp/server.js.map

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

package/dist/src/mcp/types.d.ts

@@ -0,0 +1,80 @@
+export interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    id: string | number;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface JsonRpcNotification {
+    jsonrpc: "2.0";
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface JsonRpcResponse {
+    jsonrpc: "2.0";
+    id: string | number | null;
+    result?: unknown;
+    error?: JsonRpcError;
+}
+export interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+export interface McpToolProperty {
+    type: string;
+    description?: string;
+    enum?: string[];
+    items?: {
+        type: string;
+    };
+}
+export interface McpToolInputSchema {
+    type: "object";
+    properties?: Record<string, McpToolProperty>;
+    required?: string[];
+}
+export interface McpToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: McpToolInputSchema;
+}
+export interface McpToolContent {
+    type: "text";
+    text: string;
+}
+export interface McpToolCallResult {
+    content: McpToolContent[];
+    isError?: boolean;
+}
+export interface McpToolHandler {
+    definition: McpToolDefinition;
+    handler: (args: Record<string, unknown>) => Promise<McpToolCallResult>;
+}
+export interface McpResourceDefinition {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+}
+export interface McpResourceContent {
+    uri: string;
+    mimeType?: string;
+    text?: string;
+}
+export interface McpPromptArgument {
+    name: string;
+    description?: string;
+    required?: boolean;
+}
+export interface McpPromptDefinition {
+    name: string;
+    description?: string;
+    arguments?: McpPromptArgument[];
+}
+export interface McpPromptMessage {
+    role: "user" | "assistant";
+    content: {
+        type: "text";
+        text: string;
+    };
+}

package/dist/src/mcp/types.js

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

package/dist/src/mcp/types.js.map

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

package/dist/src/paths.d.ts

@@ -0,0 +1,39 @@
+import { LineRange, StructuralSignature } from "./types.js";
+export declare function sha256(value: Buffer | string): string;
+/**
+ * Resolve the repository root: `git rev-parse --show-toplevel` when inside a Git
+ * worktree, otherwise the process cwd. The discovery engine itself needs no Git —
+ * the fallback keeps the CLI and library usable outside a repository.
+ */
+export declare function repoRoot(cwd?: string): string;
+export declare function normalizeRelativePath(input: string): string;
+export declare function resolveRepositoryFile(root: string, storedPath: string): {
+    lexical: string;
+    real: string;
+};
+export declare function readFileBytes(root: string, storedPath: string): {
+    path: string;
+    bytes: Buffer;
+};
+export declare function readFileText(root: string, storedPath: string): {
+    path: string;
+    bytes: Buffer;
+    text: string;
+};
+export declare function normalizedLines(text: string): string[];
+export declare function extractRange(lines: readonly string[], range: LineRange): string;
+export declare function normalizeSpan(text: string): string;
+export declare function structuralSignature(normalized: string): StructuralSignature;
+/**
+ * Anchor a repository-relative file range: full-file hash plus a normalized,
+ * relocation-tolerant span hash. This is the tamper-evidence primitive — the
+ * same one the in-flight continuity ledger used, kept standalone because it is
+ * the cheapest way to pin "this span said X" to a later integrity check.
+ */
+export declare function anchorForRange(root: string, storedPath: string, range: LineRange): {
+    fileSha256: string;
+    normalizedSpanHash: string;
+    normalizedSpanLen: number;
+    spanLineCount: number;
+    structuralSignature: StructuralSignature;
+};