create-booboo 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jessy Mariau
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,29 @@
+# create-booboo
+
+Scaffold a runnable [Booboo](https://github.com/jessedu29260-netizen/booboo) brain in one
+command. Zero dependencies, pure stdlib.
+
+## Use
+
+```bash
+npx create-booboo my-brain
+cd my-brain
+npm install
+npm run build      # booboo.config.yaml → brain.json (the snapshot)
+npm run serve      # REST API on http://localhost:8787
+npm run mcp        # MCP over stdio — point Claude / Cursor / Claude Code at it
+npm run view       # see your brain in 3D (opens your browser)
+```
+
+## What you get
+
+- **`booboo.config.yaml`** — layers, privacy walls, and sources: a JSON starter that works
+  immediately, plus a commented postgres block to point at your own Postgres/Supabase
+  (`${DATABASE_URL}` from the environment).
+- **`data.booboo.json`** — a small sample graph (agents / knowledge / memory) to build from.
+- **`package.json`** — wired `build` / `serve` / `mcp` / `view` scripts on `@booboo/cli`.
+- **`.gitignore`** — the built snapshot can contain real data, so it's never committed.
+
+Pass `--force` to scaffold into a non-empty directory.
+
+Part of [Booboo](https://github.com/jessedu29260-netizen/booboo) — the unified operational brain. MIT.

package/dist/cli.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { mkdirSync, writeFileSync, existsSync, readdirSync } from "fs";
+import path from "path";
+var BOOBOO_VERSION = "^0.1.0";
+var args = process.argv.slice(2);
+var flags = new Set(args.filter((a) => a.startsWith("--")));
+var dirArg = args.find((a) => !a.startsWith("--")) ?? "my-brain";
+var force = flags.has("--force");
+if (flags.has("--help") || flags.has("-h")) {
+  console.log("usage: npx create-booboo <dir> [--force]\n  scaffolds a runnable Booboo brain (json starter + postgres upgrade path)");
+  process.exit(0);
+}
+var dir = path.resolve(process.cwd(), dirArg);
+var name = path.basename(dir);
+var TITLE = name.replace(/[-_]/g, " ").toUpperCase();
+if (existsSync(dir) && readdirSync(dir).length && !force) {
+  console.error(`\u2717 "${dirArg}" exists and is not empty \u2014 pass --force to scaffold anyway.`);
+  process.exit(1);
+}
+mkdirSync(dir, { recursive: true });
+var configYaml = `# ${name} \u2014 Booboo build config. Docs: SPEC.md + CONFIG.md in the booboo repo.
+title: "${TITLE}"
+root: { id: core, type: root, label: "${TITLE}" }
+
+# The stacked planes (Z-order = array order). Use whatever layers fit YOUR system.
+layers:
+  - { name: agents,    color: "#c9a04a", label: "AGENTS" }
+  - { name: knowledge, color: "#4ECDC4", label: "KNOWLEDGE" }
+  - { name: memory,    color: "#a78bd0", label: "MEMORY" }
+
+# Namespaces that must NEVER be emitted (filtered in the builder, before JSON/API/MCP).
+walls: [private, sealed]
+
+sources:
+  # 1) JSON starter \u2014 works immediately, no database. Edit data.booboo.json.
+  - adapter: json
+    path: ./data.booboo.json
+
+  # 2) Your real data \u2014 uncomment and point at a Postgres/Supabase DB.
+  #    Each \`nodes\` entry maps a table \u2192 a layer; \`weight_from\` reads a numeric column.
+  # - adapter: postgres
+  #   url: \${DATABASE_URL}            # postgres://\u2026 (read from the environment)
+  #   nodes:
+  #     - { table: agents,       layer: agents,    id: slug, label: name, parent: core, weight: 0.6 }
+  #     - { table: observations, layer: memory,    id: id,   label: title, cluster: project }
+  #     - { table: kg_entities,  layer: knowledge, id: id,   label: name, weight_from: degree }
+  #   links:
+  #     - { table: edges, source: src, target: dst, type: rel }
+
+output:
+  snapshot: ./brain.json
+`;
+var dataJson = JSON.stringify(
+  {
+    booboo: "1.0",
+    meta: {
+      root: "core",
+      title: "Sample Brain",
+      layers: [
+        { name: "agents", color: "#c9a04a", label: "AGENTS" },
+        { name: "knowledge", color: "#4ECDC4", label: "KNOWLEDGE" },
+        { name: "memory", color: "#a78bd0", label: "MEMORY" }
+      ]
+    },
+    nodes: [
+      { id: "agent:writer", type: "agent", layer: "agents", label: "Writer", weight: 0.6, tier: 1, parent: "core", icon: "\u270D", data: { role: "drafts content" } },
+      { id: "agent:researcher", type: "agent", layer: "agents", label: "Researcher", weight: 0.6, tier: 1, parent: "core", icon: "\u{1F50E}", data: { role: "gathers sources" } },
+      { id: "kb:spec", type: "entity", layer: "knowledge", label: "Spec", weight: 0.4, tier: 2, parent: "core" },
+      { id: "kb:brand", type: "entity", layer: "knowledge", label: "Brand", weight: 0.4, tier: 2, parent: "core" },
+      { id: "mem:1", type: "memory", layer: "memory", label: "shipped v1", weight: 0.2, tier: 3, parent: "agent:writer" },
+      { id: "mem:2", type: "memory", layer: "memory", label: "found source", weight: 0.2, tier: 3, parent: "agent:researcher" }
+    ],
+    links: [
+      { source: "agent:writer", target: "kb:spec", type: "uses" },
+      { source: "agent:researcher", target: "kb:brand", type: "uses" }
+    ]
+  },
+  null,
+  2
+);
+var pkgJson = JSON.stringify(
+  {
+    name,
+    private: true,
+    version: "0.1.0",
+    type: "module",
+    scripts: {
+      build: "booboo build",
+      serve: "booboo serve --snapshot brain.json --port 8787",
+      mcp: "booboo mcp --snapshot brain.json",
+      view: "booboo view --snapshot brain.json"
+    },
+    dependencies: {
+      "@booboo/cli": BOOBOO_VERSION
+    }
+  },
+  null,
+  2
+);
+var readme = `# ${name} \u2014 a Booboo brain
+
+A rooted, queryable graph of your system, built with [Booboo](https://github.com/jessedu29260-netizen/booboo) (the unified operational brain).
+
+## Quickstart
+
+\`\`\`bash
+npm install
+npm run build      # booboo.config.yaml \u2192 brain.json (the snapshot)
+npm run serve      # REST API at http://localhost:8787  (/graph /stats /search /nodes/:id /neighbors/:id /path/:a/:b)
+npm run mcp        # MCP over stdio \u2014 point Claude / Cursor / Claude Code at it
+npm run view       # see your brain in 3D (opens your browser)
+\`\`\`
+
+## Make it yours
+
+1. Edit **booboo.config.yaml** \u2014 declare your \`layers\`, then add \`sources\`.
+2. Start from the JSON file (**data.booboo.json**), or uncomment the **postgres** source
+   to build straight from your own database. Set \`DATABASE_URL\` in your environment.
+3. \`npm run build\` again. The snapshot \`brain.json\` is what gets served.
+
+> **Privacy:** anything whose \`cluster\` is in \`walls:\` is filtered *before* emit \u2014 sealed data never reaches the snapshot, API, or MCP.
+
+## MCP
+
+\`npm run mcp\` exposes \`booboo_stats \xB7 booboo_search \xB7 booboo_node \xB7 booboo_neighbors \xB7 booboo_path\`
+so an AI client can query the brain. See the Booboo repo for client config.
+`;
+var gitignore = `node_modules/
+# the built snapshot can contain real/private data \u2014 don't commit it
+brain.json
+*.log
+`;
+var files = {
+  "booboo.config.yaml": configYaml,
+  "data.booboo.json": dataJson,
+  "package.json": pkgJson,
+  "README.md": readme,
+  ".gitignore": gitignore
+};
+for (const [f, content] of Object.entries(files)) writeFileSync(path.join(dir, f), content, "utf8");
+console.log(`
+\u{1F43E} Booboo brain scaffolded \u2192 ${dirArg}/
+`);
+console.log("Next steps:");
+console.log(`  cd ${dirArg}`);
+console.log("  npm install");
+console.log("  npm run build      # build the graph snapshot");
+console.log("  npm run serve      # REST API on http://localhost:8787");
+console.log("  npm run mcp        # MCP over stdio (Claude / Cursor / Claude Code)");
+console.log("  npm run view       # see your brain in 3D (opens your browser)\n");
+console.log("Then edit booboo.config.yaml to point at your own data \u2014 a postgres example is included.\n");

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "create-booboo",
+  "version": "0.1.0",
+  "description": "Scaffold a new Booboo brain — `npx create-booboo my-brain`. Zero deps.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jessedu29260-netizen/booboo.git",
+    "directory": "packages/create-booboo"
+  },
+  "bugs": {
+    "url": "https://github.com/jessedu29260-netizen/booboo/issues"
+  },
+  "homepage": "https://github.com/jessedu29260-netizen/booboo#readme",
+  "type": "module",
+  "bin": {
+    "create-booboo": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "tsup": "^8",
+    "typescript": "^5"
+  },
+  "keywords": [
+    "booboo",
+    "scaffold",
+    "create",
+    "knowledge-graph",
+    "mcp"
+  ],
+  "scripts": {
+    "build": "tsup src/cli.ts --format esm --clean"
+  }
+}