@digital-lake/lognexus 1.0.0-alpha.1 → 1.0.0-alpha.4

package/dist/mcp/resources.js

@@ -0,0 +1,75 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { DEFAULT_ROUTING_TEMPLATE } from "../scaffold.js";
+import { loadState } from "../state/manager.js";
+export const MCP_RESOURCE_PREFIX = "lognexus://";
+export const STATE_RESOURCE_URI = `${MCP_RESOURCE_PREFIX}state`;
+export const ROUTING_RESOURCE_URI = `${MCP_RESOURCE_PREFIX}routing`;
+export class McpResourceError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "McpResourceError";
+    }
+}
+const RESOURCE_DEFINITIONS = [
+    {
+        uri: STATE_RESOURCE_URI,
+        name: "LogNexus agent state",
+        description: "Persistent LogNexus agent state (.lognexus/state.json): active issue, current subtask, completed subtasks and last synchronization timestamp.",
+        mimeType: "application/json",
+    },
+    {
+        uri: ROUTING_RESOURCE_URI,
+        name: "Model-tier routing configuration",
+        description: "Multi-model routing rules from .lognexus/routing.md, or the default tier taxonomy when the project has not been initialized.",
+        mimeType: "text/markdown",
+    },
+];
+export function listMcpResources() {
+    return RESOURCE_DEFINITIONS;
+}
+export function readStateResource(targetDir = process.cwd()) {
+    return {
+        contents: [
+            {
+                uri: STATE_RESOURCE_URI,
+                mimeType: "application/json",
+                text: JSON.stringify(loadState(targetDir), null, 2),
+            },
+        ],
+    };
+}
+export function readRoutingResource(targetDir = process.cwd()) {
+    const routingPath = join(targetDir, ".lognexus", "routing.md");
+    const hasRoutingFile = existsSync(routingPath);
+    let text;
+    try {
+        text = hasRoutingFile ? readFileSync(routingPath, "utf8") : DEFAULT_ROUTING_TEMPLATE;
+    }
+    catch {
+        text = DEFAULT_ROUTING_TEMPLATE;
+    }
+    if (!hasRoutingFile) {
+        text = `<!-- Default routing template: .lognexus/routing.md not found in this project. -->\n${text}`;
+    }
+    return {
+        contents: [
+            {
+                uri: ROUTING_RESOURCE_URI,
+                mimeType: "text/markdown",
+                text,
+            },
+        ],
+    };
+}
+export function readMcpResource(uri, targetDir = process.cwd()) {
+    switch (uri) {
+        case STATE_RESOURCE_URI:
+            return readStateResource(targetDir);
+        case ROUTING_RESOURCE_URI:
+            return readRoutingResource(targetDir);
+        default:
+            throw new McpResourceError(`Unknown LogNexus resource: '${uri}'.`);
+    }
+}
+//# sourceMappingURL=resources.js.map

