@emseepea/create-resources-and-prompts-server 0.0.2 → 0.0.4

package/README.md

@@ -1,22 +1,63 @@
 # `@emseepea/create-resources-and-prompts-server`
 
-Create a private, standalone Em See Pea project with resources and prompts.
-The package builds its starter from the maintained
-[resources and prompts example](https://github.com/emseepea/emseepea/tree/main/examples/resources-prompts).
+This directory is both the maintained example and its public npm initializer.
 
-## Create the Project
+## Use This Template
 
-This initializer is queued for the next pre-alpha release and is not yet
-available from npm.
+Use this template to publish readable resources, parameterized resource
+addresses, reusable prompts, and prompt-field suggestions. Choose the
+[tool server](../tool-server/README.md) when the model needs to call an
+operation instead of reading material or rendering a prompt. [Compare all eight templates](https://emseepea.github.io/emseepea/examples/).
+
+## Create a Project
 
 ```sh
-npm init @emseepea/resources-and-prompts-server@next -- my-server
+npm init @emseepea/resources-and-prompts-server -- my-server
 ```
 
+<!-- generated-project-readme -->
+
+## Resources and Prompts Example
+
+Choose this example when you want to give an assistant reusable reference
+content and guided starting questions, without adding another tool.
+
+It provides:
+
+- a fixed resource at one known address
+- a resource pattern for related content at predictable addresses
+- a reusable prompt with one checked argument
+- optional suggestions for the resource and prompt fields
+
+## Run
+
+From this directory:
+
 ```sh
-cd my-server
 npm install
-npm test
-npm run lint
+npm run build
 npm start
 ```
+
+The server listens on `http://127.0.0.1:3000/mcp` by default. Set `PORT` to
+choose another port.
+
+## Check This Example
+
+[Ordinary tests](test/) live in `test/`.
+The [AI understanding test](eval/meaning.test.mjs) lives separately in `eval/`.
+The commands below run each suite independently.
+
+Run its build and MCP resource and prompt checks:
+
+```sh
+npm test
+```
+
+Check that Claude keeps sowing depth and plant spacing distinct:
+
+```sh
+npm run test:llm
+```
+
+If Claude is not already signed in, run `claude auth login` first.

package/{dist → initializer-dist}/template/README.md

@@ -35,7 +35,7 @@ Run its build and MCP resource and prompt checks:
 npm test
 ```
 
-Check that Claude keeps coffee strength and extraction distinct:
+Check that Claude keeps sowing depth and plant spacing distinct:
 
 ```sh
 npm run test:llm

package/initializer-dist/template/eval/meaning.test.mjs

@@ -0,0 +1,25 @@
+import assert from "node:assert/strict";
+import { semanticTest } from "@emseepea/testing/semantic";
+
+semanticTest("Sowing depth and plant spacing remain separate concepts", {
+  server: new URL("../dist/server.js", import.meta.url),
+  question:
+    "If I sow pea seeds deeper, should I also space the plants farther apart? " +
+    "Explain the distinction for a home gardener.",
+  criticalFacts: [
+    "sowing depth",
+    "plant spacing"
+  ],
+  criteria:
+    "The answer says sowing peas deeper does not mean spacing the plants farther " +
+    "apart. It explains that sowing depth is how deep a seed goes while plant " +
+    "spacing is the gap between plants, and it does not treat the measurements as " +
+    "interchangeable.",
+  requiredPaths: ["resources/read:guide://peas/getting-started","prompts/get:growing-guide"],
+  async exercise(client) {
+    const result1 = await client.readResource({"uri":"guide://peas/getting-started"});
+    assert.ok(result1);
+    const result2 = await client.getPrompt({"name":"growing-guide","arguments":{"topic":"sowing-depth"}});
+    assert.ok(result2);
+  },
+});

package/{dist → initializer-dist}/template/package.json

@@ -1,7 +1,7 @@
 {
   "name": "emseepea-starter",
   "version": "0.0.0",
-  "private": true,
+  "description": "Create an Em See Pea server with resources and prompts.",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -13,17 +13,18 @@
     "test:llm:built": "emseepea-test eval",
     "lint": "oxlint src test eval"
   },
-  "dependencies": {
-    "@emseepea/server": "0.1.0",
-    "zod": "4.4.3"
-  },
   "devDependencies": {
-    "@emseepea/testing": "0.2.1",
+    "@emseepea/testing": "0.2.2",
     "@types/node": "24.13.3",
     "typescript": "6.0.3",
     "oxlint": "1.80.0"
   },
   "engines": {
     "node": ">=22"
+  },
+  "private": true,
+  "dependencies": {
+    "@emseepea/server": "0.2.2",
+    "zod": "4.4.3"
   }
 }

package/{dist/template/src/capabilities/prompt.brew-guide.ts → initializer-dist/template/src/capabilities/prompt.growing-guide.ts}

@@ -1,12 +1,12 @@
 import { definePrompt, type CapabilityModuleFactory } from "@emseepea/server";
 import { z } from "zod";
 
-const topics = ["brew-ratio", "grind-size", "water-temperature"];
+const topics = ["sowing-depth", "plant-spacing", "trellis-support"];
 
 export default (() => definePrompt({
-  name: "brew-guide",
-  title: "Brew guide",
-  description: "Create a prompt for a sample brewing topic.",
+  name: "growing-guide",
+  title: "Pea growing guide",
+  description: "Create a prompt for a sample pea-growing topic.",
   argsSchema: z.object({ topic: z.string().min(1) }),
   complete: {
     topic: (value) => topics.filter((topic) => topic.startsWith(value)),
@@ -17,7 +17,7 @@ export default (() => definePrompt({
       role: "user",
       content: {
         type: "text",
-        text: `Explain ${topic} for a home brewer. Distinguish any commonly confused concepts.`,
+        text: `Explain ${topic} for a home gardener. Distinguish any commonly confused concepts.`,
       },
     }],
   }),

package/{dist → initializer-dist}/template/src/capabilities/resource.getting-started.ts

@@ -1,18 +1,18 @@
 import { defineResource, type CapabilityModuleFactory } from "@emseepea/server";
 
-const guideUri = "guide://coffee/getting-started";
+const guideUri = "guide://peas/getting-started";
 
 export default (() => defineResource({
   name: "getting-started",
   uri: guideUri,
-  title: "Coffee getting started",
+  title: "Pea growing: getting started",
   description: "A sample guide exposed as an MCP resource.",
   mimeType: "text/markdown",
   handler: () => ({
     contents: [{
       uri: guideUri,
       mimeType: "text/markdown",
-      text: "# Brew clearly\n\nStrength is concentration; extraction is how much material left the grounds. They are related, but not interchangeable.\n",
+      text: "# Plant peas clearly\n\nSowing depth is how deep a seed goes; plant spacing is the gap between plants. They are separate choices, not interchangeable measurements.\n",
     }],
   }),
 })) satisfies CapabilityModuleFactory;

package/{dist/template/src/capabilities/resource.method-guide.ts → initializer-dist/template/src/capabilities/resource.planting-guide.ts}

@@ -1,12 +1,12 @@
 import { defineResourceTemplate, type CapabilityModuleFactory } from "@emseepea/server";
 
-const methods = ["aeropress", "espresso", "pour-over"];
+const methods = ["container", "raised-bed", "row"];
 
 export default (() => defineResourceTemplate({
-  name: "method-guide",
-  uriTemplate: "guide://coffee/method/{method}",
-  title: "Coffee method guide",
-  description: "A sample guide selected by brewing method.",
+  name: "planting-guide",
+  uriTemplate: "guide://peas/planting/{method}",
+  title: "Pea planting guide",
+  description: "A sample guide selected by planting method.",
   mimeType: "text/markdown",
   complete: {
     method: (value) => methods.filter((method) => method.startsWith(value)),

package/{dist → initializer-dist}/template/src/server.ts

@@ -5,7 +5,7 @@ import {
 } from "@emseepea/server";
 
 const running = await serveEmseepea(createEmseepea({
-  name: "emseepea-resources-prompts",
+  name: "emseepea-resources-and-prompts-server",
   version: "0.0.0",
   ...await discoverCapabilities(new URL("./capabilities/", import.meta.url)),
 }), { port: Number.parseInt(process.env.PORT ?? "3000", 10) });

package/{dist → initializer-dist}/template/test/server.test.mjs

@@ -8,16 +8,16 @@ test("lists and reads the advertised resource and prompt", async (t) => {
   const client = await running.connect();
 
   assert.deepEqual((await client.listResources()).resources.map(({ uri }) => uri), [
-    "guide://coffee/getting-started",
+    "guide://peas/getting-started",
   ]);
-  const resource = await client.readResource({ uri: "guide://coffee/getting-started" });
-  assert.match(resource.contents[0].text, /Strength is concentration/);
-  assert.match(resource.contents[0].text, /extraction is how much material left the grounds/);
+  const resource = await client.readResource({ uri: "guide://peas/getting-started" });
+  assert.match(resource.contents[0].text, /Sowing depth is how deep a seed goes/);
+  assert.match(resource.contents[0].text, /plant spacing is the gap between plants/);
 
-  assert.deepEqual((await client.listPrompts()).prompts.map(({ name }) => name), ["brew-guide"]);
+  assert.deepEqual((await client.listPrompts()).prompts.map(({ name }) => name), ["growing-guide"]);
   const prompt = await client.getPrompt({
-    name: "brew-guide",
-    arguments: { topic: "brew-ratio" },
+    name: "growing-guide",
+    arguments: { topic: "sowing-depth" },
   });
-  assert.match(prompt.messages[0].content.text, /Explain brew-ratio/);
+  assert.match(prompt.messages[0].content.text, /Explain sowing-depth/);
 });

package/package.json

@@ -1,22 +1,37 @@
 {
   "name": "@emseepea/create-resources-and-prompts-server",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Create an Em See Pea server with resources and prompts.",
   "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/emseepea/emseepea.git",
-    "directory": "packages/create-resources-and-prompts-server"
-  },
-  "homepage": "https://emseepea.github.io/emseepea/examples/",
-  "bugs": "https://github.com/emseepea/emseepea/issues",
-  "publishConfig": { "access": "public", "provenance": true, "tag": "next" },
   "type": "module",
-  "bin": { "create-resources-and-prompts-server": "./dist/create.mjs" },
-  "files": ["dist"],
+  "starterDependencies": ["@emseepea/server", "zod"],
   "scripts": {
-    "build": "node ../../scripts/build-initializer.mjs",
-    "prepack": "npm run build"
+    "build": "npm run build:example && npm run build:initializer",
+    "build:example": "tsc -p tsconfig.json",
+    "build:initializer": "node ../../scripts/build-initializer.mjs",
+    "start": "node dist/server.js",
+    "test": "npm run build && npm run test:built",
+    "test:built": "node --test test/*.test.mjs",
+    "test:llm": "npm run build && npm run test:llm:built",
+    "test:llm:built": "emseepea-test eval",
+    "lint": "oxlint src test eval",
+    "prepack": "npm run build:initializer"
+  },
+  "devDependencies": {
+    "@emseepea/server": "0.2.2",
+    "zod": "4.4.3",
+    "@emseepea/testing": "0.2.2",
+    "@types/node": "24.13.3",
+    "typescript": "6.0.3",
+    "oxlint": "1.80.0"
   },
-  "engines": { "node": ">=22" }
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": { "type": "git", "url": "git+https://github.com/emseepea/emseepea.git", "directory": "examples/resources-and-prompts-server" },
+  "homepage": "https://emseepea.github.io/emseepea/examples/",
+  "bugs": "https://github.com/emseepea/emseepea/issues",
+  "publishConfig": { "access": "public", "provenance": true },
+  "bin": { "create-resources-and-prompts-server": "./initializer-dist/create.mjs" },
+  "files": ["initializer-dist"]
 }

package/dist/template/eval/meaning.test.mjs

@@ -1,25 +0,0 @@
-import assert from "node:assert/strict";
-import { semanticTest } from "@emseepea/testing/semantic";
-
-semanticTest("Strength and extraction remain separate concepts", {
-  server: new URL("../dist/server.js", import.meta.url),
-  question:
-    "Does making coffee stronger necessarily mean that extraction is higher? " +
-    "Explain the distinction for a home brewer.",
-  criticalFacts: [
-    "concentration",
-    "extraction"
-  ],
-  criteria:
-    "The answer says stronger coffee does not necessarily mean higher extraction. " +
-    "It explains that strength is concentration while extraction is how much " +
-    "material left the grounds, and it does not describe the concepts as " +
-    "interchangeable.",
-  requiredPaths: ["resources/read:guide://coffee/getting-started","prompts/get:brew-guide"],
-  async exercise(client) {
-    const result1 = await client.readResource({"uri":"guide://coffee/getting-started"});
-    assert.ok(result1);
-    const result2 = await client.getPrompt({"name":"brew-guide","arguments":{"topic":"brew-ratio"}});
-    assert.ok(result2);
-  },
-});