@marktiderman/genesis-cli 1.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/cli.js CHANGED
@@ -16,7 +16,7 @@ var NOOP_LOGGER = {
16
16
  function validateConsumerName(name) {
17
17
  if (!VALID_NAME_PATTERN.test(name)) {
18
18
  throw new Error(
19
- `Invalid consumer name "${name}". Must be lowercase letters/digits/hyphens, 2-31 chars, starting with a letter (e.g., "sanctiv", "gamify-mobile").`
19
+ `Invalid consumer name "${name}". Must be lowercase letters/digits/hyphens, 2-31 chars, starting with a letter (e.g., "acme", "gamify-mobile").`
20
20
  );
21
21
  }
22
22
  }
@@ -51,7 +51,7 @@ export type { Brand } from "./brand";
51
51
  content: globalCss()
52
52
  },
53
53
  {
54
- path: `.genesis/config.yml`,
54
+ path: `.genesis/cli.yml`,
55
55
  content: genesisConfig(consumer)
56
56
  },
57
57
  {
@@ -145,7 +145,7 @@ function brandSchema(consumer) {
145
145
  *
146
146
  * Genesis primitives consume tokens from this file via the design-system
147
147
  * provider. Edit colors/spacing/typography here to retheme every screen
148
- * at once. Domain-specific tokens (e.g., "mood" for Sanctiv, "rarity" for
148
+ * at once. Domain-specific tokens (e.g., "mood" for Acme, "rarity" for
149
149
  * Gamify) go under \`extensions\` \u2014 Genesis primitives don't read these,
150
150
  * but consumer composites do via \`useGenesisExtension(key)\`.
151
151
  *
@@ -288,7 +288,10 @@ function globalCss() {
288
288
  `;
289
289
  }
290
290
  function genesisConfig(consumer) {
291
- return `# Genesis consumer config \u2014 read by genesis CLI + .claude/hooks/*
291
+ return `# Genesis DESIGN-SYSTEM consumer pin \u2014 read by the genesis CLI + .claude/hooks/*
292
+ # NOT the harness config: the schema-validated harness/root config lives at
293
+ # genesis.config.yml (see genesis.config.example.yml). This file only pins the
294
+ # @marktiderman/genesis-* version + design-system rules for this consumer.
292
295
  #
293
296
  # version pin: which @marktiderman/genesis-* major are we on. The genesis CLI
294
297
  # uses this to validate that an upgrade hasn't drifted past breaking-change
@@ -330,7 +333,7 @@ This consumer was bootstrapped with \`@marktiderman/genesis-cli init ${consumer}
330
333
 
331
334
  ## Critical rules
332
335
 
333
- - \`.genesis/config.yml\` rules are enforced via Claude Code hooks. Don't
336
+ - \`.genesis/cli.yml\` design-system rules are enforced via Claude Code hooks. Don't
334
337
  bypass with \`StyleSheet.create()\` or raw hex; use brand tokens.
335
338
  - Run \`pnpm test\` before every commit.
336
339
  - Open RFCs in the genesis repo for missing primitives \u2014 don't fork
@@ -345,7 +348,7 @@ This consumer was bootstrapped with \`@marktiderman/genesis-cli init ${consumer}
345
348
  }
346
349
  var program = new Command();
347
350
  program.name("genesis").description("Genesis CLI \u2014 scaffolders + workspace tooling").version("0.1.0");
348
- program.command("init").description("Scaffold a new Genesis consumer (brand package + tailwind + tokens)").argument("<consumer>", "Consumer slug (lowercase, e.g., 'sanctiv')").option("-t, --target <dir>", "Target directory (default: cwd)", process.cwd()).option(
351
+ program.command("init").description("Scaffold a new Genesis consumer (brand package + tailwind + tokens)").argument("<consumer>", "Consumer slug (lowercase, e.g., 'acme')").option("-t, --target <dir>", "Target directory (default: cwd)", process.cwd()).option(
349
352
  "--genesis-version <v>",
350
353
  "Pin @marktiderman/genesis-* version (default: 'workspace:^' for monorepo)"
351
354
  ).option(
package/dist/cli.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/scaffolder.ts","../src/cli.ts"],"names":["fs","path"],"mappings":"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","file":"cli.js","sourcesContent":["/**\n * Genesis init scaffolder — pure-function core.\n *\n * `runScaffolder()` takes a plan (consumer name, target dir, options) +\n * a filesystem implementation, and writes the files needed to bootstrap\n * a new Genesis-based app:\n *\n * - `packages/<consumer>-brand/src/brand.ts` (canonical schema seed)\n * - `packages/<consumer>-brand/package.json`\n * - `tailwind.config.ts` (genesis preset import)\n * - `app/global.css` (genesis tokens import)\n * - `.genesis/config.yml` (rules + version pin)\n * - `CLAUDE.md` (cross-link + workflow)\n *\n * Idempotent: existing files are NOT overwritten. The scaffolder reads\n * each target path first; if present, it appends a `.genesis-next` sibling\n * with the would-be content + emits a warning so the caller can diff. This\n * keeps the operation safe to re-run after upstream Genesis updates.\n *\n * The CLI wraps this with a real `node:fs` impl + commander argument\n * parsing; the test harness wraps it with an in-memory map for fast,\n * deterministic tests.\n *\n * @stability Beta\n */\n\nexport interface FileSystem {\n exists(path: string): Promise<boolean>;\n readFile(path: string): Promise<string>;\n writeFile(path: string, content: string): Promise<void>;\n mkdirp(dir: string): Promise<void>;\n}\n\nexport interface ScaffoldOptions {\n /** Slug used for `<consumer>-brand` package + tokens namespace. */\n consumerName: string;\n /** Target directory the scaffold writes into. Default `process.cwd()`. */\n targetDir: string;\n /** Pin Genesis package version. Default `\"workspace:^\"` if monorepo, else `\"^1.0.0\"`. */\n genesisVersion?: string;\n /** When true, even idempotent skips emit a write at `.genesis-next` for diffing. */\n emitConflicts?: boolean;\n /**\n * Logger. Defaults to a no-op when running in tests; CLI passes\n * `console.log` etc.\n */\n logger?: ScaffoldLogger;\n}\n\nexport interface ScaffoldLogger {\n info(msg: string): void;\n warn(msg: string): void;\n error(msg: string): void;\n}\n\nexport interface ScaffoldResult {\n /** Paths the scaffolder wrote. */\n written: string[];\n /** Paths that already existed and were left alone (idempotent skip). */\n skipped: string[];\n /** Paths emitted as `.genesis-next` for consumer to diff. */\n conflicts: string[];\n}\n\nconst VALID_NAME_PATTERN = /^[a-z][a-z0-9-]{1,30}$/;\n\nconst NOOP_LOGGER: ScaffoldLogger = {\n info() {},\n warn() {},\n error() {},\n};\n\n/**\n * Validate a consumer slug. Throws if invalid.\n *\n * Rules: lowercase alphanumeric + hyphens, 2-31 chars, must start with letter.\n * Matches the npm package-name subset that's also a safe directory name.\n */\nexport function validateConsumerName(name: string): void {\n if (!VALID_NAME_PATTERN.test(name)) {\n throw new Error(\n `Invalid consumer name \"${name}\". Must be lowercase letters/digits/hyphens, ` +\n `2-31 chars, starting with a letter (e.g., \"sanctiv\", \"gamify-mobile\").`,\n );\n }\n}\n\n/**\n * Compute which files the scaffolder would write for a given plan.\n * Pure function — no I/O. Tests use this directly.\n */\nexport function planScaffold(\n opts: Pick<ScaffoldOptions, \"consumerName\" | \"genesisVersion\">,\n): { path: string; content: string }[] {\n const consumer = opts.consumerName;\n const genesisVersion = opts.genesisVersion ?? \"workspace:^\";\n return [\n {\n path: `packages/${consumer}-brand/package.json`,\n content: brandPackageJson(consumer, genesisVersion),\n },\n {\n path: `packages/${consumer}-brand/src/brand.ts`,\n content: brandSchema(consumer),\n },\n {\n path: `packages/${consumer}-brand/src/index.ts`,\n content: `export { brand } from \"./brand\";\\nexport type { Brand } from \"./brand\";\\n`,\n },\n {\n path: `packages/${consumer}-brand/tsconfig.json`,\n content: brandTsconfig(),\n },\n {\n path: `tailwind.config.ts`,\n content: tailwindConfig(consumer),\n },\n {\n path: `app/global.css`,\n content: globalCss(),\n },\n {\n path: `.genesis/config.yml`,\n content: genesisConfig(consumer),\n },\n {\n path: `CLAUDE.md`,\n content: claudeMd(consumer),\n },\n ];\n}\n\n/**\n * Run the scaffolder against a FileSystem implementation. Returns a\n * record of what it did so the CLI / test harness can summarize.\n */\nexport async function runScaffold(\n opts: ScaffoldOptions,\n fs: FileSystem,\n): Promise<ScaffoldResult> {\n validateConsumerName(opts.consumerName);\n const log = opts.logger ?? NOOP_LOGGER;\n\n const plan = planScaffold(opts);\n\n const written: string[] = [];\n const skipped: string[] = [];\n const conflicts: string[] = [];\n\n for (const file of plan) {\n const fullPath = joinPath(opts.targetDir, file.path);\n const dir = dirname(fullPath);\n await fs.mkdirp(dir);\n\n const exists = await fs.exists(fullPath);\n if (!exists) {\n await fs.writeFile(fullPath, file.content);\n written.push(file.path);\n log.info(`✔ wrote ${file.path}`);\n continue;\n }\n\n // Idempotent skip — file exists. Optionally drop a `.genesis-next`\n // sibling so consumers can diff.\n const existing = await fs.readFile(fullPath);\n if (existing === file.content) {\n skipped.push(file.path);\n log.info(`= skipped ${file.path} (identical)`);\n continue;\n }\n\n if (opts.emitConflicts) {\n const nextPath = `${fullPath}.genesis-next`;\n await fs.writeFile(nextPath, file.content);\n conflicts.push(`${file.path}.genesis-next`);\n log.warn(\n `! diff ${file.path} — wrote .genesis-next sibling for review`,\n );\n } else {\n skipped.push(file.path);\n log.warn(\n `! skipped ${file.path} (exists; pass --emit-conflicts to diff)`,\n );\n }\n }\n\n return { written, skipped, conflicts };\n}\n\n// ---------------------------------------------------------------------------\n// Path helpers — kept inline so the scaffolder has zero non-commander deps\n// ---------------------------------------------------------------------------\n\nfunction joinPath(...parts: string[]): string {\n return parts\n .filter(Boolean)\n .join(\"/\")\n .replace(/\\/+/g, \"/\");\n}\n\nfunction dirname(path: string): string {\n const idx = path.lastIndexOf(\"/\");\n return idx === -1 ? \".\" : path.slice(0, idx);\n}\n\n// ---------------------------------------------------------------------------\n// Templates — readable string builders, NOT freeze-dried .tpl files. This\n// keeps the scaffolder a single .ts file and avoids __dirname juggling\n// when we publish to npm.\n// ---------------------------------------------------------------------------\n\nfunction brandPackageJson(consumer: string, genesisVersion: string): string {\n return JSON.stringify(\n {\n name: `@${consumer}/brand`,\n version: \"0.1.0\",\n private: true,\n type: \"module\",\n main: \"./src/index.ts\",\n types: \"./src/index.ts\",\n description: `Brand tokens + extensions for the ${consumer} app. Consumed by Genesis primitives via canonical schema.`,\n peerDependencies: {\n \"@marktiderman/genesis-design-system\": genesisVersion,\n },\n },\n null,\n 2,\n ) + \"\\n\";\n}\n\nfunction brandTsconfig(): string {\n return JSON.stringify(\n {\n extends: \"../../tsconfig.base.json\",\n compilerOptions: {\n outDir: \"dist\",\n rootDir: \"src\",\n },\n include: [\"src\"],\n },\n null,\n 2,\n ) + \"\\n\";\n}\n\nfunction brandSchema(consumer: string): string {\n return `/**\n * @${consumer}/brand — canonical brand tokens + extensions.\n *\n * Genesis primitives consume tokens from this file via the design-system\n * provider. Edit colors/spacing/typography here to retheme every screen\n * at once. Domain-specific tokens (e.g., \"mood\" for Sanctiv, \"rarity\" for\n * Gamify) go under \\`extensions\\` — Genesis primitives don't read these,\n * but consumer composites do via \\`useGenesisExtension(key)\\`.\n *\n * Schema is intentionally narrow at the top level. Add categories under\n * \\`extensions\\` rather than inventing new top-level slots.\n */\n\nexport interface BrandColorScale {\n 50: string;\n 100: string;\n 200: string;\n 300: string;\n 400: string;\n 500: string;\n 600: string;\n 700: string;\n 800: string;\n 900: string;\n}\n\nexport interface BrandColors {\n primary: BrandColorScale;\n destructive: BrandColorScale;\n /** Neutral / gray scale used for surfaces, text, borders. */\n neutral: BrandColorScale;\n}\n\nexport interface Brand {\n /** Slug used for namespacing (e.g., extensions key prefix). */\n name: string;\n colors: BrandColors;\n /**\n * Domain-specific token categories. Consumer composites read these\n * via \\`useGenesisExtension(\"<key>\")\\`. Genesis primitives do NOT read\n * extensions — only canonical \\`colors\\`.\n */\n extensions?: Record<string, Record<string | number, unknown>>;\n}\n\n// ---------------------------------------------------------------------------\n// Default brand — replace these placeholder values with your design's\n// actual hex values. The canonical schema is the only contract; how you\n// reach it is up to you (Figma export, hand-pick, generated from a base).\n// ---------------------------------------------------------------------------\n\nexport const brand: Brand = {\n name: \"${consumer}\",\n colors: {\n primary: {\n 50: \"#eff6ff\",\n 100: \"#dbeafe\",\n 200: \"#bfdbfe\",\n 300: \"#93c5fd\",\n 400: \"#60a5fa\",\n 500: \"#3b82f6\",\n 600: \"#2563eb\",\n 700: \"#1d4ed8\",\n 800: \"#1e40af\",\n 900: \"#1e3a8a\",\n },\n destructive: {\n 50: \"#fef2f2\",\n 100: \"#fee2e2\",\n 200: \"#fecaca\",\n 300: \"#fca5a5\",\n 400: \"#f87171\",\n 500: \"#ef4444\",\n 600: \"#dc2626\",\n 700: \"#b91c1c\",\n 800: \"#991b1b\",\n 900: \"#7f1d1d\",\n },\n neutral: {\n 50: \"#f9fafb\",\n 100: \"#f3f4f6\",\n 200: \"#e5e7eb\",\n 300: \"#d1d5db\",\n 400: \"#9ca3af\",\n 500: \"#6b7280\",\n 600: \"#4b5563\",\n 700: \"#374151\",\n 800: \"#1f2937\",\n 900: \"#111827\",\n },\n },\n // extensions: { mood: { ... }, rarity: { ... } },\n};\n`;\n}\n\nfunction tailwindConfig(consumer: string): string {\n return `import type { Config } from \"tailwindcss\";\nimport { brand } from \"@${consumer}/brand\";\n\n/**\n * Tailwind config — wires Genesis canonical tokens to your brand values.\n *\n * Genesis ships a tailwind preset that maps semantic class names\n * (\\`bg-primary\\`, \\`text-foreground\\`, etc.) to CSS variables. This config\n * extends that preset with your consumer's hex values, so Genesis\n * primitives automatically pick up your brand once the global.css import\n * fires.\n */\nconst config: Config = {\n content: [\n \"./app/**/*.{ts,tsx}\",\n \"./components/**/*.{ts,tsx}\",\n \"./node_modules/@marktiderman/genesis-ui-native/**/*.{js,ts,tsx}\",\n ],\n presets: [require(\"@marktiderman/genesis-design-system/tailwind-preset\")],\n theme: {\n extend: {\n colors: {\n primary: {\n DEFAULT: brand.colors.primary[600],\n ...brand.colors.primary,\n },\n destructive: {\n DEFAULT: brand.colors.destructive[600],\n ...brand.colors.destructive,\n },\n },\n },\n },\n};\n\nexport default config;\n`;\n}\n\nfunction globalCss(): string {\n return `/**\n * Genesis global stylesheet entry. Imports the canonical token sheet\n * + the consumer's tailwind layers. The token sheet wires CSS variables\n * (--color-primary, --color-foreground, etc.) used by every Genesis\n * primitive's tailwind classes.\n */\n@import \"@marktiderman/genesis-design-system/tokens.css\";\n@tailwind base;\n@tailwind components;\n@tailwind utilities;\n`;\n}\n\nfunction genesisConfig(consumer: string): string {\n return `# Genesis consumer config — read by genesis CLI + .claude/hooks/*\n#\n# version pin: which @marktiderman/genesis-* major are we on. The genesis CLI\n# uses this to validate that an upgrade hasn't drifted past breaking-change\n# boundaries.\nversion: \"1\"\nconsumer: \"${consumer}\"\n\nrules:\n # Block raw hex in consumer code — must use brand tokens.\n no-raw-hex: error\n # Block StyleSheet.create() in NativeWind-first projects.\n no-stylesheet-create: error\n # Block fork-and-modify of Genesis primitives.\n no-genesis-fork: error\n # Layouts must compose Genesis primitives, not rebuild them.\n prefer-genesis-layout: warn\n\n# Path map — where consumer composites + brand live. Default values match\n# the scaffolder's output; adjust if your layout differs.\npaths:\n brand: \"packages/${consumer}-brand\"\n composites: \"components\"\n app: \"app\"\n`;\n}\n\nfunction claudeMd(consumer: string): string {\n return `# CLAUDE.md — ${consumer}\n\nThis consumer was bootstrapped with \\`@marktiderman/genesis-cli init ${consumer}\\`.\n\n## Workflow\n\n- **Reuse before extend, extend before create.** See the Genesis usage\n doctrine: \\`docs/prds/PRD-07-genesis-consumption-architecture/standards/usage-doctrine.md\\`\n- **Brand changes live in \\`packages/${consumer}-brand\\`.** Don't fork Genesis\n primitives — edit your brand schema instead (Layer 1).\n- **Layout customization has 4 layers.** Default → named props →\n ScreenContainer → brand schema. Reach for the lowest layer first.\n\n## Critical rules\n\n- \\`.genesis/config.yml\\` rules are enforced via Claude Code hooks. Don't\n bypass with \\`StyleSheet.create()\\` or raw hex; use brand tokens.\n- Run \\`pnpm test\\` before every commit.\n- Open RFCs in the genesis repo for missing primitives — don't fork\n locally and forget.\n\n## Quick reference\n\n- \\`packages/${consumer}-brand/src/brand.ts\\` — your brand tokens + extensions\n- \\`tailwind.config.ts\\` — Genesis preset + brand color overrides\n- \\`app/global.css\\` — Genesis token sheet + tailwind layers\n`;\n}\n","/**\n * Genesis CLI — `genesis init <consumer>` and friends.\n *\n * Wraps the pure scaffolder with a real `node:fs` filesystem +\n * `commander` argument parser. The command itself is intentionally\n * thin so the scaffolder logic stays unit-testable in isolation.\n *\n * Usage:\n * npx @marktiderman/genesis-cli init <consumer-name> [--target <dir>] [--emit-conflicts]\n */\nimport { Command } from \"commander\";\nimport { runScaffold, type FileSystem } from \"./scaffolder.js\";\nimport * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\n\nconst program = new Command();\n\nprogram\n .name(\"genesis\")\n .description(\"Genesis CLI — scaffolders + workspace tooling\")\n .version(\"0.1.0\");\n\nprogram\n .command(\"init\")\n .description(\"Scaffold a new Genesis consumer (brand package + tailwind + tokens)\")\n .argument(\"<consumer>\", \"Consumer slug (lowercase, e.g., 'sanctiv')\")\n .option(\"-t, --target <dir>\", \"Target directory (default: cwd)\", process.cwd())\n .option(\n \"--genesis-version <v>\",\n \"Pin @marktiderman/genesis-* version (default: 'workspace:^' for monorepo)\",\n )\n .option(\n \"--emit-conflicts\",\n \"Emit `.genesis-next` siblings for files that already exist (so you can diff)\",\n false,\n )\n .action(async (consumer: string, opts: {\n target: string;\n genesisVersion?: string;\n emitConflicts?: boolean;\n }) => {\n const fsImpl = createNodeFs();\n const result = await runScaffold(\n {\n consumerName: consumer,\n targetDir: opts.target,\n genesisVersion: opts.genesisVersion,\n emitConflicts: opts.emitConflicts ?? false,\n logger: {\n info: (msg) => console.log(msg),\n warn: (msg) => console.warn(msg),\n error: (msg) => console.error(msg),\n },\n },\n fsImpl,\n );\n\n console.log(\"\");\n console.log(`✔ Wrote ${result.written.length} files`);\n if (result.skipped.length > 0) {\n console.log(`= Skipped ${result.skipped.length} (already present)`);\n }\n if (result.conflicts.length > 0) {\n console.log(\n `! ${result.conflicts.length} files written as .genesis-next siblings (diff before adopting)`,\n );\n }\n console.log(\"\");\n console.log(\"Next steps:\");\n console.log(` 1. Edit packages/${consumer}-brand/src/brand.ts with your colors`);\n console.log(` 2. pnpm install`);\n console.log(` 3. Read docs/prds/PRD-07-genesis-consumption-architecture/standards/usage-doctrine.md`);\n });\n\nprogram.parseAsync(process.argv).catch((err: unknown) => {\n const message = err instanceof Error ? err.message : String(err);\n console.error(`✗ ${message}`);\n process.exit(1);\n});\n\nfunction createNodeFs(): FileSystem {\n return {\n async exists(p: string): Promise<boolean> {\n try {\n await fs.access(p);\n return true;\n } catch (err) {\n // Only swallow ENOENT (file genuinely doesn't exist). Permission\n // / I/O errors should bubble so the user sees them — silently\n // treating them as \"not exists\" causes the scaffolder to overwrite\n // a file the user wasn't allowed to read.\n const e = err as NodeJS.ErrnoException;\n if (e.code === \"ENOENT\") return false;\n throw err;\n }\n },\n async readFile(p: string): Promise<string> {\n return fs.readFile(p, \"utf-8\");\n },\n async writeFile(p: string, content: string): Promise<void> {\n await fs.writeFile(p, content, \"utf-8\");\n },\n async mkdirp(dir: string): Promise<void> {\n await fs.mkdir(dir, { recursive: true });\n },\n };\n}\n\nvoid path;\n"]}
1
+ {"version":3,"sources":["../src/scaffolder.ts","../src/cli.ts"],"names":["fs","path"],"mappings":"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","file":"cli.js","sourcesContent":["/**\n * Genesis init scaffolder — pure-function core.\n *\n * `runScaffolder()` takes a plan (consumer name, target dir, options) +\n * a filesystem implementation, and writes the files needed to bootstrap\n * a new Genesis-based app:\n *\n * - `packages/<consumer>-brand/src/brand.ts` (canonical schema seed)\n * - `packages/<consumer>-brand/package.json`\n * - `tailwind.config.ts` (genesis preset import)\n * - `app/global.css` (genesis tokens import)\n * - `.genesis/cli.yml` (design-system rules + version pin)\n * - `CLAUDE.md` (cross-link + workflow)\n *\n * Idempotent: existing files are NOT overwritten. The scaffolder reads\n * each target path first; if present, it appends a `.genesis-next` sibling\n * with the would-be content + emits a warning so the caller can diff. This\n * keeps the operation safe to re-run after upstream Genesis updates.\n *\n * The CLI wraps this with a real `node:fs` impl + commander argument\n * parsing; the test harness wraps it with an in-memory map for fast,\n * deterministic tests.\n *\n * @stability Beta\n */\n\nexport interface FileSystem {\n exists(path: string): Promise<boolean>;\n readFile(path: string): Promise<string>;\n writeFile(path: string, content: string): Promise<void>;\n mkdirp(dir: string): Promise<void>;\n}\n\nexport interface ScaffoldOptions {\n /** Slug used for `<consumer>-brand` package + tokens namespace. */\n consumerName: string;\n /** Target directory the scaffold writes into. Default `process.cwd()`. */\n targetDir: string;\n /** Pin Genesis package version. Default `\"workspace:^\"` if monorepo, else `\"^1.0.0\"`. */\n genesisVersion?: string;\n /** When true, even idempotent skips emit a write at `.genesis-next` for diffing. */\n emitConflicts?: boolean;\n /**\n * Logger. Defaults to a no-op when running in tests; CLI passes\n * `console.log` etc.\n */\n logger?: ScaffoldLogger;\n}\n\nexport interface ScaffoldLogger {\n info(msg: string): void;\n warn(msg: string): void;\n error(msg: string): void;\n}\n\nexport interface ScaffoldResult {\n /** Paths the scaffolder wrote. */\n written: string[];\n /** Paths that already existed and were left alone (idempotent skip). */\n skipped: string[];\n /** Paths emitted as `.genesis-next` for consumer to diff. */\n conflicts: string[];\n}\n\nconst VALID_NAME_PATTERN = /^[a-z][a-z0-9-]{1,30}$/;\n\nconst NOOP_LOGGER: ScaffoldLogger = {\n info() {},\n warn() {},\n error() {},\n};\n\n/**\n * Validate a consumer slug. Throws if invalid.\n *\n * Rules: lowercase alphanumeric + hyphens, 2-31 chars, must start with letter.\n * Matches the npm package-name subset that's also a safe directory name.\n */\nexport function validateConsumerName(name: string): void {\n if (!VALID_NAME_PATTERN.test(name)) {\n throw new Error(\n `Invalid consumer name \"${name}\". Must be lowercase letters/digits/hyphens, ` +\n `2-31 chars, starting with a letter (e.g., \"acme\", \"gamify-mobile\").`,\n );\n }\n}\n\n/**\n * Compute which files the scaffolder would write for a given plan.\n * Pure function — no I/O. Tests use this directly.\n */\nexport function planScaffold(\n opts: Pick<ScaffoldOptions, \"consumerName\" | \"genesisVersion\">,\n): { path: string; content: string }[] {\n const consumer = opts.consumerName;\n const genesisVersion = opts.genesisVersion ?? \"workspace:^\";\n return [\n {\n path: `packages/${consumer}-brand/package.json`,\n content: brandPackageJson(consumer, genesisVersion),\n },\n {\n path: `packages/${consumer}-brand/src/brand.ts`,\n content: brandSchema(consumer),\n },\n {\n path: `packages/${consumer}-brand/src/index.ts`,\n content: `export { brand } from \"./brand\";\\nexport type { Brand } from \"./brand\";\\n`,\n },\n {\n path: `packages/${consumer}-brand/tsconfig.json`,\n content: brandTsconfig(),\n },\n {\n path: `tailwind.config.ts`,\n content: tailwindConfig(consumer),\n },\n {\n path: `app/global.css`,\n content: globalCss(),\n },\n {\n path: `.genesis/cli.yml`,\n content: genesisConfig(consumer),\n },\n {\n path: `CLAUDE.md`,\n content: claudeMd(consumer),\n },\n ];\n}\n\n/**\n * Run the scaffolder against a FileSystem implementation. Returns a\n * record of what it did so the CLI / test harness can summarize.\n */\nexport async function runScaffold(\n opts: ScaffoldOptions,\n fs: FileSystem,\n): Promise<ScaffoldResult> {\n validateConsumerName(opts.consumerName);\n const log = opts.logger ?? NOOP_LOGGER;\n\n const plan = planScaffold(opts);\n\n const written: string[] = [];\n const skipped: string[] = [];\n const conflicts: string[] = [];\n\n for (const file of plan) {\n const fullPath = joinPath(opts.targetDir, file.path);\n const dir = dirname(fullPath);\n await fs.mkdirp(dir);\n\n const exists = await fs.exists(fullPath);\n if (!exists) {\n await fs.writeFile(fullPath, file.content);\n written.push(file.path);\n log.info(`✔ wrote ${file.path}`);\n continue;\n }\n\n // Idempotent skip — file exists. Optionally drop a `.genesis-next`\n // sibling so consumers can diff.\n const existing = await fs.readFile(fullPath);\n if (existing === file.content) {\n skipped.push(file.path);\n log.info(`= skipped ${file.path} (identical)`);\n continue;\n }\n\n if (opts.emitConflicts) {\n const nextPath = `${fullPath}.genesis-next`;\n await fs.writeFile(nextPath, file.content);\n conflicts.push(`${file.path}.genesis-next`);\n log.warn(\n `! diff ${file.path} — wrote .genesis-next sibling for review`,\n );\n } else {\n skipped.push(file.path);\n log.warn(\n `! skipped ${file.path} (exists; pass --emit-conflicts to diff)`,\n );\n }\n }\n\n return { written, skipped, conflicts };\n}\n\n// ---------------------------------------------------------------------------\n// Path helpers — kept inline so the scaffolder has zero non-commander deps\n// ---------------------------------------------------------------------------\n\nfunction joinPath(...parts: string[]): string {\n return parts\n .filter(Boolean)\n .join(\"/\")\n .replace(/\\/+/g, \"/\");\n}\n\nfunction dirname(path: string): string {\n const idx = path.lastIndexOf(\"/\");\n return idx === -1 ? \".\" : path.slice(0, idx);\n}\n\n// ---------------------------------------------------------------------------\n// Templates — readable string builders, NOT freeze-dried .tpl files. This\n// keeps the scaffolder a single .ts file and avoids __dirname juggling\n// when we publish to npm.\n// ---------------------------------------------------------------------------\n\nfunction brandPackageJson(consumer: string, genesisVersion: string): string {\n return JSON.stringify(\n {\n name: `@${consumer}/brand`,\n version: \"0.1.0\",\n private: true,\n type: \"module\",\n main: \"./src/index.ts\",\n types: \"./src/index.ts\",\n description: `Brand tokens + extensions for the ${consumer} app. Consumed by Genesis primitives via canonical schema.`,\n peerDependencies: {\n \"@marktiderman/genesis-design-system\": genesisVersion,\n },\n },\n null,\n 2,\n ) + \"\\n\";\n}\n\nfunction brandTsconfig(): string {\n return JSON.stringify(\n {\n extends: \"../../tsconfig.base.json\",\n compilerOptions: {\n outDir: \"dist\",\n rootDir: \"src\",\n },\n include: [\"src\"],\n },\n null,\n 2,\n ) + \"\\n\";\n}\n\nfunction brandSchema(consumer: string): string {\n return `/**\n * @${consumer}/brand — canonical brand tokens + extensions.\n *\n * Genesis primitives consume tokens from this file via the design-system\n * provider. Edit colors/spacing/typography here to retheme every screen\n * at once. Domain-specific tokens (e.g., \"mood\" for Acme, \"rarity\" for\n * Gamify) go under \\`extensions\\` — Genesis primitives don't read these,\n * but consumer composites do via \\`useGenesisExtension(key)\\`.\n *\n * Schema is intentionally narrow at the top level. Add categories under\n * \\`extensions\\` rather than inventing new top-level slots.\n */\n\nexport interface BrandColorScale {\n 50: string;\n 100: string;\n 200: string;\n 300: string;\n 400: string;\n 500: string;\n 600: string;\n 700: string;\n 800: string;\n 900: string;\n}\n\nexport interface BrandColors {\n primary: BrandColorScale;\n destructive: BrandColorScale;\n /** Neutral / gray scale used for surfaces, text, borders. */\n neutral: BrandColorScale;\n}\n\nexport interface Brand {\n /** Slug used for namespacing (e.g., extensions key prefix). */\n name: string;\n colors: BrandColors;\n /**\n * Domain-specific token categories. Consumer composites read these\n * via \\`useGenesisExtension(\"<key>\")\\`. Genesis primitives do NOT read\n * extensions — only canonical \\`colors\\`.\n */\n extensions?: Record<string, Record<string | number, unknown>>;\n}\n\n// ---------------------------------------------------------------------------\n// Default brand — replace these placeholder values with your design's\n// actual hex values. The canonical schema is the only contract; how you\n// reach it is up to you (Figma export, hand-pick, generated from a base).\n// ---------------------------------------------------------------------------\n\nexport const brand: Brand = {\n name: \"${consumer}\",\n colors: {\n primary: {\n 50: \"#eff6ff\",\n 100: \"#dbeafe\",\n 200: \"#bfdbfe\",\n 300: \"#93c5fd\",\n 400: \"#60a5fa\",\n 500: \"#3b82f6\",\n 600: \"#2563eb\",\n 700: \"#1d4ed8\",\n 800: \"#1e40af\",\n 900: \"#1e3a8a\",\n },\n destructive: {\n 50: \"#fef2f2\",\n 100: \"#fee2e2\",\n 200: \"#fecaca\",\n 300: \"#fca5a5\",\n 400: \"#f87171\",\n 500: \"#ef4444\",\n 600: \"#dc2626\",\n 700: \"#b91c1c\",\n 800: \"#991b1b\",\n 900: \"#7f1d1d\",\n },\n neutral: {\n 50: \"#f9fafb\",\n 100: \"#f3f4f6\",\n 200: \"#e5e7eb\",\n 300: \"#d1d5db\",\n 400: \"#9ca3af\",\n 500: \"#6b7280\",\n 600: \"#4b5563\",\n 700: \"#374151\",\n 800: \"#1f2937\",\n 900: \"#111827\",\n },\n },\n // extensions: { mood: { ... }, rarity: { ... } },\n};\n`;\n}\n\nfunction tailwindConfig(consumer: string): string {\n return `import type { Config } from \"tailwindcss\";\nimport { brand } from \"@${consumer}/brand\";\n\n/**\n * Tailwind config — wires Genesis canonical tokens to your brand values.\n *\n * Genesis ships a tailwind preset that maps semantic class names\n * (\\`bg-primary\\`, \\`text-foreground\\`, etc.) to CSS variables. This config\n * extends that preset with your consumer's hex values, so Genesis\n * primitives automatically pick up your brand once the global.css import\n * fires.\n */\nconst config: Config = {\n content: [\n \"./app/**/*.{ts,tsx}\",\n \"./components/**/*.{ts,tsx}\",\n \"./node_modules/@marktiderman/genesis-ui-native/**/*.{js,ts,tsx}\",\n ],\n presets: [require(\"@marktiderman/genesis-design-system/tailwind-preset\")],\n theme: {\n extend: {\n colors: {\n primary: {\n DEFAULT: brand.colors.primary[600],\n ...brand.colors.primary,\n },\n destructive: {\n DEFAULT: brand.colors.destructive[600],\n ...brand.colors.destructive,\n },\n },\n },\n },\n};\n\nexport default config;\n`;\n}\n\nfunction globalCss(): string {\n return `/**\n * Genesis global stylesheet entry. Imports the canonical token sheet\n * + the consumer's tailwind layers. The token sheet wires CSS variables\n * (--color-primary, --color-foreground, etc.) used by every Genesis\n * primitive's tailwind classes.\n */\n@import \"@marktiderman/genesis-design-system/tokens.css\";\n@tailwind base;\n@tailwind components;\n@tailwind utilities;\n`;\n}\n\nfunction genesisConfig(consumer: string): string {\n return `# Genesis DESIGN-SYSTEM consumer pin — read by the genesis CLI + .claude/hooks/*\n# NOT the harness config: the schema-validated harness/root config lives at\n# genesis.config.yml (see genesis.config.example.yml). This file only pins the\n# @marktiderman/genesis-* version + design-system rules for this consumer.\n#\n# version pin: which @marktiderman/genesis-* major are we on. The genesis CLI\n# uses this to validate that an upgrade hasn't drifted past breaking-change\n# boundaries.\nversion: \"1\"\nconsumer: \"${consumer}\"\n\nrules:\n # Block raw hex in consumer code — must use brand tokens.\n no-raw-hex: error\n # Block StyleSheet.create() in NativeWind-first projects.\n no-stylesheet-create: error\n # Block fork-and-modify of Genesis primitives.\n no-genesis-fork: error\n # Layouts must compose Genesis primitives, not rebuild them.\n prefer-genesis-layout: warn\n\n# Path map — where consumer composites + brand live. Default values match\n# the scaffolder's output; adjust if your layout differs.\npaths:\n brand: \"packages/${consumer}-brand\"\n composites: \"components\"\n app: \"app\"\n`;\n}\n\nfunction claudeMd(consumer: string): string {\n return `# CLAUDE.md — ${consumer}\n\nThis consumer was bootstrapped with \\`@marktiderman/genesis-cli init ${consumer}\\`.\n\n## Workflow\n\n- **Reuse before extend, extend before create.** See the Genesis usage\n doctrine: \\`docs/prds/PRD-07-genesis-consumption-architecture/standards/usage-doctrine.md\\`\n- **Brand changes live in \\`packages/${consumer}-brand\\`.** Don't fork Genesis\n primitives — edit your brand schema instead (Layer 1).\n- **Layout customization has 4 layers.** Default → named props →\n ScreenContainer → brand schema. Reach for the lowest layer first.\n\n## Critical rules\n\n- \\`.genesis/cli.yml\\` design-system rules are enforced via Claude Code hooks. Don't\n bypass with \\`StyleSheet.create()\\` or raw hex; use brand tokens.\n- Run \\`pnpm test\\` before every commit.\n- Open RFCs in the genesis repo for missing primitives — don't fork\n locally and forget.\n\n## Quick reference\n\n- \\`packages/${consumer}-brand/src/brand.ts\\` — your brand tokens + extensions\n- \\`tailwind.config.ts\\` — Genesis preset + brand color overrides\n- \\`app/global.css\\` — Genesis token sheet + tailwind layers\n`;\n}\n","/**\n * Genesis CLI — `genesis init <consumer>` and friends.\n *\n * Wraps the pure scaffolder with a real `node:fs` filesystem +\n * `commander` argument parser. The command itself is intentionally\n * thin so the scaffolder logic stays unit-testable in isolation.\n *\n * Usage:\n * npx @marktiderman/genesis-cli init <consumer-name> [--target <dir>] [--emit-conflicts]\n */\nimport { Command } from \"commander\";\nimport { runScaffold, type FileSystem } from \"./scaffolder.js\";\nimport * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\n\nconst program = new Command();\n\nprogram\n .name(\"genesis\")\n .description(\"Genesis CLI — scaffolders + workspace tooling\")\n .version(\"0.1.0\");\n\nprogram\n .command(\"init\")\n .description(\"Scaffold a new Genesis consumer (brand package + tailwind + tokens)\")\n .argument(\"<consumer>\", \"Consumer slug (lowercase, e.g., 'acme')\")\n .option(\"-t, --target <dir>\", \"Target directory (default: cwd)\", process.cwd())\n .option(\n \"--genesis-version <v>\",\n \"Pin @marktiderman/genesis-* version (default: 'workspace:^' for monorepo)\",\n )\n .option(\n \"--emit-conflicts\",\n \"Emit `.genesis-next` siblings for files that already exist (so you can diff)\",\n false,\n )\n .action(async (consumer: string, opts: {\n target: string;\n genesisVersion?: string;\n emitConflicts?: boolean;\n }) => {\n const fsImpl = createNodeFs();\n const result = await runScaffold(\n {\n consumerName: consumer,\n targetDir: opts.target,\n genesisVersion: opts.genesisVersion,\n emitConflicts: opts.emitConflicts ?? false,\n logger: {\n info: (msg) => console.log(msg),\n warn: (msg) => console.warn(msg),\n error: (msg) => console.error(msg),\n },\n },\n fsImpl,\n );\n\n console.log(\"\");\n console.log(`✔ Wrote ${result.written.length} files`);\n if (result.skipped.length > 0) {\n console.log(`= Skipped ${result.skipped.length} (already present)`);\n }\n if (result.conflicts.length > 0) {\n console.log(\n `! ${result.conflicts.length} files written as .genesis-next siblings (diff before adopting)`,\n );\n }\n console.log(\"\");\n console.log(\"Next steps:\");\n console.log(` 1. Edit packages/${consumer}-brand/src/brand.ts with your colors`);\n console.log(` 2. pnpm install`);\n console.log(` 3. Read docs/prds/PRD-07-genesis-consumption-architecture/standards/usage-doctrine.md`);\n });\n\nprogram.parseAsync(process.argv).catch((err: unknown) => {\n const message = err instanceof Error ? err.message : String(err);\n console.error(`✗ ${message}`);\n process.exit(1);\n});\n\nfunction createNodeFs(): FileSystem {\n return {\n async exists(p: string): Promise<boolean> {\n try {\n await fs.access(p);\n return true;\n } catch (err) {\n // Only swallow ENOENT (file genuinely doesn't exist). Permission\n // / I/O errors should bubble so the user sees them — silently\n // treating them as \"not exists\" causes the scaffolder to overwrite\n // a file the user wasn't allowed to read.\n const e = err as NodeJS.ErrnoException;\n if (e.code === \"ENOENT\") return false;\n throw err;\n }\n },\n async readFile(p: string): Promise<string> {\n return fs.readFile(p, \"utf-8\");\n },\n async writeFile(p: string, content: string): Promise<void> {\n await fs.writeFile(p, content, \"utf-8\");\n },\n async mkdirp(dir: string): Promise<void> {\n await fs.mkdir(dir, { recursive: true });\n },\n };\n}\n\nvoid path;\n"]}
package/dist/index.js CHANGED
@@ -11,7 +11,7 @@ var NOOP_LOGGER = {
11
11
  function validateConsumerName(name) {
12
12
  if (!VALID_NAME_PATTERN.test(name)) {
13
13
  throw new Error(
14
- `Invalid consumer name "${name}". Must be lowercase letters/digits/hyphens, 2-31 chars, starting with a letter (e.g., "sanctiv", "gamify-mobile").`
14
+ `Invalid consumer name "${name}". Must be lowercase letters/digits/hyphens, 2-31 chars, starting with a letter (e.g., "acme", "gamify-mobile").`
15
15
  );
16
16
  }
17
17
  }
@@ -46,7 +46,7 @@ export type { Brand } from "./brand";
46
46
  content: globalCss()
47
47
  },
48
48
  {
49
- path: `.genesis/config.yml`,
49
+ path: `.genesis/cli.yml`,
50
50
  content: genesisConfig(consumer)
51
51
  },
52
52
  {
@@ -140,7 +140,7 @@ function brandSchema(consumer) {
140
140
  *
141
141
  * Genesis primitives consume tokens from this file via the design-system
142
142
  * provider. Edit colors/spacing/typography here to retheme every screen
143
- * at once. Domain-specific tokens (e.g., "mood" for Sanctiv, "rarity" for
143
+ * at once. Domain-specific tokens (e.g., "mood" for Acme, "rarity" for
144
144
  * Gamify) go under \`extensions\` \u2014 Genesis primitives don't read these,
145
145
  * but consumer composites do via \`useGenesisExtension(key)\`.
146
146
  *
@@ -283,7 +283,10 @@ function globalCss() {
283
283
  `;
284
284
  }
285
285
  function genesisConfig(consumer) {
286
- return `# Genesis consumer config \u2014 read by genesis CLI + .claude/hooks/*
286
+ return `# Genesis DESIGN-SYSTEM consumer pin \u2014 read by the genesis CLI + .claude/hooks/*
287
+ # NOT the harness config: the schema-validated harness/root config lives at
288
+ # genesis.config.yml (see genesis.config.example.yml). This file only pins the
289
+ # @marktiderman/genesis-* version + design-system rules for this consumer.
287
290
  #
288
291
  # version pin: which @marktiderman/genesis-* major are we on. The genesis CLI
289
292
  # uses this to validate that an upgrade hasn't drifted past breaking-change
@@ -325,7 +328,7 @@ This consumer was bootstrapped with \`@marktiderman/genesis-cli init ${consumer}
325
328
 
326
329
  ## Critical rules
327
330
 
328
- - \`.genesis/config.yml\` rules are enforced via Claude Code hooks. Don't
331
+ - \`.genesis/cli.yml\` design-system rules are enforced via Claude Code hooks. Don't
329
332
  bypass with \`StyleSheet.create()\` or raw hex; use brand tokens.
330
333
  - Run \`pnpm test\` before every commit.
331
334
  - Open RFCs in the genesis repo for missing primitives \u2014 don't fork
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/scaffolder.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Genesis init scaffolder — pure-function core.\n *\n * `runScaffolder()` takes a plan (consumer name, target dir, options) +\n * a filesystem implementation, and writes the files needed to bootstrap\n * a new Genesis-based app:\n *\n * - `packages/<consumer>-brand/src/brand.ts` (canonical schema seed)\n * - `packages/<consumer>-brand/package.json`\n * - `tailwind.config.ts` (genesis preset import)\n * - `app/global.css` (genesis tokens import)\n * - `.genesis/config.yml` (rules + version pin)\n * - `CLAUDE.md` (cross-link + workflow)\n *\n * Idempotent: existing files are NOT overwritten. The scaffolder reads\n * each target path first; if present, it appends a `.genesis-next` sibling\n * with the would-be content + emits a warning so the caller can diff. This\n * keeps the operation safe to re-run after upstream Genesis updates.\n *\n * The CLI wraps this with a real `node:fs` impl + commander argument\n * parsing; the test harness wraps it with an in-memory map for fast,\n * deterministic tests.\n *\n * @stability Beta\n */\n\nexport interface FileSystem {\n exists(path: string): Promise<boolean>;\n readFile(path: string): Promise<string>;\n writeFile(path: string, content: string): Promise<void>;\n mkdirp(dir: string): Promise<void>;\n}\n\nexport interface ScaffoldOptions {\n /** Slug used for `<consumer>-brand` package + tokens namespace. */\n consumerName: string;\n /** Target directory the scaffold writes into. Default `process.cwd()`. */\n targetDir: string;\n /** Pin Genesis package version. Default `\"workspace:^\"` if monorepo, else `\"^1.0.0\"`. */\n genesisVersion?: string;\n /** When true, even idempotent skips emit a write at `.genesis-next` for diffing. */\n emitConflicts?: boolean;\n /**\n * Logger. Defaults to a no-op when running in tests; CLI passes\n * `console.log` etc.\n */\n logger?: ScaffoldLogger;\n}\n\nexport interface ScaffoldLogger {\n info(msg: string): void;\n warn(msg: string): void;\n error(msg: string): void;\n}\n\nexport interface ScaffoldResult {\n /** Paths the scaffolder wrote. */\n written: string[];\n /** Paths that already existed and were left alone (idempotent skip). */\n skipped: string[];\n /** Paths emitted as `.genesis-next` for consumer to diff. */\n conflicts: string[];\n}\n\nconst VALID_NAME_PATTERN = /^[a-z][a-z0-9-]{1,30}$/;\n\nconst NOOP_LOGGER: ScaffoldLogger = {\n info() {},\n warn() {},\n error() {},\n};\n\n/**\n * Validate a consumer slug. Throws if invalid.\n *\n * Rules: lowercase alphanumeric + hyphens, 2-31 chars, must start with letter.\n * Matches the npm package-name subset that's also a safe directory name.\n */\nexport function validateConsumerName(name: string): void {\n if (!VALID_NAME_PATTERN.test(name)) {\n throw new Error(\n `Invalid consumer name \"${name}\". Must be lowercase letters/digits/hyphens, ` +\n `2-31 chars, starting with a letter (e.g., \"sanctiv\", \"gamify-mobile\").`,\n );\n }\n}\n\n/**\n * Compute which files the scaffolder would write for a given plan.\n * Pure function — no I/O. Tests use this directly.\n */\nexport function planScaffold(\n opts: Pick<ScaffoldOptions, \"consumerName\" | \"genesisVersion\">,\n): { path: string; content: string }[] {\n const consumer = opts.consumerName;\n const genesisVersion = opts.genesisVersion ?? \"workspace:^\";\n return [\n {\n path: `packages/${consumer}-brand/package.json`,\n content: brandPackageJson(consumer, genesisVersion),\n },\n {\n path: `packages/${consumer}-brand/src/brand.ts`,\n content: brandSchema(consumer),\n },\n {\n path: `packages/${consumer}-brand/src/index.ts`,\n content: `export { brand } from \"./brand\";\\nexport type { Brand } from \"./brand\";\\n`,\n },\n {\n path: `packages/${consumer}-brand/tsconfig.json`,\n content: brandTsconfig(),\n },\n {\n path: `tailwind.config.ts`,\n content: tailwindConfig(consumer),\n },\n {\n path: `app/global.css`,\n content: globalCss(),\n },\n {\n path: `.genesis/config.yml`,\n content: genesisConfig(consumer),\n },\n {\n path: `CLAUDE.md`,\n content: claudeMd(consumer),\n },\n ];\n}\n\n/**\n * Run the scaffolder against a FileSystem implementation. Returns a\n * record of what it did so the CLI / test harness can summarize.\n */\nexport async function runScaffold(\n opts: ScaffoldOptions,\n fs: FileSystem,\n): Promise<ScaffoldResult> {\n validateConsumerName(opts.consumerName);\n const log = opts.logger ?? NOOP_LOGGER;\n\n const plan = planScaffold(opts);\n\n const written: string[] = [];\n const skipped: string[] = [];\n const conflicts: string[] = [];\n\n for (const file of plan) {\n const fullPath = joinPath(opts.targetDir, file.path);\n const dir = dirname(fullPath);\n await fs.mkdirp(dir);\n\n const exists = await fs.exists(fullPath);\n if (!exists) {\n await fs.writeFile(fullPath, file.content);\n written.push(file.path);\n log.info(`✔ wrote ${file.path}`);\n continue;\n }\n\n // Idempotent skip — file exists. Optionally drop a `.genesis-next`\n // sibling so consumers can diff.\n const existing = await fs.readFile(fullPath);\n if (existing === file.content) {\n skipped.push(file.path);\n log.info(`= skipped ${file.path} (identical)`);\n continue;\n }\n\n if (opts.emitConflicts) {\n const nextPath = `${fullPath}.genesis-next`;\n await fs.writeFile(nextPath, file.content);\n conflicts.push(`${file.path}.genesis-next`);\n log.warn(\n `! diff ${file.path} — wrote .genesis-next sibling for review`,\n );\n } else {\n skipped.push(file.path);\n log.warn(\n `! skipped ${file.path} (exists; pass --emit-conflicts to diff)`,\n );\n }\n }\n\n return { written, skipped, conflicts };\n}\n\n// ---------------------------------------------------------------------------\n// Path helpers — kept inline so the scaffolder has zero non-commander deps\n// ---------------------------------------------------------------------------\n\nfunction joinPath(...parts: string[]): string {\n return parts\n .filter(Boolean)\n .join(\"/\")\n .replace(/\\/+/g, \"/\");\n}\n\nfunction dirname(path: string): string {\n const idx = path.lastIndexOf(\"/\");\n return idx === -1 ? \".\" : path.slice(0, idx);\n}\n\n// ---------------------------------------------------------------------------\n// Templates — readable string builders, NOT freeze-dried .tpl files. This\n// keeps the scaffolder a single .ts file and avoids __dirname juggling\n// when we publish to npm.\n// ---------------------------------------------------------------------------\n\nfunction brandPackageJson(consumer: string, genesisVersion: string): string {\n return JSON.stringify(\n {\n name: `@${consumer}/brand`,\n version: \"0.1.0\",\n private: true,\n type: \"module\",\n main: \"./src/index.ts\",\n types: \"./src/index.ts\",\n description: `Brand tokens + extensions for the ${consumer} app. Consumed by Genesis primitives via canonical schema.`,\n peerDependencies: {\n \"@marktiderman/genesis-design-system\": genesisVersion,\n },\n },\n null,\n 2,\n ) + \"\\n\";\n}\n\nfunction brandTsconfig(): string {\n return JSON.stringify(\n {\n extends: \"../../tsconfig.base.json\",\n compilerOptions: {\n outDir: \"dist\",\n rootDir: \"src\",\n },\n include: [\"src\"],\n },\n null,\n 2,\n ) + \"\\n\";\n}\n\nfunction brandSchema(consumer: string): string {\n return `/**\n * @${consumer}/brand — canonical brand tokens + extensions.\n *\n * Genesis primitives consume tokens from this file via the design-system\n * provider. Edit colors/spacing/typography here to retheme every screen\n * at once. Domain-specific tokens (e.g., \"mood\" for Sanctiv, \"rarity\" for\n * Gamify) go under \\`extensions\\` — Genesis primitives don't read these,\n * but consumer composites do via \\`useGenesisExtension(key)\\`.\n *\n * Schema is intentionally narrow at the top level. Add categories under\n * \\`extensions\\` rather than inventing new top-level slots.\n */\n\nexport interface BrandColorScale {\n 50: string;\n 100: string;\n 200: string;\n 300: string;\n 400: string;\n 500: string;\n 600: string;\n 700: string;\n 800: string;\n 900: string;\n}\n\nexport interface BrandColors {\n primary: BrandColorScale;\n destructive: BrandColorScale;\n /** Neutral / gray scale used for surfaces, text, borders. */\n neutral: BrandColorScale;\n}\n\nexport interface Brand {\n /** Slug used for namespacing (e.g., extensions key prefix). */\n name: string;\n colors: BrandColors;\n /**\n * Domain-specific token categories. Consumer composites read these\n * via \\`useGenesisExtension(\"<key>\")\\`. Genesis primitives do NOT read\n * extensions — only canonical \\`colors\\`.\n */\n extensions?: Record<string, Record<string | number, unknown>>;\n}\n\n// ---------------------------------------------------------------------------\n// Default brand — replace these placeholder values with your design's\n// actual hex values. The canonical schema is the only contract; how you\n// reach it is up to you (Figma export, hand-pick, generated from a base).\n// ---------------------------------------------------------------------------\n\nexport const brand: Brand = {\n name: \"${consumer}\",\n colors: {\n primary: {\n 50: \"#eff6ff\",\n 100: \"#dbeafe\",\n 200: \"#bfdbfe\",\n 300: \"#93c5fd\",\n 400: \"#60a5fa\",\n 500: \"#3b82f6\",\n 600: \"#2563eb\",\n 700: \"#1d4ed8\",\n 800: \"#1e40af\",\n 900: \"#1e3a8a\",\n },\n destructive: {\n 50: \"#fef2f2\",\n 100: \"#fee2e2\",\n 200: \"#fecaca\",\n 300: \"#fca5a5\",\n 400: \"#f87171\",\n 500: \"#ef4444\",\n 600: \"#dc2626\",\n 700: \"#b91c1c\",\n 800: \"#991b1b\",\n 900: \"#7f1d1d\",\n },\n neutral: {\n 50: \"#f9fafb\",\n 100: \"#f3f4f6\",\n 200: \"#e5e7eb\",\n 300: \"#d1d5db\",\n 400: \"#9ca3af\",\n 500: \"#6b7280\",\n 600: \"#4b5563\",\n 700: \"#374151\",\n 800: \"#1f2937\",\n 900: \"#111827\",\n },\n },\n // extensions: { mood: { ... }, rarity: { ... } },\n};\n`;\n}\n\nfunction tailwindConfig(consumer: string): string {\n return `import type { Config } from \"tailwindcss\";\nimport { brand } from \"@${consumer}/brand\";\n\n/**\n * Tailwind config — wires Genesis canonical tokens to your brand values.\n *\n * Genesis ships a tailwind preset that maps semantic class names\n * (\\`bg-primary\\`, \\`text-foreground\\`, etc.) to CSS variables. This config\n * extends that preset with your consumer's hex values, so Genesis\n * primitives automatically pick up your brand once the global.css import\n * fires.\n */\nconst config: Config = {\n content: [\n \"./app/**/*.{ts,tsx}\",\n \"./components/**/*.{ts,tsx}\",\n \"./node_modules/@marktiderman/genesis-ui-native/**/*.{js,ts,tsx}\",\n ],\n presets: [require(\"@marktiderman/genesis-design-system/tailwind-preset\")],\n theme: {\n extend: {\n colors: {\n primary: {\n DEFAULT: brand.colors.primary[600],\n ...brand.colors.primary,\n },\n destructive: {\n DEFAULT: brand.colors.destructive[600],\n ...brand.colors.destructive,\n },\n },\n },\n },\n};\n\nexport default config;\n`;\n}\n\nfunction globalCss(): string {\n return `/**\n * Genesis global stylesheet entry. Imports the canonical token sheet\n * + the consumer's tailwind layers. The token sheet wires CSS variables\n * (--color-primary, --color-foreground, etc.) used by every Genesis\n * primitive's tailwind classes.\n */\n@import \"@marktiderman/genesis-design-system/tokens.css\";\n@tailwind base;\n@tailwind components;\n@tailwind utilities;\n`;\n}\n\nfunction genesisConfig(consumer: string): string {\n return `# Genesis consumer config — read by genesis CLI + .claude/hooks/*\n#\n# version pin: which @marktiderman/genesis-* major are we on. The genesis CLI\n# uses this to validate that an upgrade hasn't drifted past breaking-change\n# boundaries.\nversion: \"1\"\nconsumer: \"${consumer}\"\n\nrules:\n # Block raw hex in consumer code — must use brand tokens.\n no-raw-hex: error\n # Block StyleSheet.create() in NativeWind-first projects.\n no-stylesheet-create: error\n # Block fork-and-modify of Genesis primitives.\n no-genesis-fork: error\n # Layouts must compose Genesis primitives, not rebuild them.\n prefer-genesis-layout: warn\n\n# Path map — where consumer composites + brand live. Default values match\n# the scaffolder's output; adjust if your layout differs.\npaths:\n brand: \"packages/${consumer}-brand\"\n composites: \"components\"\n app: \"app\"\n`;\n}\n\nfunction claudeMd(consumer: string): string {\n return `# CLAUDE.md — ${consumer}\n\nThis consumer was bootstrapped with \\`@marktiderman/genesis-cli init ${consumer}\\`.\n\n## Workflow\n\n- **Reuse before extend, extend before create.** See the Genesis usage\n doctrine: \\`docs/prds/PRD-07-genesis-consumption-architecture/standards/usage-doctrine.md\\`\n- **Brand changes live in \\`packages/${consumer}-brand\\`.** Don't fork Genesis\n primitives — edit your brand schema instead (Layer 1).\n- **Layout customization has 4 layers.** Default → named props →\n ScreenContainer → brand schema. Reach for the lowest layer first.\n\n## Critical rules\n\n- \\`.genesis/config.yml\\` rules are enforced via Claude Code hooks. Don't\n bypass with \\`StyleSheet.create()\\` or raw hex; use brand tokens.\n- Run \\`pnpm test\\` before every commit.\n- Open RFCs in the genesis repo for missing primitives — don't fork\n locally and forget.\n\n## Quick reference\n\n- \\`packages/${consumer}-brand/src/brand.ts\\` — your brand tokens + extensions\n- \\`tailwind.config.ts\\` — Genesis preset + brand color overrides\n- \\`app/global.css\\` — Genesis token sheet + tailwind layers\n`;\n}\n"]}
1
+ {"version":3,"sources":["../src/scaffolder.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Genesis init scaffolder — pure-function core.\n *\n * `runScaffolder()` takes a plan (consumer name, target dir, options) +\n * a filesystem implementation, and writes the files needed to bootstrap\n * a new Genesis-based app:\n *\n * - `packages/<consumer>-brand/src/brand.ts` (canonical schema seed)\n * - `packages/<consumer>-brand/package.json`\n * - `tailwind.config.ts` (genesis preset import)\n * - `app/global.css` (genesis tokens import)\n * - `.genesis/cli.yml` (design-system rules + version pin)\n * - `CLAUDE.md` (cross-link + workflow)\n *\n * Idempotent: existing files are NOT overwritten. The scaffolder reads\n * each target path first; if present, it appends a `.genesis-next` sibling\n * with the would-be content + emits a warning so the caller can diff. This\n * keeps the operation safe to re-run after upstream Genesis updates.\n *\n * The CLI wraps this with a real `node:fs` impl + commander argument\n * parsing; the test harness wraps it with an in-memory map for fast,\n * deterministic tests.\n *\n * @stability Beta\n */\n\nexport interface FileSystem {\n exists(path: string): Promise<boolean>;\n readFile(path: string): Promise<string>;\n writeFile(path: string, content: string): Promise<void>;\n mkdirp(dir: string): Promise<void>;\n}\n\nexport interface ScaffoldOptions {\n /** Slug used for `<consumer>-brand` package + tokens namespace. */\n consumerName: string;\n /** Target directory the scaffold writes into. Default `process.cwd()`. */\n targetDir: string;\n /** Pin Genesis package version. Default `\"workspace:^\"` if monorepo, else `\"^1.0.0\"`. */\n genesisVersion?: string;\n /** When true, even idempotent skips emit a write at `.genesis-next` for diffing. */\n emitConflicts?: boolean;\n /**\n * Logger. Defaults to a no-op when running in tests; CLI passes\n * `console.log` etc.\n */\n logger?: ScaffoldLogger;\n}\n\nexport interface ScaffoldLogger {\n info(msg: string): void;\n warn(msg: string): void;\n error(msg: string): void;\n}\n\nexport interface ScaffoldResult {\n /** Paths the scaffolder wrote. */\n written: string[];\n /** Paths that already existed and were left alone (idempotent skip). */\n skipped: string[];\n /** Paths emitted as `.genesis-next` for consumer to diff. */\n conflicts: string[];\n}\n\nconst VALID_NAME_PATTERN = /^[a-z][a-z0-9-]{1,30}$/;\n\nconst NOOP_LOGGER: ScaffoldLogger = {\n info() {},\n warn() {},\n error() {},\n};\n\n/**\n * Validate a consumer slug. Throws if invalid.\n *\n * Rules: lowercase alphanumeric + hyphens, 2-31 chars, must start with letter.\n * Matches the npm package-name subset that's also a safe directory name.\n */\nexport function validateConsumerName(name: string): void {\n if (!VALID_NAME_PATTERN.test(name)) {\n throw new Error(\n `Invalid consumer name \"${name}\". Must be lowercase letters/digits/hyphens, ` +\n `2-31 chars, starting with a letter (e.g., \"acme\", \"gamify-mobile\").`,\n );\n }\n}\n\n/**\n * Compute which files the scaffolder would write for a given plan.\n * Pure function — no I/O. Tests use this directly.\n */\nexport function planScaffold(\n opts: Pick<ScaffoldOptions, \"consumerName\" | \"genesisVersion\">,\n): { path: string; content: string }[] {\n const consumer = opts.consumerName;\n const genesisVersion = opts.genesisVersion ?? \"workspace:^\";\n return [\n {\n path: `packages/${consumer}-brand/package.json`,\n content: brandPackageJson(consumer, genesisVersion),\n },\n {\n path: `packages/${consumer}-brand/src/brand.ts`,\n content: brandSchema(consumer),\n },\n {\n path: `packages/${consumer}-brand/src/index.ts`,\n content: `export { brand } from \"./brand\";\\nexport type { Brand } from \"./brand\";\\n`,\n },\n {\n path: `packages/${consumer}-brand/tsconfig.json`,\n content: brandTsconfig(),\n },\n {\n path: `tailwind.config.ts`,\n content: tailwindConfig(consumer),\n },\n {\n path: `app/global.css`,\n content: globalCss(),\n },\n {\n path: `.genesis/cli.yml`,\n content: genesisConfig(consumer),\n },\n {\n path: `CLAUDE.md`,\n content: claudeMd(consumer),\n },\n ];\n}\n\n/**\n * Run the scaffolder against a FileSystem implementation. Returns a\n * record of what it did so the CLI / test harness can summarize.\n */\nexport async function runScaffold(\n opts: ScaffoldOptions,\n fs: FileSystem,\n): Promise<ScaffoldResult> {\n validateConsumerName(opts.consumerName);\n const log = opts.logger ?? NOOP_LOGGER;\n\n const plan = planScaffold(opts);\n\n const written: string[] = [];\n const skipped: string[] = [];\n const conflicts: string[] = [];\n\n for (const file of plan) {\n const fullPath = joinPath(opts.targetDir, file.path);\n const dir = dirname(fullPath);\n await fs.mkdirp(dir);\n\n const exists = await fs.exists(fullPath);\n if (!exists) {\n await fs.writeFile(fullPath, file.content);\n written.push(file.path);\n log.info(`✔ wrote ${file.path}`);\n continue;\n }\n\n // Idempotent skip — file exists. Optionally drop a `.genesis-next`\n // sibling so consumers can diff.\n const existing = await fs.readFile(fullPath);\n if (existing === file.content) {\n skipped.push(file.path);\n log.info(`= skipped ${file.path} (identical)`);\n continue;\n }\n\n if (opts.emitConflicts) {\n const nextPath = `${fullPath}.genesis-next`;\n await fs.writeFile(nextPath, file.content);\n conflicts.push(`${file.path}.genesis-next`);\n log.warn(\n `! diff ${file.path} — wrote .genesis-next sibling for review`,\n );\n } else {\n skipped.push(file.path);\n log.warn(\n `! skipped ${file.path} (exists; pass --emit-conflicts to diff)`,\n );\n }\n }\n\n return { written, skipped, conflicts };\n}\n\n// ---------------------------------------------------------------------------\n// Path helpers — kept inline so the scaffolder has zero non-commander deps\n// ---------------------------------------------------------------------------\n\nfunction joinPath(...parts: string[]): string {\n return parts\n .filter(Boolean)\n .join(\"/\")\n .replace(/\\/+/g, \"/\");\n}\n\nfunction dirname(path: string): string {\n const idx = path.lastIndexOf(\"/\");\n return idx === -1 ? \".\" : path.slice(0, idx);\n}\n\n// ---------------------------------------------------------------------------\n// Templates — readable string builders, NOT freeze-dried .tpl files. This\n// keeps the scaffolder a single .ts file and avoids __dirname juggling\n// when we publish to npm.\n// ---------------------------------------------------------------------------\n\nfunction brandPackageJson(consumer: string, genesisVersion: string): string {\n return JSON.stringify(\n {\n name: `@${consumer}/brand`,\n version: \"0.1.0\",\n private: true,\n type: \"module\",\n main: \"./src/index.ts\",\n types: \"./src/index.ts\",\n description: `Brand tokens + extensions for the ${consumer} app. Consumed by Genesis primitives via canonical schema.`,\n peerDependencies: {\n \"@marktiderman/genesis-design-system\": genesisVersion,\n },\n },\n null,\n 2,\n ) + \"\\n\";\n}\n\nfunction brandTsconfig(): string {\n return JSON.stringify(\n {\n extends: \"../../tsconfig.base.json\",\n compilerOptions: {\n outDir: \"dist\",\n rootDir: \"src\",\n },\n include: [\"src\"],\n },\n null,\n 2,\n ) + \"\\n\";\n}\n\nfunction brandSchema(consumer: string): string {\n return `/**\n * @${consumer}/brand — canonical brand tokens + extensions.\n *\n * Genesis primitives consume tokens from this file via the design-system\n * provider. Edit colors/spacing/typography here to retheme every screen\n * at once. Domain-specific tokens (e.g., \"mood\" for Acme, \"rarity\" for\n * Gamify) go under \\`extensions\\` — Genesis primitives don't read these,\n * but consumer composites do via \\`useGenesisExtension(key)\\`.\n *\n * Schema is intentionally narrow at the top level. Add categories under\n * \\`extensions\\` rather than inventing new top-level slots.\n */\n\nexport interface BrandColorScale {\n 50: string;\n 100: string;\n 200: string;\n 300: string;\n 400: string;\n 500: string;\n 600: string;\n 700: string;\n 800: string;\n 900: string;\n}\n\nexport interface BrandColors {\n primary: BrandColorScale;\n destructive: BrandColorScale;\n /** Neutral / gray scale used for surfaces, text, borders. */\n neutral: BrandColorScale;\n}\n\nexport interface Brand {\n /** Slug used for namespacing (e.g., extensions key prefix). */\n name: string;\n colors: BrandColors;\n /**\n * Domain-specific token categories. Consumer composites read these\n * via \\`useGenesisExtension(\"<key>\")\\`. Genesis primitives do NOT read\n * extensions — only canonical \\`colors\\`.\n */\n extensions?: Record<string, Record<string | number, unknown>>;\n}\n\n// ---------------------------------------------------------------------------\n// Default brand — replace these placeholder values with your design's\n// actual hex values. The canonical schema is the only contract; how you\n// reach it is up to you (Figma export, hand-pick, generated from a base).\n// ---------------------------------------------------------------------------\n\nexport const brand: Brand = {\n name: \"${consumer}\",\n colors: {\n primary: {\n 50: \"#eff6ff\",\n 100: \"#dbeafe\",\n 200: \"#bfdbfe\",\n 300: \"#93c5fd\",\n 400: \"#60a5fa\",\n 500: \"#3b82f6\",\n 600: \"#2563eb\",\n 700: \"#1d4ed8\",\n 800: \"#1e40af\",\n 900: \"#1e3a8a\",\n },\n destructive: {\n 50: \"#fef2f2\",\n 100: \"#fee2e2\",\n 200: \"#fecaca\",\n 300: \"#fca5a5\",\n 400: \"#f87171\",\n 500: \"#ef4444\",\n 600: \"#dc2626\",\n 700: \"#b91c1c\",\n 800: \"#991b1b\",\n 900: \"#7f1d1d\",\n },\n neutral: {\n 50: \"#f9fafb\",\n 100: \"#f3f4f6\",\n 200: \"#e5e7eb\",\n 300: \"#d1d5db\",\n 400: \"#9ca3af\",\n 500: \"#6b7280\",\n 600: \"#4b5563\",\n 700: \"#374151\",\n 800: \"#1f2937\",\n 900: \"#111827\",\n },\n },\n // extensions: { mood: { ... }, rarity: { ... } },\n};\n`;\n}\n\nfunction tailwindConfig(consumer: string): string {\n return `import type { Config } from \"tailwindcss\";\nimport { brand } from \"@${consumer}/brand\";\n\n/**\n * Tailwind config — wires Genesis canonical tokens to your brand values.\n *\n * Genesis ships a tailwind preset that maps semantic class names\n * (\\`bg-primary\\`, \\`text-foreground\\`, etc.) to CSS variables. This config\n * extends that preset with your consumer's hex values, so Genesis\n * primitives automatically pick up your brand once the global.css import\n * fires.\n */\nconst config: Config = {\n content: [\n \"./app/**/*.{ts,tsx}\",\n \"./components/**/*.{ts,tsx}\",\n \"./node_modules/@marktiderman/genesis-ui-native/**/*.{js,ts,tsx}\",\n ],\n presets: [require(\"@marktiderman/genesis-design-system/tailwind-preset\")],\n theme: {\n extend: {\n colors: {\n primary: {\n DEFAULT: brand.colors.primary[600],\n ...brand.colors.primary,\n },\n destructive: {\n DEFAULT: brand.colors.destructive[600],\n ...brand.colors.destructive,\n },\n },\n },\n },\n};\n\nexport default config;\n`;\n}\n\nfunction globalCss(): string {\n return `/**\n * Genesis global stylesheet entry. Imports the canonical token sheet\n * + the consumer's tailwind layers. The token sheet wires CSS variables\n * (--color-primary, --color-foreground, etc.) used by every Genesis\n * primitive's tailwind classes.\n */\n@import \"@marktiderman/genesis-design-system/tokens.css\";\n@tailwind base;\n@tailwind components;\n@tailwind utilities;\n`;\n}\n\nfunction genesisConfig(consumer: string): string {\n return `# Genesis DESIGN-SYSTEM consumer pin — read by the genesis CLI + .claude/hooks/*\n# NOT the harness config: the schema-validated harness/root config lives at\n# genesis.config.yml (see genesis.config.example.yml). This file only pins the\n# @marktiderman/genesis-* version + design-system rules for this consumer.\n#\n# version pin: which @marktiderman/genesis-* major are we on. The genesis CLI\n# uses this to validate that an upgrade hasn't drifted past breaking-change\n# boundaries.\nversion: \"1\"\nconsumer: \"${consumer}\"\n\nrules:\n # Block raw hex in consumer code — must use brand tokens.\n no-raw-hex: error\n # Block StyleSheet.create() in NativeWind-first projects.\n no-stylesheet-create: error\n # Block fork-and-modify of Genesis primitives.\n no-genesis-fork: error\n # Layouts must compose Genesis primitives, not rebuild them.\n prefer-genesis-layout: warn\n\n# Path map — where consumer composites + brand live. Default values match\n# the scaffolder's output; adjust if your layout differs.\npaths:\n brand: \"packages/${consumer}-brand\"\n composites: \"components\"\n app: \"app\"\n`;\n}\n\nfunction claudeMd(consumer: string): string {\n return `# CLAUDE.md — ${consumer}\n\nThis consumer was bootstrapped with \\`@marktiderman/genesis-cli init ${consumer}\\`.\n\n## Workflow\n\n- **Reuse before extend, extend before create.** See the Genesis usage\n doctrine: \\`docs/prds/PRD-07-genesis-consumption-architecture/standards/usage-doctrine.md\\`\n- **Brand changes live in \\`packages/${consumer}-brand\\`.** Don't fork Genesis\n primitives — edit your brand schema instead (Layer 1).\n- **Layout customization has 4 layers.** Default → named props →\n ScreenContainer → brand schema. Reach for the lowest layer first.\n\n## Critical rules\n\n- \\`.genesis/cli.yml\\` design-system rules are enforced via Claude Code hooks. Don't\n bypass with \\`StyleSheet.create()\\` or raw hex; use brand tokens.\n- Run \\`pnpm test\\` before every commit.\n- Open RFCs in the genesis repo for missing primitives — don't fork\n locally and forget.\n\n## Quick reference\n\n- \\`packages/${consumer}-brand/src/brand.ts\\` — your brand tokens + extensions\n- \\`tailwind.config.ts\\` — Genesis preset + brand color overrides\n- \\`app/global.css\\` — Genesis token sheet + tailwind layers\n`;\n}\n"]}
@@ -9,7 +9,7 @@
9
9
  * - `packages/<consumer>-brand/package.json`
10
10
  * - `tailwind.config.ts` (genesis preset import)
11
11
  * - `app/global.css` (genesis tokens import)
12
- * - `.genesis/config.yml` (rules + version pin)
12
+ * - `.genesis/cli.yml` (design-system rules + version pin)
13
13
  * - `CLAUDE.md` (cross-link + workflow)
14
14
  *
15
15
  * Idempotent: existing files are NOT overwritten. The scaffolder reads
@@ -11,7 +11,7 @@ var NOOP_LOGGER = {
11
11
  function validateConsumerName(name) {
12
12
  if (!VALID_NAME_PATTERN.test(name)) {
13
13
  throw new Error(
14
- `Invalid consumer name "${name}". Must be lowercase letters/digits/hyphens, 2-31 chars, starting with a letter (e.g., "sanctiv", "gamify-mobile").`
14
+ `Invalid consumer name "${name}". Must be lowercase letters/digits/hyphens, 2-31 chars, starting with a letter (e.g., "acme", "gamify-mobile").`
15
15
  );
16
16
  }
17
17
  }
@@ -46,7 +46,7 @@ export type { Brand } from "./brand";
46
46
  content: globalCss()
47
47
  },
48
48
  {
49
- path: `.genesis/config.yml`,
49
+ path: `.genesis/cli.yml`,
50
50
  content: genesisConfig(consumer)
51
51
  },
52
52
  {
@@ -140,7 +140,7 @@ function brandSchema(consumer) {
140
140
  *
141
141
  * Genesis primitives consume tokens from this file via the design-system
142
142
  * provider. Edit colors/spacing/typography here to retheme every screen
143
- * at once. Domain-specific tokens (e.g., "mood" for Sanctiv, "rarity" for
143
+ * at once. Domain-specific tokens (e.g., "mood" for Acme, "rarity" for
144
144
  * Gamify) go under \`extensions\` \u2014 Genesis primitives don't read these,
145
145
  * but consumer composites do via \`useGenesisExtension(key)\`.
146
146
  *
@@ -283,7 +283,10 @@ function globalCss() {
283
283
  `;
284
284
  }
285
285
  function genesisConfig(consumer) {
286
- return `# Genesis consumer config \u2014 read by genesis CLI + .claude/hooks/*
286
+ return `# Genesis DESIGN-SYSTEM consumer pin \u2014 read by the genesis CLI + .claude/hooks/*
287
+ # NOT the harness config: the schema-validated harness/root config lives at
288
+ # genesis.config.yml (see genesis.config.example.yml). This file only pins the
289
+ # @marktiderman/genesis-* version + design-system rules for this consumer.
287
290
  #
288
291
  # version pin: which @marktiderman/genesis-* major are we on. The genesis CLI
289
292
  # uses this to validate that an upgrade hasn't drifted past breaking-change
@@ -325,7 +328,7 @@ This consumer was bootstrapped with \`@marktiderman/genesis-cli init ${consumer}
325
328
 
326
329
  ## Critical rules
327
330
 
328
- - \`.genesis/config.yml\` rules are enforced via Claude Code hooks. Don't
331
+ - \`.genesis/cli.yml\` design-system rules are enforced via Claude Code hooks. Don't
329
332
  bypass with \`StyleSheet.create()\` or raw hex; use brand tokens.
330
333
  - Run \`pnpm test\` before every commit.
331
334
  - Open RFCs in the genesis repo for missing primitives \u2014 don't fork
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/scaffolder.ts"],"names":[],"mappings":"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","file":"scaffolder.js","sourcesContent":["/**\n * Genesis init scaffolder — pure-function core.\n *\n * `runScaffolder()` takes a plan (consumer name, target dir, options) +\n * a filesystem implementation, and writes the files needed to bootstrap\n * a new Genesis-based app:\n *\n * - `packages/<consumer>-brand/src/brand.ts` (canonical schema seed)\n * - `packages/<consumer>-brand/package.json`\n * - `tailwind.config.ts` (genesis preset import)\n * - `app/global.css` (genesis tokens import)\n * - `.genesis/config.yml` (rules + version pin)\n * - `CLAUDE.md` (cross-link + workflow)\n *\n * Idempotent: existing files are NOT overwritten. The scaffolder reads\n * each target path first; if present, it appends a `.genesis-next` sibling\n * with the would-be content + emits a warning so the caller can diff. This\n * keeps the operation safe to re-run after upstream Genesis updates.\n *\n * The CLI wraps this with a real `node:fs` impl + commander argument\n * parsing; the test harness wraps it with an in-memory map for fast,\n * deterministic tests.\n *\n * @stability Beta\n */\n\nexport interface FileSystem {\n exists(path: string): Promise<boolean>;\n readFile(path: string): Promise<string>;\n writeFile(path: string, content: string): Promise<void>;\n mkdirp(dir: string): Promise<void>;\n}\n\nexport interface ScaffoldOptions {\n /** Slug used for `<consumer>-brand` package + tokens namespace. */\n consumerName: string;\n /** Target directory the scaffold writes into. Default `process.cwd()`. */\n targetDir: string;\n /** Pin Genesis package version. Default `\"workspace:^\"` if monorepo, else `\"^1.0.0\"`. */\n genesisVersion?: string;\n /** When true, even idempotent skips emit a write at `.genesis-next` for diffing. */\n emitConflicts?: boolean;\n /**\n * Logger. Defaults to a no-op when running in tests; CLI passes\n * `console.log` etc.\n */\n logger?: ScaffoldLogger;\n}\n\nexport interface ScaffoldLogger {\n info(msg: string): void;\n warn(msg: string): void;\n error(msg: string): void;\n}\n\nexport interface ScaffoldResult {\n /** Paths the scaffolder wrote. */\n written: string[];\n /** Paths that already existed and were left alone (idempotent skip). */\n skipped: string[];\n /** Paths emitted as `.genesis-next` for consumer to diff. */\n conflicts: string[];\n}\n\nconst VALID_NAME_PATTERN = /^[a-z][a-z0-9-]{1,30}$/;\n\nconst NOOP_LOGGER: ScaffoldLogger = {\n info() {},\n warn() {},\n error() {},\n};\n\n/**\n * Validate a consumer slug. Throws if invalid.\n *\n * Rules: lowercase alphanumeric + hyphens, 2-31 chars, must start with letter.\n * Matches the npm package-name subset that's also a safe directory name.\n */\nexport function validateConsumerName(name: string): void {\n if (!VALID_NAME_PATTERN.test(name)) {\n throw new Error(\n `Invalid consumer name \"${name}\". Must be lowercase letters/digits/hyphens, ` +\n `2-31 chars, starting with a letter (e.g., \"sanctiv\", \"gamify-mobile\").`,\n );\n }\n}\n\n/**\n * Compute which files the scaffolder would write for a given plan.\n * Pure function — no I/O. Tests use this directly.\n */\nexport function planScaffold(\n opts: Pick<ScaffoldOptions, \"consumerName\" | \"genesisVersion\">,\n): { path: string; content: string }[] {\n const consumer = opts.consumerName;\n const genesisVersion = opts.genesisVersion ?? \"workspace:^\";\n return [\n {\n path: `packages/${consumer}-brand/package.json`,\n content: brandPackageJson(consumer, genesisVersion),\n },\n {\n path: `packages/${consumer}-brand/src/brand.ts`,\n content: brandSchema(consumer),\n },\n {\n path: `packages/${consumer}-brand/src/index.ts`,\n content: `export { brand } from \"./brand\";\\nexport type { Brand } from \"./brand\";\\n`,\n },\n {\n path: `packages/${consumer}-brand/tsconfig.json`,\n content: brandTsconfig(),\n },\n {\n path: `tailwind.config.ts`,\n content: tailwindConfig(consumer),\n },\n {\n path: `app/global.css`,\n content: globalCss(),\n },\n {\n path: `.genesis/config.yml`,\n content: genesisConfig(consumer),\n },\n {\n path: `CLAUDE.md`,\n content: claudeMd(consumer),\n },\n ];\n}\n\n/**\n * Run the scaffolder against a FileSystem implementation. Returns a\n * record of what it did so the CLI / test harness can summarize.\n */\nexport async function runScaffold(\n opts: ScaffoldOptions,\n fs: FileSystem,\n): Promise<ScaffoldResult> {\n validateConsumerName(opts.consumerName);\n const log = opts.logger ?? NOOP_LOGGER;\n\n const plan = planScaffold(opts);\n\n const written: string[] = [];\n const skipped: string[] = [];\n const conflicts: string[] = [];\n\n for (const file of plan) {\n const fullPath = joinPath(opts.targetDir, file.path);\n const dir = dirname(fullPath);\n await fs.mkdirp(dir);\n\n const exists = await fs.exists(fullPath);\n if (!exists) {\n await fs.writeFile(fullPath, file.content);\n written.push(file.path);\n log.info(`✔ wrote ${file.path}`);\n continue;\n }\n\n // Idempotent skip — file exists. Optionally drop a `.genesis-next`\n // sibling so consumers can diff.\n const existing = await fs.readFile(fullPath);\n if (existing === file.content) {\n skipped.push(file.path);\n log.info(`= skipped ${file.path} (identical)`);\n continue;\n }\n\n if (opts.emitConflicts) {\n const nextPath = `${fullPath}.genesis-next`;\n await fs.writeFile(nextPath, file.content);\n conflicts.push(`${file.path}.genesis-next`);\n log.warn(\n `! diff ${file.path} — wrote .genesis-next sibling for review`,\n );\n } else {\n skipped.push(file.path);\n log.warn(\n `! skipped ${file.path} (exists; pass --emit-conflicts to diff)`,\n );\n }\n }\n\n return { written, skipped, conflicts };\n}\n\n// ---------------------------------------------------------------------------\n// Path helpers — kept inline so the scaffolder has zero non-commander deps\n// ---------------------------------------------------------------------------\n\nfunction joinPath(...parts: string[]): string {\n return parts\n .filter(Boolean)\n .join(\"/\")\n .replace(/\\/+/g, \"/\");\n}\n\nfunction dirname(path: string): string {\n const idx = path.lastIndexOf(\"/\");\n return idx === -1 ? \".\" : path.slice(0, idx);\n}\n\n// ---------------------------------------------------------------------------\n// Templates — readable string builders, NOT freeze-dried .tpl files. This\n// keeps the scaffolder a single .ts file and avoids __dirname juggling\n// when we publish to npm.\n// ---------------------------------------------------------------------------\n\nfunction brandPackageJson(consumer: string, genesisVersion: string): string {\n return JSON.stringify(\n {\n name: `@${consumer}/brand`,\n version: \"0.1.0\",\n private: true,\n type: \"module\",\n main: \"./src/index.ts\",\n types: \"./src/index.ts\",\n description: `Brand tokens + extensions for the ${consumer} app. Consumed by Genesis primitives via canonical schema.`,\n peerDependencies: {\n \"@marktiderman/genesis-design-system\": genesisVersion,\n },\n },\n null,\n 2,\n ) + \"\\n\";\n}\n\nfunction brandTsconfig(): string {\n return JSON.stringify(\n {\n extends: \"../../tsconfig.base.json\",\n compilerOptions: {\n outDir: \"dist\",\n rootDir: \"src\",\n },\n include: [\"src\"],\n },\n null,\n 2,\n ) + \"\\n\";\n}\n\nfunction brandSchema(consumer: string): string {\n return `/**\n * @${consumer}/brand — canonical brand tokens + extensions.\n *\n * Genesis primitives consume tokens from this file via the design-system\n * provider. Edit colors/spacing/typography here to retheme every screen\n * at once. Domain-specific tokens (e.g., \"mood\" for Sanctiv, \"rarity\" for\n * Gamify) go under \\`extensions\\` — Genesis primitives don't read these,\n * but consumer composites do via \\`useGenesisExtension(key)\\`.\n *\n * Schema is intentionally narrow at the top level. Add categories under\n * \\`extensions\\` rather than inventing new top-level slots.\n */\n\nexport interface BrandColorScale {\n 50: string;\n 100: string;\n 200: string;\n 300: string;\n 400: string;\n 500: string;\n 600: string;\n 700: string;\n 800: string;\n 900: string;\n}\n\nexport interface BrandColors {\n primary: BrandColorScale;\n destructive: BrandColorScale;\n /** Neutral / gray scale used for surfaces, text, borders. */\n neutral: BrandColorScale;\n}\n\nexport interface Brand {\n /** Slug used for namespacing (e.g., extensions key prefix). */\n name: string;\n colors: BrandColors;\n /**\n * Domain-specific token categories. Consumer composites read these\n * via \\`useGenesisExtension(\"<key>\")\\`. Genesis primitives do NOT read\n * extensions — only canonical \\`colors\\`.\n */\n extensions?: Record<string, Record<string | number, unknown>>;\n}\n\n// ---------------------------------------------------------------------------\n// Default brand — replace these placeholder values with your design's\n// actual hex values. The canonical schema is the only contract; how you\n// reach it is up to you (Figma export, hand-pick, generated from a base).\n// ---------------------------------------------------------------------------\n\nexport const brand: Brand = {\n name: \"${consumer}\",\n colors: {\n primary: {\n 50: \"#eff6ff\",\n 100: \"#dbeafe\",\n 200: \"#bfdbfe\",\n 300: \"#93c5fd\",\n 400: \"#60a5fa\",\n 500: \"#3b82f6\",\n 600: \"#2563eb\",\n 700: \"#1d4ed8\",\n 800: \"#1e40af\",\n 900: \"#1e3a8a\",\n },\n destructive: {\n 50: \"#fef2f2\",\n 100: \"#fee2e2\",\n 200: \"#fecaca\",\n 300: \"#fca5a5\",\n 400: \"#f87171\",\n 500: \"#ef4444\",\n 600: \"#dc2626\",\n 700: \"#b91c1c\",\n 800: \"#991b1b\",\n 900: \"#7f1d1d\",\n },\n neutral: {\n 50: \"#f9fafb\",\n 100: \"#f3f4f6\",\n 200: \"#e5e7eb\",\n 300: \"#d1d5db\",\n 400: \"#9ca3af\",\n 500: \"#6b7280\",\n 600: \"#4b5563\",\n 700: \"#374151\",\n 800: \"#1f2937\",\n 900: \"#111827\",\n },\n },\n // extensions: { mood: { ... }, rarity: { ... } },\n};\n`;\n}\n\nfunction tailwindConfig(consumer: string): string {\n return `import type { Config } from \"tailwindcss\";\nimport { brand } from \"@${consumer}/brand\";\n\n/**\n * Tailwind config — wires Genesis canonical tokens to your brand values.\n *\n * Genesis ships a tailwind preset that maps semantic class names\n * (\\`bg-primary\\`, \\`text-foreground\\`, etc.) to CSS variables. This config\n * extends that preset with your consumer's hex values, so Genesis\n * primitives automatically pick up your brand once the global.css import\n * fires.\n */\nconst config: Config = {\n content: [\n \"./app/**/*.{ts,tsx}\",\n \"./components/**/*.{ts,tsx}\",\n \"./node_modules/@marktiderman/genesis-ui-native/**/*.{js,ts,tsx}\",\n ],\n presets: [require(\"@marktiderman/genesis-design-system/tailwind-preset\")],\n theme: {\n extend: {\n colors: {\n primary: {\n DEFAULT: brand.colors.primary[600],\n ...brand.colors.primary,\n },\n destructive: {\n DEFAULT: brand.colors.destructive[600],\n ...brand.colors.destructive,\n },\n },\n },\n },\n};\n\nexport default config;\n`;\n}\n\nfunction globalCss(): string {\n return `/**\n * Genesis global stylesheet entry. Imports the canonical token sheet\n * + the consumer's tailwind layers. The token sheet wires CSS variables\n * (--color-primary, --color-foreground, etc.) used by every Genesis\n * primitive's tailwind classes.\n */\n@import \"@marktiderman/genesis-design-system/tokens.css\";\n@tailwind base;\n@tailwind components;\n@tailwind utilities;\n`;\n}\n\nfunction genesisConfig(consumer: string): string {\n return `# Genesis consumer config — read by genesis CLI + .claude/hooks/*\n#\n# version pin: which @marktiderman/genesis-* major are we on. The genesis CLI\n# uses this to validate that an upgrade hasn't drifted past breaking-change\n# boundaries.\nversion: \"1\"\nconsumer: \"${consumer}\"\n\nrules:\n # Block raw hex in consumer code — must use brand tokens.\n no-raw-hex: error\n # Block StyleSheet.create() in NativeWind-first projects.\n no-stylesheet-create: error\n # Block fork-and-modify of Genesis primitives.\n no-genesis-fork: error\n # Layouts must compose Genesis primitives, not rebuild them.\n prefer-genesis-layout: warn\n\n# Path map — where consumer composites + brand live. Default values match\n# the scaffolder's output; adjust if your layout differs.\npaths:\n brand: \"packages/${consumer}-brand\"\n composites: \"components\"\n app: \"app\"\n`;\n}\n\nfunction claudeMd(consumer: string): string {\n return `# CLAUDE.md — ${consumer}\n\nThis consumer was bootstrapped with \\`@marktiderman/genesis-cli init ${consumer}\\`.\n\n## Workflow\n\n- **Reuse before extend, extend before create.** See the Genesis usage\n doctrine: \\`docs/prds/PRD-07-genesis-consumption-architecture/standards/usage-doctrine.md\\`\n- **Brand changes live in \\`packages/${consumer}-brand\\`.** Don't fork Genesis\n primitives — edit your brand schema instead (Layer 1).\n- **Layout customization has 4 layers.** Default → named props →\n ScreenContainer → brand schema. Reach for the lowest layer first.\n\n## Critical rules\n\n- \\`.genesis/config.yml\\` rules are enforced via Claude Code hooks. Don't\n bypass with \\`StyleSheet.create()\\` or raw hex; use brand tokens.\n- Run \\`pnpm test\\` before every commit.\n- Open RFCs in the genesis repo for missing primitives — don't fork\n locally and forget.\n\n## Quick reference\n\n- \\`packages/${consumer}-brand/src/brand.ts\\` — your brand tokens + extensions\n- \\`tailwind.config.ts\\` — Genesis preset + brand color overrides\n- \\`app/global.css\\` — Genesis token sheet + tailwind layers\n`;\n}\n"]}
1
+ {"version":3,"sources":["../src/scaffolder.ts"],"names":[],"mappings":";AAgEA,IAAM,kBAAA,GAAqB,wBAAA;AAE3B,IAAM,WAAA,GAA8B;AAAA,EAClC,IAAA,GAAO;AAAA,EAAC,CAAA;AAAA,EACR,IAAA,GAAO;AAAA,EAAC,CAAA;AAAA,EACR,KAAA,GAAQ;AAAA,EAAC;AACX,CAAA;AAQO,SAAS,qBAAqB,IAAA,EAAoB;AACvD,EAAA,IAAI,CAAC,kBAAA,CAAmB,IAAA,CAAK,IAAI,CAAA,EAAG;AAClC,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,0BAA0B,IAAI,CAAA,gHAAA;AAAA,KAEhC;AAAA,EACF;AACF;AAMO,SAAS,aACd,IAAA,EACqC;AACrC,EAAA,MAAM,WAAW,IAAA,CAAK,YAAA;AACtB,EAAA,MAAM,cAAA,GAAiB,KAAK,cAAA,IAAkB,aAAA;AAC9C,EAAA,OAAO;AAAA,IACL;AAAA,MACE,IAAA,EAAM,YAAY,QAAQ,CAAA,mBAAA,CAAA;AAAA,MAC1B,OAAA,EAAS,gBAAA,CAAiB,QAAA,EAAU,cAAc;AAAA,KACpD;AAAA,IACA;AAAA,MACE,IAAA,EAAM,YAAY,QAAQ,CAAA,mBAAA,CAAA;AAAA,MAC1B,OAAA,EAAS,YAAY,QAAQ;AAAA,KAC/B;AAAA,IACA;AAAA,MACE,IAAA,EAAM,YAAY,QAAQ,CAAA,mBAAA,CAAA;AAAA,MAC1B,OAAA,EAAS,CAAA;AAAA;AAAA;AAAA,KACX;AAAA,IACA;AAAA,MACE,IAAA,EAAM,YAAY,QAAQ,CAAA,oBAAA,CAAA;AAAA,MAC1B,SAAS,aAAA;AAAc,KACzB;AAAA,IACA;AAAA,MACE,IAAA,EAAM,CAAA,kBAAA,CAAA;AAAA,MACN,OAAA,EAAS,eAAe,QAAQ;AAAA,KAClC;AAAA,IACA;AAAA,MACE,IAAA,EAAM,CAAA,cAAA,CAAA;AAAA,MACN,SAAS,SAAA;AAAU,KACrB;AAAA,IACA;AAAA,MACE,IAAA,EAAM,CAAA,gBAAA,CAAA;AAAA,MACN,OAAA,EAAS,cAAc,QAAQ;AAAA,KACjC;AAAA,IACA;AAAA,MACE,IAAA,EAAM,CAAA,SAAA,CAAA;AAAA,MACN,OAAA,EAAS,SAAS,QAAQ;AAAA;AAC5B,GACF;AACF;AAMA,eAAsB,WAAA,CACpB,MACA,EAAA,EACyB;AACzB,EAAA,oBAAA,CAAqB,KAAK,YAAY,CAAA;AACtC,EAAA,MAAM,GAAA,GAAM,KAAK,MAAA,IAAU,WAAA;AAE3B,EAAA,MAAM,IAAA,GAAO,aAAa,IAAI,CAAA;AAE9B,EAAA,MAAM,UAAoB,EAAC;AAC3B,EAAA,MAAM,UAAoB,EAAC;AAC3B,EAAA,MAAM,YAAsB,EAAC;AAE7B,EAAA,KAAA,MAAW,QAAQ,IAAA,EAAM;AACvB,IAAA,MAAM,QAAA,GAAW,QAAA,CAAS,IAAA,CAAK,SAAA,EAAW,KAAK,IAAI,CAAA;AACnD,IAAA,MAAM,GAAA,GAAM,QAAQ,QAAQ,CAAA;AAC5B,IAAA,MAAM,EAAA,CAAG,OAAO,GAAG,CAAA;AAEnB,IAAA,MAAM,MAAA,GAAS,MAAM,EAAA,CAAG,MAAA,CAAO,QAAQ,CAAA;AACvC,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,MAAM,EAAA,CAAG,SAAA,CAAU,QAAA,EAAU,IAAA,CAAK,OAAO,CAAA;AACzC,MAAA,OAAA,CAAQ,IAAA,CAAK,KAAK,IAAI,CAAA;AACtB,MAAA,GAAA,CAAI,IAAA,CAAK,CAAA,aAAA,EAAW,IAAA,CAAK,IAAI,CAAA,CAAE,CAAA;AAC/B,MAAA;AAAA,IACF;AAIA,IAAA,MAAM,QAAA,GAAW,MAAM,EAAA,CAAG,QAAA,CAAS,QAAQ,CAAA;AAC3C,IAAA,IAAI,QAAA,KAAa,KAAK,OAAA,EAAS;AAC7B,MAAA,OAAA,CAAQ,IAAA,CAAK,KAAK,IAAI,CAAA;AACtB,MAAA,GAAA,CAAI,IAAA,CAAK,CAAA,UAAA,EAAa,IAAA,CAAK,IAAI,CAAA,YAAA,CAAc,CAAA;AAC7C,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,KAAK,aAAA,EAAe;AACtB,MAAA,MAAM,QAAA,GAAW,GAAG,QAAQ,CAAA,aAAA,CAAA;AAC5B,MAAA,MAAM,EAAA,CAAG,SAAA,CAAU,QAAA,EAAU,IAAA,CAAK,OAAO,CAAA;AACzC,MAAA,SAAA,CAAU,IAAA,CAAK,CAAA,EAAG,IAAA,CAAK,IAAI,CAAA,aAAA,CAAe,CAAA;AAC1C,MAAA,GAAA,CAAI,IAAA;AAAA,QACF,CAAA,OAAA,EAAU,KAAK,IAAI,CAAA,8CAAA;AAAA,OACrB;AAAA,IACF,CAAA,MAAO;AACL,MAAA,OAAA,CAAQ,IAAA,CAAK,KAAK,IAAI,CAAA;AACtB,MAAA,GAAA,CAAI,IAAA;AAAA,QACF,CAAA,UAAA,EAAa,KAAK,IAAI,CAAA,wCAAA;AAAA,OACxB;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,EAAE,OAAA,EAAS,OAAA,EAAS,SAAA,EAAU;AACvC;AAMA,SAAS,YAAY,KAAA,EAAyB;AAC5C,EAAA,OAAO,KAAA,CACJ,OAAO,OAAO,CAAA,CACd,KAAK,GAAG,CAAA,CACR,OAAA,CAAQ,MAAA,EAAQ,GAAG,CAAA;AACxB;AAEA,SAAS,QAAQ,IAAA,EAAsB;AACrC,EAAA,MAAM,GAAA,GAAM,IAAA,CAAK,WAAA,CAAY,GAAG,CAAA;AAChC,EAAA,OAAO,QAAQ,EAAA,GAAK,GAAA,GAAM,IAAA,CAAK,KAAA,CAAM,GAAG,GAAG,CAAA;AAC7C;AAQA,SAAS,gBAAA,CAAiB,UAAkB,cAAA,EAAgC;AAC1E,EAAA,OAAO,IAAA,CAAK,SAAA;AAAA,IACV;AAAA,MACE,IAAA,EAAM,IAAI,QAAQ,CAAA,MAAA,CAAA;AAAA,MAClB,OAAA,EAAS,OAAA;AAAA,MACT,OAAA,EAAS,IAAA;AAAA,MACT,IAAA,EAAM,QAAA;AAAA,MACN,IAAA,EAAM,gBAAA;AAAA,MACN,KAAA,EAAO,gBAAA;AAAA,MACP,WAAA,EAAa,qCAAqC,QAAQ,CAAA,0DAAA,CAAA;AAAA,MAC1D,gBAAA,EAAkB;AAAA,QAChB,qCAAA,EAAuC;AAAA;AACzC,KACF;AAAA,IACA,IAAA;AAAA,IACA;AAAA,GACF,GAAI,IAAA;AACN;AAEA,SAAS,aAAA,GAAwB;AAC/B,EAAA,OAAO,IAAA,CAAK,SAAA;AAAA,IACV;AAAA,MACE,OAAA,EAAS,0BAAA;AAAA,MACT,eAAA,EAAiB;AAAA,QACf,MAAA,EAAQ,MAAA;AAAA,QACR,OAAA,EAAS;AAAA,OACX;AAAA,MACA,OAAA,EAAS,CAAC,KAAK;AAAA,KACjB;AAAA,IACA,IAAA;AAAA,IACA;AAAA,GACF,GAAI,IAAA;AACN;AAEA,SAAS,YAAY,QAAA,EAA0B;AAC7C,EAAA,OAAO,CAAA;AAAA,IAAA,EACH,QAAQ,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA,SAAA,EAmDH,QAAQ,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAAA;AA0CnB;AAEA,SAAS,eAAe,QAAA,EAA0B;AAChD,EAAA,OAAO,CAAA;AAAA,wBAAA,EACiB,QAAQ,CAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA,CAAA;AAoClC;AAEA,SAAS,SAAA,GAAoB;AAC3B,EAAA,OAAO,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAAA;AAWT;AAEA,SAAS,cAAc,QAAA,EAA0B;AAC/C,EAAA,OAAO,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,WAAA,EASI,QAAQ,CAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA,mBAAA,EAeA,QAAQ,CAAA;AAAA;AAAA;AAAA,CAAA;AAI7B;AAEA,SAAS,SAAS,QAAA,EAA0B;AAC1C,EAAA,OAAO,sBAAiB,QAAQ;;AAAA,qEAAA,EAEqC,QAAQ,CAAA;;AAAA;;AAAA;AAAA;AAAA,qCAAA,EAMxC,QAAQ,CAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA,aAAA,EAehC,QAAQ,CAAA;AAAA;AAAA;AAAA,CAAA;AAIvB","file":"scaffolder.js","sourcesContent":["/**\n * Genesis init scaffolder — pure-function core.\n *\n * `runScaffolder()` takes a plan (consumer name, target dir, options) +\n * a filesystem implementation, and writes the files needed to bootstrap\n * a new Genesis-based app:\n *\n * - `packages/<consumer>-brand/src/brand.ts` (canonical schema seed)\n * - `packages/<consumer>-brand/package.json`\n * - `tailwind.config.ts` (genesis preset import)\n * - `app/global.css` (genesis tokens import)\n * - `.genesis/cli.yml` (design-system rules + version pin)\n * - `CLAUDE.md` (cross-link + workflow)\n *\n * Idempotent: existing files are NOT overwritten. The scaffolder reads\n * each target path first; if present, it appends a `.genesis-next` sibling\n * with the would-be content + emits a warning so the caller can diff. This\n * keeps the operation safe to re-run after upstream Genesis updates.\n *\n * The CLI wraps this with a real `node:fs` impl + commander argument\n * parsing; the test harness wraps it with an in-memory map for fast,\n * deterministic tests.\n *\n * @stability Beta\n */\n\nexport interface FileSystem {\n exists(path: string): Promise<boolean>;\n readFile(path: string): Promise<string>;\n writeFile(path: string, content: string): Promise<void>;\n mkdirp(dir: string): Promise<void>;\n}\n\nexport interface ScaffoldOptions {\n /** Slug used for `<consumer>-brand` package + tokens namespace. */\n consumerName: string;\n /** Target directory the scaffold writes into. Default `process.cwd()`. */\n targetDir: string;\n /** Pin Genesis package version. Default `\"workspace:^\"` if monorepo, else `\"^1.0.0\"`. */\n genesisVersion?: string;\n /** When true, even idempotent skips emit a write at `.genesis-next` for diffing. */\n emitConflicts?: boolean;\n /**\n * Logger. Defaults to a no-op when running in tests; CLI passes\n * `console.log` etc.\n */\n logger?: ScaffoldLogger;\n}\n\nexport interface ScaffoldLogger {\n info(msg: string): void;\n warn(msg: string): void;\n error(msg: string): void;\n}\n\nexport interface ScaffoldResult {\n /** Paths the scaffolder wrote. */\n written: string[];\n /** Paths that already existed and were left alone (idempotent skip). */\n skipped: string[];\n /** Paths emitted as `.genesis-next` for consumer to diff. */\n conflicts: string[];\n}\n\nconst VALID_NAME_PATTERN = /^[a-z][a-z0-9-]{1,30}$/;\n\nconst NOOP_LOGGER: ScaffoldLogger = {\n info() {},\n warn() {},\n error() {},\n};\n\n/**\n * Validate a consumer slug. Throws if invalid.\n *\n * Rules: lowercase alphanumeric + hyphens, 2-31 chars, must start with letter.\n * Matches the npm package-name subset that's also a safe directory name.\n */\nexport function validateConsumerName(name: string): void {\n if (!VALID_NAME_PATTERN.test(name)) {\n throw new Error(\n `Invalid consumer name \"${name}\". Must be lowercase letters/digits/hyphens, ` +\n `2-31 chars, starting with a letter (e.g., \"acme\", \"gamify-mobile\").`,\n );\n }\n}\n\n/**\n * Compute which files the scaffolder would write for a given plan.\n * Pure function — no I/O. Tests use this directly.\n */\nexport function planScaffold(\n opts: Pick<ScaffoldOptions, \"consumerName\" | \"genesisVersion\">,\n): { path: string; content: string }[] {\n const consumer = opts.consumerName;\n const genesisVersion = opts.genesisVersion ?? \"workspace:^\";\n return [\n {\n path: `packages/${consumer}-brand/package.json`,\n content: brandPackageJson(consumer, genesisVersion),\n },\n {\n path: `packages/${consumer}-brand/src/brand.ts`,\n content: brandSchema(consumer),\n },\n {\n path: `packages/${consumer}-brand/src/index.ts`,\n content: `export { brand } from \"./brand\";\\nexport type { Brand } from \"./brand\";\\n`,\n },\n {\n path: `packages/${consumer}-brand/tsconfig.json`,\n content: brandTsconfig(),\n },\n {\n path: `tailwind.config.ts`,\n content: tailwindConfig(consumer),\n },\n {\n path: `app/global.css`,\n content: globalCss(),\n },\n {\n path: `.genesis/cli.yml`,\n content: genesisConfig(consumer),\n },\n {\n path: `CLAUDE.md`,\n content: claudeMd(consumer),\n },\n ];\n}\n\n/**\n * Run the scaffolder against a FileSystem implementation. Returns a\n * record of what it did so the CLI / test harness can summarize.\n */\nexport async function runScaffold(\n opts: ScaffoldOptions,\n fs: FileSystem,\n): Promise<ScaffoldResult> {\n validateConsumerName(opts.consumerName);\n const log = opts.logger ?? NOOP_LOGGER;\n\n const plan = planScaffold(opts);\n\n const written: string[] = [];\n const skipped: string[] = [];\n const conflicts: string[] = [];\n\n for (const file of plan) {\n const fullPath = joinPath(opts.targetDir, file.path);\n const dir = dirname(fullPath);\n await fs.mkdirp(dir);\n\n const exists = await fs.exists(fullPath);\n if (!exists) {\n await fs.writeFile(fullPath, file.content);\n written.push(file.path);\n log.info(`✔ wrote ${file.path}`);\n continue;\n }\n\n // Idempotent skip — file exists. Optionally drop a `.genesis-next`\n // sibling so consumers can diff.\n const existing = await fs.readFile(fullPath);\n if (existing === file.content) {\n skipped.push(file.path);\n log.info(`= skipped ${file.path} (identical)`);\n continue;\n }\n\n if (opts.emitConflicts) {\n const nextPath = `${fullPath}.genesis-next`;\n await fs.writeFile(nextPath, file.content);\n conflicts.push(`${file.path}.genesis-next`);\n log.warn(\n `! diff ${file.path} — wrote .genesis-next sibling for review`,\n );\n } else {\n skipped.push(file.path);\n log.warn(\n `! skipped ${file.path} (exists; pass --emit-conflicts to diff)`,\n );\n }\n }\n\n return { written, skipped, conflicts };\n}\n\n// ---------------------------------------------------------------------------\n// Path helpers — kept inline so the scaffolder has zero non-commander deps\n// ---------------------------------------------------------------------------\n\nfunction joinPath(...parts: string[]): string {\n return parts\n .filter(Boolean)\n .join(\"/\")\n .replace(/\\/+/g, \"/\");\n}\n\nfunction dirname(path: string): string {\n const idx = path.lastIndexOf(\"/\");\n return idx === -1 ? \".\" : path.slice(0, idx);\n}\n\n// ---------------------------------------------------------------------------\n// Templates — readable string builders, NOT freeze-dried .tpl files. This\n// keeps the scaffolder a single .ts file and avoids __dirname juggling\n// when we publish to npm.\n// ---------------------------------------------------------------------------\n\nfunction brandPackageJson(consumer: string, genesisVersion: string): string {\n return JSON.stringify(\n {\n name: `@${consumer}/brand`,\n version: \"0.1.0\",\n private: true,\n type: \"module\",\n main: \"./src/index.ts\",\n types: \"./src/index.ts\",\n description: `Brand tokens + extensions for the ${consumer} app. Consumed by Genesis primitives via canonical schema.`,\n peerDependencies: {\n \"@marktiderman/genesis-design-system\": genesisVersion,\n },\n },\n null,\n 2,\n ) + \"\\n\";\n}\n\nfunction brandTsconfig(): string {\n return JSON.stringify(\n {\n extends: \"../../tsconfig.base.json\",\n compilerOptions: {\n outDir: \"dist\",\n rootDir: \"src\",\n },\n include: [\"src\"],\n },\n null,\n 2,\n ) + \"\\n\";\n}\n\nfunction brandSchema(consumer: string): string {\n return `/**\n * @${consumer}/brand — canonical brand tokens + extensions.\n *\n * Genesis primitives consume tokens from this file via the design-system\n * provider. Edit colors/spacing/typography here to retheme every screen\n * at once. Domain-specific tokens (e.g., \"mood\" for Acme, \"rarity\" for\n * Gamify) go under \\`extensions\\` — Genesis primitives don't read these,\n * but consumer composites do via \\`useGenesisExtension(key)\\`.\n *\n * Schema is intentionally narrow at the top level. Add categories under\n * \\`extensions\\` rather than inventing new top-level slots.\n */\n\nexport interface BrandColorScale {\n 50: string;\n 100: string;\n 200: string;\n 300: string;\n 400: string;\n 500: string;\n 600: string;\n 700: string;\n 800: string;\n 900: string;\n}\n\nexport interface BrandColors {\n primary: BrandColorScale;\n destructive: BrandColorScale;\n /** Neutral / gray scale used for surfaces, text, borders. */\n neutral: BrandColorScale;\n}\n\nexport interface Brand {\n /** Slug used for namespacing (e.g., extensions key prefix). */\n name: string;\n colors: BrandColors;\n /**\n * Domain-specific token categories. Consumer composites read these\n * via \\`useGenesisExtension(\"<key>\")\\`. Genesis primitives do NOT read\n * extensions — only canonical \\`colors\\`.\n */\n extensions?: Record<string, Record<string | number, unknown>>;\n}\n\n// ---------------------------------------------------------------------------\n// Default brand — replace these placeholder values with your design's\n// actual hex values. The canonical schema is the only contract; how you\n// reach it is up to you (Figma export, hand-pick, generated from a base).\n// ---------------------------------------------------------------------------\n\nexport const brand: Brand = {\n name: \"${consumer}\",\n colors: {\n primary: {\n 50: \"#eff6ff\",\n 100: \"#dbeafe\",\n 200: \"#bfdbfe\",\n 300: \"#93c5fd\",\n 400: \"#60a5fa\",\n 500: \"#3b82f6\",\n 600: \"#2563eb\",\n 700: \"#1d4ed8\",\n 800: \"#1e40af\",\n 900: \"#1e3a8a\",\n },\n destructive: {\n 50: \"#fef2f2\",\n 100: \"#fee2e2\",\n 200: \"#fecaca\",\n 300: \"#fca5a5\",\n 400: \"#f87171\",\n 500: \"#ef4444\",\n 600: \"#dc2626\",\n 700: \"#b91c1c\",\n 800: \"#991b1b\",\n 900: \"#7f1d1d\",\n },\n neutral: {\n 50: \"#f9fafb\",\n 100: \"#f3f4f6\",\n 200: \"#e5e7eb\",\n 300: \"#d1d5db\",\n 400: \"#9ca3af\",\n 500: \"#6b7280\",\n 600: \"#4b5563\",\n 700: \"#374151\",\n 800: \"#1f2937\",\n 900: \"#111827\",\n },\n },\n // extensions: { mood: { ... }, rarity: { ... } },\n};\n`;\n}\n\nfunction tailwindConfig(consumer: string): string {\n return `import type { Config } from \"tailwindcss\";\nimport { brand } from \"@${consumer}/brand\";\n\n/**\n * Tailwind config — wires Genesis canonical tokens to your brand values.\n *\n * Genesis ships a tailwind preset that maps semantic class names\n * (\\`bg-primary\\`, \\`text-foreground\\`, etc.) to CSS variables. This config\n * extends that preset with your consumer's hex values, so Genesis\n * primitives automatically pick up your brand once the global.css import\n * fires.\n */\nconst config: Config = {\n content: [\n \"./app/**/*.{ts,tsx}\",\n \"./components/**/*.{ts,tsx}\",\n \"./node_modules/@marktiderman/genesis-ui-native/**/*.{js,ts,tsx}\",\n ],\n presets: [require(\"@marktiderman/genesis-design-system/tailwind-preset\")],\n theme: {\n extend: {\n colors: {\n primary: {\n DEFAULT: brand.colors.primary[600],\n ...brand.colors.primary,\n },\n destructive: {\n DEFAULT: brand.colors.destructive[600],\n ...brand.colors.destructive,\n },\n },\n },\n },\n};\n\nexport default config;\n`;\n}\n\nfunction globalCss(): string {\n return `/**\n * Genesis global stylesheet entry. Imports the canonical token sheet\n * + the consumer's tailwind layers. The token sheet wires CSS variables\n * (--color-primary, --color-foreground, etc.) used by every Genesis\n * primitive's tailwind classes.\n */\n@import \"@marktiderman/genesis-design-system/tokens.css\";\n@tailwind base;\n@tailwind components;\n@tailwind utilities;\n`;\n}\n\nfunction genesisConfig(consumer: string): string {\n return `# Genesis DESIGN-SYSTEM consumer pin — read by the genesis CLI + .claude/hooks/*\n# NOT the harness config: the schema-validated harness/root config lives at\n# genesis.config.yml (see genesis.config.example.yml). This file only pins the\n# @marktiderman/genesis-* version + design-system rules for this consumer.\n#\n# version pin: which @marktiderman/genesis-* major are we on. The genesis CLI\n# uses this to validate that an upgrade hasn't drifted past breaking-change\n# boundaries.\nversion: \"1\"\nconsumer: \"${consumer}\"\n\nrules:\n # Block raw hex in consumer code — must use brand tokens.\n no-raw-hex: error\n # Block StyleSheet.create() in NativeWind-first projects.\n no-stylesheet-create: error\n # Block fork-and-modify of Genesis primitives.\n no-genesis-fork: error\n # Layouts must compose Genesis primitives, not rebuild them.\n prefer-genesis-layout: warn\n\n# Path map — where consumer composites + brand live. Default values match\n# the scaffolder's output; adjust if your layout differs.\npaths:\n brand: \"packages/${consumer}-brand\"\n composites: \"components\"\n app: \"app\"\n`;\n}\n\nfunction claudeMd(consumer: string): string {\n return `# CLAUDE.md — ${consumer}\n\nThis consumer was bootstrapped with \\`@marktiderman/genesis-cli init ${consumer}\\`.\n\n## Workflow\n\n- **Reuse before extend, extend before create.** See the Genesis usage\n doctrine: \\`docs/prds/PRD-07-genesis-consumption-architecture/standards/usage-doctrine.md\\`\n- **Brand changes live in \\`packages/${consumer}-brand\\`.** Don't fork Genesis\n primitives — edit your brand schema instead (Layer 1).\n- **Layout customization has 4 layers.** Default → named props →\n ScreenContainer → brand schema. Reach for the lowest layer first.\n\n## Critical rules\n\n- \\`.genesis/cli.yml\\` design-system rules are enforced via Claude Code hooks. Don't\n bypass with \\`StyleSheet.create()\\` or raw hex; use brand tokens.\n- Run \\`pnpm test\\` before every commit.\n- Open RFCs in the genesis repo for missing primitives — don't fork\n locally and forget.\n\n## Quick reference\n\n- \\`packages/${consumer}-brand/src/brand.ts\\` — your brand tokens + extensions\n- \\`tailwind.config.ts\\` — Genesis preset + brand color overrides\n- \\`app/global.css\\` — Genesis token sheet + tailwind layers\n`;\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@marktiderman/genesis-cli",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "description": "Genesis init scaffolder — npx @marktiderman/genesis-cli init <consumer> to bootstrap a new Genesis-based app in one command.",