@outfitter/presets 0.2.0 → 0.3.0

package/presets/mcp/README.md.template

@@ -4,26 +4,28 @@
 
 MCP (Model Context Protocol) server for integration with AI assistants.
 
-## Installation
-
-```bash
-bun add {{packageName}}
-```
-
-## Usage with Claude Desktop
+## Claude Desktop Configuration
 
 Add to your Claude Desktop config:
 
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
 ```json
 {
   "mcpServers": {
-    "{{binName}}": {
-      "command": "{{binName}}"
+    "{{projectName}}": {
+      "command": "bun",
+      "args": ["run", "/absolute/path/to/{{projectName}}/src/server.ts"]
     }
   }
 }
 ```
 
+Replace `/absolute/path/to/` with the actual path to your project directory.
+
+> **Note:** On macOS, `bun` may not be on Claude Desktop's PATH. If the server fails to start, replace `"bun"` with the full path (e.g., `"/Users/you/.bun/bin/bun"` — run `which bun` to find it).
+
 ## Available Tools
 
 ### hello
@@ -31,6 +33,7 @@ Add to your Claude Desktop config:
 Say hello to someone.
 
 **Parameters:**
+
 - `name` (string, optional): Name to greet. Default: "World"
 
 ## Development

package/presets/mcp/package.json.template

@@ -1,46 +1,50 @@
 {
-	"name": "{{packageName}}",
-	"version": "{{version}}",
-	"description": "{{description}}",
-	"type": "module",
-	"bin": {
-		"{{binName}}": "./dist/server.js"
-	},
-	"main": "./dist/index.js",
-	"types": "./dist/index.d.ts",
-	"exports": {
-		".": {
-			"types": "./dist/index.d.ts",
-			"import": "./dist/index.js"
-		}
-	},
-	"scripts": {
-		"build": "bun build src/server.ts --outdir dist --target bun && bun build src/index.ts --outdir dist --target bun --sourcemap",
-		"dev": "bun --watch src/server.ts",
-		"typecheck": "tsc --noEmit",
-		"check": "ultracite check",
-		"verify:ci": "bun run typecheck && bun run check && bun run build && bun run test",
-		"test": "bun test",
-		"test:watch": "bun test --watch",
-		"lint": "biome check .",
-		"lint:fix": "biome check . --write",
-		"format": "biome format --write .",
-		"clean:artifacts": "rm -rf dist .turbo"
-	},
-	"dependencies": {
-		"@modelcontextprotocol/sdk": "^1.12.1",
-		"@outfitter/contracts": "workspace:*",
-		"@outfitter/types": "workspace:*",
-		"@outfitter/mcp": "workspace:*",
-		"@outfitter/logging": "workspace:*"
-	},
-	"devDependencies": {},
-	"outfitter": {
-		"template": {
-			"kind": "runnable",
-			"placement": "apps",
-			"surfaces": ["mcp"]
-		}
-	},
-	"license": "MIT"
+  "name": "{{packageName}}",
+  "version": "{{version}}",
+  "description": "{{description}}",
+  "license": "MIT",
+  "bin": {
+    "{{binName}}": "./dist/server.js"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "bun build src/server.ts --outdir dist --target bun && bun build src/index.ts --outdir dist --target bun --sourcemap",
+    "dev": "bun --watch src/server.ts",
+    "typecheck": "tsc --noEmit",
+    "check": "ultracite check",
+    "verify:ci": "bun run typecheck && bun run check && bun run build && bun run test",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint --fix .",
+    "format": "oxfmt --write .",
+    "clean:artifacts": "rm -rf dist .turbo"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "catalog:",
+    "@outfitter/contracts": "workspace:*",
+    "@outfitter/mcp": "workspace:*",
+    "@outfitter/types": "workspace:*",
+    "zod": "catalog:"
+  },
+  "devDependencies": {
+    "@outfitter/testing": "workspace:*"
+  },
+  "outfitter": {
+    "template": {
+      "kind": "runnable",
+      "placement": "apps",
+      "surfaces": [
+        "mcp"
+      ]
+    }
+  }
 }

package/presets/mcp/src/index.test.ts.template

