partweave 0.3.1 → 0.3.3

package/dist/{chunk-ANKGMR2Z.js → chunk-I2IJROBO.js}

@@ -4,8 +4,100 @@
 import { spawnSync as spawnSync3 } from "child_process";
 import { existsSync as existsSync5, readdirSync as readdirSync3 } from "fs";
 import { basename, resolve as resolve3 } from "path";
-import { confirm as confirm3, intro, isCancel as isCancel3, log as log2, note, outro, spinner as spinner2 } from "@clack/prompts";
-import pc2 from "picocolors";
+import { confirm as confirm3, intro, isCancel as isCancel3, log as log2, note as note2, outro, spinner as spinner2 } from "@clack/prompts";
+import pc3 from "picocolors";
+
+// src/banner.ts
+import pc from "picocolors";
+var GLYPHS = {
+  p: ["\u2588\u2588\u2588 ", "\u2588  \u2588", "\u2588\u2588\u2588 ", "\u2588   ", "\u2588   "],
+  a: [" \u2588\u2588 ", "\u2588  \u2588", "\u2588\u2588\u2588\u2588", "\u2588  \u2588", "\u2588  \u2588"],
+  r: ["\u2588\u2588\u2588 ", "\u2588  \u2588", "\u2588\u2588\u2588 ", "\u2588 \u2588 ", "\u2588  \u2588"],
+  t: ["\u2588\u2588\u2588\u2588\u2588", "  \u2588  ", "  \u2588  ", "  \u2588  ", "  \u2588  "],
+  w: ["\u2588   \u2588", "\u2588   \u2588", "\u2588 \u2588 \u2588", "\u2588\u2588 \u2588\u2588", "\u2588   \u2588"],
+  e: ["\u2588\u2588\u2588\u2588", "\u2588   ", "\u2588\u2588\u2588 ", "\u2588   ", "\u2588\u2588\u2588\u2588"],
+  v: ["\u2588   \u2588", "\u2588   \u2588", "\u2588   \u2588", " \u2588 \u2588 ", "  \u2588  "]
+};
+var weaveCell = (row, col) => (row + col) % 2 ? "\u2593" : "\u2588";
+var LOOM = ["\u2503\u2501\u2503\u2501", "\u2501\u2503\u2501\u2503", "\u2503\u2501\u2503\u2501", "\u2501\u2503\u2501\u2503", "\u2503\u2501\u2503\u2501"];
+var WORD = "partweave";
+var HEIGHT = 5;
+function colorMode() {
+  if (process.env.NO_COLOR || !process.stdout.isTTY) return "none";
+  if (/truecolor|24bit/i.test(process.env.COLORTERM ?? "")) return "truecolor";
+  return "basic";
+}
+var STOPS = [
+  [124, 92, 246],
+  // violet
+  [190, 75, 219],
+  // magenta
+  [232, 74, 143],
+  // pink
+  [225, 51, 74],
+  // red
+  [248, 96, 76]
+  // coral / bright red
+];
+function gradient(t) {
+  const n = STOPS.length - 1;
+  const scaled = Math.min(Math.max(t, 0), 1) * n;
+  const i = Math.min(Math.floor(scaled), n - 1);
+  const local = scaled - i;
+  const [a, b] = [STOPS[i], STOPS[i + 1]];
+  return [0, 1, 2].map((k) => Math.round(a[k] + (b[k] - a[k]) * local));
+}
+function paintFace(ch, t, mode) {
+  if (ch === " ") return " ";
+  if (mode === "none") return ch;
+  if (mode === "basic") return t < 0.5 ? pc.magentaBright(ch) : pc.redBright(ch);
+  const [r, g, b] = gradient(t);
+  return `\x1B[38;2;${r};${g};${b}m${ch}\x1B[39m`;
+}
+function paintShadow(ch, mode) {
+  if (ch === " ") return " ";
+  if (mode === "none") return ch;
+  if (mode === "basic") return pc.gray(ch);
+  return `\x1B[38;2;110;110;110m${ch}\x1B[39m`;
+}
+function paintThread(ch, mode) {
+  if (ch === " ") return " ";
+  if (mode === "none") return ch;
+  if (mode === "basic") return pc.dim(ch);
+  return `\x1B[38;2;120;110;140m${ch}\x1B[39m`;
+}
+function word2tone(word, mode) {
+  if (mode === "none") return word;
+  return [...word].map((ch, i) => paintFace(ch, word.length > 1 ? i / (word.length - 1) : 0, mode)).join("");
+}
+function compact(mode) {
+  return "  " + (mode === "none" ? "partweave" : word2tone("partweave", mode));
+}
+function renderBanner() {
+  const mode = colorMode();
+  if (!process.stdout.isTTY) return compact(mode);
+  const rows = [];
+  for (let r = 0; r < HEIGHT; r++) {
+    rows.push([...WORD].map((ch) => GLYPHS[ch]?.[r] ?? "").join(" "));
+  }
+  const glyphW = rows[0].length;
+  const total = 2 + LOOM[0].length + 1 + (glyphW + 1);
+  if (total > (process.stdout.columns ?? 80)) return compact(mode);
+  const front = (r, c) => r >= 0 && r < HEIGHT && c >= 0 && c < glyphW && rows[r][c] === "\u2588";
+  const out = [];
+  for (let R = 0; R < HEIGHT; R++) {
+    const loom = [...LOOM[R]].map((ch) => paintThread(ch, mode)).join("");
+    let mark = "";
+    for (let C = 0; C <= glyphW; C++) {
+      const t = glyphW > 1 ? Math.min(C, glyphW - 1) / (glyphW - 1) : 0;
+      if (front(R, C)) mark += paintFace(weaveCell(R, C), t, mode);
+      else if (front(R, C - 1)) mark += paintShadow("\u2591", mode);
+      else mark += " ";
+    }
+    out.push("  " + loom + " " + mark);
+  }
+  return out.join("\n");
+}
 
 // src/compose.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
