@outfitter/presets 0.2.0

package/presets/full-stack/packages/core/package.json.template

@@ -0,0 +1,32 @@
+{
+	"name": "{{packageName}}-core",
+	"version": "{{version}}",
+	"description": "Shared handlers for {{projectName}}",
+	"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/index.ts --outdir dist --format=esm && tsc --emitDeclarationOnly --outDir dist",
+		"dev": "bun --watch src/index.ts",
+		"test": "bun test",
+		"test:watch": "bun test --watch",
+		"typecheck": "tsc --noEmit",
+		"lint": "biome check .",
+		"lint:fix": "biome check . --write",
+		"format": "biome format --write .",
+		"clean:artifacts": "rm -rf dist .turbo"
+	},
+	"dependencies": {
+		"@outfitter/contracts": "workspace:*",
+		"@outfitter/logging": "workspace:*",
+		"zod": "^4.3.5"
+	},
+	"devDependencies": {},
+	"license": "MIT"
+}

package/presets/full-stack/packages/core/src/handlers.ts.template

@@ -0,0 +1,31 @@
+import { Result, ValidationError, type Handler } from "@outfitter/contracts";
+import { createLogger } from "@outfitter/logging";
+import { greetingInputSchema, type Greeting } from "./types.js";
+
+const logger = createLogger({ name: "{{projectName}}-core" });
+
+export const createGreeting: Handler<unknown, Greeting, ValidationError> = async (
+	input,
+	ctx
+) => {
+	const parsed = greetingInputSchema.safeParse(input);
+	if (!parsed.success) {
+		return Result.err(
+			new ValidationError({
+				message: "Invalid greeting input",
+				field: "name",
+			})
+		);
+	}
+
+	const suffix = parsed.data.excited ? "!" : ".";
+	const greeting: Greeting = {
+		message: `Hello, ${parsed.data.name}${suffix}`,
+		issuedAt: new Date().toISOString(),
+	};
+
+	logger.info(`Created greeting for ${parsed.data.name}`, {
+		requestId: ctx.requestId,
+	});
+	return Result.ok(greeting);
+};

package/presets/full-stack/packages/core/src/index.test.ts.template

@@ -0,0 +1,30 @@
+import { describe, expect, test } from "bun:test";
+import { createContext } from "@outfitter/contracts";
+import { createGreeting } from "./handlers.js";
+
+describe("createGreeting", () => {
+	test("returns greeting for valid input", async () => {
+		const result = await createGreeting(
+			{ name: "Outfitter", excited: true },
+			createContext({ cwd: process.cwd(), env: process.env })
+		);
+
+		expect(result.isOk()).toBe(true);
+		if (result.isErr()) {
+			return;
+		}
+		expect(result.value.message).toBe("Hello, Outfitter!");
+	});
+
+	test("returns validation error for invalid input", async () => {
+		const result = await createGreeting(
+			{ name: "" },
+			createContext({ cwd: process.cwd(), env: process.env })
+		);
+
+		expect(result.isErr()).toBe(true);
+		if (result.isErr()) {
+			expect(result.error.name).toBe("ValidationError");
+		}
+	});
+});

package/presets/full-stack/packages/core/src/index.ts.template

@@ -0,0 +1,8 @@
+/**
+ * {{projectName}} core - shared domain handlers.
+ *
+ * @packageDocumentation
+ */
+
+export * from "./types.js";
+export * from "./handlers.js";

package/presets/full-stack/packages/core/src/types.ts.template

@@ -0,0 +1,13 @@
+import { z } from "zod";
+
+export const greetingInputSchema = z.object({
+	name: z.string().min(1, "name is required"),
+	excited: z.boolean().default(false),
+});
+
+export type GreetingInput = z.infer<typeof greetingInputSchema>;
+
+export interface Greeting {
+	readonly message: string;
+	readonly issuedAt: string;
+}

package/presets/full-stack/packages/core/tsconfig.json.template

@@ -0,0 +1,34 @@
+{
+	"$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,
+
+		"declaration": true,
+		"declarationMap": 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"]
+}

package/presets/library/.gitignore.template

@@ -0,0 +1,30 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Test coverage
+coverage/
+
+# Bun
+bun.lockb

