@nebutra/brand-genesis 0.2.0

package/dist/index.js

@@ -0,0 +1,15 @@
+import {
+  BrandGenesis,
+  brandContextFromDraft,
+  distillBrandIdea,
+  readBrandGenesisDebug,
+  renderBrandMarkdown
+} from "./chunk-SB4N3ZZW.js";
+export {
+  BrandGenesis,
+  brandContextFromDraft,
+  distillBrandIdea,
+  readBrandGenesisDebug,
+  renderBrandMarkdown
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/examples/brand-context-only.ts

@@ -0,0 +1,9 @@
+import { brandContextFromDraft, distillBrandIdea, renderBrandMarkdown } from "../src";
+
+const draft = distillBrandIdea({
+  idea: "Customer support copilot for solo founders called Harbor",
+  visualDirectionHint: "minimal",
+});
+const brand = brandContextFromDraft(draft, "tenant_demo");
+
+process.stdout.write(renderBrandMarkdown(draft, brand));

package/examples/doctor.ts

@@ -0,0 +1,11 @@
+import { BrandGenesis } from "../src";
+
+const genesis = await BrandGenesis.open(".nebutra/brand-genesis-doctor", {
+  tenantId: "tenant_demo",
+});
+
+try {
+  process.stdout.write(`${JSON.stringify(await genesis.doctor(), null, 2)}\n`);
+} finally {
+  await genesis.close();
+}

package/examples/quickstart.ts

@@ -0,0 +1,27 @@
+import { BrandGenesis } from "../src";
+
+const genesis = await BrandGenesis.open(".nebutra/brand-genesis-example", {
+  tenantId: "tenant_demo",
+});
+
+try {
+  const result = await genesis.run({
+    idea: "AI debugging for indie devs called Loop",
+    visualDirectionHint: "cyberpunk",
+  });
+
+  process.stdout.write(
+    `${JSON.stringify(
+      {
+        brand: result.brand.name,
+        brandMd: result.brandMdPath,
+        film: result.film.path,
+        eventId: result.eventId,
+      },
+      null,
+      2,
+    )}\n`,
+  );
+} finally {
+  await genesis.close();
+}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@nebutra/brand-genesis",
+  "version": "0.2.0",
+  "description": "BrandContext-first flagship play for creating a complete brand package from one idea",
+  "private": false,
+  "license": "MIT",
+  "type": "module",
+  "nebutra": {
+    "status": "wip",
+    "productionReady": false,
+    "surface": "play-product",
+    "requires": [
+      "@nebutra/play-loader for SKILL.md play parsing",
+      "@nebutra/generation-context for BrandContext",
+      "@nebutra/content-store for BrandContext materialization",
+      "@nebutra/image-pipeline, @nebutra/video-pipeline, @nebutra/audio-pipeline, @nebutra/voice-realtime, and @nebutra/3d-pipeline for generated assets",
+      "@nebutra/event-log for Time Machine checkpoints"
+    ],
+    "gaps": [
+      "Generated media uses deterministic local fallbacks until model-backed providers are configured",
+      "Storyboard editing is represented as an orchestration checkpoint, not yet a GUI step",
+      "Landing page handoff is a manifest placeholder until landing-builder is implemented"
+    ],
+    "featureId": "brand-genesis",
+    "category": "ai",
+    "summary": "Flagship play that distills an idea into BrandContext and orchestrates lower generation capabilities"
+  },
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "dependencies": {
+    "@nebutra/3d-pipeline": "0.1.0",
+    "@nebutra/content-store": "0.1.0",
+    "@nebutra/capability-kit": "0.2.0",
+    "@nebutra/audio-pipeline": "0.1.0",
+    "@nebutra/errors": "0.1.0",
+    "@nebutra/event-log": "0.1.0",
+    "@nebutra/generation-context": "0.1.0",
+    "@nebutra/image-pipeline": "0.1.0",
+    "@nebutra/play-loader": "0.1.0",
+    "@nebutra/video-pipeline": "0.1.0",
+    "@nebutra/voice-realtime": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.15",
+    "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.4"
+  },
+  "homepage": "https://github.com/Nebutra/Nebutra-Sailor/tree/main/packages/ai/brand-genesis#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Nebutra/Nebutra-Sailor.git",
+    "directory": "packages/ai/brand-genesis"
+  },
+  "bugs": {
+    "url": "https://github.com/Nebutra/Nebutra-Sailor/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/plays/brand_film_60s/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: brand_film_60s
+kind: play
+version: 1.0.0
+description: From one idea to a brand system, generated assets, narration, and a 60s film manifest
+inputs:
+  idea:
+    type: string
+    max_length: 500
+    description: One-sentence company idea
+  founder_voice_id:
+    type: string
+    optional: true
+    description: Enrolled voice profile for narration
+  visual_direction_hint:
+    type: enum
+    options: [cyberpunk, minimal, organic, playful, corporate, retro, futurist]
+    optional: true
+outputs:
+  brand_md: { type: file, path: company/BRAND.md, mime: text/markdown }
+  logo: { type: file, path: company/assets/logo.svg, mime: image/svg+xml }
+  palette: { type: file, path: company/assets/palette.json, mime: application/json }
+  film: { type: file, path: company/film_60s.mp4, mime: video/mp4 }
+  landing: { type: file, path: company/landing/index.html, mime: text/html }
+  bgm: { type: file, path: company/audio/bgm.wav, mime: audio/wav }
+budget:
+  duration_s: 300
+  cost_usd: 5
+  alert_at_pct: 80
+required_skills:
+  - image_pipeline.generate
+  - video_pipeline.plan
+  - video_pipeline.render
+  - video_pipeline.compose
+  - audio_pipeline.generate
+  - voice_realtime.synthesize_narration
+  - mesh_pipeline.from_image
+  - content_store.write
+required_plays:
+  - landing_page_v1
+sub_agents:
+  - role: brand_strategist
+    allowed_skills: [llm_gateway.complete, content_store.write]
+  - role: visual_designer
+    allowed_skills: [image_pipeline.generate, mesh_pipeline.from_image, content_store.write]
+  - role: video_director
+    allowed_skills: [video_pipeline.plan, video_pipeline.render, video_pipeline.compose]
+  - role: music_composer
+    allowed_skills: [audio_pipeline.generate]
+  - role: narrator
+    allowed_skills: [voice_realtime.synthesize_narration]
+  - role: web_builder
+    allowed_skills: [play_loader.run]
+depends_on_plays: []
+checkpoints:
+  - after_step: brand_distillation
+  - after_step: visual_direction
+  - after_step: assets_generated
+  - after_step: video_rendered
+  - after_step: final_compose
+---
+
+## What this play does
+
+Creates a first brand package from one short company idea. The Play must first
+materialize `company/BRAND.md`; every downstream media call reads the resulting
+BrandContext instead of inventing its own style.
+
+## Steps
+
+1. Distill the idea into a compact brand identity.
+2. Choose one visual direction and write `company/BRAND.md`.
+3. Generate independent visual assets in parallel.
+4. Plan the storyboard before any video rendering.
+5. Render video, then generate music and narration with the final timing.
+6. Compose the film manifest and write a landing handoff manifest.
+7. Commit the resulting paths to the event log.
+
+## Anti-patterns
+
+- Do not generate assets without BrandContext.
+- Do not define image, video, audio, voice, or mesh generation logic here.
+- Do not skip storyboard planning.
+- Do not hardcode one visual style across all companies.

package/plays/brand_film_60s/fixtures/input_1.json

@@ -0,0 +1,5 @@
+{
+  "tenantId": "tenant_demo",
+  "idea": "AI debugging for indie devs called Loop",
+  "visualDirectionHint": "cyberpunk"
+}

package/plays/brand_film_60s/fixtures/input_2.json

@@ -0,0 +1,5 @@
+{
+  "tenantId": "tenant_demo",
+  "idea": "Customer support copilot for solo founders called Harbor",
+  "visualDirectionHint": "minimal"
+}

package/plays/brand_film_60s/fixtures/input_3.json

@@ -0,0 +1,5 @@
+{
+  "tenantId": "tenant_demo",
+  "idea": "Analytics workspace for creator businesses called Signal Garden",
+  "visualDirectionHint": "organic"
+}

package/plays/brand_film_60s/templates/BRAND.md.tmpl

@@ -0,0 +1,29 @@
+---
+type: brand_profile
+brand_id: {{brand_id}}
+name: {{name}}
+---
+
+# {{name}}
+
+{{one_liner}}
+
+## Tagline
+
+{{tagline}}
+
+## Audience
+
+{{target_audience}}
+
+## Tone
+
+{{tone_keywords}}
+
+## Visual Direction
+
+{{visual_style}}
+
+## Differentiation
+
+{{differentiation}}

package/plays/brand_film_60s/templates/palette.json.tmpl

@@ -0,0 +1,4 @@
+{
+  "brandId": "{{brand_id}}",
+  "colors": []
+}

package/src/cli.ts

@@ -0,0 +1,64 @@
+import { mkdir, rm, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { BrandGenesis, readBrandGenesisDebug } from "./index";
+
+const command = process.argv[2] ?? "doctor";
+const root = process.env.BRAND_GENESIS_ROOT ?? ".nebutra/brand-genesis";
+const tenantId = process.env.NEBUTRA_TENANT_ID ?? "local";
+
+async function sleep(ms: number): Promise<void> {
+  await new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+async function acquireCliLock(rootPath: string): Promise<() => Promise<void>> {
+  const lockPath = join(rootPath, ".cli.lock");
+  await mkdir(rootPath, { recursive: true });
+  for (let attempt = 0; attempt < 40; attempt += 1) {
+    try {
+      await mkdir(lockPath);
+      return async () => {
+        await rm(lockPath, { recursive: true, force: true });
+      };
+    } catch (error) {
+      const code = (error as NodeJS.ErrnoException).code;
+      if (code !== "EEXIST") throw error;
+      const lockStat = await stat(lockPath).catch(() => ({ mtimeMs: Date.now() }));
+      if (Date.now() - lockStat.mtimeMs > 30_000) {
+        await rm(lockPath, { recursive: true, force: true });
+        continue;
+      }
+      await sleep(50);
+    }
+  }
+  throw new Error("brand-genesis CLI is busy. Suggestion: wait a moment and retry the command.");
+}
+
+if (command === "doctor") {
+  const releaseLock = await acquireCliLock(root);
+  const genesis = await BrandGenesis.open(root, { tenantId });
+  try {
+    process.stdout.write(`${JSON.stringify(await genesis.doctor(), null, 2)}\n`);
+  } finally {
+    await genesis.close();
+    await releaseLock();
+  }
+} else if (command === "quickstart") {
+  const idea = process.argv.slice(3).join(" ") || "AI debugging for indie devs called Loop";
+  const releaseLock = await acquireCliLock(root);
+  const genesis = await BrandGenesis.open(root, { tenantId });
+  try {
+    process.stdout.write(
+      `${JSON.stringify({ capability: "brand-genesis", result: await genesis.run({ idea }) }, null, 2)}\n`,
+    );
+  } finally {
+    await genesis.close();
+    await releaseLock();
+  }
+} else if (command === "debug") {
+  process.stdout.write(
+    `${JSON.stringify({ capability: "brand-genesis", entries: await readBrandGenesisDebug() }, null, 2)}\n`,
+  );
+} else {
+  process.stderr.write(`Unknown brand-genesis command: ${command}\n`);
+  process.exitCode = 1;
+}

package/src/index.test.ts

@@ -0,0 +1,123 @@
+import { mkdtemp, readFile, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { parsePlayMarkdown } from "@nebutra/play-loader";
+import { afterEach, describe, expect, it } from "vitest";
+import {
+  BrandGenesis,
+  brandContextFromDraft,
+  distillBrandIdea,
+  readBrandGenesisDebug,
+  renderBrandMarkdown,
+} from "./index";
+
+let root: string | undefined;
+let genesis: BrandGenesis | undefined;
+
+afterEach(async () => {
+  if (genesis) await genesis.close();
+  if (root) await rm(root, { recursive: true, force: true });
+  root = undefined;
+  genesis = undefined;
+});
+
+async function open(tenantId = "tenant_demo"): Promise<BrandGenesis> {
+  root = await mkdtemp(join(tmpdir(), "brand-genesis-"));
+  genesis = await BrandGenesis.open(root, { tenantId });
+  return genesis;
+}
+
+describe("brand-genesis", () => {
+  it("distills an idea into a BrandContext without owning generation primitives", () => {
+    const draft = distillBrandIdea({
+      idea: "AI debugging for indie devs called Loop",
+      visualDirectionHint: "cyberpunk",
+    });
+    const brand = brandContextFromDraft(draft, "tenant_a");
+    const markdown = renderBrandMarkdown(draft, brand);
+
+    expect(draft.name).toBe("Loop");
+    expect(brand).toMatchObject({
+      tenantId: "tenant_a",
+      brandId: "loop",
+      sourcePath: "company/BRAND.md",
+    });
+    expect(markdown).toContain("type: brand_profile");
+    expect(markdown).toContain("Debug like it is a conversation");
+  });
+
+  it("runs the brand_film_60s play through lower capabilities and writes checkpoints", async () => {
+    const runtime = await open("tenant_a");
+
+    const result = await runtime.run({
+      idea: "AI debugging for indie devs called Loop",
+      visualDirectionHint: "cyberpunk",
+      founderVoiceId: "founder_voice",
+    });
+
+    expect(result.brand.name).toBe("Loop");
+    expect(result.logo.brandId).toBe(result.brand.brandId);
+    expect(result.mesh.brandId).toBe(result.brand.brandId);
+    expect(result.film.kind).toBe("video");
+    expect(result.bgm.license.status).toBe("commercial-ok");
+    expect(result.narration.voiceProfileId).toBe("founder_voice");
+    expect(result.checkpoints).toEqual([
+      "brand_distillation",
+      "visual_direction",
+      "assets_generated",
+      "video_rendered",
+      "final_compose",
+    ]);
+    await expect(readBrandGenesisDebug(root)).resolves.toEqual(expect.any(Array));
+  });
+
+  it("requires tenant context before persistent operations", async () => {
+    root = await mkdtemp(join(tmpdir(), "brand-genesis-"));
+    const runtime = await BrandGenesis.open(root);
+    genesis = runtime;
+
+    await expect(runtime.run({ tenantId: "", idea: "AI tool called Loop" })).rejects.toMatchObject({
+      capability: "brand-genesis",
+      suggestion: expect.stringContaining("tenantId"),
+    });
+  });
+
+  it("keeps the flagship Play as SKILL.md instead of a new workflow format", async () => {
+    const skill = await readFile(join(process.cwd(), "plays", "brand_film_60s", "SKILL.md"), {
+      encoding: "utf8",
+    }).catch(async () =>
+      readFile(
+        join(
+          process.cwd(),
+          "packages",
+          "ai",
+          "brand-genesis",
+          "plays",
+          "brand_film_60s",
+          "SKILL.md",
+        ),
+        "utf8",
+      ),
+    );
+    const play = parsePlayMarkdown(skill);
+
+    expect(play.meta).toMatchObject({
+      name: "brand_film_60s",
+      kind: "play",
+      version: "1.0.0",
+    });
+    expect(play.requiredSkills).toContain("image_pipeline.generate");
+    expect(play.requiredSkills).toContain("content_store.write");
+    expect(play.subAgents.map((agent) => agent.role)).toContain("visual_designer");
+  });
+
+  it("reports doctor health from delegated media capabilities", async () => {
+    const runtime = await open("tenant_a");
+
+    await expect(runtime.doctor()).resolves.toMatchObject({
+      capability: "brand-genesis",
+      ok: true,
+      play: { ok: true, name: "brand_film_60s" },
+    });
+  });
+});