@moonsjs/mcp 0.0.0-stage → 0.1.1

package/dist/cli.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env bun
+import {
+  createMcpServer2
+} from "./index-1df68295.js";
+
+// src/cli.ts
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+var server = createMcpServer2({ cwd: process.cwd() });
+await server.connect(new StdioServerTransport);
+
+//# debugId=7EE8F785146C32D364756E2164756E21

package/dist/cli.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli.ts"],
+  "sourcesContent": [
+    "#!/usr/bin/env bun\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { createMcpServer } from \"./server\";\n\nconst server = createMcpServer({ cwd: process.cwd() });\nawait server.connect(new StdioServerTransport());\n"
+  ],
+  "mappings": ";;;;;;AACA;AAGA,IAAM,SAAS,iBAAgB,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC;AACrD,MAAM,OAAO,QAAQ,IAAI,oBAAsB;",
+  "debugId": "7EE8F785146C32D364756E2164756E21",
+  "names": []
+}

package/dist/index-1df68295.js

@@ -0,0 +1,116 @@
+// src/tools.ts
+import {
+  collectFns,
+  collectRoutes,
+  executeCheck
+} from "@moonsjs/cli";
+import { existsSync, readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+var CONTEXT_URL2 = "https://raw.githubusercontent.com/RamonymousDev/Moons/main/docs/ai/CONTEXT.md";
+function localContextPath(cliEntry) {
+  return join(dirname(cliEntry), "..", "docs", "ai", "CONTEXT.md");
+}
+function readLocalContext() {
+  try {
+    const entry = createRequire(import.meta.url).resolve("@moonsjs/cli");
+    const path = localContextPath(entry);
+    if (existsSync(path)) {
+      return { source: `local:${path}`, text: readFileSync(path, "utf8") };
+    }
+  } catch {}
+  return null;
+}
+async function defaultLoadContext() {
+  const local = readLocalContext();
+  if (local !== null) {
+    return local;
+  }
+  const response = await fetch(CONTEXT_URL2);
+  if (!response.ok) {
+    throw new Error(`gagal mengambil ${CONTEXT_URL2} (HTTP ${response.status})`);
+  }
+  return { source: CONTEXT_URL2, text: await response.text() };
+}
+function searchMarkdown2(text, query, limit = 20) {
+  const needle = query.trim().toLowerCase();
+  if (needle.length === 0) {
+    return [];
+  }
+  const lines = text.split(`
+`);
+  const matches = [];
+  let section = "(top)";
+  for (let index = 0;index < lines.length; index += 1) {
+    const line = lines[index];
+    const heading = /^#{1,6}\s+(.*)$/.exec(line);
+    if (heading !== null) {
+      section = (heading[1] ?? "").trim();
+    }
+    if (line.toLowerCase().includes(needle)) {
+      matches.push({ section, line: index + 1, text: line.trim() });
+      if (matches.length >= limit) {
+        break;
+      }
+    }
+  }
+  return matches;
+}
+function createTools2(options) {
+  const loadContext = options.fetchContext === undefined ? defaultLoadContext : async () => ({
+    source: CONTEXT_URL2,
+    text: await options.fetchContext()
+  });
+  let cached = null;
+  return {
+    listRoutes: () => collectRoutes(options.cwd),
+    getFnRegistry: () => Promise.resolve(collectFns(options.cwd)),
+    runCheck: () => executeCheck(options.cwd, { quiet: true }),
+    searchDocs: async (query) => {
+      if (cached === null) {
+        cached = await loadContext();
+      }
+      return { source: cached.source, query, matches: searchMarkdown2(cached.text, query) };
+    }
+  };
+}
+
+// src/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+function jsonContent(value, isError = false) {
+  return {
+    content: [{ type: "text", text: JSON.stringify(value, null, 2) }],
+    ...isError ? { isError: true } : {}
+  };
+}
+async function guard(run) {
+  try {
+    return jsonContent(await run());
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return jsonContent({ ok: false, error: message }, true);
+  }
+}
+function createMcpServer2(options) {
+  const tools = createTools2(options);
+  const server = new McpServer({ name: "moons", version: "0.1.0" });
+  server.registerTool("list_routes", {
+    description: "Route table of the Moons app (path, file, key, kind, params, layouts) — scanned, no build needed."
+  }, () => guard(() => tools.listRoutes()));
+  server.registerTool("get_fn_registry", {
+    description: "serverFn registry of the Moons app (file#export → hash, line) plus the registry map written to .moons/fn-registry.json."
+  }, () => guard(() => tools.getFnRegistry()));
+  server.registerTool("run_check", {
+    description: "Definition of done: typegen → tsc --noEmit → build client → build server. Returns { ok, steps }."
+  }, () => guard(() => tools.runCheck()));
+  server.registerTool("search_docs", {
+    description: "Search the Moons agent context pack (docs/ai/CONTEXT.md) by substring; returns matching lines with their sections.",
+    inputSchema: { query: z.string().describe("substring to search (case-insensitive)") }
+  }, ({ query }) => guard(() => tools.searchDocs(query)));
+  return server;
+}
+
+export { CONTEXT_URL2, searchMarkdown2, createTools2, createMcpServer2 };
+
+//# debugId=B9CD7705A575E8B564756E2164756E21

