@marktiderman/genesis-cli 1.0.0 → 1.0.2
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/LICENSE +21 -0
- package/dist/cli.js +9 -6
- package/dist/cli.js.map +1 -1
- package/dist/index.js +8 -5
- package/dist/index.js.map +1 -1
- package/dist/scaffolder.d.ts +1 -1
- package/dist/scaffolder.js +8 -5
- package/dist/scaffolder.js.map +1 -1
- package/package.json +2 -2
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Mark Tiderman
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
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., "
|
|
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/
|
|
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
|
|
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
|
|
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/
|
|
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., '
|
|
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., "
|
|
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/
|
|
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
|
|
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
|
|
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/
|
|
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"]}
|
package/dist/scaffolder.d.ts
CHANGED
|
@@ -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/
|
|
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
|
package/dist/scaffolder.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., "
|
|
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/
|
|
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
|
|
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
|
|
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/
|
|
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/scaffolder.js.map
CHANGED
|
@@ -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":"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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/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.
|
|
3
|
+
"version": "1.0.2",
|
|
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.",
|
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
"url": "git+https://github.com/marktiderman/genesis.git",
|
|
10
10
|
"directory": "packages/genesis-cli"
|
|
11
11
|
},
|
|
12
|
-
"license": "
|
|
12
|
+
"license": "MIT",
|
|
13
13
|
"publishConfig": {
|
|
14
14
|
"access": "public",
|
|
15
15
|
"provenance": false
|