brand-intent 0.1.5 → 0.1.7

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) {
@@ -107,30 +146,25 @@ if (!command || command === '--help' || command === '-h') {
   process.exit(0);
 }
 
-// Both "init" and "install-skills" do the same thing now
-const installed = await installSkills(cwd);
-closeRl();
+// Ask for project folder
+console.log('  Brand Intent \u2014 What a brand means. Authored, structured, shared.\n');
+const folder = await ask('  Project folder (. for current directory): ');
+const targetDir = resolve(cwd, folder.trim() || '.');
+if (targetDir !== cwd) {
+  mkdirSync(targetDir, { recursive: true });
+}
+console.log('');
 
-// Show next steps with skill-specific commands
-const hasClaudeCode = installed.some(h => h.id === 'claude');
-const hasCursor = installed.some(h => h.id === 'cursor');
+scaffoldExample(targetDir);
+await installSkills(targetDir);
+closeRl();
 
 console.log('\n  Done. Now open your AI agent and try:\n');
 console.log('    "Onboard my brand"');
 console.log('    "Show me the Krume bakery example"');
-
-if (hasClaudeCode || hasCursor) {
-  console.log('\n  Or use the skill directly:\n');
-  if (hasClaudeCode) {
-    console.log('    /brand-intent onboard     Create your brand through a guided interview');
-    console.log('    /brand-intent example     Scaffold the Krume reference implementation');
-    console.log('    /brand-intent validate    Validate content against your brand rules');
-    console.log('    /brand-intent             Discover brand files and available purposes');
-  }
-  if (hasCursor) {
-    console.log('    @brand-intent onboard     Create your brand through a guided interview');
-    console.log('    @brand-intent example     Scaffold the Krume reference implementation');
-  }
-}
-
+console.log('\n  Skill commands:\n');
+console.log('    /brand-intent onboard     Create your brand through a guided interview');
+console.log('    /brand-intent example     Scaffold the Krume reference implementation');
+console.log('    /brand-intent validate    Validate content against your brand rules');
+console.log('    /brand-intent             Discover brand files and available purposes');
 console.log('');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brand-intent",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "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.