brand-intent 0.1.6 → 0.1.8

package/cli/index.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { existsSync, mkdirSync, copyFileSync, readFileSync, writeFileSync, readdirSync, statSync } from 'fs';
 import { join, dirname, resolve } from 'path';
 import { fileURLToPath } from 'url';
 import { createInterface } from 'readline';
@@ -44,6 +44,45 @@ function ask(q) {
   return new Promise((res) => rl().question(q, res));
 }
 
+// ── File operations ──
+
+function copyDirRecursive(src, dest) {
+  mkdirSync(dest, { recursive: true });
+  for (const entry of readdirSync(src)) {
+    const srcPath = join(src, entry);
+    const destPath = join(dest, entry);
+    if (statSync(srcPath).isDirectory()) {
+      copyDirRecursive(srcPath, destPath);
+    } else {
+      copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function scaffoldExample(targetDir) {
+  const brandSrc = join(PKG_ROOT, 'brands', 'krume');
+  const exampleDest = join(targetDir, 'examples', 'krume');
+
+  copyDirRecursive(brandSrc, exampleDest);
+
+  const layers = [
+    { layer: 'formats', file: 'instagram-4-5-feed-portrait.format' },
+    { layer: 'purposes', file: 'daily-bread.purpose' },
+    { layer: 'compositions', file: 'editorial.composition' },
+  ];
+
+  for (const { layer, file } of layers) {
+    const src = join(PKG_ROOT, layer, file);
+    if (existsSync(src)) {
+      const dest = join(exampleDest, layer, file);
+      mkdirSync(dirname(dest), { recursive: true });
+      copyFileSync(src, dest);
+    }
+  }
+
+  console.log('  \u2713 examples/krume/ \u2014 reference implementation (identity, brand, format, purpose, composition)');
+}
+
 // ── Install skill ──
 
 async function installSkills(cwd) {
@@ -114,8 +153,17 @@ const targetDir = resolve(cwd, folder.trim() || '.');
 if (targetDir !== cwd) {
   mkdirSync(targetDir, { recursive: true });
 }
+console.log('\n  This will:');
+console.log('  \u2014 Copy the Krume bakery reference into examples/krume/');
+console.log('  \u2014 Install the Brand Intent skill for your AI agent\n');
+const proceed = await ask('  Proceed? (Y/n) ');
+if (proceed.trim().toLowerCase() === 'n') {
+  closeRl();
+  process.exit(0);
+}
 console.log('');
 
+scaffoldExample(targetDir);
 await installSkills(targetDir);
 closeRl();
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brand-intent",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "An open file format specification for making brand intent machine-readable.",
   "author": "Christophe Stoll <christophe@stoll.studio>",
   "license": "MIT",

package/skills/brand-intent.md

@@ -216,30 +216,16 @@ Once confirmed, generate these files at the project root:
 - **Typography sizes use `cqmin` units.** Use these sensible defaults unless the user specified otherwise: headline 6, body 2.8, caption 2.2, label 2.
 - **Spacing defaults:** unit cqmin, xs 1.5, s 2, m 3, l 5, xl 6.5.
 
-## Example: Scaffold the Krume Reference
-
-When `$ARGUMENTS` is "example", copy the Krume bakery reference files into `examples/krume/` in the current project. The Krume files are distributed with the npm package.
-
-Run this shell command to copy them:
-
-```bash
-node -e "
-const pkg = require.resolve('brand-intent/package.json');
-const root = require('path').dirname(pkg);
-const { cpSync, mkdirSync } = require('fs');
-const dest = 'examples/krume';
-mkdirSync(dest, { recursive: true });
-for (const d of ['brands/krume', 'formats', 'purposes', 'compositions']) {
-  const src = require('path').join(root, d);
-  try { cpSync(src, require('path').join(dest, d.replace('brands/krume', '')), { recursive: true }); } catch {}
-}
-console.log('Krume example scaffolded into examples/krume/');
-"
-```
+## Example: Explore the Krume Reference
+
+When `$ARGUMENTS` is "example", the Krume bakery reference is already in `examples/krume/` (copied there by `npx brand-intent init`).
+
+Read the files and walk the user through them:
+
+- **`krume.identity`** — the strategic layer: essence, voice, values, audiences. Start here.
+- **`krume.brand`** — derived expression: colors, themes, typography, spacing. Every decision traces back to identity.
+- **`formats/`** — canvas dimensions, safe zones, grid. Where content appears.
+- **`purposes/`** — content type with semantic slots, samples, constraints. What content does.
+- **`compositions/`** — spatial arrangement of slots. How elements are placed.
 
-Then explain to the user what each file does:
-- **`.identity`** — the strategic layer: essence, voice, values, audiences. Read this first.
-- **`.brand`** — derived expression: colors, themes, typography, spacing. Every decision traces back to identity.
-- **`.format`** — canvas dimensions, safe zones, grid. Where content appears.
-- **`.purpose`** — content type with semantic slots, samples, constraints. What content does.
-- **`.composition`** — spatial arrangement of slots. How elements are placed.
+If `examples/krume/` doesn't exist, tell the user to run `npx brand-intent init` first.