@jsswift/knowledge-mcp 0.1.5 → 0.1.7

package/dist/server.mjs

@@ -116,10 +116,25 @@ async function loadKnowledge(root = defaultRoot) {
       }).filter((entry) => entry.score > 0).sort((a, b) => b.score - a.score || a.id.localeCompare(b.id));
       return ranked.slice(0, limit);
     },
-    async read(id) {
+    async read(id, selection = {}) {
       const entry = entries.get(id);
       if (!entry) throw new Error("Unknown document ID; use jsswift_search to find a documented ID");
-      return { id, path: entry.path, text: await readFile(await safePath(entry.path), "utf8") };
+      const text = await readFile(await safePath(entry.path), "utf8");
+      if (selection.keys && !selection.section) throw new Error("keys requires a section");
+      if (!selection.section) return { id, path: entry.path, text };
+      if (entry.kind !== "component" || !["props", "events", "methods", "slots"].includes(selection.section)) throw new Error("Select a component contract section");
+      const metadata = JSON.parse(text.match(/```json\s*([\s\S]*?)```/)[1]);
+      let values = { ...metadata[selection.section] ?? {} };
+      if (selection.section === "props" && metadata.commonProps) {
+        const sharedText = await readFile(await safePath(metadata.commonProps.path), "utf8");
+        const shared = JSON.parse(sharedText.match(/```json\s*([\s\S]*?)```/)[1]);
+        values = { ...Object.fromEntries(metadata.commonProps.keys.map((key) => [key, shared.props[key]])), ...values };
+      }
+      if (selection.keys) {
+        if (!Array.isArray(selection.keys) || !selection.keys.length || selection.keys.length > 30 || selection.keys.some((key) => typeof key !== "string" || !Object.hasOwn(values, key))) throw new Error("Unknown or invalid contract keys");
+        values = Object.fromEntries(selection.keys.map((key) => [key, values[key]]));
+      }
+      return { id, path: entry.path, section: selection.section, text: JSON.stringify({ signature: metadata.signature, [selection.section]: values }, null, 2) };
     }
   };
 }
@@ -174,14 +189,14 @@ server.registerTool("jsswift_search", {
 }, async ({ query, limit }) => jsonResult({ project: context.project, version: context.version, results: knowledge.search(query, limit) }));
 server.registerTool("jsswift_read", {
   title: "Read a JSswift guide or exact component contract",
-  description: "Read one complete indexed application document using its ID from jsswift_search or the resource list. Does not accept filesystem paths.",
-  inputSchema: z.object({ id: z.string().min(1).max(200) }),
+  description: "Read an indexed document, or only a component section and named keys. Prefer section/keys for missing APIs; inherited props are resolved. Does not accept filesystem paths.",
+  inputSchema: z.object({ id: z.string().min(1).max(200), section: z.enum(["props", "events", "methods", "slots"]).optional(), keys: z.array(z.string().min(1).max(100)).min(1).max(30).optional() }),
   annotations
-}, async ({ id }) => {
+}, async ({ id, section, keys }) => {
   try {
-    return jsonResult({ project: context.project, version: context.version, ...await knowledge.read(id) });
+    return jsonResult({ project: context.project, version: context.version, ...await knowledge.read(id, { section, keys }) });
   } catch {
-    return { isError: true, content: [{ type: "text", text: "Document unavailable or unknown ID. Use jsswift_search to select an indexed document." }] };
+    return { isError: true, content: [{ type: "text", text: "Document, section or keys unavailable. Use jsswift_search to select a document; omit section/keys for the full contract." }] };
   }
 });
 server.registerResource("knowledge-map", "jsswift://knowledge/map", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsswift/knowledge-mcp",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Read-only MCP for the installed JSswift version's documentation",
   "type": "module",
   "engines": {