@julong/mono-rele2-core 1.2.0 → 1.3.1

package/README.md

@@ -0,0 +1,93 @@
+# @julong/mono-rele2-core
+
+Core system utility tools for the mono-rele2 monorepo. Available as an MCP server and a standalone CLI.
+
+## CLI
+
+### Installation
+
+```sh
+npm install -g @julong/mono-rele2-core
+# or
+npx @julong/mono-rele2-core <skillName> [...args]
+```
+
+### Usage
+
+```sh
+mono-rele2-core <skillName> [...args]
+```
+
+Run without arguments to list all available skills:
+
+```sh
+mono-rele2-core
+```
+
+```
+Available skills:
+
+  echoTool
+  Returns the message as-is
+    message  Message to echo
+  ...
+```
+
+### Skills
+
+#### `echoTool`
+
+Returns the message as-is.
+
+```sh
+mono-rele2-core echoTool <message>
+```
+
+| arg | type | description |
+|-----|------|-------------|
+| `message` | string | Message to echo |
+
+```sh
+mono-rele2-core echoTool "hello world"    # hello world
+```
+
+#### `timestampTool`
+
+Returns the current UTC timestamp.
+
+```sh
+mono-rele2-core timestampTool [format]
+```
+
+| arg | type | description |
+|-----|------|-------------|
+| `format` | `iso` \| `unix` | Output format (default: `iso`) |
+
+```sh
+mono-rele2-core timestampTool           # 2026-05-03T00:00:00.000Z
+mono-rele2-core timestampTool iso       # 2026-05-03T00:00:00.000Z
+mono-rele2-core timestampTool unix      # 1746230400000
+```
+
+#### `envTool`
+
+Returns the value of an environment variable.
+
+```sh
+mono-rele2-core envTool <key>
+```
+
+| arg | type | description |
+|-----|------|-------------|
+| `key` | string | Environment variable name |
+
+```sh
+mono-rele2-core envTool HOME        # /Users/julong
+mono-rele2-core envTool NODE_ENV    # development
+```
+
+## MCP Server
+
+```sh
+mcp-core
+```

package/dist/cli.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+
+// ../common/mcp/tool.ts
+function toolDef(def) {
+  return def;
+}
+function defineTool(tool) {
+  return tool;
+}
+function text(content) {
+  return { content: [{ type: "text", text: content }] };
+}
+
+// ../common/mcp/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+// ../common/mcp/cli.ts
+import { z } from "zod";
+function formatSkills(tools2) {
+  const sections = Object.entries(tools2).map(([key, tool]) => {
+    const params = Object.entries(tool.inputSchema);
+    const maxLen = Math.max(...params.map(([f]) => f.length));
+    const paramLines = params.map(([field, schema]) => {
+      const desc = schema.description ?? "";
+      return `    ${field.padEnd(maxLen + 2)}${desc}`;
+    }).join("\n");
+    return `  ${key}
+  ${tool.description}
+${paramLines}`;
+  });
+  return "Available skills:\n\n" + sections.join("\n\n");
+}
+async function runCli(tools2) {
+  const [, , toolName, ...rawArgs] = process.argv;
+  if (!toolName || !(toolName in tools2)) {
+    if (toolName) console.error(`Unknown skill: "${toolName}"
+`);
+    console.log(formatSkills(tools2));
+    process.exit(toolName ? 1 : 0);
+  }
+  const tool = tools2[toolName];
+  const fieldNames = Object.keys(tool.inputSchema);
+  const rawInput = {};
+  for (let i = 0; i < fieldNames.length; i++) {
+    const raw = rawArgs[i];
+    if (raw === void 0) continue;
+    try {
+      rawInput[fieldNames[i]] = JSON.parse(raw);
+    } catch {
+      rawInput[fieldNames[i]] = raw;
+    }
+  }
+  const parsed = z.object(tool.inputSchema).parse(rawInput);
+  const result = await tool.handler(parsed);
+  for (const part of result.content) {
+    if (part.type === "text") console.log(part.text);
+  }
+}
+function handleCliError(err) {
+  if (err instanceof z.ZodError) {
+    console.error("Validation error:", err.issues.map((e) => `${e.path.join(".")}: ${e.message}`).join(", "));
+  } else {
+    console.error("Error:", err instanceof Error ? err.message : String(err));
+  }
+  process.exit(1);
+}
+
+// src/tools/system.ts
+import { z as z2 } from "zod";
+var tools = {
+  echoTool: toolDef({
+    name: "echo",
+    description: "Returns the message as-is",
+    inputSchema: {
+      message: z2.string().describe("Message to echo")
+    },
+    handler: async ({ message }) => text(message)
+  }),
+  timestampTool: toolDef({
+    name: "timestamp",
+    description: "Returns the current UTC timestamp",
+    inputSchema: {
+      format: z2.enum(["iso", "unix"]).default("iso").describe("Timestamp format")
+    },
+    handler: async ({ format }) => {
+      const value = format === "unix" ? String(Date.now()) : (/* @__PURE__ */ new Date()).toISOString();
+      return text(value);
+    }
+  }),
+  envTool: toolDef({
+    name: "env",
+    description: "Returns the value of an environment variable",
+    inputSchema: {
+      key: z2.string().describe("Environment variable name")
+    },
+    handler: async ({ key }) => text(process.env[key] ?? "")
+  })
+};
+var echoTool = defineTool(tools.echoTool);
+var timestampTool = defineTool(tools.timestampTool);
+var envTool = defineTool(tools.envTool);
+
+// src/cli.ts
+runCli(tools).catch(handleCliError);

