@outfitter/presets 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+interface ResolvedVersions {
+	/** All dependency versions from the presets package (catalog-resolved at publish time). */
+	readonly all: Readonly<Record<string, string>>;
+}
+interface PresetInfo {
+	/** The preset name (directory name). */
+	readonly name: string;
+	/** Absolute path to the preset directory. */
+	readonly path: string;
+}
+/**
+* Get the absolute path to the presets directory.
+* Works both in the monorepo (source) and when published to npm (dist/).
+*/
+declare function getPresetsDir(): string;
+/**
+* List all available presets.
+*/
+declare function listPresets(): readonly PresetInfo[];
+/**
+* Get the absolute path to a specific preset directory.
+* Returns undefined if the preset does not exist.
+*/
+declare function getPresetPath(presetName: string): string | undefined;
+/**
+* Read resolved dependency versions from the presets package's own package.json.
+*
+* When published to npm, `catalog:` is replaced with concrete semver ranges,
+* so versions are read directly. In the monorepo, `catalog:` references are
+* resolved by reading the workspace root's catalog field.
+*
+* @returns Resolved versions for all declared dependencies.
+*
+* @example
+* ```typescript
+* import { getResolvedVersions } from "@outfitter/presets";
+*
+* const { all } = getResolvedVersions();
+* console.log(all["zod"]); // "^4.3.5"
+* ```
+*/
+declare function getResolvedVersions(): ResolvedVersions;
+export { listPresets, getResolvedVersions, getPresetsDir, getPresetPath, ResolvedVersions, PresetInfo };

package/dist/index.js

@@ -0,0 +1,118 @@
+// @bun
+// packages/presets/src/index.ts
+import { existsSync, readdirSync, readFileSync, statSync } from "fs";
+import { dirname, isAbsolute, join, relative, resolve } from "path";
+import { fileURLToPath } from "url";
+var DEPENDENCY_SECTIONS = [
+  "dependencies",
+  "devDependencies",
+  "peerDependencies",
+  "optionalDependencies"
+];
+function getPresetsDir() {
+  const thisFile = dirname(fileURLToPath(import.meta.url));
+  const presetsDir = join(thisFile, "..", "presets");
+  if (existsSync(presetsDir)) {
+    return presetsDir;
+  }
+  throw new Error(`Presets directory not found at ${presetsDir}. Ensure @outfitter/presets is properly installed.`);
+}
+function listPresets() {
+  const presetsDir = getPresetsDir();
+  return readdirSync(presetsDir, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => ({
+    name: entry.name,
+    path: join(presetsDir, entry.name)
+  })).sort((a, b) => a.name.localeCompare(b.name));
+}
+function getPresetPath(presetName) {
+  const presetsDir = getPresetsDir();
+  const presetDir = resolve(presetsDir, presetName);
+  const relativePath = relative(presetsDir, presetDir);
+  if (relativePath.length === 0 || relativePath.startsWith("..") || isAbsolute(relativePath)) {
+    return;
+  }
+  if (!existsSync(presetDir)) {
+    return;
+  }
+  return statSync(presetDir).isDirectory() ? presetDir : undefined;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function loadWorkspaceCatalog(packageDir) {
+  let dir = packageDir;
+  for (let i = 0;i < 10; i++) {
+    const rootPkgPath = join(dir, "package.json");
+    if (existsSync(rootPkgPath)) {
+      try {
+        const raw = JSON.parse(readFileSync(rootPkgPath, "utf-8"));
+        if (isRecord(raw) && isRecord(raw["catalog"])) {
+          const catalog = {};
+          for (const [name, version] of Object.entries(raw["catalog"])) {
+            if (typeof version === "string") {
+              catalog[name] = version;
+            }
+          }
+          return catalog;
+        }
+      } catch {}
+    }
+    const parent = dirname(dir);
+    if (parent === dir)
+      break;
+    dir = parent;
+  }
+  return {};
+}
+function getResolvedVersions() {
+  const packageDir = join(dirname(fileURLToPath(import.meta.url)), "..");
+  const packageJsonPath = join(packageDir, "package.json");
+  const raw = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+  if (!isRecord(raw)) {
+    throw new Error("@outfitter/presets package.json must be a JSON object");
+  }
+  const all = {};
+  let hasCatalogRefs = false;
+  for (const section of DEPENDENCY_SECTIONS) {
+    const deps = raw[section];
+    if (!isRecord(deps))
+      continue;
+    for (const [name, version] of Object.entries(deps)) {
+      if (typeof version === "string") {
+        if (version === "catalog:") {
+          hasCatalogRefs = true;
+        } else {
+          all[name] = version;
+        }
+      }
+    }
+  }
+  if (hasCatalogRefs) {
+    const catalog = loadWorkspaceCatalog(packageDir);
+    const unresolved = [];
+    for (const section of DEPENDENCY_SECTIONS) {
+      const deps = raw[section];
+      if (!isRecord(deps))
+        continue;
+      for (const [name, version] of Object.entries(deps)) {
+        if (version === "catalog:") {
+          if (catalog[name]) {
+            all[name] = catalog[name];
+          } else {
+            unresolved.push(name);
+          }
+        }
+      }
+    }
+    if (unresolved.length > 0) {
+      throw new Error(`Unresolvable catalog: references (no catalog entry found): ${unresolved.join(", ")}`);
+    }
+  }
+  return { all };
+}
+export {
+  listPresets,
+  getResolvedVersions,
+  getPresetsDir,
+  getPresetPath
+};

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@outfitter/presets",
+  "description": "Scaffold presets and shared dependency versions for Outfitter projects",
+  "version": "0.2.0",
+  "type": "module",
+  "files": [
+    "dist",
+    "presets"
+  ],
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@biomejs/biome": "2.4.4",
+    "@clack/prompts": "^1.0.1",
+    "@logtape/logtape": "^2.0.0",
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@types/node": "^25.3.0",
+    "better-result": "^2.5.1",
+    "bunup": "^0.16.29",
+    "commander": "^14.0.2",
+    "lefthook": "^2.1.1",
+    "smol-toml": "^1.6.0",
+    "ultracite": "7.2.3",
+    "yaml": "^2.8.2",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.9",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "bun": ">=1.3.9"
+  },
+  "keywords": [
+    "outfitter",
+    "presets",
+    "scaffolding",
+    "templates",
+    "versions"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/outfitter-dev/stack.git",
+    "directory": "packages/presets"
+  },
+  "scripts": {
+    "build": "cd ../.. && bunup --filter @outfitter/presets",
+    "clean": "rm -rf dist .turbo",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun ../../scripts/check-publish-manifest.ts"
+  }
+}