@@ -26,14 +118,19 @@ function injectAtAnchor(content, anchorId, lines) {
     throw new Error(`Anchor <partweave:${anchorId}> not found in target file`);
   }
   const indent = match[1] ?? "";
-  const existing = new Set(
-    content.split("\n").map((l) => l.trim()).filter(Boolean)
-  );
-  const toInsert = lines.filter((l) => !existing.has(l.trim()));
+  const before = content.slice(0, match.index).split("\n");
+  if (before[before.length - 1] === "") before.pop();
+  const block = /* @__PURE__ */ new Set();
+  for (let i = before.length - 1; i >= 0; i--) {
+    const trimmed = before[i].trim();
+    if (trimmed === "") break;
+    block.add(trimmed);
+  }
+  const toInsert = lines.filter((l) => !block.has(l.trim()));
   if (toInsert.length === 0) return { content, inserted: 0 };
-  const block = toInsert.map((l) => l ? indent + l : "").join("\n") + "\n";
+  const insertion = toInsert.map((l) => l ? indent + l : "").join("\n") + "\n";
   const anchorStart = match.index;
-  const newContent = content.slice(0, anchorStart) + block + content.slice(anchorStart);
+  const newContent = content.slice(0, anchorStart) + insertion + content.slice(anchorStart);
   return { content: newContent, inserted: toInsert.length };
 }
 function parseDep(dep) {
@@ -50,34 +147,35 @@ function normalizeWorkspaceDeps(deps, workspaceRange) {
     return dep;
   });
 }
+function higherVersion(a, b) {
+  const core = (v) => {
+    const m = v.match(/(\d+)(?:\.(\d+))?(?:\.(\d+))?/);
+    if (!m || m[1] === void 0) return null;
+    return [m[1], m[2], m[3]].map((n) => n === void 0 ? 0 : Number(n));
+  };
+  const ca = core(a);
+  const cb = core(b);
+  if (!ca || !cb) return a;
+  for (let i = 0; i < 3; i++) {
+    if (ca[i] !== cb[i]) return ca[i] > cb[i] ? a : b;
+  }
+  return a;
+}
 function mergePackageJsonDeps(pkgJson, deps, field = "dependencies") {
   if (deps.length === 0) return pkgJson;
   const pkg = JSON.parse(pkgJson);
   const bucket = pkg[field] ?? {};
   for (const dep of deps) {
     const { name, version } = parseDep(dep);
-    if (!(name in bucket)) bucket[name] = version;
+    bucket[name] = name in bucket ? higherVersion(bucket[name], version) : version;
   }
   pkg[field] = Object.fromEntries(
     Object.entries(bucket).sort(([a], [b]) => a.localeCompare(b))
   );
   return JSON.stringify(pkg, null, 2) + "\n";
 }