package/dist/index.js

@@ -1,4 +1,7 @@
 // ../common/mcp/tool.ts
+function toolDef(def) {
+  return def;
+}
 function defineTool(tool) {
   return tool;
 }
@@ -9,9 +12,9 @@ function text(content) {
 // ../common/mcp/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-function createMcpServer(config, tools) {
+function createMcpServer(config, tools2) {
   const server = new McpServer(config);
-  for (const tool of tools) {
+  for (const tool of tools2) {
     server.registerTool(
       tool.name,
       { description: tool.description, inputSchema: tool.inputSchema },
@@ -22,35 +25,43 @@ function createMcpServer(config, tools) {
   return server;
 }
 
-// src/tools/system.ts
+// ../common/mcp/cli.ts
 import { z } from "zod";
-var echoTool = defineTool({
-  name: "echo",
-  description: "Returns the message as-is",
-  inputSchema: {
-    message: z.string().describe("Message to echo")
-  },
-  handler: async ({ message }) => text(message)
-});
-var timestampTool = defineTool({
-  name: "timestamp",
-  description: "Returns the current UTC timestamp",
-  inputSchema: {
-    format: z.enum(["iso", "unix"]).default("iso").describe("Timestamp format")
-  },
-  handler: async ({ format }) => {
-    const value = format === "unix" ? String(Date.now()) : (/* @__PURE__ */ new Date()).toISOString();
-    return text(value);
-  }
-});
-var envTool = defineTool({
-  name: "env",
-  description: "Returns the value of an environment variable",
-  inputSchema: {
-    key: z.string().describe("Environment variable name")
-  },
-  handler: async ({ key }) => text(process.env[key] ?? "")
-});
+
+// src/tools/system.ts
+import { z as z2 } from "zod";
+var tools = {
+  echoTool: toolDef({
+    name: "echo",
+    description: "Returns the message as-is",
+    inputSchema: {
+      message: z2.string().describe("Message to echo")
+    },
+    handler: async ({ message }) => text(message)
+  }),
+  timestampTool: toolDef({
+    name: "timestamp",
+    description: "Returns the current UTC timestamp",
+    inputSchema: {
+      format: z2.enum(["iso", "unix"]).default("iso").describe("Timestamp format")
+    },
+    handler: async ({ format }) => {
+      const value = format === "unix" ? String(Date.now()) : (/* @__PURE__ */ new Date()).toISOString();
+      return text(value);
+    }
+  }),
+  envTool: toolDef({
+    name: "env",
+    description: "Returns the value of an environment variable",
+    inputSchema: {
+      key: z2.string().describe("Environment variable name")
+    },
+    handler: async ({ key }) => text(process.env[key] ?? "")
+  })
+};
+var echoTool = defineTool(tools.echoTool);
+var timestampTool = defineTool(tools.timestampTool);
+var envTool = defineTool(tools.envTool);
 
 // src/index.ts
 function createCoreServer() {

package/dist/mono-rele2-core/skill.md

@@ -0,0 +1,54 @@
+---
+name: mono-rele2-core
+description: Use this skill to invoke core system utility functions via the mono-rele2-core CLI. Handles message echo, UTC timestamp generation, and environment variable lookup.
+---
+
+# mono-rele2-core
+
+CLI for running core system utility functions from the mono-rele2 package.
+
+```sh
+mono-rele2-core <skillName> [...args]
+```
+
+## Skills
+
+### echoTool
+
+Returns the message as-is.
+
+| arg | description |
+|-----|-------------|
+| `message` | Message to echo |
+
+### timestampTool
+
+Returns the current UTC timestamp.
+
+| arg | description |
+|-----|-------------|
+| `format` | Output format: `iso` (default) \| `unix` |
+
+### envTool
+
+Returns the value of an environment variable.
+
+| arg | description |
+|-----|-------------|
+| `key` | Environment variable name |
+
+## Examples
+
+- `mono-rele2-core echoTool "hello world"` → `hello world`
+- `mono-rele2-core timestampTool` → `2026-05-02T00:00:00.000Z`
+- `mono-rele2-core timestampTool iso` → `2026-05-02T00:00:00.000Z`
+- `mono-rele2-core timestampTool unix` → `1746144000000`
+- `mono-rele2-core envTool HOME` → `/Users/julong`
+- `mono-rele2-core envTool NODE_ENV` → `development`
+
+## Guidelines
+
+- Arguments are positional — pass them in the order listed in each skill's table
+- `format` in `timestampTool` defaults to `iso` if omitted
+- `envTool` returns an empty string when the variable is not set
+- Run `mono-rele2-core` with no args to list all available skills

package/dist/server.js

@@ -1,6 +1,9 @@
 #!/usr/bin/env node
 
 // ../common/mcp/tool.ts
+function toolDef(def) {
+  return def;
+}
 function defineTool(tool) {
   return tool;
 }
@@ -11,9 +14,9 @@ function text(content) {
 // ../common/mcp/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-function createMcpServer(config, tools) {
+function createMcpServer(config, tools2) {
   const server2 = new McpServer(config);
-  for (const tool of tools) {
+  for (const tool of tools2) {
     server2.registerTool(
       tool.name,
       { description: tool.description, inputSchema: tool.inputSchema },
@@ -28,35 +31,43 @@ async function startServer(server2) {
   await server2.connect(transport);
 }
 
-// src/tools/system.ts
+// ../common/mcp/cli.ts
 import { z } from "zod";
-var echoTool = defineTool({
-  name: "echo",
-  description: "Returns the message as-is",
-  inputSchema: {
-    message: z.string().describe("Message to echo")
-  },
-  handler: async ({ message }) => text(message)
-});
-var timestampTool = defineTool({
-  name: "timestamp",
-  description: "Returns the current UTC timestamp",
-  inputSchema: {
-    format: z.enum(["iso", "unix"]).default("iso").describe("Timestamp format")
-  },
-  handler: async ({ format }) => {
-    const value = format === "unix" ? String(Date.now()) : (/* @__PURE__ */ new Date()).toISOString();
-    return text(value);
-  }
-});
-var envTool = defineTool({
-  name: "env",
-  description: "Returns the value of an environment variable",
-  inputSchema: {
-    key: z.string().describe("Environment variable name")
-  },
-  handler: async ({ key }) => text(process.env[key] ?? "")
-});
+
+// src/tools/system.ts
+import { z as z2 } from "zod";
+var tools = {
+  echoTool: toolDef({
+    name: "echo",
+    description: "Returns the message as-is",
+    inputSchema: {
+      message: z2.string().describe("Message to echo")
+    },
+    handler: async ({ message }) => text(message)
+  }),
+  timestampTool: toolDef({
+    name: "timestamp",
+    description: "Returns the current UTC timestamp",
+    inputSchema: {
+      format: z2.enum(["iso", "unix"]).default("iso").describe("Timestamp format")
+    },
+    handler: async ({ format }) => {
+      const value = format === "unix" ? String(Date.now()) : (/* @__PURE__ */ new Date()).toISOString();
+      return text(value);
+    }
+  }),
+  envTool: toolDef({
+    name: "env",
+    description: "Returns the value of an environment variable",
+    inputSchema: {
+      key: z2.string().describe("Environment variable name")
+    },
+    handler: async ({ key }) => text(process.env[key] ?? "")
+  })
+};
+var echoTool = defineTool(tools.echoTool);
+var timestampTool = defineTool(tools.timestampTool);
+var envTool = defineTool(tools.envTool);
 
 // src/index.ts
 function createCoreServer() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@julong/mono-rele2-core",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "license": "ISC",
   "type": "module",
   "exports": {
@@ -10,7 +10,8 @@
     }
   },
   "bin": {
-    "mcp-core": "./dist/server.js"
+    "mcp-core": "./dist/server.js",
+    "mono-rele2-core": "./dist/cli.js"
   },
   "files": [
     "dist"
@@ -22,5 +23,9 @@
     "build": "tsup",
     "typecheck": "tsc --noEmit",
     "clean": "rimraf dist"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.2"
   }
 }