package/presets/basic/.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/basic/.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/basic/package.json.template

@@ -0,0 +1,39 @@
+{
+	"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": {},
+	"engines": {
+		"bun": ">=1.3.9"
+	},
+	"keywords": [],
+	"license": "MIT"
+}

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

@@ -0,0 +1,26 @@
+/**
+ * {{projectName}}
+ *
+ * {{description}}
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Main entry point for {{projectName}}.
+ *
+ * @example
+ * ```typescript
+ * import { main } from "{{packageName}}";
+ *
+ * main();
+ * ```
+ */
+export function main(): void {
+	console.log("Hello from {{projectName}}!");
+}
+
+// Run if executed directly
+if (import.meta.main) {
+	main();
+}

package/presets/basic/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/cli/.gitignore.template

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

package/presets/cli/.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/cli/README.md.template

@@ -0,0 +1,35 @@
+# {{projectName}}
+
+{{description}}
+
+## Installation
+
+```bash
+bun add {{packageName}}
+```
+
+## Usage
+
+```bash
+{{binName}} hello [name]
+```
+
+## 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/cli/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/cli/package.json.template

@@ -0,0 +1,46 @@
+{
+	"name": "{{packageName}}",
+	"version": "{{version}}",
+	"description": "{{description}}",
+	"type": "module",
+	"bin": {
+		"{{binName}}": "./dist/cli.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/cli.ts --outdir dist --target bun && bun build src/index.ts --outdir dist --target bun --sourcemap",
+		"dev": "bun --watch src/cli.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": {
+		"@outfitter/contracts": "workspace:*",
+		"@outfitter/types": "workspace:*",
+		"@outfitter/cli": "workspace:*",
+		"@outfitter/logging": "workspace:*",
+		"commander": "^14.0.2"
+	},
+	"devDependencies": {},
+	"outfitter": {
+		"template": {
+			"kind": "runnable",
+			"placement": "apps",
+			"surfaces": ["cli"]
+		}
+	},
+	"license": "MIT"
+}

package/presets/cli/src/cli.ts.template

@@ -0,0 +1,8 @@
+#!/usr/bin/env bun
+/**
+ * {{projectName}} CLI entry point
+ */
+
+import { program } from "./program.js";
+
+program.parse(process.argv);

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

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

package/presets/cli/src/program.ts.template

@@ -0,0 +1,31 @@
+/**
+ * {{projectName}} - CLI program definition
+ */
+
+import { command, createCLI } from "@outfitter/cli/command";
+import { verbosePreset } from "@outfitter/cli/flags";
+import { createLogger } from "@outfitter/logging";
+
+const logger = createLogger({ name: "{{binName}}" });
+
+export const program = createCLI({
+	name: "{{binName}}",
+	version: "{{version}}",
+	description: "{{description}}",
+});
+
+const verbose = verbosePreset();
+
+program.register(
+	command("hello [name]")
+		.description("Say hello")
+		.preset(verbose)
+		.action<{ verbose: boolean }>(async ({ args, flags }) => {
+			const { verbose: isVerbose } = verbose.resolve(flags);
+			const name = args[0] ?? "World";
+			logger.info(`Hello, ${name}!`);
+			if (isVerbose) {
+				logger.debug("Running in verbose mode");
+			}
+		}),
+);

package/presets/cli/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/daemon/.gitignore.template

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

package/presets/daemon/.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