outfitter 0.2.6 → 0.2.7

package/templates/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/templates/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/templates/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/templates/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/templates/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/templates/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/templates/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/templates/library/package.json.template

@@ -0,0 +1,55 @@
+{
+	"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": {
+		"@biomejs/biome": "^2.4.4",
+		"@types/bun": "^1.3.9",
+		"bunup": "^0.16.29",
+		"typescript": "^5.9.3"
+	},
+	"outfitter": {
+		"template": {
+			"kind": "library",
+			"placement": "packages",
+			"surfaces": []
+		}
+	},
+	"engines": {
+		"bun": ">=1.3.9"
+	},
+	"keywords": [],
+	"license": "MIT"
+}

package/templates/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/templates/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/templates/library/src/index.ts.template

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

package/templates/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/templates/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/templates/mcp/biome.json.template

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

package/templates/mcp/package.json.template

@@ -28,18 +28,26 @@
 		"clean:artifacts": "rm -rf dist .turbo"
 	},
 	"dependencies": {
-		"@modelcontextprotocol/sdk": "^1.0.0",
-		"@outfitter/kit": "^0.1.0-rc.0",
-		"@outfitter/mcp": "^0.1.0-rc.0",
-		"@outfitter/logging": "^0.1.0-rc.0"
+		"@modelcontextprotocol/sdk": "^1.12.1",
+		"@outfitter/contracts": "workspace:*",
+		"@outfitter/types": "workspace:*",
+		"@outfitter/mcp": "workspace:*",
+		"@outfitter/logging": "workspace:*"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "^2.3.12",
-		"@outfitter/tooling": "^0.2.1",
-		"@types/bun": "^1.3.7",
-		"lefthook": "^2.0.16",
+		"@biomejs/biome": "^2.4.4",
+		"@outfitter/tooling": "workspace:*",
+		"@types/bun": "^1.3.9",
+		"lefthook": "^2.1.1",
 		"typescript": "^5.9.3",
-		"ultracite": "^7.1.1"
+		"ultracite": "^7.2.3"
+	},
+	"outfitter": {
+		"template": {
+			"kind": "runnable",
+			"placement": "apps",
+			"surfaces": ["mcp"]
+		}
 	},
 	"license": "MIT"
 }

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

@@ -4,4 +4,4 @@
  * @packageDocumentation
  */
 
-export { createMCPServer } from "./mcp.js";
+export { server, startServer } from "./mcp.js";

package/templates/mcp/src/mcp.ts.template

@@ -2,78 +2,32 @@
  * {{projectName}} - MCP server definition
  */
 
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
-import { createLogger } from "@outfitter/logging";
-
-const logger = createLogger({ name: "{{binName}}" });
-
-type HelloArgs = {
-	name?: unknown;
-};
-
-export function createMCPServer(): Server {
-	const server = new Server(
-		{
-			name: "{{binName}}",
-			version: "{{version}}",
-		},
-		{
-			capabilities: {
-				tools: {},
-			},
-		}
-	);
-
-	// List available tools
-	server.setRequestHandler(ListToolsRequestSchema, async () => ({
-		tools: [
-			{
-				name: "hello",
-				description: "Say hello to someone",
-				inputSchema: {
-					type: "object" as const,
-					properties: {
-						name: {
-							type: "string",
-							description: "Name to greet",
-							default: "World",
-						},
-					},
-				},
-			},
-		],
-	}));
-
-	// Handle tool calls
-	server.setRequestHandler(CallToolRequestSchema, async (request) => {
-		const { name, arguments: args } = request.params;
-
-		const handlers: Record<string, (input: HelloArgs) => { content: { type: "text"; text: string }[] }> = {
-			hello: (input) => {
-				const greeting =
-					typeof input.name === "string" && input.name.trim().length > 0 ? input.name : "World";
-
-				logger.info`Greeting ${greeting}`;
-				return {
-					content: [
-						{
-							type: "text" as const,
-							text: `Hello, ${greeting}!`,
-						},
-					],
-				};
-			},
-		};
-
-		const handler = handlers[name];
-		if (handler) {
-			return handler((args ?? {}) as HelloArgs);
-		}
-
-		logger.warn`Unknown tool ${name}`;
-		throw new Error(`Unknown tool: ${name}`);
-	});
-
-	return server;
+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/templates/mcp/src/server.ts.template

@@ -3,13 +3,6 @@
  * {{projectName}} MCP server entry point
  */
 
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { createMCPServer } from "./mcp.js";
+import { startServer } from "./mcp.js";
 
-async function main() {
-	const server = createMCPServer();
-	const transport = new StdioServerTransport();
-	await server.connect(transport);
-}
-
-main().catch(console.error);
+startServer().catch(console.error);

package/templates/minimal/package.json.template

@@ -31,15 +31,22 @@
 		"clean": "rm -rf dist"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "^2.3.12",
-		"@outfitter/tooling": "^0.2.1",
-		"@types/bun": "^1.3.7",
-		"lefthook": "^2.0.16",
+		"@biomejs/biome": "^2.4.4",
+		"@outfitter/tooling": "workspace:*",
+		"@types/bun": "^1.3.9",
+		"lefthook": "^2.1.1",
 		"typescript": "^5.9.3",
-		"ultracite": "^7.1.1"
+		"ultracite": "^7.2.3"
+	},
+	"outfitter": {
+		"template": {
+			"kind": "library",
+			"placement": "packages",
+			"surfaces": []
+		}
 	},
 	"engines": {
-		"bun": ">=1.3.7"
+		"bun": ">=1.3.9"
 	},
 	"keywords": [],
 	"license": "MIT"