@@ -0,0 +1,49 @@
+import { describe, expect, test } from "bun:test";
+
+import { createContext } from "@outfitter/contracts";
+import { createMcpHarness } from "@outfitter/testing";
+
+import { server } from "./mcp.js";
+import { helloTool } from "./tools/hello.js";
+
+describe("server", () => {
+  test("registers the hello tool", () => {
+    const harness = createMcpHarness(server);
+    const tools = harness.listTools();
+    const registered = tools.some((tool) => tool.name === "hello");
+
+    expect(registered).toBe(true);
+  });
+
+  test("can call hello tool via harness", async () => {
+    const harness = createMcpHarness(server);
+    const result = await harness.callTool("hello", {
+      name: "Outfitter",
+    });
+
+    expect(result.isOk()).toBe(true);
+  });
+});
+
+describe("helloTool", () => {
+  test("returns greeting for valid input", async () => {
+    const ctx = createContext({ cwd: process.cwd(), env: process.env });
+    const result = await helloTool.handler({ name: "Outfitter" }, ctx);
+
+    expect(result.isOk()).toBe(true);
+    if (result.isErr()) return;
+    expect(result.value.greeting).toBe("Hello, Outfitter!");
+  });
+
+  // Direct handler invocation returns ValidationError.
+  // Via harness.callTool(), errors are wrapped as McpError by translateError().
+  test("returns error for reserved name", async () => {
+    const ctx = createContext({ cwd: process.cwd(), env: process.env });
+    const result = await helloTool.handler({ name: "error" }, ctx);
+
+    expect(result.isErr()).toBe(true);
+    if (!result.isErr()) return;
+    expect(result.error.name).toBe("ValidationError");
+    expect(result.error.message).toBe("name: reserved name not allowed");
+  });
+});

package/presets/mcp/src/index.ts.template

@@ -5,3 +5,5 @@
  */
 
 export { server, startServer } from "./mcp.js";
+export { helloTool } from "./tools/hello.js";
+export type { HelloInput, HelloOutput } from "./tools/hello.js";

package/presets/mcp/src/mcp.ts.template

@@ -3,31 +3,31 @@
  */
 
 import { Result } from "@outfitter/contracts";
-import { createMcpServer, defineTool, connectStdio } from "@outfitter/mcp";
-import { z } from "zod";
+import { createMcpServer, connectStdio, defineResource } from "@outfitter/mcp";
+
+import { helloTool } from "./tools/hello.js";
 
 const server = createMcpServer({
-	name: "{{binName}}",
-	version: "{{version}}",
+  name: "{{binName}}",
+  version: "{{version}}",
 });
 
