@alfredmouelle/create-stack 0.1.1 → 0.1.2

package/lib/build.mjs

@@ -1,5 +1,5 @@
-// Pure build phase (no prompts, no install) — fork → strip → mailer → env →
-// identity. Shared by index.mjs (after the wizard) and the test harness.
+// Pure build phase (no prompts/install): fork → strip → mailer → env → identity.
+// Shared by index.mjs (post-wizard) and the test harness.
 
 import { writeEnv } from './env.mjs'
 import { stampIdentity } from './identity.mjs'
@@ -13,33 +13,25 @@ import { join, pkgAddDeps, pkgRemoveDeps, pkgRemoveScripts, readJSON, writeJSON
  * @param {string} o.projectDir  absolute target dir (must be empty)
  * @param {string} o.projectName
  * @param {'next'|'tanstack'} o.framework
- * @param {Set<string>} o.kept   logical foundations to keep (deps pre-resolved)
+ * @param {Set<string>} o.kept   foundations to keep (deps pre-resolved)
  * @param {'resend'|'brevo'|'ses'|'none'} o.mailerProvider
- * @param {object} o.patterns    loadPatterns()
  * @returns {{ kept: string[], keptMailer: boolean, mailerProvider: string, envKeys: string[] }}
  */
-export function buildProject({
-  projectDir,
-  projectName,
-  framework,
-  kept,
-  mailerProvider,
-  patterns,
-}) {
+export function buildProject({ projectDir, projectName, framework, kept, mailerProvider }) {
   const authKept = kept.has('better-auth')
   const keptMailer = mailerProvider !== 'none'
 
   forkBase(framework, projectDir)
   makeStandalone(projectDir, projectName, framework)
 
-  const strip = stripFoundations({ projectDir, framework, kept, keptMailer, patterns })
+  const strip = stripFoundations({ projectDir, framework, kept, keptMailer })
   const mailer = keptMailer
     ? swapMailer(projectDir, mailerProvider)
     : { addDeps: {}, removeDeps: [], envKeys: [] }
 
   const pkgPath = join(projectDir, 'package.json')
   const pkg = readJSON(pkgPath)
-  pkg.description = `${projectName} — bootstrapped from the personal reference stack.`
+  pkg.description = `${projectName} — scaffolded from the personal reference stack.`
   pkgRemoveDeps(pkg, [...strip.removeDeps, ...mailer.removeDeps])
   pkgRemoveScripts(pkg, strip.removeScripts)
   pkgAddDeps(pkg, mailer.addDeps)

package/lib/env.mjs

@@ -1,10 +1,9 @@
-// Rebuilds src/env.ts `server` + `runtimeEnv` blocks from the final key set,
-// and generates .env.example + .env. Adds keys (e.g. a swapped mailer provider)
-// and prunes keys of stripped foundations/capabilities — deterministically.
+// Rebuilds src/env.ts `server` + `runtimeEnv` from the final key set; generates
+// .env.example + .env. Adds swapped-mailer keys, prunes stripped ones, deterministically.
 
 import { editFile, join, write } from './util.mjs'
 
-/** valibot schema text per known env key. */
+/** valibot schema text per env key. */
 const SCHEMAS = {
   DATABASE_URL: 'v.pipe(v.string(), v.url())',
   BETTER_AUTH_URL: 'v.pipe(v.string(), v.url())',
@@ -19,7 +18,7 @@ const SCHEMAS = {
   AWS_SECRET_ACCESS_KEY: 'v.optional(v.pipe(v.string(), v.minLength(1)))',
 }
 
-/** Placeholder values for the generated .env files. */
+/** Placeholder values for generated .env files. */
 const PLACEHOLDERS = {
   DATABASE_URL: 'postgres://postgres:postgres@localhost:5432/app',
   BETTER_AUTH_URL: 'http://localhost:3000',
@@ -29,7 +28,7 @@ const PLACEHOLDERS = {
 
 const indent = (s) => `    ${s}`
 
-/** Write the final env.ts and .env files. `keys` is an ordered string[]. */
+/** Write final env.ts + .env files. `keys`: ordered string[]. */
 export function writeEnv(projectDir, keys) {
   const seen = new Set()
   const ordered = keys.filter((k) => SCHEMAS[k] && !seen.has(k) && seen.add(k))

package/lib/foundations.mjs

@@ -0,0 +1,35 @@
+// Foundations the CLI can strip + the npm footprint each adds (deps/devDeps/scripts only).
+// File deletes, env keys, code seams live in strip.mjs/build.mjs (need framework-specific surgery).
+
+export const FOUNDATIONS = ['drizzle', 'trpc', 'better-auth', 'data-table']
+
+const DATA = {
+  drizzle: {
+    deps: ['drizzle-orm', 'pg'],
+    devDeps: ['drizzle-kit', 'dotenv', 'tsx', '@types/pg', '@faker-js/faker'],
+    scripts: ['db:generate', 'db:migrate', 'db:push', 'db:studio', 'db:seed'],
+  },
+  trpc: {
+    deps: ['@trpc/server', '@trpc/client', '@tanstack/react-query', 'superjson', 'valibot'],
+    // React Query bridge differs per framework
+    perFramework: { tanstack: ['@trpc/tanstack-react-query'], next: ['@trpc/react-query'] },
+  },
+  'better-auth': {
+    deps: ['better-auth'],
+  },
+  'data-table': {
+    deps: ['@tanstack/react-table'],
+  },
+}
+
+/** Every npm dep (prod + dev) a foundation contributes, for `framework`. */
+export function foundationDeps(name, framework) {
+  const d = DATA[name]
+  if (!d) return []
+  return [...(d.deps ?? []), ...(d.devDeps ?? []), ...(d.perFramework?.[framework] ?? [])]
+}
+
+/** package.json script names a foundation adds. */
+export function foundationScripts(name) {
+  return DATA[name]?.scripts ?? []
+}

package/lib/identity.mjs

@@ -1,7 +1,6 @@
-// Step A4 — stamp the project identity: title/meta + a README that ends with
-// the stack's `# Author` footer verbatim.
+// Stamp project identity: title/meta + README ending with the `# Author` footer verbatim.
 
-import { STACK_ROOT } from './manifests.mjs'
+import { TEMPLATES } from './paths.mjs'
 import { editFile, join, read, write } from './util.mjs'
 
 const titleFiles = {
@@ -10,12 +9,12 @@ const titleFiles = {
 }
 
 export function stampIdentity(projectDir, projectName, framework) {
-  // Swap the placeholder title 'App' in the root document/metadata.
+  // swap placeholder title 'App' in root document/metadata
   for (const rel of titleFiles[framework === 'next' ? 'next' : 'tanstack']) {
     editFile(join(projectDir, rel), (c) => c.replaceAll("title: 'App'", `title: '${projectName}'`))
   }
 
-  const footer = read(join(STACK_ROOT, 'patterns/_baseline/README-author.md'))
+  const footer = read(join(TEMPLATES, 'README-author.md'))
   const readme = `# ${projectName}
 
 Bootstrapped from the personal reference stack.

package/lib/mailer.mjs

@@ -1,13 +1,12 @@
-// Mailer provider swap. The base inlines the Resend adapter; if the user picks
-// another provider we swap the adapter files + the composition root (email/index.ts)
-// and return the dep/env deltas. Mirrors the mailer capability manifest.
+// Mailer provider swap. Base inlines Resend; other providers swap adapter files +
+// composition root (email/index.ts) and return dep/env deltas. Mirrors the mailer manifest.
 
-import { STACK_ROOT } from './manifests.mjs'
+import { STACK_ROOT } from './paths.mjs'
 import { copy, join, readJSON, remove, write } from './util.mjs'
 
 const EMAIL_DIR = 'src/server/email'
 
-/** getMailer() body per provider (composition root in email/index.ts). */
+/** getMailer() body per provider (composition root). */
 const FACTORY = {
   brevo: {
     import: "import { brevoAdapter } from './adapters/brevo/index'",
@@ -17,7 +16,7 @@ const FACTORY = {
   },
   ses: {
     import: "import { sesAdapter } from './adapters/ses/index'",
-    // SESv2 SDK reads AWS_REGION / AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY from env.
+    // SESv2 SDK reads AWS_REGION / AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY from env
     adapter: 'sesAdapter()',
     envKeys: ['EMAIL_FROM', 'AWS_REGION', 'AWS_ACCESS_KEY_ID', 'AWS_SECRET_ACCESS_KEY'],
     pkgDep: '@aws-sdk/client-sesv2',
@@ -63,10 +62,7 @@ export async function sendEmail(params: {
 }
 `
 
-/**
- * Swap the inlined mailer to `provider`. Returns { addDeps, removeDeps, envKeys }.
- * provider === 'resend' is a no-op (the base default).
- */
+/** Swap inlined mailer to `provider` → { addDeps, removeDeps, envKeys }. 'resend' is a no-op (base default). */
 export function swapMailer(projectDir, provider) {
   if (provider === 'resend') {
     return { addDeps: {}, removeDeps: [], envKeys: ['EMAIL_FROM', 'RESEND_API_KEY'] }
@@ -74,17 +70,17 @@ export function swapMailer(projectDir, provider) {
   const cfg = FACTORY[provider]
   if (!cfg) throw new Error(`Unknown mailer provider: ${provider}`)
 
-  // Swap adapter files: drop resend, copy the chosen adapter from the package.
+  // swap adapter files: drop resend, copy chosen adapter from package
   remove(join(projectDir, EMAIL_DIR, 'adapters/resend'))
   copy(
     join(STACK_ROOT, 'packages/mailer/src/adapters', provider),
     join(projectDir, EMAIL_DIR, 'adapters', provider),
   )
 
-  // Rewrite the composition root.
+  // rewrite composition root
   write(join(projectDir, EMAIL_DIR, 'index.ts'), INDEX_TS(cfg))
 
-  // Dep delta — pull the provider's range from the mailer package manifest.
+  // dep delta — pull provider's range from mailer package manifest
   const mailerPkg = readJSON(join(STACK_ROOT, 'packages/mailer/package.json'))
   const range = mailerPkg.dependencies?.[cfg.pkgDep] ?? 'latest'
   return {

package/lib/paths.mjs

@@ -0,0 +1,15 @@
+// Where the bundled stack assets live: cli/_stack when published (scripts/bundle.mjs), repo root in dev.
+
+import { existsSync } from 'node:fs'
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const bundled = resolve(here, '..', '_stack')
+
+// Forkable source (base apps + mailer adapters): _stack when published, monorepo root in dev.
+export const STACK_ROOT = existsSync(bundled) ? bundled : resolve(here, '..', '..')
+
+// CLI-owned templates injected into the fork (root-wiring variants, biome.jsonc,
+// # Author README footer). Always shipped in the package.
+export const TEMPLATES = resolve(here, '..', 'templates')

package/lib/scaffold.mjs

@@ -1,7 +1,7 @@
-// Step A2 — fork a base app into the target dir and make it standalone
-// (its own Biome config, pnpm workspace + build allowlist, project name).
+// Fork a base app into the target dir + make it standalone
+// (own Biome config, pnpm workspace + build allowlist, project name).
 
-import { STACK_ROOT } from './manifests.mjs'
+import { STACK_ROOT, TEMPLATES } from './paths.mjs'
 import { copy, exists, join, readJSON, run, write, writeJSON } from './util.mjs'
 
 const RSYNC_EXCLUDES = [
@@ -22,8 +22,8 @@ const PNPM_WORKSPACE = `allowBuilds:
   lightningcss: true
 `
 
-// Generated explicitly: npm strips `.gitignore` from published tarballs, so we
-// can't rely on the bundled base app's copy surviving. Both keep `.env.example`.
+// Generated explicitly: npm strips `.gitignore` from published tarballs, so the
+// bundled base app's copy won't survive. Both keep `.env.example`.
 const GITIGNORE = {
   tanstack: `node_modules
 .DS_Store
@@ -74,7 +74,7 @@ next-env.d.ts
 `,
 }
 
-/** Copy the base app into projectDir, minus build output & generated files. */
+/** Copy base app into projectDir, minus build output & generated files. */
 export function forkBase(framework, projectDir) {
   const base = join(STACK_ROOT, 'apps', framework === 'next' ? 'next-base' : 'tanstack-base')
   if (!exists(base)) throw new Error(`Base app not found: ${base}`)
@@ -86,19 +86,19 @@ export function forkBase(framework, projectDir) {
 
 /** Make the fork standalone (Biome, pnpm workspace, .gitignore, identity). */
 export function makeStandalone(projectDir, projectName, framework) {
-  // A fork needs its own Biome config (the base inherits the monorepo root's).
-  copy(join(STACK_ROOT, 'patterns/_baseline/biome.jsonc'), join(projectDir, 'biome.jsonc'))
+  // fork needs its own Biome config (base inherits the monorepo root's)
+  copy(join(TEMPLATES, 'biome.jsonc'), join(projectDir, 'biome.jsonc'))
 
-  // Biome's vcs.useIgnoreFile needs a .gitignore; also good project hygiene.
+  // Biome vcs.useIgnoreFile needs a .gitignore
   write(join(projectDir, '.gitignore'), GITIGNORE[framework === 'next' ? 'next' : 'tanstack'])
 
-  // Avoid ERR_PNPM_IGNORED_BUILDS on a fresh install (native build scripts).
+  // avoid ERR_PNPM_IGNORED_BUILDS on fresh install (native build scripts)
   write(join(projectDir, 'pnpm-workspace.yaml'), PNPM_WORKSPACE)
 
   const pkgPath = join(projectDir, 'package.json')
   const pkg = readJSON(pkgPath)
   pkg.name = projectName
-  delete pkg.private // a leaf project; let the user decide
+  delete pkg.private // leaf project
   pkg.private = true
   writeJSON(pkgPath, pkg)
 }

package/lib/strip.mjs

@@ -1,43 +1,28 @@
-// Step A3 — reverse-strip the foundations the user did NOT select.
-// Whole-directory deletes (robust against orphans) + the few code "seams"
-// that need surgery (trpc/auth wiring) via shipped reduced variants.
+// Strip unselected foundations: whole-dir deletes + code-seam variants (trpc/auth).
 
-import { dirname } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { foundationManifest } from './manifests.mjs'
+import { FOUNDATIONS, foundationDeps, foundationScripts } from './foundations.mjs'
+import { TEMPLATES } from './paths.mjs'
 import { copy, editFile, join, remove } from './util.mjs'
 
-const here = dirname(fileURLToPath(import.meta.url))
-const tpl = (rel) => join(here, '..', 'templates', rel)
+const tpl = (rel) => join(TEMPLATES, rel)
 
 const ALWAYS_KEEP = new Set(['valibot'])
 
-const manifestDeps = (m) => [...(m?.deps ?? []), ...(m?.devDeps ?? [])]
-
-/** Logical foundations always present in a base app. */
-export const FOUNDATIONS = ['drizzle', 'trpc', 'better-auth', 'data-table']
-
-/**
- * Strip the unselected foundations from the fork.
- * @returns {{ removeDeps: string[], removeScripts: string[] }}
- */
-export function stripFoundations({ projectDir, framework, kept, keptMailer, patterns }) {
+/** @returns {{ removeDeps: string[], removeScripts: string[] }} */
+export function stripFoundations({ projectDir, framework, kept, keptMailer }) {
   const next = framework === 'next'
   const src = (p) => join(projectDir, 'src', p)
   const dropped = FOUNDATIONS.filter((f) => !kept.has(f))
 
   // Dep diff: remove a dropped foundation's deps unless a kept one still needs it.
-  const keptDeps = new Set(
-    [...kept].flatMap((f) => manifestDeps(patterns[foundationManifest(f, framework)])),
-  )
+  const keptDeps = new Set([...kept].flatMap((f) => foundationDeps(f, framework)))
   const removeDeps = new Set()
   const removeScripts = new Set()
   for (const f of dropped) {
-    const m = patterns[foundationManifest(f, framework)]
-    for (const d of manifestDeps(m)) {
+    for (const d of foundationDeps(f, framework)) {
       if (!keptDeps.has(d) && !ALWAYS_KEEP.has(d)) removeDeps.add(d)
     }
-    for (const s of Object.keys(m?.scripts ?? {})) removeScripts.add(s)
+    for (const s of foundationScripts(f)) removeScripts.add(s)
   }
 
   // --- data-table ---

package/lib/util.mjs

@@ -1,5 +1,4 @@
-// Small fs / exec / package.json helpers shared by the CLI modules.
-// No external deps — keep the CLI lean and instantly runnable.
+// fs / exec / package.json helpers shared by the CLI. No external deps.
 
 import { spawnSync } from 'node:child_process'
 import {
@@ -22,18 +21,18 @@ export const exists = (p) => existsSync(p)
 export const readJSON = (p) => JSON.parse(read(p))
 export const writeJSON = (p, obj) => write(p, `${JSON.stringify(obj, null, 2)}\n`)
 
-/** Remove a file or directory if it exists (recursive, never throws on absent). */
+/** Remove file/dir if present (recursive, never throws on absent). */
 export const remove = (p) => {
   if (existsSync(p)) rmSync(p, { recursive: true, force: true })
 }
 
-/** Copy a file or directory tree. */
+/** Copy a file/dir tree. */
 export const copy = (from, to) => {
   mkdirSync(dirname(to), { recursive: true })
   cpSync(from, to, { recursive: true })
 }
 
-/** Edit a file in place via a (content) => content transform. No-op if absent. */
+/** Edit a file in place via (content) => content. No-op if absent. */
 export const editFile = (p, fn) => {
   if (!existsSync(p)) return false
   const next = fn(read(p))
@@ -41,20 +40,20 @@ export const editFile = (p, fn) => {
   return true
 }
 
-/** Is a directory empty (or absent)? Ignores common noise files. */
+/** Dir empty (or absent)? Ignores noise files. */
 export const isDirEmpty = (p) => {
   if (!existsSync(p)) return true
   const noise = new Set(['.git', '.DS_Store'])
   return readdirSync(p).every((f) => noise.has(f))
 }
 
-/** Run a command, inheriting stdio. Returns true on exit 0. */
+/** Run a command (inherits stdio). True on exit 0. */
 export const run = (cmd, args, opts = {}) => {
   const res = spawnSync(cmd, args, { stdio: 'inherit', ...opts })
   return res.status === 0
 }
 
-/** Run a command capturing stdout (trimmed). Returns '' on failure. */
+/** Run a command, capturing trimmed stdout. '' on failure. */
 export const runCapture = (cmd, args, opts = {}) => {
   const res = spawnSync(cmd, args, { encoding: 'utf8', ...opts })
   return res.status === 0 ? (res.stdout || '').trim() : ''
@@ -62,7 +61,7 @@ export const runCapture = (cmd, args, opts = {}) => {
 
 export { join }
 
-// --- package.json helpers (operate on a parsed object, mutate in place) ---
+// --- package.json helpers (mutate parsed object in place) ---
 
 export const pkgRemoveDeps = (pkg, names) => {
   for (const field of ['dependencies', 'devDependencies']) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfredmouelle/create-stack",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "type": "module",
   "description": "Interactive, deterministic installer for the personal reference stack — forks a base app (Next.js / TanStack Start) and strips it to your selection.",
   "author": {

package/_stack/packages/analytics/capability.json

@@ -1,26 +0,0 @@
-{
-  "$schema": "../../capability.schema.json",
-  "name": "analytics",
-  "description": "Product analytics behind a swappable port. Capture events and identify users; flush/shutdown to drain pending events.",
-  "port": "src/core/port.ts",
-  "defaultAdapter": "posthog",
-  "adapters": {
-    "posthog": {
-      "deps": ["posthog-node"],
-      "env": ["POSTHOG_API_KEY", "POSTHOG_HOST"],
-      "files": ["src/adapters/posthog"]
-    },
-    "plausible": {
-      "deps": ["@alfredmouelle/http"],
-      "env": ["PLAUSIBLE_DOMAIN", "PLAUSIBLE_API_HOST"],
-      "files": ["src/adapters/plausible"]
-    },
-    "noop": {
-      "deps": [],
-      "env": [],
-      "files": ["src/adapters/noop"]
-    }
-  },
-  "sharedDeps": ["valibot"],
-  "sharedFiles": ["src/core", "src/index.ts"]
-}

package/_stack/packages/cache/capability.json

@@ -1,21 +0,0 @@
-{
-  "$schema": "../../capability.schema.json",
-  "name": "cache",
-  "description": "Key/value cache behind a swappable port. Values are serialized as JSON for remote stores.",
-  "port": "src/core/port.ts",
-  "defaultAdapter": "redis",
-  "adapters": {
-    "redis": {
-      "deps": ["ioredis"],
-      "env": ["REDIS_URL"],
-      "files": ["src/adapters/redis"]
-    },
-    "memory": {
-      "deps": [],
-      "env": [],
-      "files": ["src/adapters/memory"]
-    }
-  },
-  "sharedDeps": ["valibot"],
-  "sharedFiles": ["src/core", "src/index.ts"]
-}

package/_stack/packages/error-tracking/capability.json

@@ -1,21 +0,0 @@
-{
-  "$schema": "../../capability.schema.json",
-  "name": "error-tracking",
-  "description": "Error reporting behind a swappable port. Capture exceptions, messages, breadcrumbs and user context, then ship them to a provider.",
-  "port": "src/core/port.ts",
-  "defaultAdapter": "sentry",
-  "adapters": {
-    "sentry": {
-      "deps": ["@sentry/node"],
-      "env": ["SENTRY_DSN", "SENTRY_ENVIRONMENT"],
-      "files": ["src/adapters/sentry"]
-    },
-    "console": {
-      "deps": [],
-      "env": [],
-      "files": ["src/adapters/console"]
-    }
-  },
-  "sharedDeps": ["valibot"],
-  "sharedFiles": ["src/core", "src/index.ts"]
-}

package/_stack/packages/jobs/capability.json

@@ -1,26 +0,0 @@
-{
-  "$schema": "../../capability.schema.json",
-  "name": "jobs",
-  "description": "Background jobs / events behind a swappable port. Event-driven: define jobs against named events and trigger them; the adapter handles delivery and execution.",
-  "port": "src/core/port.ts",
-  "defaultAdapter": "inngest",
-  "adapters": {
-    "inngest": {
-      "deps": ["inngest"],
-      "env": ["INNGEST_EVENT_KEY", "INNGEST_SIGNING_KEY"],
-      "files": ["src/adapters/inngest"]
-    },
-    "trigger": {
-      "deps": ["@trigger.dev/sdk"],
-      "env": ["TRIGGER_SECRET_KEY"],
-      "files": ["src/adapters/trigger"]
-    },
-    "memory": {
-      "deps": [],
-      "env": [],
-      "files": ["src/adapters/memory"]
-    }
-  },
-  "sharedDeps": ["valibot"],
-  "sharedFiles": ["src/core", "src/index.ts"]
-}

package/_stack/packages/logger/capability.json

@@ -1,21 +0,0 @@
-{
-  "$schema": "../../capability.schema.json",
-  "name": "logger",
-  "description": "Structured logging behind a swappable port. Application code depends only on the Logger interface; pick an adapter (pino, console) at the composition root.",
-  "port": "src/core/port.ts",
-  "defaultAdapter": "pino",
-  "adapters": {
-    "pino": {
-      "deps": ["pino"],
-      "env": [],
-      "files": ["src/adapters/pino"]
-    },
-    "console": {
-      "deps": [],
-      "env": [],
-      "files": ["src/adapters/console"]
-    }
-  },
-  "sharedDeps": ["valibot"],
-  "sharedFiles": ["src/core", "src/index.ts"]
-}

package/_stack/packages/mailer/capability.json

@@ -1,28 +0,0 @@
-{
-  "$schema": "../../capability.schema.json",
-  "name": "mailer",
-  "description": "Transactional email. Bodies are always React Email components, rendered to HTML + plain text.",
-  "port": "src/core/port.ts",
-  "factory": "src/factory.ts",
-  "defaultAdapter": "resend",
-  "adapters": {
-    "resend": {
-      "deps": ["resend"],
-      "env": ["RESEND_API_KEY"],
-      "files": ["src/adapters/resend"]
-    },
-    "brevo": {
-      "deps": ["@getbrevo/brevo"],
-      "env": ["BREVO_API_KEY"],
-      "files": ["src/adapters/brevo"]
-    },
-    "ses": {
-      "deps": ["@aws-sdk/client-sesv2"],
-      "env": ["AWS_REGION", "AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY"],
-      "files": ["src/adapters/ses"]
-    }
-  },
-  "sharedDeps": ["valibot", "@react-email/render"],
-  "peerDeps": ["react", "react-dom"],
-  "sharedFiles": ["src/core", "src/factory.ts", "src/index.ts"]
-}

package/_stack/packages/storage/capability.json

@@ -1,32 +0,0 @@
-{
-  "$schema": "../../capability.schema.json",
-  "name": "storage",
-  "description": "Object storage behind a swappable port: put/get/delete/exists plus signed URLs. Adapters for S3, Cloudflare R2, Google Cloud Storage and the local filesystem.",
-  "port": "src/core/port.ts",
-  "factory": "src/index.ts",
-  "defaultAdapter": "s3",
-  "adapters": {
-    "s3": {
-      "deps": ["@aws-sdk/client-s3", "@aws-sdk/s3-request-presigner"],
-      "env": ["S3_BUCKET", "S3_REGION", "AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY"],
-      "files": ["src/adapters/s3"]
-    },
-    "r2": {
-      "deps": ["@aws-sdk/client-s3", "@aws-sdk/s3-request-presigner"],
-      "env": ["R2_BUCKET", "R2_ACCOUNT_ID", "R2_ACCESS_KEY_ID", "R2_SECRET_ACCESS_KEY"],
-      "files": ["src/adapters/r2", "src/adapters/s3"]
-    },
-    "gcs": {
-      "deps": ["@google-cloud/storage"],
-      "env": ["GCS_BUCKET", "GOOGLE_CLOUD_PROJECT"],
-      "files": ["src/adapters/gcs"]
-    },
-    "local": {
-      "deps": [],
-      "env": ["STORAGE_LOCAL_DIR"],
-      "files": ["src/adapters/local"]
-    }
-  },
-  "sharedDeps": ["valibot"],
-  "sharedFiles": ["src/core", "src/index.ts"]
-}

package/_stack/patterns/README.md

@@ -1,58 +0,0 @@
-# Patterns
-
-Foundational, framework-coupled **patterns** the `bootstrap` skill vendors into a
-freshly scaffolded app — the counterpart to `packages/` (swappable capabilities).
-
-A *capability* is a provider behind a port (mailer, storage, …), swappable by
-changing one line. A *pattern* is a foundation you don't swap but always set up
-the same way: tRPC wiring, the better-auth instance, the Drizzle client. They are
-**framework-coupled** (currently `tanstack-start`, mirrored from the reference
-base apps) and depend on each other.
-
-**The code lives in the base apps, not here.** `patterns/` is a pure *manifest
-layer*: each `pattern.json` describes a foundation (how to detect it, its deps,
-env, framework, dependencies) and lists the files that make it up — by pointing
-**into the base apps** (`apps/tanstack-base`, `apps/next-base`), the single source
-of truth. No code is duplicated.
-
-Each pattern is `<name>/pattern.json` (see `../pattern.schema.json`).
-`_baseline/` is special: real always-applied config files (Biome, tsconfig, env
-skeleton, the `# Author` README footer) that a standalone fork needs but the base
-apps don't carry on their own (they inherit the monorepo's Biome).
-
-## How the skills use these
-
-The manifests drive two flows:
-
-- **bootstrap — create mode** (empty folder): fork a base app, then *strip* every
-  foundation/capability the user didn't pick, using each manifest's `files`/`deps`/
-  `env` to know its exact footprint.
-- **bootstrap — existing project / add-capability**: match each manifest's `detect`
-  against the project → the opt-in set, then *vendor* the listed files (copied from
-  the base apps) + deps + env, wire `integratesWith` when both sides are opt-in, and
-  pull required `capabilities`. A pattern not referenced is never pulled.
-
-## Available patterns
-
-- **drizzle** — Drizzle ORM + drizzle-kit (Postgres). Client, schema barrel,
-  cursor pagination, seed harness.
-- **better-auth** — better-auth v1 with the Drizzle adapter. Email+password,
-  verification, optional Google OAuth, rate limiting, auth tables, client +
-  session helpers, route guard. `dependsOn` drizzle; needs the mailer + email-kit
-  capabilities.
-- **trpc** — tRPC v11 + TanStack React Query. Context, procedure tiers, error
-  formatter, client + SSR caller, fetch handler. `dependsOn` drizzle,
-  `integratesWith` better-auth.
-- **data-table** — headless tables with TanStack Table (table + skeleton
-  primitives, DataTable, InfiniteDataTable, SortableHeader). `framework: agnostic`
-  — works in both Next and TanStack Start.
-
-Next.js variants (App Router) of the framework-coupled patterns:
-
-- **better-auth-next** — better-auth with `next/headers` session, `toNextJsHandler`
-  catch-all, server-component guards (`requireAuth`).
-- **trpc-next** — tRPC with the classic `api.x.useQuery` hooks (createTRPCReact) +
-  RSC hydration. `integratesWith` better-auth-next.
-
-bootstrap picks the variant matching the project's framework: `trpc`/`better-auth`
-for TanStack Start, `trpc-next`/`better-auth-next` for Next.