-function appendEnv(envBody, entries, heading) {
-  const keys = Object.keys(entries);
-  if (keys.length === 0) return envBody;
-  const present = new Set(
-    envBody.split("\n").map((l) => l.split("=")[0]?.trim()).filter(Boolean)
-  );
-  const missing = keys.filter((k) => !present.has(k));
-  if (missing.length === 0) return envBody;
-  let out = envBody.replace(/\n*$/, "\n");
-  if (heading) out += `
-# ${heading}
-`;
-  for (const k of missing) out += `${k}=${entries[k]}
-`;
-  return out;
+function pyDepName(dep) {
+  return dep.trim().replace(/^["']|["']$/g, "").split(/[<>=!~;[\s]/)[0].trim().toLowerCase();
 }
 
 // src/fsutil.ts
@@ -548,45 +646,82 @@ function buildTsconfigBase(ctx) {
     2
   ) + "\n";
 }
-function buildBaseEnv(ctx) {
-  const lines = [
-    "# Environment for " + ctx.projectName,
-    "#",
-    "# Every value the app reads from the environment lives here. Copy this file to",
-    "# `.env` and adjust as needed \u2014 the server, web/mobile apps, and each component",
-    "# read their configuration from it, so there's nothing to configure elsewhere.",
-    ""
-  ];
+function envScopeFor(key) {
+  if (key.startsWith("POSTGRES_")) return "root";
+  if (key.startsWith("NEXT_PUBLIC_")) return "web";
+  if (key.startsWith("EXPO_PUBLIC_")) return "mobile";
+  return "server";
+}
+function buildEnvFiles(ctx, modules) {
+  const componentBlocks = { server: [], web: [], mobile: [], root: [] };
+  for (const m of modules) {
+    const byScope = { server: [], web: [], mobile: [], root: [] };
+    for (const [key, value] of Object.entries(m.manifest.env)) {
+      byScope[envScopeFor(key)].push(`${key}=${value}`);
+    }
+    for (const scope of ["server", "web", "mobile", "root"]) {
+      if (byScope[scope].length === 0) continue;
+      componentBlocks[scope].push(`# ${m.manifest.title}`, ...byScope[scope], "");
+    }
+  }
+  const render2 = (lines) => lines.join("\n").replace(/\n*$/, "\n");
+  const files = [];
   if (ctx.hasServer) {
-    lines.push(
-      "# --- server ---",
-      "# Unique per-project key generated at scaffold time; signs sessions and JWTs.",
-      "# Use a separate secret value in production (and never commit the real one).",
-      `DJANGO_SECRET_KEY=${randomBytes(48).toString("base64url")}`,
+    const serverBase = (secretLine) => [
+      `# ${ctx.projectName} \u2014 server (Django). Read by apps/server.`,
+      "# `.env` is gitignored; keep real secrets here, not in `.env.example`.",
+      "",
+      "# Unique per-project key; signs sessions and JWTs.",
+      secretLine,
       "DJANGO_DEBUG=true",
-      "DJANGO_ALLOWED_HOSTS=localhost,127.0.0.1",
-      "# Web origins allowed to call the API when DEBUG is off (comma-separated).",
-      "# In DEBUG every origin is allowed, so this is only needed in production.",
+      "# Leave DJANGO_ALLOWED_HOSTS unset in dev: with DEBUG on, any host is allowed,",
+      "# so a phone/simulator can reach the server over your LAN (e.g. 192.168.x.y).",
+      "# Set it (comma-separated) in production, e.g. DJANGO_ALLOWED_HOSTS=api.example.com",
+      "# Origins allowed to call the API when DEBUG is off (comma-separated).",
       "# DJANGO_CORS_ALLOWED_ORIGINS=https://app.example.com",
-      "# DATABASE_URL \u2014 the server uses local SQLite by default; set a database URL",
-      "# to switch (the `db-postgres` component sets a Postgres DSN here for you).",
+      "# DATABASE_URL \u2014 unset uses local SQLite; the db-postgres component sets a Postgres DSN.",
       ""
-    );
+    ];
+    files.push({
+      dir: "apps/server",
+      example: render2([...serverBase("DJANGO_SECRET_KEY=replace-with-a-generated-secret"), ...componentBlocks.server]),
+      env: render2([...serverBase(`DJANGO_SECRET_KEY=${randomBytes(48).toString("base64url")}`), ...componentBlocks.server])
+    });
   }
   if (ctx.hasWeb) {
-    lines.push("# --- web ---", "NEXT_PUBLIC_API_URL=http://localhost:8000", "");
+    const web = [
+      `# ${ctx.projectName} \u2014 web (Next.js). Read by apps/web.`,
+      "# Only NEXT_PUBLIC_* is exposed to the browser.",
+      "NEXT_PUBLIC_API_URL=http://localhost:8000",
+      "",
+      ...componentBlocks.web
+    ];
+    const body = render2(web);
+    files.push({ dir: "apps/web", example: body, env: body });
   }
   if (ctx.hasMobile) {
-    lines.push(
-      "# --- mobile (Expo) ---",
-      "# In dev the app auto-detects your machine's LAN IP so a physical device can",
-      "# reach the server \u2014 leave this unset. Set it for simulators or production,",
-      "# in the environment or apps/mobile/.env (Expo reads EXPO_PUBLIC_* from there).",
+    const mobile = [
+      `# ${ctx.projectName} \u2014 mobile (Expo). Read by apps/mobile.`,
+      "# Only EXPO_PUBLIC_* is exposed to the app. In dev the app auto-detects your",
+      "# machine's LAN IP, so this can stay unset; set it for simulators/device/production.",
       "# EXPO_PUBLIC_API_URL=http://localhost:8000",
-      ""
-    );
-  }
-  return lines.join("\n");
+      "",
+      ...componentBlocks.mobile
+    ];
+    const body = render2(mobile);
+    files.push({ dir: "apps/mobile", example: body, env: body });
+  }
+  if (componentBlocks.root.length > 0) {
+    const root = [
+      `# ${ctx.projectName} \u2014 infrastructure. Read by docker compose (--env-file .env).`,
+      "# Keep these in sync with DATABASE_URL in apps/server/.env.",
+      "",
+      ...componentBlocks.root
+    ];
+    const body = render2(root);
+    files.push({ dir: "", example: body, env: body });
+  }
+  return files;
 }
 function jsCiSteps(ctx) {
   if (ctx.jsPm === "npm") {
@@ -711,7 +846,18 @@ function buildReadme(ctx, modules) {
   if (ctx.hasWeb) parts.push("npm run web      # http://localhost:3000");
   if (ctx.hasMobile) parts.push("npm run mobile   # Expo dev server");
   parts.push("```", "");
-  parts.push("Copy `.env.example` to `.env` and fill in values before running.", "");
+  parts.push("## Configuration", "");
+  parts.push(
+    "Each app reads its **own** env file, created for you (and gitignored) with a",
+    "committed `.env.example` template alongside it. Edit the `.env` to change values:",
+    ""
+  );
+  const envFiles = [];
+  if (ctx.hasServer) envFiles.push("- `apps/server/.env` \u2014 Django secret key, allowed hosts, `DATABASE_URL`");
+  if (ctx.hasWeb) envFiles.push("- `apps/web/.env` \u2014 `NEXT_PUBLIC_*` (browser-exposed)");
+  if (ctx.hasMobile) envFiles.push("- `apps/mobile/.env` \u2014 `EXPO_PUBLIC_*` (app-exposed)");
+  if (hasDocker) envFiles.push("- `.env` (root) \u2014 `POSTGRES_*` for the database container");
+  parts.push(...envFiles, "");
   return parts.join("\n");
 }
 function buildServerDockerfile(ctx) {
@@ -838,7 +984,7 @@ var ManifestSchema = z.object({
   conflicts: z.array(z.string()).default([]),
   /** capability/interface this module satisfies (for conflict grouping) */
   provides: z.string().optional(),
-  /** env keys → default value, appended to .env.example */
+  /** env keys → default value; routed to the consuming app's .env/.env.example by prefix (POSTGRES_→root, NEXT_PUBLIC_→web, EXPO_PUBLIC_→mobile, else server) */
   env: z.record(z.string()).default({}),
   /** per-target wiring (files are copied separately from wiring injection) */
   wiring: z.record(z.enum(TARGETS), WiringForTargetSchema).default({}),
@@ -928,6 +1074,25 @@ function injectIntoFiles(index, anchorId, lines, targetLabel) {
     writeFileSync2(file, next);
   }
 }
+function injectPyDeps(index, deps, targetLabel) {
+  const files = index.get("deps");
+  if (!files || files.length === 0) {
+    throw new Error(
+      `Wiring error: anchor <partweave:deps> not found in ${targetLabel}. Add the anchor to the _core/${targetLabel} scaffold.`
+    );
+  }
+  for (const file of files) {
+    const content = readFileSync2(file, "utf8");
+    const region = content.match(/dependencies\s*=\s*\[([\s\S]*?)\]/)?.[1] ?? content;
+    const present = new Set(
+      [...region.matchAll(/["']([^"']+)["']/g)].map((m) => pyDepName(m[1]))
+    );
+    const fresh = deps.filter((d) => !present.has(pyDepName(d)));
+    if (fresh.length === 0) continue;
+    const { content: next } = injectAtAnchor(content, "deps", fresh.map((d) => `"${d}",`));
+    writeFileSync2(file, next);
+  }
+}
 function applyWiring(outDir, targets, modules, workspaceRange) {
   const indexes = /* @__PURE__ */ new Map();
   for (const t of targets) {
@@ -945,8 +1110,7 @@ function applyWiring(outDir, targets, modules, workspaceRange) {
       }
       if (wiring.deps?.length) {
         if (t === "server") {
-          const lines = wiring.deps.map((d) => `"${d}",`);
-          injectIntoFiles(index, "deps", lines, t);
+          injectPyDeps(index, wiring.deps, t);
         } else {
           const pkgPath = join2(targetDir, "package.json");
           if (existsSync2(pkgPath)) {
@@ -961,14 +1125,19 @@ function applyWiring(outDir, targets, modules, workspaceRange) {
     }
   }
 }
-function applyEnv(outDir, modules) {
-  const envPath = join2(outDir, ".env.example");
-  let body = existsSync2(envPath) ? readFileSync2(envPath, "utf8") : "";
-  for (const mod of modules) {
-    if (Object.keys(mod.manifest.env).length === 0) continue;
-    body = appendEnv(body, mod.manifest.env, mod.manifest.title);
+function writeEnvFiles(outDir, ctx, modules) {
+  const written = [];
+  for (const file of buildEnvFiles(ctx, modules)) {
+    const exampleRel = join2(file.dir, ".env.example");
+    writeFileEnsured(join2(outDir, exampleRel), file.example);
+    written.push(exampleRel);
+    const envRel = join2(file.dir, ".env");
+    if (!existsSync2(join2(outDir, envRel))) {
+      writeFileEnsured(join2(outDir, envRel), file.env);
+      written.push(envRel);
+    }
   }
-  if (body) writeFileSync2(envPath, body);
+  return written;
 }
 function writeStructuralRootFiles(outDir, ctx, modules) {
   const workspace = buildJsWorkspace(ctx);
@@ -984,7 +1153,6 @@ function writeStructuralRootFiles(outDir, ctx, modules) {
   if (pipSync) writeFileEnsured(join2(outDir, "apps/server/scripts/sync_deps.py"), pipSync);
   writeFileEnsured(join2(outDir, "scripts/run.mjs"), buildTaskRunner(ctx, hasDocker));
   writeFileEnsured(join2(outDir, "Makefile"), buildMakefile(ctx, hasDocker));
-  writeFileEnsured(join2(outDir, ".env.example"), buildBaseEnv(ctx));
 }
 function compose(opts) {
   const { selection, registry, scaffoldTargets, wireTargets, rootFiles } = opts;
@@ -1013,7 +1181,7 @@ function compose(opts) {
     }
   }
   applyWiring(outDir, wireTargets, modules, jsPmProfile(ctx.jsPm).workspaceRange);
-  applyEnv(outDir, modules);
+  if (rootFiles !== "none") written.push(...writeEnvFiles(outDir, ctx, modules));
   if (selection.modules.includes("ci")) {
     for (const [rel, content] of Object.entries(buildCiWorkflows(ctx))) {
       writeFileEnsured(join2(outDir, rel), content);
@@ -1209,11 +1377,28 @@ function resolveModules(registry, chosen) {
       provided.set(cap, id);
     }
   }
-  const order = [...resolved].sort((a, b) => {
-    const da = registry.require(a).manifest.requires.length;
-    const db = registry.require(b).manifest.requires.length;
-    return da - db || a.localeCompare(b);
-  });
+  const ids = [...resolved];
+  const deps = new Map(
+    ids.map((id) => [id, registry.require(id).manifest.requires.filter((r) => resolved.has(r))])
+  );
+  const indegree = new Map(ids.map((id) => [id, deps.get(id).length]));
+  const dependents = new Map(ids.map((id) => [id, []]));
+  for (const id of ids) for (const d of deps.get(id)) dependents.get(d).push(id);
+  const byId = (a, b) => a.localeCompare(b);
+  const ready = ids.filter((id) => indegree.get(id) === 0).sort(byId);
+  const order = [];
+  while (ready.length > 0) {
+    const id = ready.shift();
+    order.push(id);
+    for (const dep of dependents.get(id)) {
+      const n = indegree.get(dep) - 1;
+      indegree.set(dep, n);
+      if (n === 0) {
+        ready.push(dep);
+        ready.sort(byId);
+      }
+    }
+  }
   return { modules: order, autoAdded: [...autoAdded].sort() };
 }
 function validateApps(registry, moduleIds, apps) {
@@ -1242,12 +1427,13 @@ import {
   confirm as confirm2,
   isCancel as isCancel2,
   multiselect,
+  note,
   select,
   text
 } from "@clack/prompts";
-import pc from "picocolors";
+import pc2 from "picocolors";
 import { resolve as resolve2 } from "path";
-var MULTI_HINT = pc.dim("\u2191/\u2193 move \xB7 space toggle \xB7 a all \xB7 enter confirm");
+var MULTI_HINT = pc2.dim("\u2191/\u2193 move \xB7 space toggle \xB7 a all \xB7 enter confirm");
 function bail(v) {
   if (isCancel2(v)) {
     cancel("Cancelled.");
@@ -1327,9 +1513,19 @@ async function promptCreate(registry, defaults) {
     bail(pyRaw);
     pyPm = pyRaw;
   }
-  const ok = await confirm2({
-    message: `Scaffold ${apps.join(" + ")}${modules.length ? " with " + modules.join(", ") : ""} into ${outDir}?`
-  });
+  const row = (k, v) => `${pc2.dim(k.padEnd(8))} ${v}`;
+  const tooling = [anyJs ? jsPm : null, apps.includes("server") ? pyPm : null].filter(Boolean).join(pc2.dim(" \xB7 "));
+  note(
+    [
+      row("project", pc2.bold(projectName)),
+      row("where", outDir),
+      row("apps", apps.join(pc2.dim(" \xB7 "))),
+      row("add-ons", modules.length ? modules.join(pc2.dim(" \xB7 ")) : pc2.dim("none")),
+      row("tooling", tooling)
+    ].join("\n"),
+    "Review"
+  );
+  const ok = await confirm2({ message: "Scaffold this?" });
   bail(ok);
   if (!ok) {
     cancel("Cancelled.");
@@ -1339,6 +1535,21 @@ async function promptCreate(registry, defaults) {
 }
 
 // src/commands/create.ts
+function isInsideGitRepo(dir) {
+  return spawnSync3("git", ["rev-parse", "--is-inside-work-tree"], { cwd: dir, stdio: "ignore" }).status === 0;
+}
+function initGit(dir) {
+  if (spawnSync3("git", ["init", "-b", "main"], { cwd: dir, stdio: "ignore" }).status !== 0) {
+    spawnSync3("git", ["init"], { cwd: dir, stdio: "ignore" });
+    spawnSync3("git", ["branch", "-M", "main"], { cwd: dir, stdio: "ignore" });
+  }
+  spawnSync3("git", ["add", "-A"], { cwd: dir, stdio: "ignore" });
+  const msg = "Initial commit (scaffolded with partweave)";
+  const opts = { cwd: dir, stdio: "ignore" };
+  if (spawnSync3("git", ["commit", "-m", msg], opts).status === 0) return true;
+  const id = ["-c", "user.name=partweave", "-c", "user.email=partweave@users.noreply.github.com"];
+  return spawnSync3("git", [...id, "commit", "-m", msg], opts).status === 0;
+}
 function resolvePm(value, allowed, detect, flag) {
   if (value === void 0) return detect();
   if (allowed.includes(value)) return value;
@@ -1360,7 +1571,8 @@ function defaultModules(registry, apps) {
   return registry.features().filter((m) => m.manifest.default).filter((m) => m.manifest.targets.some((t) => present.has(t))).filter((m) => m.manifest.requiresApps.every((a) => apps.includes(a))).map((m) => m.manifest.id);
 }
 async function runCreate(flags) {
-  intro(pc2.bgCyan(pc2.black(" partweave ")) + pc2.dim(" full-stack scaffolder"));
+  console.log("\n" + renderBanner());
+  intro(pc3.dim("full-stack scaffolder \u2014 pick the parts, own the code"));
   const registry = new Registry();
   const flagApps = appsFromFlags(flags);
   const nonInteractive = flags.yes === true || flagApps !== null;
@@ -1461,6 +1673,27 @@ async function runCreate(flags) {
       installed = false;
     }
   }
+  let gitInitialized = false;
+  const gitAvailable = hasCommand("git");
+  const alreadyRepo = gitAvailable && isInsideGitRepo(choices.outDir);
+  let wantGit;
+  if (flags.git !== void 0) {
+    wantGit = flags.git;
+  } else if (nonInteractive) {
+    wantGit = false;
+  } else {
+    const ans = await confirm3({ message: "Initialize a git repository?" });
+    wantGit = !isCancel3(ans) && ans === true;
+  }
+  if (wantGit && gitAvailable && !alreadyRepo) {
+    gitInitialized = initGit(choices.outDir);
+    if (gitInitialized) log2.success("Initialized a git repository (branch main, initial commit).");
+    else log2.warn("Couldn't create the initial git commit \u2014 the repo was left uninitialized.");
+  } else if (wantGit && !gitAvailable) {
+    log2.warn("git isn't installed \u2014 skipped repository initialization.");
+  } else if (wantGit && alreadyRepo) {
+    log2.info("Target is already inside a git repository \u2014 skipped `git init`.");
+  }
   const rel = basename(choices.outDir);
   const hasDocker = resolved.modules.includes("docker");
   const steps = [`cd ${rel}`];
@@ -1471,12 +1704,12 @@ async function runCreate(flags) {
   }
   if (choices.apps.includes("web")) steps.push("npm run web");
   if (choices.apps.includes("mobile")) steps.push("npm run mobile");
-  note(
-    steps.join("\n") + "\n\n" + pc2.dim("These work on macOS, Linux & Windows. On macOS/Linux, `make <task>` works too."),
+  note2(
+    steps.join("\n") + "\n\n" + pc3.dim("These work on macOS, Linux & Windows. On macOS/Linux, `make <task>` works too."),
     "Next steps"
   );
-  if (result.notes.length) note(result.notes.join("\n"), "Notes");
-  outro(pc2.green("Done."));
+  if (result.notes.length) note2(result.notes.join("\n"), "Notes");
+  outro(pc3.green("Done."));
 }
 
 export {
@@ -1496,4 +1729,4 @@ export {
   validateApps,
   runCreate
 };
-//# sourceMappingURL=chunk-ANKGMR2Z.js.map
+//# sourceMappingURL=chunk-I2IJROBO.js.map

package/dist/create-bin.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runCreate
-} from "./chunk-ANKGMR2Z.js";
+} from "./chunk-I2IJROBO.js";
 
 // src/create-bin.ts
 import { Command } from "commander";

package/dist/index.js

@@ -15,7 +15,7 @@ import {
   selectedTargets,
   validateApps,
   writeProjectManifest
-} from "./chunk-ANKGMR2Z.js";
+} from "./chunk-I2IJROBO.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -178,7 +178,7 @@ async function runDoctor(flags) {
 function buildProgram() {
   const program = new Command();
   program.name("partweave").description("A modular full-stack scaffolder \u2014 pick parts, generate only that code.").version("0.1.0");
-  program.command("create", { isDefault: true }).argument("[name]", "project name").description("Scaffold a new project").option("-d, --dir <path>", "target directory").option("--server", "include the Django server").option("--no-server", "exclude the server").option("--web", "include the Next.js web app").option("--no-web", "exclude the web app").option("--mobile", "include the Expo mobile app").option("--no-mobile", "exclude the mobile app").option("--with <ids>", "comma-separated component ids (e.g. auth,docker,ci)").option("--js-pm <pm>", "JS package manager: pnpm | npm (default: auto-detect)").option("--py-pm <pm>", "Python package manager: uv | pip (default: auto-detect)").option("-y, --yes", "skip prompts; use flags/defaults").option("-f, --force", "write into a non-empty directory").option("--install", "install dependencies after scaffolding (default: ask, off with --yes)").action(async (name, opts) => {
+  program.command("create", { isDefault: true }).argument("[name]", "project name").description("Scaffold a new project").option("-d, --dir <path>", "target directory").option("--server", "include the Django server").option("--no-server", "exclude the server").option("--web", "include the Next.js web app").option("--no-web", "exclude the web app").option("--mobile", "include the Expo mobile app").option("--no-mobile", "exclude the mobile app").option("--with <ids>", "comma-separated component ids (e.g. auth,docker,ci)").option("--js-pm <pm>", "JS package manager: pnpm | npm (default: auto-detect)").option("--py-pm <pm>", "Python package manager: uv | pip (default: auto-detect)").option("-y, --yes", "skip prompts; use flags/defaults").option("-f, --force", "write into a non-empty directory").option("--install", "install dependencies after scaffolding (default: ask, off with --yes)").option("--git", "initialize a git repo + initial commit (default: ask, off with --yes)").option("--no-git", "skip git initialization").action(async (name, opts) => {
     const flags = { ...opts, name: name ?? opts.name };
     await runCreate(flags);
   });

package/modules/db-postgres/module.json

@@ -16,7 +16,7 @@
     }
   },
   "notes": [
-    "PostgreSQL: set DATABASE_URL in .env (already added to .env.example).",
+    "PostgreSQL: DATABASE_URL lives in apps/server/.env (created for you, with a matching .env.example).",
     "Need a local database? Include the 'docker' component and run `make db-up`."
   ]
 }

package/modules/docker/module.json

@@ -14,6 +14,6 @@
   },
   "notes": [
     "Local DB: `make db-up` (docker compose). Server image: `docker build apps/server`.",
-    "Postgres creds/port come from .env (POSTGRES_USER/PASSWORD/DB/PORT); keep them in sync with DATABASE_URL."
+    "Postgres creds/port come from the root `.env` (POSTGRES_USER/PASSWORD/DB/PORT); keep them in sync with DATABASE_URL in apps/server/.env."
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "partweave",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "A modular full-stack scaffolder — pick the parts you need (Django server, Next.js web, Expo mobile) and generate only that code, wired together.",
   "type": "module",
   "license": "Apache-2.0",