package/presets/library/README.md.template

@@ -0,0 +1,29 @@
+# {{projectName}}
+
+{{description}}
+
+## Installation
+
+```bash
+bun add {{packageName}}
+```
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Build CJS + ESM artifacts
+bun run build
+
+# Typecheck
+bun run typecheck
+
+# Run tests
+bun run test
+```
+
+## License
+
+MIT

package/presets/library/bunup.config.ts.template

@@ -0,0 +1,20 @@
+import { defineWorkspace } from "bunup";
+
+export default defineWorkspace(
+	[
+		{
+			name: "{{packageName}}",
+			root: ".",
+		},
+	],
+	{
+		entry: ["src/**/*.ts", "!src/**/*.test.ts", "!src/**/__tests__/**"],
+		sourceBase: "./src",
+		format: ["esm", "cjs"],
+		dts: true,
+		exports: true,
+		splitting: true,
+		clean: true,
+		target: "bun",
+	}
+);

package/presets/library/package.json.template

@@ -0,0 +1,52 @@
+{
+	"name": "{{packageName}}",
+	"version": "{{version}}",
+	"description": "{{description}}",
+	"type": "module",
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"dist"
+	],
+	"sideEffects": false,
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"require": "./dist/index.cjs"
+		}
+	},
+	"scripts": {
+		"build": "bunup",
+		"dev": "bun --watch src/index.ts",
+		"test": "bun test",
+		"test:watch": "bun test --watch",
+		"typecheck": "tsc --noEmit",
+		"lint": "biome check .",
+		"lint:fix": "biome check . --write",
+		"format": "biome format --write .",
+		"clean:artifacts": "rm -rf dist .turbo",
+		"clean": "rm -rf dist"
+	},
+	"dependencies": {
+		"@outfitter/contracts": "workspace:*",
+		"@outfitter/logging": "workspace:*",
+		"zod": "^4.3.5"
+	},
+	"devDependencies": {
+		"bunup": "^0.16.29"
+	},
+	"outfitter": {
+		"template": {
+			"kind": "library",
+			"placement": "packages",
+			"surfaces": []
+		}
+	},
+	"engines": {
+		"bun": ">=1.3.9"
+	},
+	"keywords": [],
+	"license": "MIT"
+}

package/presets/library/src/handlers.ts.template

@@ -0,0 +1,31 @@
+import { Result, ValidationError, type Handler } from "@outfitter/contracts";
+import { createLogger } from "@outfitter/logging";
+import { greetingInputSchema, type Greeting } from "./types.js";
+
+const logger = createLogger({ name: "{{projectName}}" });
+
+export const createGreeting: Handler<unknown, Greeting, ValidationError> = async (
+	input,
+	ctx
+) => {
+	const parsed = greetingInputSchema.safeParse(input);
+	if (!parsed.success) {
+		return Result.err(
+			new ValidationError({
+				message: "Invalid greeting input",
+				field: "name",
+			})
+		);
+	}
+
+	const suffix = parsed.data.excited ? "!" : ".";
+	const greeting: Greeting = {
+		message: `Hello, ${parsed.data.name}${suffix}`,
+		issuedAt: new Date().toISOString(),
+	};
+
+	logger.info(`Created greeting for ${parsed.data.name}`, {
+		requestId: ctx.requestId,
+	});
+	return Result.ok(greeting);
+};

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

@@ -0,0 +1,35 @@
+import { describe, expect, test } from "bun:test";
+import { createContext } from "@outfitter/contracts";
+import { createGreeting } from "./handlers.js";
+
+describe("createGreeting", () => {
+	test("returns greeting for valid input", async () => {
+		const ctx = createContext({
+			cwd: process.cwd(),
+			env: process.env,
+		});
+		const result = await createGreeting(
+			{ name: "Outfitter", excited: true },
+			ctx
+		);
+
+		expect(result.isOk()).toBe(true);
+		if (result.isErr()) {
+			return;
+		}
+		expect(result.value.message).toBe("Hello, Outfitter!");
+	});
+
+	test("returns validation error for invalid input", async () => {
+		const ctx = createContext({
+			cwd: process.cwd(),
+			env: process.env,
+		});
+		const result = await createGreeting({ name: "" }, ctx);
+
+		expect(result.isErr()).toBe(true);
+		if (result.isErr()) {
+			expect(result.error.name).toBe("ValidationError");
+		}
+	});
+});

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

@@ -0,0 +1,8 @@
+/**
+ * {{projectName}} - Public API exports.
+ *
+ * @packageDocumentation
+ */
+
+export * from "./types.js";
+export * from "./handlers.js";

package/presets/library/src/types.ts.template

@@ -0,0 +1,13 @@
+import { z } from "zod";
+
+export const greetingInputSchema = z.object({
+	name: z.string().min(1, "name is required"),
+	excited: z.boolean().default(false),
+});
+
+export type GreetingInput = z.infer<typeof greetingInputSchema>;
+
+export interface Greeting {
+	readonly message: string;
+	readonly issuedAt: string;
+}

package/presets/library/tsconfig.json.template

@@ -0,0 +1,34 @@
+{
+	"$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,
+
+		"declaration": true,
+		"declarationMap": 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"]
+}

package/presets/mcp/.gitignore.template

@@ -0,0 +1,4 @@
+node_modules/
+dist/
+*.log
+.DS_Store

package/presets/mcp/.lefthook.yml.template

@@ -0,0 +1,26 @@
+# Lefthook configuration
+# https://github.com/evilmartians/lefthook
+
+pre-commit:
+  parallel: true
+  commands:
+    format:
+      glob: "*.{js,ts,tsx,json,md}"
+      run: bunx biome format --no-errors-on-unmatched {staged_files}
+      stage_fixed: true
+
+    lint:
+      glob: "*.{js,ts,tsx}"
+      run: bunx biome lint --no-errors-on-unmatched {staged_files}
+
+    typecheck:
+      glob: "*.{ts,tsx}"
+      run: bun run typecheck
+
+pre-push:
+  parallel: false
+  commands:
+    verify:
+      # TDD-aware strict verification with RED-phase branch carveout
+      # (*-tests, */tests, *_tests).
+      run: bunx @outfitter/tooling pre-push

package/presets/mcp/README.md.template

@@ -0,0 +1,54 @@
+# {{projectName}}
+
+{{description}}
+
+MCP (Model Context Protocol) server for integration with AI assistants.
+
+## Installation
+
+```bash
+bun add {{packageName}}
+```
+
+## Usage with Claude Desktop
+
+Add to your Claude Desktop config:
+
+```json
+{
+  "mcpServers": {
+    "{{binName}}": {
+      "command": "{{binName}}"
+    }
+  }
+}
+```
+
+## Available Tools
+
+### hello
+
+Say hello to someone.
+
+**Parameters:**
+- `name` (string, optional): Name to greet. Default: "World"
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Run in development
+bun run dev
+
+# Build
+bun run build
+
+# Run tests
+bun run test
+```
+
+## License
+
+MIT