package/dist/index-1df68295.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/tools.ts", "../src/server.ts"],
+  "sourcesContent": [
+    "import {\n  collectFns,\n  collectRoutes,\n  executeCheck,\n  type CheckJson,\n  type FnsJson,\n  type RoutesJson,\n} from \"@moonsjs/cli\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { dirname, join } from \"node:path\";\n\n/** Sumber teks konteks framework (default: lokal dulu, lalu GitHub raw). */\nexport type ContextFetcher = () => Promise<string>;\n\nexport const CONTEXT_URL =\n  \"https://raw.githubusercontent.com/RamonymousDev/Moons/main/docs/ai/CONTEXT.md\";\n\n/** Path konteks offline di paket `@moonsjs/cli`, dari entry yang di-resolve. */\nexport function localContextPath(cliEntry: string): string {\n  return join(dirname(cliEntry), \"..\", \"docs\", \"ai\", \"CONTEXT.md\");\n}\n\nfunction readLocalContext(): { source: string; text: string } | null {\n  try {\n    const entry = createRequire(import.meta.url).resolve(\"@moonsjs/cli\");\n    const path = localContextPath(entry);\n    if (existsSync(path)) {\n      return { source: `local:${path}`, text: readFileSync(path, \"utf8\") };\n    }\n  } catch {\n    // fallthrough ke remote\n  }\n  return null;\n}\n\nasync function defaultLoadContext(): Promise<{ source: string; text: string }> {\n  const local = readLocalContext();\n  if (local !== null) {\n    return local;\n  }\n  const response = await fetch(CONTEXT_URL);\n  if (!response.ok) {\n    throw new Error(`gagal mengambil ${CONTEXT_URL} (HTTP ${response.status})`);\n  }\n  return { source: CONTEXT_URL, text: await response.text() };\n}\n\nexport interface DocMatch {\n  /** Judul section terakhir sebelum baris ini. */\n  section: string;\n  /** Nomor baris (1-based) di CONTEXT.md. */\n  line: number;\n  text: string;\n}\n\nexport interface SearchDocsResult {\n  source: string;\n  query: string;\n  matches: DocMatch[];\n}\n\nexport interface Toolset {\n  listRoutes: () => Promise<RoutesJson>;\n  getFnRegistry: () => Promise<FnsJson>;\n  runCheck: () => Promise<CheckJson>;\n  searchDocs: (query: string) => Promise<SearchDocsResult>;\n}\n\nexport interface ToolsetOptions {\n  cwd: string;\n  fetchContext?: ContextFetcher;\n}\n\n/** Pencarian substring case-insensitive atas markdown; returns baris + section. */\nexport function searchMarkdown(text: string, query: string, limit = 20): DocMatch[] {\n  const needle = query.trim().toLowerCase();\n  if (needle.length === 0) {\n    return [];\n  }\n\n  const lines = text.split(\"\\n\");\n  const matches: DocMatch[] = [];\n  let section = \"(top)\";\n\n  for (let index = 0; index < lines.length; index += 1) {\n    const line = lines[index] as string;\n    const heading = /^#{1,6}\\s+(.*)$/.exec(line);\n    if (heading !== null) {\n      section = (heading[1] ?? \"\").trim();\n    }\n    if (line.toLowerCase().includes(needle)) {\n      matches.push({ section, line: index + 1, text: line.trim() });\n      if (matches.length >= limit) {\n        break;\n      }\n    }\n  }\n\n  return matches;\n}\n\n/** Toolset MCP (Addendum A.7) — deterministik, tanpa panggilan LLM. */\nexport function createTools(options: ToolsetOptions): Toolset {\n  const loadContext =\n    options.fetchContext === undefined\n      ? defaultLoadContext\n      : async (): Promise<{ source: string; text: string }> => ({\n          source: CONTEXT_URL,\n          text: await (options.fetchContext as ContextFetcher)(),\n        });\n  let cached: { source: string; text: string } | null = null;\n\n  return {\n    listRoutes: () => collectRoutes(options.cwd),\n    getFnRegistry: () => Promise.resolve(collectFns(options.cwd)),\n    runCheck: () => executeCheck(options.cwd, { quiet: true }),\n    searchDocs: async (query: string): Promise<SearchDocsResult> => {\n      if (cached === null) {\n        cached = await loadContext();\n      }\n      return { source: cached.source, query, matches: searchMarkdown(cached.text, query) };\n    },\n  };\n}\n",
+    "import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport { createTools, type ToolsetOptions } from \"./tools\";\n\nfunction jsonContent(value: unknown, isError = false): {\n  content: Array<{ type: \"text\"; text: string }>;\n  isError?: boolean;\n} {\n  return {\n    content: [{ type: \"text\", text: JSON.stringify(value, null, 2) }],\n    ...(isError ? { isError: true } : {}),\n  };\n}\n\nasync function guard(\n  run: () => Promise<unknown>,\n): Promise<{ content: Array<{ type: \"text\"; text: string }>; isError?: boolean }> {\n  try {\n    return jsonContent(await run());\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    return jsonContent({ ok: false, error: message }, true);\n  }\n}\n\n/** Bangun MCP server `moons` (stdio) untuk satu project (Addendum A.7). */\nexport function createMcpServer(options: ToolsetOptions): McpServer {\n  const tools = createTools(options);\n  const server = new McpServer({ name: \"moons\", version: \"0.1.0\" });\n\n  server.registerTool(\n    \"list_routes\",\n    {\n      description:\n        \"Route table of the Moons app (path, file, key, kind, params, layouts) — scanned, no build needed.\",\n    },\n    () => guard(() => tools.listRoutes()),\n  );\n\n  server.registerTool(\n    \"get_fn_registry\",\n    {\n      description:\n        \"serverFn registry of the Moons app (file#export → hash, line) plus the registry map written to .moons/fn-registry.json.\",\n    },\n    () => guard(() => tools.getFnRegistry()),\n  );\n\n  server.registerTool(\n    \"run_check\",\n    {\n      description:\n        \"Definition of done: typegen → tsc --noEmit → build client → build server. Returns { ok, steps }.\",\n    },\n    () => guard(() => tools.runCheck()),\n  );\n\n  server.registerTool(\n    \"search_docs\",\n    {\n      description:\n        \"Search the Moons agent context pack (docs/ai/CONTEXT.md) by substring; returns matching lines with their sections.\",\n      inputSchema: { query: z.string().describe(\"substring to search (case-insensitive)\") },\n    },\n    ({ query }) => guard(() => tools.searchDocs(query)),\n  );\n\n  return server;\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "B9CD7705A575E8B564756E2164756E21",
+  "names": []
+}