package/dist/mcp/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/mcp/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AACjD,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,mBAAmB,OAAO,CAAC;AAChE,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,mBAAmB,SAAS,CAAC;AAmBpE,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,oBAAoB,GAAyB;IACjD;QACE,GAAG,EAAE,kBAAkB;QACvB,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EACT,+IAA+I;QACjJ,QAAQ,EAAE,kBAAkB;KAC7B;IACD;QACE,GAAG,EAAE,oBAAoB;QACzB,IAAI,EAAE,kCAAkC;QACxC,WAAW,EACT,8HAA8H;QAChI,QAAQ,EAAE,eAAe;KAC1B;CACF,CAAC;AAEF,MAAM,UAAU,gBAAgB;IAC9B,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAS,GAAW,OAAO,CAAC,GAAG,EAAE;IACjE,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,kBAAkB;gBACvB,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;aACpD;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,SAAS,GAAW,OAAO,CAAC,GAAG,EAAE;IACnE,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IAC/D,MAAM,cAAc,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAE/C,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,cAAc,CAAC,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC;IACvF,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,GAAG,wBAAwB,CAAC;IAClC,CAAC;IAED,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,IAAI,GAAG,uFAAuF,IAAI,EAAE,CAAC;IACvG,CAAC;IAED,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,oBAAoB;gBACzB,QAAQ,EAAE,eAAe;gBACzB,IAAI;aACL;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,GAAW,EACX,SAAS,GAAW,OAAO,CAAC,GAAG,EAAE;IAEjC,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,kBAAkB;YACrB,OAAO,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACtC,KAAK,oBAAoB;YACvB,OAAO,mBAAmB,CAAC,SAAS,CAAC,CAAC;QACxC;YACE,MAAM,IAAI,gBAAgB,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAAC;IACvE,CAAC;AACH,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,22 @@
+export declare const MCP_PROTOCOL_VERSION = "2024-11-05";
+export declare const MCP_SERVER_VERSION = "1.0.0";
+export interface McpInitializeResult {
+    protocolVersion: string;
+    capabilities: {
+        tools: Record<string, never>;
+        resources: Record<string, never>;
+        prompts: Record<string, never>;
+    };
+    serverInfo: {
+        name: string;
+        version: string;
+    };
+}
+/**
+ * Processes a single newline-delimited JSON-RPC message.
+ * Returns the serialized response, or null when no response must be written
+ * (notifications and client responses).
+ */
+export declare function processMcpMessage(rawMessage: string, targetDir?: string): Promise<string | null>;
+export declare function startMcpServer(targetDir?: string): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,oBAAoB,eAAe,CAAC;AACjD,eAAO,MAAM,kBAAkB,UAAU,CAAC;AA6B1C,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC7B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;KAChC,CAAC;IACF,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAuID;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,MAAsB,GAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA2ExB;AAED,wBAAsB,cAAc,CAAC,SAAS,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BrF"}

package/dist/mcp/server.js