package/presets/mcp/biome.json.template

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

package/presets/mcp/package.json.template

@@ -0,0 +1,46 @@
+{
+	"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"
+}

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

@@ -0,0 +1,7 @@
+/**
+ * {{projectName}} - Public API exports
+ *
+ * @packageDocumentation
+ */
+
+export { server, startServer } from "./mcp.js";

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

@@ -0,0 +1,33 @@
+/**
+ * {{projectName}} - MCP server definition
+ */
+
+import { Result } from "@outfitter/contracts";
+import { createMcpServer, defineTool, connectStdio } from "@outfitter/mcp";
+import { z } from "zod";
+
+const server = createMcpServer({
+	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);
+
+export { server };
+
+/** Start the MCP server over stdio transport. */
+export async function startServer(): Promise<void> {
+	await connectStdio(server);
+}

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

@@ -0,0 +1,8 @@
+#!/usr/bin/env bun
+/**
+ * {{projectName}} MCP server entry point
+ */
+
+import { startServer } from "./mcp.js";
+
+startServer().catch(console.error);

package/presets/mcp/tsconfig.json.template

@@ -0,0 +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"]
+}

package/presets/minimal/.gitignore.template

@@ -0,0 +1,30 @@
+# Dependencies
+node_modules/
+
+# Build output
+dist/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Test coverage
+coverage/
+
+# Bun
+bun.lockb