package/dist/commands/migrate-kit.d.ts

@@ -1,2 +0,0 @@
-import { MigrateKitError, MigrateKitOptions, MigrateKitResult, migrateKitCommand, printMigrateKitResults, runMigrateKit } from "../shared/outfitter-npemy7ta";
-export { runMigrateKit, printMigrateKitResults, migrateKitCommand, MigrateKitResult, MigrateKitOptions, MigrateKitError };

package/dist/commands/migrate-kit.js

@@ -1,15 +0,0 @@
-// @bun
-import {
-  MigrateKitError,
-  migrateKitCommand,
-  printMigrateKitResults,
-  runMigrateKit
-} from "../shared/outfitter-mxz69pgy.js";
-import"../shared/outfitter-7r12fj7f.js";
-import"../shared/outfitter-mdt37hqm.js";
-export {
-  runMigrateKit,
-  printMigrateKitResults,
-  migrateKitCommand,
-  MigrateKitError
-};

package/dist/shared/outfitter-7ha7p61k.d.ts

@@ -1,6 +0,0 @@
-import { ScaffoldError } from "./outfitter-qfh36ddg";
-import { Result } from "@outfitter/contracts";
-declare function buildWorkspaceRootPackageJson(workspaceName: string): string;
-declare function scaffoldWorkspaceRoot(rootDir: string, workspaceName: string, force: boolean): Result<void, ScaffoldError>;
-declare function detectWorkspaceRoot(cwd: string): Result<string | null, ScaffoldError>;
-export { buildWorkspaceRootPackageJson, scaffoldWorkspaceRoot, detectWorkspaceRoot };

package/dist/shared/outfitter-ara3djt0.js

@@ -1,73 +0,0 @@
-// @bun
-import {
-  SHARED_DEV_DEPS,
-  SHARED_SCRIPTS
-} from "./outfitter-k112c427.js";
-import {
-  ScaffoldError
-} from "./outfitter-8y2dfx6n.js";
-
-// apps/outfitter/src/engine/config.ts
-import { existsSync, readFileSync, writeFileSync } from "fs";
-import { join } from "path";
-import { Result } from "@outfitter/contracts";
-var DEPENDENCY_SECTIONS = [
-  "dependencies",
-  "devDependencies",
-  "peerDependencies",
-  "optionalDependencies"
-];
-function injectSharedConfig(targetDir) {
-  const packageJsonPath = join(targetDir, "package.json");
-  if (!existsSync(packageJsonPath)) {
-    return Result.ok(undefined);
-  }
-  try {
-    const content = readFileSync(packageJsonPath, "utf-8");
-    const parsed = JSON.parse(content);
-    const existingDevDeps = parsed["devDependencies"] ?? {};
-    parsed["devDependencies"] = { ...SHARED_DEV_DEPS, ...existingDevDeps };
-    const existingScripts = parsed["scripts"] ?? {};
-    parsed["scripts"] = { ...SHARED_SCRIPTS, ...existingScripts };
-    writeFileSync(packageJsonPath, `${JSON.stringify(parsed, null, 2)}
-`, "utf-8");
-    return Result.ok(undefined);
-  } catch (error) {
-    const message = error instanceof Error ? error.message : "Unknown error";
-    return Result.err(new ScaffoldError(`Failed to inject shared config: ${message}`));
-  }
-}
-function rewriteLocalDependencies(targetDir) {
-  const packageJsonPath = join(targetDir, "package.json");
-  if (!existsSync(packageJsonPath)) {
-    return Result.ok(undefined);
-  }
-  try {
-    const content = readFileSync(packageJsonPath, "utf-8");
-    const parsed = JSON.parse(content);
-    let updated = false;
-    for (const section of DEPENDENCY_SECTIONS) {
-      const deps = parsed[section];
-      if (!deps || typeof deps !== "object" || Array.isArray(deps)) {
-        continue;
-      }
-      const entries = deps;
-      for (const [name, version] of Object.entries(entries)) {
-        if (typeof version === "string" && name.startsWith("@outfitter/") && version !== "workspace:*") {
-          entries[name] = "workspace:*";
-          updated = true;
-        }
-      }
-    }
-    if (updated) {
-      writeFileSync(packageJsonPath, `${JSON.stringify(parsed, null, 2)}
-`, "utf-8");
-    }
-    return Result.ok(undefined);
-  } catch (error) {
-    const message = error instanceof Error ? error.message : "Unknown error";
-    return Result.err(new ScaffoldError(`Failed to update local dependencies: ${message}`));
-  }
-}
-
-export { injectSharedConfig, rewriteLocalDependencies };