@@ -0,0 +1,202 @@
+import { createInterface } from "node:readline";
+import { getMcpPrompt, listMcpPrompts, McpPromptError } from "./prompts.js";
+import { listMcpResources, McpResourceError, readMcpResource } from "./resources.js";
+import { callMcpTool, isKnownTool, listMcpTools, MCP_SERVER_NAME, } from "./tools.js";
+export const MCP_PROTOCOL_VERSION = "2024-11-05";
+export const MCP_SERVER_VERSION = "1.0.0";
+const JSON_RPC_PARSE_ERROR = -32700;
+const JSON_RPC_INVALID_REQUEST = -32600;
+const JSON_RPC_METHOD_NOT_FOUND = -32601;
+const JSON_RPC_INVALID_PARAMS = -32602;
+const JSON_RPC_INTERNAL_ERROR = -32603;
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function success(id, result) {
+    return { jsonrpc: "2.0", id, result };
+}
+function failure(id, code, message, data) {
+    const error = { code, message };
+    if (data !== undefined) {
+        error.data = data;
+    }
+    return { jsonrpc: "2.0", id, error };
+}
+function getPromptArgs(params) {
+    const raw = params.arguments;
+    if (raw === undefined || raw === null)
+        return {};
+    if (!isObject(raw)) {
+        throw new McpPromptError("Parameter 'arguments' must be an object.");
+    }
+    const args = {};
+    for (const [key, value] of Object.entries(raw)) {
+        if (value === undefined || value === null)
+            continue;
+        args[key] = String(value);
+    }
+    return args;
+}
+function buildInitializeResult() {
+    return {
+        protocolVersion: MCP_PROTOCOL_VERSION,
+        capabilities: {
+            tools: {},
+            resources: {},
+            prompts: {},
+        },
+        serverInfo: { name: MCP_SERVER_NAME, version: MCP_SERVER_VERSION },
+    };
+}
+/**
+ * Resolves a JSON-RPC method to its result payload.
+ * Throws a JsonRpcFailure to short-circuit with an error response.
+ */
+async function dispatchRequest(method, params, targetDir) {
+    switch (method) {
+        case "initialize":
+            return buildInitializeResult();
+        case "ping":
+            return {};
+        case "tools/list":
+            return { tools: listMcpTools() };
+        case "tools/call": {
+            const name = params.name;
+            if (typeof name !== "string" || name.trim() === "") {
+                throw failure(null, JSON_RPC_INVALID_PARAMS, "Parameter 'name' must be a non-empty string.");
+            }
+            if (!isKnownTool(name)) {
+                const result = {
+                    content: [{ type: "text", text: `Unknown LogNexus tool: '${name}'.` }],
+                    isError: true,
+                };
+                return result;
+            }
+            const rawArgs = params.arguments;
+            if (rawArgs !== undefined && rawArgs !== null && !isObject(rawArgs)) {
+                throw failure(null, JSON_RPC_INVALID_PARAMS, "Parameter 'arguments' must be an object.");
+            }
+            return callMcpTool(name, rawArgs ?? {}, targetDir);
+        }
+        case "resources/list":
+            return { resources: listMcpResources() };
+        case "resources/read": {
+            const uri = params.uri;
+            if (typeof uri !== "string" || uri.trim() === "") {
+                throw failure(null, JSON_RPC_INVALID_PARAMS, "Parameter 'uri' must be a non-empty string.");
+            }
+            try {
+                return readMcpResource(uri, targetDir);
+            }
+            catch (error) {
+                const message = error instanceof McpResourceError ? error.message : String(error);
+                throw failure(null, JSON_RPC_INVALID_PARAMS, message);
+            }
+        }
+        case "prompts/list":
+            return { prompts: listMcpPrompts() };
+        case "prompts/get": {
+            const name = params.name;
+            if (typeof name !== "string" || name.trim() === "") {
+                throw failure(null, JSON_RPC_INVALID_PARAMS, "Parameter 'name' must be a non-empty string.");
+            }
+            let prompt;
+            try {
+                prompt = getMcpPrompt(name, getPromptArgs(params));
+            }
+            catch (error) {
+                const message = error instanceof McpPromptError ? error.message : String(error);
+                throw failure(null, JSON_RPC_INVALID_PARAMS, message);
+            }
+            return prompt;
+        }
+        default:
+            throw failure(null, JSON_RPC_METHOD_NOT_FOUND, `Method not found: ${method}`);
+    }
+}
+/**
+ * Processes a single newline-delimited JSON-RPC message.
+ * Returns the serialized response, or null when no response must be written
+ * (notifications and client responses).
+ */
+export async function processMcpMessage(rawMessage, targetDir = process.cwd()) {
+    const trimmed = rawMessage.trim();
+    if (trimmed === "") {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        return JSON.stringify(failure(null, JSON_RPC_PARSE_ERROR, "Parse error: invalid JSON payload."));
+    }
+    if (!isObject(parsed)) {
+        return JSON.stringify(failure(null, JSON_RPC_INVALID_REQUEST, "Invalid Request: expected a JSON object."));
+    }
+    const hasMethod = typeof parsed.method === "string";
+    const isNotification = hasMethod && !("id" in parsed);
+    if (!isNotification && !("method" in parsed)) {
+        return null;
+    }
+    const request = parsed;
+    const rawId = request.id;
+    const id = typeof rawId === "string" || typeof rawId === "number" ? rawId : null;
+    if (!hasMethod || request.method.trim() === "") {
+        if (isNotification)
+            return null;
+        return JSON.stringify(failure(id, JSON_RPC_INVALID_REQUEST, "Invalid Request: 'method' must be a string."));
+    }
+    const method = request.method;
+    if ("jsonrpc" in parsed && parsed.jsonrpc !== "2.0") {
+        if (isNotification)
+            return null;
+        return JSON.stringify(failure(id, JSON_RPC_INVALID_REQUEST, "Invalid Request: 'jsonrpc' must be \"2.0\"."));
+    }
+    let params = {};
+    if (request.params !== undefined && request.params !== null) {
+        if (!isObject(request.params)) {
+            if (isNotification)
+                return null;
+            return JSON.stringify(failure(id, JSON_RPC_INVALID_PARAMS, "Invalid params: 'params' must be an object."));
+        }
+        params = request.params;
+    }
+    if (isNotification) {
+        return null;
+    }
+    try {
+        const result = await dispatchRequest(method, params, targetDir);
+        return JSON.stringify(success(id, result));
+    }
+    catch (error) {
+        if (isObject(error) && isObject(error.error) && typeof error.error.code === "number") {
+            const payload = error;
+            return JSON.stringify({ ...payload, id });
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        return JSON.stringify(failure(id, JSON_RPC_INTERNAL_ERROR, `Internal error: ${message}`));
+    }
+}
+export async function startMcpServer(targetDir = process.cwd()) {
+    const rl = createInterface({ input: process.stdin, terminal: false });
+    process.stderr.write(`${MCP_SERVER_NAME} MCP server v${MCP_SERVER_VERSION} listening on stdio (protocol ${MCP_PROTOCOL_VERSION}) — cwd: ${targetDir}\n`);
+    let queue = Promise.resolve();
+    rl.on("line", (line) => {
+        queue = queue
+            .then(async () => {
+            const response = await processMcpMessage(line, targetDir);
+            if (response !== null) {
+                process.stdout.write(`${response}\n`);
+            }
+        })
+            .catch((error) => {
+            const message = error instanceof Error ? error.message : String(error);
+            process.stderr.write(`Failed to process MCP message: ${message}\n`);
+        });
+    });
+    await new Promise((resolve) => {
+        rl.on("close", () => resolve());
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/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/mcp/tools.d.ts

@@ -0,0 +1,26 @@
+export declare const MCP_SERVER_NAME = "lognexus";
+export interface ToolDefinition {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+export interface ToolTextContent {
+    type: "text";
+    text: string;
+}
+export interface ToolCallResult {
+    content: ToolTextContent[];
+    isError?: boolean;
+}
+export declare class McpToolError extends Error {
+    constructor(message: string);
+}
+export declare function listMcpTools(): ToolDefinition[];
+export declare function isKnownTool(name: string): boolean;
+export declare function callMcpTool(name: string, args?: Record<string, unknown>, targetDir?: string): Promise<ToolCallResult>;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,eAAe,aAAa,CAAC;AAE1C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AA+GD,wBAAgB,YAAY,IAAI,cAAc,EAAE,CAE/C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAwCD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAClC,SAAS,GAAE,MAAsB,GAChC,OAAO,CAAC,cAAc,CAAC,CAsDzB"}

package/dist/mcp/tools.js

@@ -0,0 +1,197 @@
+import { attachCurrentStateToCommit } from "../notes/attach.js";
+import { getNote } from "../notes/notes.js";
+import { clearState, finishSubtask, loadState, setSubtask } from "../state/manager.js";
+import { syncStateFromGit } from "../state/sync.js";
+import { getProjectStatus } from "../status.js";
+export const MCP_SERVER_NAME = "lognexus";
+export class McpToolError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "McpToolError";
+    }
+}
+const TOOL_DEFINITIONS = [
+    {
+        name: "lognexus_status",
+        title: "LogNexus project status",
+        description: "Inspect the current Git branch, whether the directory is a Git repository, the active issue, the routing mode and the recommended model tier.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "lognexus_state_get",
+        title: "Get agent state",
+        description: "Return the persistent LogNexus agent state (.lognexus/state.json): active issue, current subtask, completed subtasks and last synchronization timestamp.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "lognexus_state_sync",
+        title: "Sync state from Git",
+        description: "Synchronize the persistent state from the current Git branch and GitHub metadata, then return the updated state.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "lognexus_state_set_task",
+        title: "Set active subtask",
+        description: "Mark a subtask as in progress (equivalent to 'lognexus state set-task <id> [title]') and return the updated state.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                taskId: {
+                    type: "string",
+                    description: "Subtask identifier, e.g. 'T1'.",
+                },
+                title: {
+                    type: "string",
+                    description: "Optional human-readable subtask title.",
+                },
+            },
+            required: ["taskId"],
+        },
+    },
+    {
+        name: "lognexus_state_finish_task",
+        title: "Finish subtask",
+        description: "Mark a subtask as completed (equivalent to 'lognexus state finish-task <id>') and return the updated state.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                taskId: {
+                    type: "string",
+                    description: "Subtask identifier, e.g. 'T1'.",
+                },
+            },
+            required: ["taskId"],
+        },
+    },
+    {
+        name: "lognexus_state_clear",
+        title: "Clear agent state",
+        description: "Reset the persistent LogNexus agent state to empty (equivalent to 'lognexus state clear').",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "lognexus_note_show",
+        title: "Show Git Note",
+        description: "Read the LogNexus Git Note (refs/notes/lognexus) attached to a commit and return its parsed JSON payload. Defaults to HEAD.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                commitRef: {
+                    type: "string",
+                    description: "Git commit reference (SHA, branch, tag or HEAD). Defaults to HEAD.",
+                },
+            },
+        },
+    },
+    {
+        name: "lognexus_note_attach",
+        title: "Attach Git Note",
+        description: "Attach the current LogNexus state as a Git Note (refs/notes/lognexus) to a commit. Defaults to HEAD.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                commitRef: {
+                    type: "string",
+                    description: "Git commit reference (SHA, branch, tag or HEAD). Defaults to HEAD.",
+                },
+            },
+        },
+    },
+];
+export function listMcpTools() {
+    return TOOL_DEFINITIONS;
+}
+export function isKnownTool(name) {
+    return TOOL_DEFINITIONS.some((tool) => tool.name === name);
+}
+function textResult(value) {
+    const text = typeof value === "string" ? value : JSON.stringify(value, null, 2);
+    return { content: [{ type: "text", text }] };
+}
+function errorResult(message) {
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+function readStringArg(args, key, options = {}) {
+    const value = args[key];
+    if (value === undefined || value === null) {
+        if (options.required) {
+            throw new McpToolError(`Missing required argument: '${key}'.`);
+        }
+        return undefined;
+    }
+    if (typeof value !== "string") {
+        throw new McpToolError(`Argument '${key}' must be a string.`);
+    }
+    const trimmed = value.trim();
+    if (trimmed === "") {
+        if (options.required) {
+            throw new McpToolError(`Argument '${key}' must be a non-empty string.`);
+        }
+        return undefined;
+    }
+    return trimmed;
+}
+function resolveCommitRef(args) {
+    return readStringArg(args, "commitRef") ?? "HEAD";
+}
+export async function callMcpTool(name, args = {}, targetDir = process.cwd()) {
+    try {
+        switch (name) {
+            case "lognexus_status":
+                return textResult(getProjectStatus(targetDir));
+            case "lognexus_state_get":
+                return textResult(loadState(targetDir));
+            case "lognexus_state_sync":
+                return textResult(syncStateFromGit(targetDir));
+            case "lognexus_state_set_task": {
+                const taskId = readStringArg(args, "taskId", { required: true });
+                const title = readStringArg(args, "title") ?? "";
+                return textResult(setSubtask(taskId, title, undefined, targetDir));
+            }
+            case "lognexus_state_finish_task": {
+                const taskId = readStringArg(args, "taskId", { required: true });
+                return textResult(finishSubtask(taskId, targetDir));
+            }
+            case "lognexus_state_clear": {
+                const cleared = clearState(targetDir);
+                return {
+                    content: [
+                        { type: "text", text: "LogNexus state cleared." },
+                        { type: "text", text: JSON.stringify(cleared, null, 2) },
+                    ],
+                };
+            }
+            case "lognexus_note_show": {
+                const commitRef = resolveCommitRef(args);
+                const note = getNote(commitRef, { cwd: targetDir });
+                if (note === null) {
+                    return errorResult(`No LogNexus note found for commit '${commitRef}'.`);
+                }
+                return textResult(note);
+            }
+            case "lognexus_note_attach": {
+                const commitRef = resolveCommitRef(args);
+                return textResult(attachCurrentStateToCommit(commitRef, { cwd: targetDir }));
+            }
+            default:
+                return errorResult(`Unknown LogNexus tool: '${name}'.`);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return errorResult(`Tool '${name}' failed: ${message}`);
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

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

package/dist/notes/attach.d.ts

@@ -0,0 +1,20 @@
+import { type NoteOptions } from "./notes.js";
+export interface GitNotePayload {
+    $schema: string;
+    generator: string;
+    version: string;
+    timestamp: string;
+    issue: {
+        id: number;
+        title: string;
+    } | null;
+    subtask: {
+        id: string;
+        title: string;
+        contract?: unknown;
+    } | null;
+    tier: string;
+}
+export declare function buildStateNotePayload(targetDir?: string): GitNotePayload;
+export declare function attachCurrentStateToCommit(commitRef?: string, options?: NoteOptions): GitNotePayload;
+//# sourceMappingURL=attach.d.ts.map

package/dist/notes/attach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.d.ts","sourceRoot":"","sources":["../../src/notes/attach.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5C,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,GAAG,IAAI,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,qBAAqB,CAAC,SAAS,GAAE,MAAsB,GAAG,cAAc,CAkBvF;AAED,wBAAgB,0BAA0B,CACxC,SAAS,GAAE,MAAe,EAC1B,OAAO,GAAE,WAAgB,GACxB,cAAc,CAKhB"}

package/dist/notes/attach.js

@@ -0,0 +1,27 @@
+import { loadState } from "../state/manager.js";
+import { attachNote } from "./notes.js";
+export function buildStateNotePayload(targetDir = process.cwd()) {
+    const state = loadState(targetDir);
+    return {
+        $schema: "https://lognexus.digital-lake.ai/schemas/git-note-v1.json",
+        generator: "LogNexus",
+        version: "1.0.0",
+        timestamp: new Date().toISOString(),
+        issue: state.activeIssue ? { id: state.activeIssue.id, title: state.activeIssue.title } : null,
+        subtask: state.currentSubtask
+            ? {
+                id: state.currentSubtask.id,
+                title: state.currentSubtask.title,
+                contract: state.currentSubtask.contract,
+            }
+            : null,
+        tier: state.activeIssue?.tier ?? "tier-3",
+    };
+}
+export function attachCurrentStateToCommit(commitRef = "HEAD", options = {}) {
+    const payload = buildStateNotePayload(options.cwd);
+    const serialized = JSON.stringify(payload, null, 2);
+    attachNote(serialized, commitRef, options);
+    return payload;
+}
+//# sourceMappingURL=attach.js.map

package/dist/notes/attach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.js","sourceRoot":"","sources":["../../src/notes/attach.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAoB,MAAM,YAAY,CAAC;AAgB1D,MAAM,UAAU,qBAAqB,CAAC,SAAS,GAAW,OAAO,CAAC,GAAG,EAAE;IACrE,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;IAEnC,OAAO;QACL,OAAO,EAAE,2DAA2D;QACpE,SAAS,EAAE,UAAU;QACrB,OAAO,EAAE,OAAO;QAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI;QAC9F,OAAO,EAAE,KAAK,CAAC,cAAc;YAC3B,CAAC,CAAC;gBACE,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,EAAE;gBAC3B,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK;gBACjC,QAAQ,EAAE,KAAK,CAAC,cAAc,CAAC,QAAQ;aACxC;YACH,CAAC,CAAC,IAAI;QACR,IAAI,EAAE,KAAK,CAAC,WAAW,EAAE,IAAI,IAAI,QAAQ;KAC1C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,SAAS,GAAW,MAAM,EAC1B,OAAO,GAAgB,EAAE;IAEzB,MAAM,OAAO,GAAG,qBAAqB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACpD,UAAU,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAC3C,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/notes/notes.d.ts

@@ -0,0 +1,14 @@
+export declare const DEFAULT_NOTES_REF = "refs/notes/lognexus";
+export interface NoteOptions {
+    ref?: string;
+    cwd?: string;
+}
+export declare function attachNote(content: string, commitRef?: string, options?: NoteOptions): void;
+export declare function getNote(commitRef?: string, options?: NoteOptions): string | null;
+export declare function listNotes(options?: NoteOptions): Array<{
+    commitSha: string;
+    noteBlob: string;
+}>;
+export declare function pushNotes(remote?: string, options?: NoteOptions): boolean;
+export declare function fetchNotes(remote?: string, options?: NoteOptions): boolean;
+//# sourceMappingURL=notes.d.ts.map

package/dist/notes/notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notes.d.ts","sourceRoot":"","sources":["../../src/notes/notes.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,wBAAwB,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,MAAe,EAC1B,OAAO,GAAE,WAAgB,GACxB,IAAI,CAWN;AAED,wBAAgB,OAAO,CAAC,SAAS,GAAE,MAAe,EAAE,OAAO,GAAE,WAAgB,GAAG,MAAM,GAAG,IAAI,CAc5F;AAED,wBAAgB,SAAS,CACvB,OAAO,GAAE,WAAgB,GACxB,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAuBhD;AAED,wBAAgB,SAAS,CAAC,MAAM,GAAE,MAAiB,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAcvF;AAED,wBAAgB,UAAU,CAAC,MAAM,GAAE,MAAiB,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAcxF"}