package/dist/index.js

@@ -0,0 +1,14 @@
+import {
+  CONTEXT_URL2,
+  searchMarkdown2,
+  createTools2,
+  createMcpServer2
+} from "./index-1df68295.js";
+export {
+  CONTEXT_URL2 as CONTEXT_URL,
+  createMcpServer2 as createMcpServer,
+  createTools2 as createTools,
+  searchMarkdown2 as searchMarkdown
+};
+
+//# debugId=D02D2DA632CDA0F864756E2164756E21

package/dist/index.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "D02D2DA632CDA0F864756E2164756E21",
+  "names": []
+}

package/package.json

@@ -1,6 +1,44 @@
 {
   "name": "@moonsjs/mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "type": "module",
+  "license": "MIT",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RamonymousDev/Moons.git",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://github.com/RamonymousDev/Moons#readme",
+  "bugs": {
+    "url": "https://github.com/RamonymousDev/Moons/issues"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "bin": {
+    "moons-mcp": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "bun": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "prepack": "bun run build",
+    "build": "rm -rf dist && tsc -p tsconfig.json --emitDeclarationOnly && bun build src/index.ts src/cli.ts --outdir dist --target node --format esm --splitting --sourcemap=external --external @moonsjs/cli --external '@moonsjs/cli/*' --external @moonsjs/core --external '@moonsjs/core/*' --external @modelcontextprotocol/sdk --external '@modelcontextprotocol/sdk/*' --external zod"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "@moonsjs/cli": "^0.1.0",
+    "@moonsjs/core": "^0.1.0",
+    "zod": "^4.6.7"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.4.3",
+    "typescript": "^7.0.2"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env bun
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createMcpServer } from "./server";
+
+const server = createMcpServer({ cwd: process.cwd() });
+await server.connect(new StdioServerTransport());

package/src/ctx-fallback.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Fallback global `Ctx` untuk kompilasi mandiri package ini.
+ * Aplikasi memakai deklarasi hasil typegen (§13: `.moons/context.d.ts`).
+ */
+declare global {
+  type Ctx = unknown;
+}
+
+export {};

package/src/index.ts

@@ -0,0 +1,9 @@
+export { createTools, searchMarkdown, CONTEXT_URL } from "./tools";
+export type {
+  ContextFetcher,
+  DocMatch,
+  SearchDocsResult,
+  Toolset,
+  ToolsetOptions,
+} from "./tools";
+export { createMcpServer } from "./server";

package/src/server.ts

@@ -0,0 +1,69 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { createTools, type ToolsetOptions } from "./tools";
+
+function jsonContent(value: unknown, isError = false): {
+  content: Array<{ type: "text"; text: string }>;
+  isError?: boolean;
+} {
+  return {
+    content: [{ type: "text", text: JSON.stringify(value, null, 2) }],
+    ...(isError ? { isError: true } : {}),
+  };
+}
+
+async function guard(
+  run: () => Promise<unknown>,
+): Promise<{ content: Array<{ type: "text"; text: string }>; isError?: boolean }> {
+  try {
+    return jsonContent(await run());
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return jsonContent({ ok: false, error: message }, true);
+  }
+}
+
+/** Bangun MCP server `moons` (stdio) untuk satu project (Addendum A.7). */
+export function createMcpServer(options: ToolsetOptions): McpServer {
+  const tools = createTools(options);
+  const server = new McpServer({ name: "moons", version: "0.1.0" });
+
+  server.registerTool(
+    "list_routes",
+    {
+      description:
+        "Route table of the Moons app (path, file, key, kind, params, layouts) — scanned, no build needed.",
+    },
+    () => guard(() => tools.listRoutes()),
+  );
+
+  server.registerTool(
+    "get_fn_registry",
+    {
+      description:
+        "serverFn registry of the Moons app (file#export → hash, line) plus the registry map written to .moons/fn-registry.json.",
+    },
+    () => guard(() => tools.getFnRegistry()),
+  );
+
+  server.registerTool(
+    "run_check",
+    {
+      description:
+        "Definition of done: typegen → tsc --noEmit → build client → build server. Returns { ok, steps }.",
+    },
+    () => guard(() => tools.runCheck()),
+  );
+
+  server.registerTool(
+    "search_docs",
+    {
+      description:
+        "Search the Moons agent context pack (docs/ai/CONTEXT.md) by substring; returns matching lines with their sections.",
+      inputSchema: { query: z.string().describe("substring to search (case-insensitive)") },
+    },
+    ({ query }) => guard(() => tools.searchDocs(query)),
+  );
+
+  return server;
+}

package/src/tools.ts

@@ -0,0 +1,125 @@
+import {
+  collectFns,
+  collectRoutes,
+  executeCheck,
+  type CheckJson,
+  type FnsJson,
+  type RoutesJson,
+} from "@moonsjs/cli";
+import { existsSync, readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+
+/** Sumber teks konteks framework (default: lokal dulu, lalu GitHub raw). */
+export type ContextFetcher = () => Promise<string>;
+
+export const CONTEXT_URL =
+  "https://raw.githubusercontent.com/RamonymousDev/Moons/main/docs/ai/CONTEXT.md";
+
+/** Path konteks offline di paket `@moonsjs/cli`, dari entry yang di-resolve. */
+export function localContextPath(cliEntry: string): string {
+  return join(dirname(cliEntry), "..", "docs", "ai", "CONTEXT.md");
+}
+
+function readLocalContext(): { source: string; text: string } | null {
+  try {
+    const entry = createRequire(import.meta.url).resolve("@moonsjs/cli");
+    const path = localContextPath(entry);
+    if (existsSync(path)) {
+      return { source: `local:${path}`, text: readFileSync(path, "utf8") };
+    }
+  } catch {
+    // fallthrough ke remote
+  }
+  return null;
+}
+
+async function defaultLoadContext(): Promise<{ source: string; text: string }> {
+  const local = readLocalContext();
+  if (local !== null) {
+    return local;
+  }
+  const response = await fetch(CONTEXT_URL);
+  if (!response.ok) {
+    throw new Error(`gagal mengambil ${CONTEXT_URL} (HTTP ${response.status})`);
+  }
+  return { source: CONTEXT_URL, text: await response.text() };
+}
+
+export interface DocMatch {
+  /** Judul section terakhir sebelum baris ini. */
+  section: string;
+  /** Nomor baris (1-based) di CONTEXT.md. */
+  line: number;
+  text: string;
+}
+
+export interface SearchDocsResult {
+  source: string;
+  query: string;
+  matches: DocMatch[];
+}
+
+export interface Toolset {
+  listRoutes: () => Promise<RoutesJson>;
+  getFnRegistry: () => Promise<FnsJson>;
+  runCheck: () => Promise<CheckJson>;
+  searchDocs: (query: string) => Promise<SearchDocsResult>;
+}
+
+export interface ToolsetOptions {
+  cwd: string;
+  fetchContext?: ContextFetcher;
+}
+
+/** Pencarian substring case-insensitive atas markdown; returns baris + section. */
+export function searchMarkdown(text: string, query: string, limit = 20): DocMatch[] {
+  const needle = query.trim().toLowerCase();
+  if (needle.length === 0) {
+    return [];
+  }
+
+  const lines = text.split("\n");
+  const matches: DocMatch[] = [];
+  let section = "(top)";
+
+  for (let index = 0; index < lines.length; index += 1) {
+    const line = lines[index] as string;
+    const heading = /^#{1,6}\s+(.*)$/.exec(line);
+    if (heading !== null) {
+      section = (heading[1] ?? "").trim();
+    }
+    if (line.toLowerCase().includes(needle)) {
+      matches.push({ section, line: index + 1, text: line.trim() });
+      if (matches.length >= limit) {
+        break;
+      }
+    }
+  }
+
+  return matches;
+}
+
+/** Toolset MCP (Addendum A.7) — deterministik, tanpa panggilan LLM. */
+export function createTools(options: ToolsetOptions): Toolset {
+  const loadContext =
+    options.fetchContext === undefined
+      ? defaultLoadContext
+      : async (): Promise<{ source: string; text: string }> => ({
+          source: CONTEXT_URL,
+          text: await (options.fetchContext as ContextFetcher)(),
+        });
+  let cached: { source: string; text: string } | null = null;
+
+  return {
+    listRoutes: () => collectRoutes(options.cwd),
+    getFnRegistry: () => Promise.resolve(collectFns(options.cwd)),
+    runCheck: () => executeCheck(options.cwd, { quiet: true }),
+    searchDocs: async (query: string): Promise<SearchDocsResult> => {
+      if (cached === null) {
+        cached = await loadContext();
+      }
+      return { source: cached.source, query, matches: searchMarkdown(cached.text, query) };
+    },
+  };
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.