-const helloTool = defineTool({
-	name: "hello",
-	description: "Say hello to someone",
-	inputSchema: z.object({
-		name: z.string().default("World").describe("Name to greet"),
-	}),
-	handler: async (input, ctx) => {
-		ctx.logger.info(`Greeting ${input.name}`);
-		return Result.ok({ greeting: `Hello, ${input.name}!` });
-	},
+server.registerTool(helloTool);
+
+/** Static resource exposing the server version. */
+const versionResource = defineResource({
+  uri: "info:///version",
+  name: "Server Version",
+  description: "Returns the current server version",
+  handler: async (uri, _ctx) =>
+    Result.ok([{ uri, text: JSON.stringify({ version: "{{version}}" }) }]),
 });
 
-server.registerTool(helloTool);
+server.registerResource(versionResource);
 
 export { server };
 
 /** Start the MCP server over stdio transport. */
 export async function startServer(): Promise<void> {
-	await connectStdio(server);
+  await connectStdio(server);
 }

package/presets/mcp/src/server.ts.template

@@ -3,6 +3,13 @@
  * {{projectName}} MCP server entry point
  */
 
+import { createLogger } from "@outfitter/logging";
+
 import { startServer } from "./mcp.js";
 
-startServer().catch(console.error);
+const logger = createLogger({ name: "{{binName}}" });
+
+startServer().catch((error: unknown) => {
+  logger.error("Server failed", { error });
+  process.exit(1);
+});

package/presets/mcp/src/tools/hello.ts.template

@@ -0,0 +1,48 @@
+/**
+ * Hello tool - demonstrates MCP tool definition with Result types.
+ */
+
+import { Result, ValidationError } from "@outfitter/contracts";
+import { defineTool } from "@outfitter/mcp";
+import { type ZodType, z } from "zod";
+
+/** Input for the hello tool. */
+export interface HelloInput {
+  readonly name: string;
+}
+
+/** Zod schema for hello tool input validation. */
+export const helloInputSchema: ZodType<HelloInput> = z.object({
+  name: z.string().min(1, "name must not be empty").describe("Name to greet"),
+});
+
+/** Output from the hello tool. */
+export interface HelloOutput {
+  readonly greeting: string;
+}
+
+/** Tool that greets a user by name. */
+export const helloTool = defineTool({
+  name: "hello",
+  description: "Say hello to someone",
+  inputSchema: helloInputSchema,
+  annotations: {
+    readOnlyHint: true,
+    openWorldHint: false,
+  },
+  handler: async (
+    input,
+    _ctx
+  ): Promise<Result<HelloOutput, ValidationError>> => {
+    // Demonstrate Result.err() for business logic errors
+    if (input.name.toLowerCase() === "error") {
+      return Result.err(
+        ValidationError.create("name", "reserved name not allowed", {
+          reserved: ["error"],
+        })
+      );
+    }
+
+    return Result.ok({ greeting: `Hello, ${input.name}!` });
+  },
+});

package/presets/mcp/tsconfig.json.template

@@ -1,23 +1,23 @@
 {
-	"compilerOptions": {
-		"target": "ESNext",
-		"module": "ESNext",
-		"moduleResolution": "bundler",
-		"strict": true,
-		"esModuleInterop": true,
-		"verbatimModuleSyntax": true,
-		"skipLibCheck": true,
-		"declaration": true,
-		"declarationDir": "dist",
-		"outDir": "dist",
-		"rootDir": "src",
-		"types": ["bun-types"],
-		"noImplicitAny": true,
-		"strictNullChecks": true,
-		"noUncheckedIndexedAccess": true,
-		"exactOptionalPropertyTypes": true,
-		"noPropertyAccessFromIndexSignature": true
-	},
-	"include": ["src"],
-	"exclude": ["node_modules", "dist"]
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "verbatimModuleSyntax": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationDir": "dist",
+    "outDir": "dist",
+    "rootDir": "src",
+    "types": ["bun-types"],
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "noPropertyAccessFromIndexSignature": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist"]
 }

package/presets/minimal/.lefthook.yml.template

@@ -6,12 +6,12 @@ pre-commit:
   commands:
     format:
       glob: "*.{js,ts,tsx,json,md}"
-      run: bunx biome format --no-errors-on-unmatched {staged_files}
+      run: bunx oxfmt --write {staged_files}
       stage_fixed: true
 
     lint:
       glob: "*.{js,ts,tsx}"
-      run: bunx biome lint --no-errors-on-unmatched {staged_files}
+      run: bunx oxlint {staged_files}
 
     typecheck:
       glob: "*.{ts,tsx}"

package/presets/minimal/README.md.template

@@ -0,0 +1,22 @@
+# {{projectName}}
+
+{{description}}
+
+## Quick Start
+
+```bash
+bun install
+bun run dev
+```
+
+## Scripts
+
+```bash
+bun test          # Run tests
+bun run build     # Build
+bun run typecheck # Type checking
+```
+
+## License
+
+MIT

package/presets/minimal/package.json.template

@@ -1,46 +1,49 @@
 {
-	"name": "{{packageName}}",
-	"version": "{{version}}",
-	"description": "{{description}}",
-	"type": "module",
-	"main": "./dist/index.js",
-	"types": "./dist/index.d.ts",
-	"files": [
-		"dist"
-	],
-	"exports": {
-		".": {
-			"import": {
-				"types": "./dist/index.d.ts",
-				"default": "./dist/index.js"
-			}
-		}
-	},
-	"scripts": {
-		"build": "bun build ./src/index.ts --outdir=dist --format=esm",
-		"dev": "bun run --watch src/index.ts",
-		"test": "bun test",
-		"test:watch": "bun test --watch",
-		"typecheck": "tsc --noEmit",
-		"check": "ultracite check",
-		"verify:ci": "bun run typecheck && bun run check && bun run build && bun run test",
-		"lint": "biome check .",
-		"lint:fix": "biome check . --write",
-		"format": "biome format --write .",
-		"clean:artifacts": "rm -rf dist .turbo",
-		"clean": "rm -rf dist"
-	},
-	"devDependencies": {},
-	"outfitter": {
-		"template": {
-			"kind": "library",
-			"placement": "packages",
-			"surfaces": []
-		}
-	},
-	"engines": {
-		"bun": ">=1.3.9"
-	},
-	"keywords": [],
-	"license": "MIT"
+  "name": "{{packageName}}",
+  "version": "{{version}}",
+  "description": "{{description}}",
+  "keywords": [],
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir=dist --format=esm && tsc --emitDeclarationOnly",
+    "dev": "bun run --watch src/index.ts",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "typecheck": "tsc --noEmit",
+    "check": "ultracite check",
+    "verify:ci": "bun run typecheck && bun run check && bun run build && bun run test",
+    "lint": "oxlint .",
+    "lint:fix": "oxlint --fix .",
+    "format": "oxfmt --write .",
+    "clean:artifacts": "rm -rf dist .turbo",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@outfitter/contracts": "workspace:*"
+  },
+  "devDependencies": {},
+  "engines": {
+    "bun": ">=1.3.10"
+  },
+  "outfitter": {
+    "template": {
+      "kind": "library",
+      "placement": "packages",
+      "surfaces": []
+    }
+  }
 }

package/presets/minimal/src/index.test.ts.template

@@ -0,0 +1,19 @@
+import { describe, expect, test } from "bun:test";
+
+import { greet } from "./index.js";
+
+describe("greet", () => {
+  test("returns greeting for valid name", () => {
+    const result = greet("World");
+
+    expect(result.isOk()).toBe(true);
+    if (result.isErr()) return;
+    expect(result.value.message).toBe("Hello, World!");
+  });
+
+  test("returns error for empty name", () => {
+    const result = greet("");
+
+    expect(result.isErr()).toBe(true);
+  });
+});

package/presets/minimal/src/index.ts.template

@@ -6,21 +6,16 @@
  * @packageDocumentation
  */
 
-/**
- * Main entry point for {{projectName}}.
- *
- * @example
- * ```typescript
- * import { main } from "{{packageName}}";
- *
- * main();
- * ```
- */
-export function main(): void {
-	console.log("Hello from {{projectName}}!");
+import { Result } from "@outfitter/contracts";
+
+export interface Greeting {
+  readonly message: string;
 }
 
-// Run if executed directly
-if (import.meta.main) {
-	main();
+export function greet(name: string): Result<Greeting, Error> {
+  if (!name) {
+    return Result.err(new Error("name is required"));
+  }
+
+  return Result.ok({ message: `Hello, ${name}!` });
 }

package/presets/minimal/tsconfig.json.template

@@ -1,34 +1,33 @@
 {
-	"$schema": "https://json.schemastore.org/tsconfig",
-	"compilerOptions": {
-		"target": "ESNext",
-		"module": "ESNext",
-		"moduleResolution": "bundler",
-		"lib": ["ESNext"],
-		"types": ["@types/bun"],
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ESNext"],
+    "types": ["@types/bun"],
 
-		"strict": true,
-		"noImplicitAny": true,
-		"strictNullChecks": true,
-		"noUncheckedIndexedAccess": true,
-		"exactOptionalPropertyTypes": true,
-		"noPropertyAccessFromIndexSignature": true,
-		"noImplicitReturns": true,
-		"noFallthroughCasesInSwitch": true,
+    "strict": true,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
 
-		"declaration": true,
-		"declarationMap": true,
-		"sourceMap": true,
-		"outDir": "./dist",
-		"rootDir": "./src",
+    "declaration": true,
+    "sourceMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
 
-		"esModuleInterop": true,
-		"forceConsistentCasingInFileNames": true,
-		"isolatedModules": true,
-		"verbatimModuleSyntax": true,
-		"skipLibCheck": true,
-		"resolveJsonModule": true
-	},
-	"include": ["src/**/*"],
-	"exclude": ["node_modules", "dist"]
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "src/**/*.test.ts"]
 }

package/presets/cli/biome.json.template

@@ -1,4 +0,0 @@
-{
-	"$schema": "https://biomejs.dev/schemas/2.4.4/schema.json",
-	"extends": ["ultracite/config/biome/core/biome.jsonc"]
-}

package/presets/daemon/biome.json.template

@@ -1,4 +0,0 @@
-{
-	"$schema": "https://biomejs.dev/schemas/2.4.4/schema.json",
-	"extends": ["ultracite/config/biome/core/biome.jsonc"]
-}

package/presets/mcp/biome.json.template

@@ -1,4 +0,0 @@
-{
-	"$schema": "https://biomejs.dev/schemas/2.4.4/schema.json",
-	"extends": ["ultracite/config/biome/core/biome.jsonc"]
-}