partweave 0.2.0 → 0.3.0

package/dist/{chunk-2IGBGILB.js → chunk-XB7H4V4J.js}

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 
 // src/commands/create.ts
+import { spawnSync as spawnSync3 } from "child_process";
 import { existsSync as existsSync5, readdirSync as readdirSync3 } from "fs";
 import { basename, resolve as resolve3 } from "path";
-import { intro, log, note, outro, spinner } from "@clack/prompts";
+import { confirm as confirm3, intro, isCancel as isCancel3, log as log2, note, outro, spinner as spinner2 } from "@clack/prompts";
 import pc2 from "picocolors";
 
 // src/compose.ts
@@ -42,6 +43,13 @@ function parseDep(dep) {
   }
   return { name: dep, version: "latest" };
 }
+function normalizeWorkspaceDeps(deps, workspaceRange) {
+  return deps.map((dep) => {
+    const { name, version } = parseDep(dep);
+    if (version.startsWith("workspace:")) return `${name}@${workspaceRange}`;
+    return dep;
+  });
+}
 function mergePackageJsonDeps(pkgJson, deps, field = "dependencies") {
   if (deps.length === 0) return pkgJson;
   const pkg = JSON.parse(pkgJson);
@@ -180,7 +188,8 @@ function jsPmProfile(name) {
       runAll: (script) => `npm run ${script} --workspaces --if-present`,
       packageManagerField: null,
       usesWorkspaceYaml: false,
-      needsHoistNpmrc: false
+      needsHoistNpmrc: false,
+      workspaceRange: "*"
     };
   }
   return {
@@ -190,7 +199,8 @@ function jsPmProfile(name) {
     runAll: (script) => `pnpm -r ${script}`,
     packageManagerField: PNPM_VERSION,
     usesWorkspaceYaml: true,
-    needsHoistNpmrc: true
+    needsHoistNpmrc: true,
+    workspaceRange: "workspace:*"
   };
 }
 var PIP_SYNC = "python3 -m venv .venv && .venv/bin/python -m pip install -U pip && .venv/bin/python scripts/sync_deps.py";
@@ -210,6 +220,34 @@ function pyPmProfile(name) {
     needsSyncScript: false
   };
 }
+function jsPmInstallPlan(pm) {
+  if (pm === "npm") return null;
+  return {
+    label: "Enabling pnpm via corepack",
+    cmd: "corepack",
+    args: ["enable", "pnpm"],
+    hint: "corepack enable pnpm   (or: npm i -g pnpm)"
+  };
+}
+function pyPmInstallPlan(pm) {
+  if (pm === "pip") return null;
+  if (process.platform === "win32") {
+    const ps = "irm https://astral.sh/uv/install.ps1 | iex";
+    return {
+      label: "Installing uv",
+      cmd: "powershell",
+      args: ["-ExecutionPolicy", "Bypass", "-c", ps],
+      hint: `powershell -ExecutionPolicy Bypass -c "${ps}"`
+    };
+  }
+  const sh = "curl -LsSf https://astral.sh/uv/install.sh | sh";
+  return {
+    label: "Installing uv",
+    cmd: "sh",
+    args: ["-c", sh],
+    hint: sh
+  };
+}
 function hasCommand(cmd) {
   try {
     const probe = process.platform === "win32" ? spawnSync("where", [cmd], { stdio: "ignore" }) : spawnSync("sh", ["-c", `command -v ${cmd}`], { stdio: "ignore" });
@@ -241,73 +279,206 @@ function buildJsWorkspace(ctx) {
   if (members.length === 0) return null;
   return "packages:\n" + members.map((m) => `  - "${m}"`).join("\n") + "\n";
 }
-function buildRootPackageJson(ctx) {
+function buildRootPackageJson(ctx, hasDocker) {
   const anyJs = ctx.hasWeb || ctx.hasMobile || ctx.hasShared;
-  if (!anyJs) return null;
+  if (!anyJs && !ctx.hasServer) return null;
   const pm = jsPmProfile(ctx.jsPm);
-  const scripts = {};
-  if (ctx.hasWeb) scripts["dev:web"] = pm.run("web", "dev");
-  if (ctx.hasMobile) scripts["dev:mobile"] = pm.run("mobile", "start");
-  if (ctx.hasApiClient) scripts["gen:api"] = pm.run("@app/api-client", "generate");
-  scripts["typecheck"] = pm.runAll("typecheck");
+  const t = (task) => `node scripts/run.mjs ${task}`;
+  const scripts = { bootstrap: t("bootstrap"), dev: t("dev") };
+  if (ctx.hasWeb) scripts["web"] = t("web");
+  if (ctx.hasMobile) scripts["mobile"] = t("mobile");
+  if (ctx.hasServer) {
+    scripts["server"] = t("server");
+    scripts["migrate"] = t("migrate");
+    scripts["superuser"] = t("superuser");
+    if (hasDocker) {
+      scripts["db:up"] = t("db:up");
+      scripts["db:down"] = t("db:down");
+    }
+  }
+  if (ctx.hasApiClient) scripts["gen:api"] = t("gen:api");
+  if (anyJs) scripts["typecheck"] = pm.runAll("typecheck");
   const pkg = {
     name: ctx.projectSlug,
     version: "0.1.0",
     private: true
   };
-  if (pm.packageManagerField) pkg.packageManager = pm.packageManagerField;
-  if (!pm.usesWorkspaceYaml) pkg.workspaces = jsMembers(ctx);
+  if (anyJs && pm.packageManagerField) pkg.packageManager = pm.packageManagerField;
+  if (anyJs && !pm.usesWorkspaceYaml) pkg.workspaces = jsMembers(ctx);
   pkg.scripts = scripts;
-  pkg.devDependencies = { typescript: "^5.7.2" };
+  if (anyJs) pkg.devDependencies = { typescript: "^5.7.2" };
   return JSON.stringify(pkg, null, 2) + "\n";
 }
+function buildTaskRunner(ctx, hasDocker) {
+  const anyJs = ctx.hasWeb || ctx.hasMobile || ctx.hasShared;
+  const npm = ctx.jsPm === "npm";
+  const pip = ctx.pyPm === "pip";
+  const jsInstall = npm ? `run("npm", ["install"])` : `run("pnpm", ["install"])`;
+  const jsRun = (pkg, script) => npm ? `run("npm", ["run", "${script}", "-w", "${pkg}"])` : `run("pnpm", ["--filter", "${pkg}", "${script}"])`;
+  const pyManage = (...sub) => {
+    const args = sub.map((s) => `"${s}"`).join(", ");
+    return ctx.pyPm === "uv" ? `run("uv", ["run", "python", "manage.py", ${args}], SERVER)` : `run(venvPy, ["manage.py", ${args}], SERVER)`;
+  };
+  const serverDev = ctx.pyPm === "uv" ? `["uv", ["run", "python", "manage.py", "runserver", "0.0.0.0:8000"], SERVER]` : `[venvPy, ["manage.py", "runserver", "0.0.0.0:8000"], SERVER]`;
+  const jsDevTuple = (pkg, script) => npm ? `["npm", ["run", "${script}", "-w", "${pkg}"]]` : `["pnpm", ["--filter", "${pkg}", "${script}"]]`;
+  const devTuples = [];
+  if (ctx.hasServer) devTuples.push(serverDev);
+  if (ctx.hasWeb) devTuples.push(jsDevTuple("web", "dev"));
+  if (ctx.hasMobile) devTuples.push(jsDevTuple("mobile", "start"));
+  const needsParallel = devTuples.length > 1;
+  const L = [];
+  L.push(
+    `#!/usr/bin/env node`,
+    `// ${ctx.projectName} \u2014 cross-platform task runner (generated by partweave).`,
+    `// Run a task on any OS:  node scripts/run.mjs <task>`,
+    `// Also available as:     npm run <task>   \xB7   make <task> (on macOS/Linux)`,
+    needsParallel ? `import { spawn, spawnSync } from "node:child_process";` : `import { spawnSync } from "node:child_process";`,
+    `import { existsSync } from "node:fs";`,
+    ``,
+    `const isWin = process.platform === "win32";`,
+    `const SERVER = { cwd: "apps/server" };`
+  );
+  if (ctx.hasServer && pip) {
+    L.push(`const venvPy = isWin ? ".venv\\\\Scripts\\\\python.exe" : ".venv/bin/python";`);
+  }
+  L.push(
+    ``,
+    `// Windows must spawn Node's .cmd shims through a shell; POSIX doesn't.`,
+    `function run(cmd, args = [], opts = {}) {`,
+    `  const r = spawnSync(cmd, args, { stdio: "inherit", shell: isWin, ...opts });`,
+    `  if (r.error) { console.error("\\u2716 " + cmd + ": " + r.error.message); process.exit(1); }`,
+    `  if (r.status) process.exit(r.status);`,
+    `}`,
+    `function has(cmd) {`,
+    `  const p = isWin`,
+    `    ? spawnSync("where", [cmd], { stdio: "ignore" })`,
+    `    : spawnSync("sh", ["-c", "command -v " + cmd], { stdio: "ignore" });`,
+    `  return p.status === 0;`,
+    `}`,
+    ``
+  );
+  if (needsParallel) {
+    L.push(
+      `// Run several long-lived dev servers at once; Ctrl-C stops them all.`,
+      `function parallel(specs) {`,
+      `  const kids = specs.map(([cmd, args, opts = {}]) =>`,
+      `    spawn(cmd, args, { stdio: "inherit", shell: isWin, ...opts }));`,
+      `  const stop = () => kids.forEach((k) => k.kill());`,
+      `  process.on("SIGINT", stop);`,
+      `  process.on("SIGTERM", stop);`,
+      `  kids.forEach((k) => k.on("exit", (code) => { if (code) { stop(); process.exit(code); } }));`,
+      `}`,
+      ``
+    );
+  }
+  const ensure = [];
+  if (anyJs && ctx.jsPm === "pnpm") {
+    ensure.push(
+      `  if (!has("pnpm")) {`,
+      `    console.log("pnpm not found \\u2014 enabling it via corepack\\u2026");`,
+      `    spawnSync("corepack", ["enable", "pnpm"], { stdio: "inherit", shell: isWin });`,
+      `    if (!has("pnpm")) { console.error("Could not enable pnpm. Install it with: npm i -g pnpm"); process.exit(1); }`,
+      `  }`
+    );
+  }
+  if (ctx.hasServer && ctx.pyPm === "uv") {
+    ensure.push(
+      `  if (!has("uv")) {`,
+      `    console.error("uv not found. Install it, then re-run bootstrap:\\n  " + (isWin`,
+      `      ? 'powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"'`,
+      `      : "curl -LsSf https://astral.sh/uv/install.sh | sh"));`,
+      `    process.exit(1);`,
+      `  }`
+    );
+  }
+  if (ctx.hasServer && pip) {
+    ensure.push(
+      `  if (!has("python3") && !has("python")) { console.error("Python 3 not found. Install Python 3.12+ and re-run."); process.exit(1); }`
+    );
+  }
+  L.push(
+    `function ensureTools() {`,
+    ...ensure.length ? ensure : [`  // npm and pip ship with Node and Python respectively.`],
+    `}`,
+    ``
+  );
+  if (ctx.hasServer && pip) {
+    L.push(
+      `function pipSync() {`,
+      `  const py = has("python3") ? "python3" : "python";`,
+      `  run(py, ["-m", "venv", ".venv"], SERVER);`,
+      `  run(venvPy, ["-m", "pip", "install", "-U", "pip"], SERVER);`,
+      `  run(venvPy, ["scripts/sync_deps.py"], SERVER);`,
+      `}`,
+      ``
+    );
+  }
+  L.push(`const tasks = {`);
+  const boot = [`    ensureTools();`];
+  if (anyJs) boot.push(`    ${jsInstall};`);
+  if (ctx.hasServer) boot.push(pip ? `    pipSync();` : `    run("uv", ["sync"], SERVER);`);
+  L.push(`  bootstrap() {`, ...boot, `  },`);
+  if (devTuples.length === 1) {
+    L.push(`  dev() { const [c, a, o = {}] = ${devTuples[0]}; run(c, a, o); },`);
+  } else if (devTuples.length > 1) {
+    L.push(`  dev() { parallel([${devTuples.join(", ")}]); },`);
+  }
+  if (ctx.hasWeb) L.push(`  web() { ${jsRun("web", "dev")}; },`);
+  if (ctx.hasMobile) L.push(`  mobile() { ${jsRun("mobile", "start")}; },`);
+  if (ctx.hasServer) {
+    L.push(`  server() { ${pyManage("runserver", "0.0.0.0:8000")}; },`);
+    L.push(`  migrate() { ${pyManage("migrate")}; },`);
+    L.push(`  superuser() { ${pyManage("createsuperuser")}; },`);
+    if (hasDocker) {
+      L.push(
+        `  "db:up"() {`,
+        `    if (spawnSync("docker", ["info"], { stdio: "ignore", shell: isWin }).status) {`,
+        `      console.error("Docker isn't running \\u2014 start Docker Desktop and retry."); process.exit(1);`,
+        `    }`,
+        `    const env = existsSync(".env") ? ["--env-file", ".env"] : [];`,
+        `    run("docker", ["compose", ...env, "-f", "infra/docker-compose.yml", "up", "-d", "db"]);`,
+        `  },`,
+        `  "db:down"() { run("docker", ["compose", "-f", "infra/docker-compose.yml", "down"]); },`
+      );
+    }
+  }
+  if (ctx.hasApiClient) L.push(`  "gen:api"() { ${jsRun("@app/api-client", "generate")}; },`);
+  L.push(`};`, ``);
+  L.push(
+    `const task = process.argv[2];`,
+    `if (!task || !Object.hasOwn(tasks, task)) {`,
+    `  console.log("Tasks: " + Object.keys(tasks).join(", "));`,
+    `  process.exit(task ? 1 : 0);`,
+    `}`,
+    `tasks[task]();`,
+    ``
+  );
+  return L.join("\n");
+}
 function buildMakefile(ctx, hasDocker) {
-  const js = jsPmProfile(ctx.jsPm);
-  const py = pyPmProfile(ctx.pyPm);
   const L = [];
   const phony = [];
-  const add = (name, body, help) => {
+  const add = (name, task, help) => {
     phony.push(name);
-    L.push(`${name}: ## ${help}`);
-    for (const line of body) L.push(`	${line}`);
-    L.push("");
+    L.push(`${name}: ## ${help}`, `	node scripts/run.mjs ${task}`, "");
   };
-  L.push("# " + ctx.projectName + " \u2014 dev tasks");
+  L.push("# " + ctx.projectName + " \u2014 dev tasks (wrappers around scripts/run.mjs)");
   L.push(".DEFAULT_GOAL := help");
   L.push("");
-  const bootstrap = [];
-  if (ctx.hasWeb || ctx.hasMobile || ctx.hasShared) bootstrap.push(js.install);
-  if (ctx.hasServer) bootstrap.push(`cd apps/server && ${py.syncInServer}`);
-  if (bootstrap.length) add("bootstrap", bootstrap, "install all dependencies");
+  add("bootstrap", "bootstrap", "install all dependencies");
+  add("dev", "dev", "run all dev servers");
   if (ctx.hasServer) {
     if (hasDocker) {
-      add(
-        "db-up",
-        [
-          `@docker info >/dev/null 2>&1 || { echo "Docker isn't running \u2014 start Docker Desktop and wait for it to be ready, then retry."; exit 1; }`,
-          // Load the project's .env (if present) so POSTGRES_* there drive the container.
-          "docker compose $$([ -f .env ] && echo --env-file .env) -f infra/docker-compose.yml up -d db"
-        ],
-        "start Postgres (needs Docker running)"
-      );
-      add("db-down", ["docker compose -f infra/docker-compose.yml down"], "stop Postgres");
+      add("db-up", "db:up", "start Postgres (needs Docker running)");
+      add("db-down", "db:down", "stop Postgres");
     }
-    add("migrate", [`cd apps/server && ${py.run("python manage.py migrate")}`], "run migrations");
-    add(
-      "server",
-      [`cd apps/server && ${py.run("python manage.py runserver 0.0.0.0:8000")}`],
-      "run the Django dev server"
-    );
-    add(
-      "superuser",
-      [`cd apps/server && ${py.run("python manage.py createsuperuser")}`],
-      "create an admin user"
-    );
+    add("migrate", "migrate", "run migrations");
+    add("server", "server", "run the Django dev server");
+    add("superuser", "superuser", "create an admin user");
   }
-  if (ctx.hasWeb) add("web", [js.run("web", "dev")], "run the Next.js dev server");
-  if (ctx.hasMobile) add("mobile", [js.run("mobile", "start")], "run the Expo dev server");
-  if (ctx.hasApiClient)
-    add("gen-api", [js.run("@app/api-client", "generate")], "regenerate the typed API client");
+  if (ctx.hasWeb) add("web", "web", "run the Next.js dev server");
+  if (ctx.hasMobile) add("mobile", "mobile", "run the Expo dev server");
+  if (ctx.hasApiClient) add("gen-api", "gen:api", "regenerate the typed API client");
   L.push(
     "help: ## show this help",
     `	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "  \\033[36m%-12s\\033[0m %s\\n", $$1, $$2}'`,
@@ -507,10 +678,22 @@ function buildReadme(ctx, modules) {
     for (const m of modules) parts.push(`- **${m.manifest.title}** \u2014 ${m.manifest.description ?? ""}`);
     parts.push("");
   }
-  parts.push("## Getting started", "", "```sh", "make bootstrap");
-  if (ctx.hasServer) parts.push("make db-up && make migrate", "make server   # http://localhost:8000");
-  if (ctx.hasWeb) parts.push("make web      # http://localhost:3000");
-  if (ctx.hasMobile) parts.push("make mobile   # Expo dev server");
+  parts.push(
+    "## Getting started",
+    "",
+    "These `npm run` tasks work the same on macOS, Linux, and Windows (they wrap",
+    "`scripts/run.mjs`). On macOS/Linux you can also use `make <task>`.",
+    "",
+    "```sh",
+    "npm run bootstrap"
+  );
+  const hasDocker = modules.some((m) => m.manifest.id === "docker");
+  if (ctx.hasServer) {
+    if (hasDocker) parts.push("npm run db:up        # start Postgres (needs Docker)");
+    parts.push("npm run migrate", "npm run server   # http://localhost:8000");
+  }
+  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.", "");
   return parts.join("\n");
@@ -729,7 +912,7 @@ function injectIntoFiles(index, anchorId, lines, targetLabel) {
     writeFileSync2(file, next);
   }
 }
-function applyWiring(outDir, targets, modules) {
+function applyWiring(outDir, targets, modules, workspaceRange) {
   const indexes = /* @__PURE__ */ new Map();
   for (const t of targets) {
     indexes.set(t, buildAnchorIndex(join2(outDir, TARGET_DEST[t])));
@@ -753,7 +936,7 @@ function applyWiring(outDir, targets, modules) {
           if (existsSync2(pkgPath)) {
             const merged = mergePackageJsonDeps(
               readFileSync2(pkgPath, "utf8"),
-              wiring.deps
+              normalizeWorkspaceDeps(wiring.deps, workspaceRange)
             );
             writeFileSync2(pkgPath, merged);
           }
@@ -774,7 +957,8 @@ function applyEnv(outDir, modules) {
 function writeStructuralRootFiles(outDir, ctx, modules) {
   const workspace = buildJsWorkspace(ctx);
   if (workspace) writeFileEnsured(join2(outDir, "pnpm-workspace.yaml"), workspace);
-  const rootPkg = buildRootPackageJson(ctx);
+  const hasDocker = modules.some((m) => m.manifest.id === "docker");
+  const rootPkg = buildRootPackageJson(ctx, hasDocker);
   if (rootPkg) writeFileEnsured(join2(outDir, "package.json"), rootPkg);
   const turbo = buildTurboJson(ctx);
   if (turbo) writeFileEnsured(join2(outDir, "turbo.json"), turbo);
@@ -784,7 +968,7 @@ function writeStructuralRootFiles(outDir, ctx, modules) {
   if (npmrc) writeFileEnsured(join2(outDir, ".npmrc"), npmrc);
   const pipSync = buildPipSyncScript(ctx);
   if (pipSync) writeFileEnsured(join2(outDir, "apps/server/scripts/sync_deps.py"), pipSync);
-  const hasDocker = modules.some((m) => m.manifest.id === "docker");
+  writeFileEnsured(join2(outDir, "scripts/run.mjs"), buildTaskRunner(ctx, hasDocker));
   writeFileEnsured(join2(outDir, "Makefile"), buildMakefile(ctx, hasDocker));
   writeFileEnsured(join2(outDir, ".env.example"), buildBaseEnv(ctx));
 }
@@ -814,7 +998,7 @@ function compose(opts) {
       }
     }
   }
-  applyWiring(outDir, wireTargets, modules);
+  applyWiring(outDir, wireTargets, modules, jsPmProfile(ctx.jsPm).workspaceRange);
   applyEnv(outDir, modules);
   if (selection.modules.includes("ci")) {
     for (const [rel, content] of Object.entries(buildCiWorkflows(ctx))) {
@@ -831,6 +1015,43 @@ function compose(opts) {
   return { written, notes };
 }
 
+// src/preflight.ts
+import { spawnSync as spawnSync2 } from "child_process";
+import { confirm, isCancel, log, spinner } from "@clack/prompts";
+function runInstall(plan, probe) {
+  const s = spinner();
+  s.start(plan.label);
+  const r = spawnSync2(plan.cmd, plan.args, {
+    stdio: ["ignore", "ignore", "inherit"],
+    shell: process.platform === "win32"
+  });
+  const ok = r.status === 0 && hasCommand(probe);
+  s.stop(ok ? `${probe} is ready` : `Could not install ${probe}`);
+  return ok;
+}
+async function ensurePm(chosen, fallback, plan, opts) {
+  if (hasCommand(chosen)) return chosen;
+  if (!plan) return chosen;
+  let doInstall = opts.install === true;
+  if (opts.interactive) {
+    const answer = await confirm({
+      message: `${chosen} isn't installed. Install it now?  (${plan.hint})`
+    });
+    doInstall = !isCancel(answer) && answer === true;
+  }
+  if (doInstall && runInstall(plan, chosen)) return chosen;
+  log.warn(
+    `Using ${fallback} instead of ${chosen}. To use ${chosen} later, run:  ${plan.hint}`
+  );
+  return fallback;
+}
+function ensureJsPm(pm, opts) {
+  return ensurePm(pm, "npm", jsPmInstallPlan(pm), opts);
+}
+function ensurePyPm(pm, opts) {
+  return ensurePm(pm, "pip", pyPmInstallPlan(pm), opts);
+}
+
 // src/registry.ts
 import { readdirSync as readdirSync2, readFileSync as readFileSync3, statSync as statSync2 } from "fs";
 import { join as join4 } from "path";
@@ -1004,8 +1225,8 @@ Enable the required app(s) or drop the component(s).`
 // src/prompts.ts
 import {
   cancel,
-  confirm,
-  isCancel,
+  confirm as confirm2,
+  isCancel as isCancel2,
   multiselect,
   select,
   text
@@ -1014,7 +1235,7 @@ import pc 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");
 function bail(v) {
-  if (isCancel(v)) {
+  if (isCancel2(v)) {
     cancel("Cancelled.");
     process.exit(0);
   }
@@ -1092,7 +1313,7 @@ async function promptCreate(registry, defaults) {
     bail(pyRaw);
     pyPm = pyRaw;
   }
-  const ok = await confirm({
+  const ok = await confirm2({
     message: `Scaffold ${apps.join(" + ")}${modules.length ? " with " + modules.join(", ") : ""} into ${outDir}?`
   });
   bail(ok);
@@ -1107,7 +1328,7 @@ async function promptCreate(registry, defaults) {
 function resolvePm(value, allowed, detect, flag) {
   if (value === void 0) return detect();
   if (allowed.includes(value)) return value;
-  log.error(`Invalid ${flag} "${value}". Choose one of: ${allowed.join(", ")}.`);
+  log2.error(`Invalid ${flag} "${value}". Choose one of: ${allowed.join(", ")}.`);
   process.exit(1);
 }
 function appsFromFlags(flags) {
@@ -1149,26 +1370,33 @@ async function runCreate(flags) {
     });
   }
   if (existsSync5(choices.outDir) && readdirSync3(choices.outDir).length > 0 && !flags.force) {
-    log.error(`${choices.outDir} exists and is not empty. Use --force to override.`);
+    log2.error(`${choices.outDir} exists and is not empty. Use --force to override.`);
     process.exit(1);
   }
+  const ensureOpts = { interactive: !nonInteractive, install: flags.install };
+  if (choices.apps.includes("web") || choices.apps.includes("mobile")) {
+    choices.jsPm = await ensureJsPm(choices.jsPm, ensureOpts);
+  }
+  if (choices.apps.includes("server")) {
+    choices.pyPm = await ensurePyPm(choices.pyPm, ensureOpts);
+  }
   let resolved;
   try {
     resolved = resolveModules(registry, choices.modules);
   } catch (err) {
-    log.error(err.message);
+    log2.error(err.message);
     process.exit(1);
   }
   if (resolved.autoAdded.length) {
-    log.info(`Added required components: ${resolved.autoAdded.join(", ")}`);
+    log2.info(`Added required components: ${resolved.autoAdded.join(", ")}`);
   }
   try {
     validateApps(registry, resolved.modules, choices.apps);
   } catch (err) {
-    log.error(err.message);
+    log2.error(err.message);
     process.exit(1);
   }
-  const s = spinner();
+  const s = spinner2();
   s.start("Scaffolding");
   let result;
   try {
@@ -1190,7 +1418,7 @@ async function runCreate(flags) {
     });
   } catch (err) {
     s.stop("Failed");
-    log.error(err.message);
+    log2.error(err.message);
     process.exit(1);
   }
   s.stop(`Created ${result.written.length} files`);
@@ -1201,25 +1429,52 @@ async function runCreate(flags) {
     jsPm: choices.jsPm,
     pyPm: choices.pyPm
   });
+  let installed = false;
+  if (nonInteractive) {
+    installed = flags.install === true;
+  } else {
+    const ans = await confirm3({ message: "Install dependencies now?" });
+    installed = !isCancel3(ans) && ans === true;
+  }
+  if (installed) {
+    log2.step("Installing dependencies (npm run bootstrap)\u2026");
+    const r = spawnSync3("node", ["scripts/run.mjs", "bootstrap"], {
+      cwd: choices.outDir,
+      stdio: "inherit"
+    });
+    if (r.status) {
+      log2.warn("bootstrap didn't finish cleanly \u2014 run `npm run bootstrap` in the project to retry.");
+      installed = false;
+    }
+  }
   const rel = basename(choices.outDir);
-  const steps = [`cd ${rel}`, "make bootstrap"];
-  if (choices.apps.includes("server")) steps.push("make db-up && make migrate", "make server");
-  if (choices.apps.includes("web")) steps.push("make web");
-  if (choices.apps.includes("mobile")) steps.push("make mobile");
-  note(steps.join("\n"), "Next steps");
+  const hasDocker = resolved.modules.includes("docker");
+  const steps = [`cd ${rel}`];
+  if (!installed) steps.push("npm run bootstrap");
+  if (choices.apps.includes("server")) {
+    steps.push(hasDocker ? "npm run db:up && npm run migrate" : "npm run migrate");
+    steps.push("npm run server");
+  }
+  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."),
+    "Next steps"
+  );
   if (result.notes.length) note(result.notes.join("\n"), "Notes");
   outro(pc2.green("Done."));
 }
 
 export {
-  DEFAULT_JS_PM,
-  DEFAULT_PY_PM,
-  jsPmProfile,
-  pyPmProfile,
+  jsPmInstallPlan,
+  pyPmInstallPlan,
+  hasCommand,
   APPS,
   buildContext,
   selectedTargets,
   compose,
+  ensureJsPm,
+  ensurePyPm,
   Registry,
   readProjectManifest,
   writeProjectManifest,
@@ -1227,4 +1482,4 @@ export {
   validateApps,
   runCreate
 };
-//# sourceMappingURL=chunk-2IGBGILB.js.map
+//# sourceMappingURL=chunk-XB7H4V4J.js.map

package/dist/create-bin.js

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

package/dist/index.js

@@ -1,20 +1,21 @@
 #!/usr/bin/env node
 import {
   APPS,
-  DEFAULT_JS_PM,
-  DEFAULT_PY_PM,
   Registry,
   buildContext,
   compose,
-  jsPmProfile,
-  pyPmProfile,
+  ensureJsPm,
+  ensurePyPm,
+  hasCommand,
+  jsPmInstallPlan,
+  pyPmInstallPlan,
   readProjectManifest,
   resolveModules,
   runCreate,
   selectedTargets,
   validateApps,
   writeProjectManifest
-} from "./chunk-2IGBGILB.js";
+} from "./chunk-XB7H4V4J.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -54,13 +55,9 @@ async function runAdd(ids, flags) {
   let manifest = pm;
   if (appIds.length) manifest = addApps(registry, dir, manifest, appIds);
   if (moduleIds.length) manifest = addModules(registry, dir, manifest, moduleIds);
-  const js = jsPmProfile(manifest.jsPm ?? DEFAULT_JS_PM);
-  const py = pyPmProfile(manifest.pyPm ?? DEFAULT_PY_PM);
-  const reinstall = [];
-  if (manifest.apps.some((a) => a === "web" || a === "mobile")) reinstall.push(js.install);
-  if (manifest.apps.includes("server"))
-    reinstall.push(`cd apps/server && ${py.syncInServer} && ${py.run("python manage.py migrate")}`);
-  if (reinstall.length) note(reinstall.join("\n"), "Sync deps");
+  const reinstall = ["npm run bootstrap"];
+  if (manifest.apps.includes("server")) reinstall.push("npm run migrate");
+  note(reinstall.join("\n"), "Sync deps");
   outro(pc.green("Done."));
 }
 function addApps(registry, dir, pm, appIds) {
@@ -135,17 +132,62 @@ function addModules(registry, dir, pm, moduleIds) {
   return updated;
 }
 
+// src/commands/doctor.ts
+import { spawnSync } from "child_process";
+import { resolve as resolve2 } from "path";
+import { intro as intro2, note as note2, outro as outro2 } from "@clack/prompts";
+import pc2 from "picocolors";
+function version(cmd) {
+  const r = spawnSync(cmd, ["--version"], { encoding: "utf8" });
+  if (r.error || r.status !== 0) return null;
+  return (r.stdout || r.stderr || "").trim().split("\n")[0] ?? "";
+}
+async function runDoctor(flags) {
+  intro2(pc2.bgCyan(pc2.black(" partweave ")) + pc2.dim(" doctor"));
+  const dir = resolve2(flags.dir ?? process.cwd());
+  const project = readProjectManifest(dir);
+  const rows = [];
+  const check = (label, cmd, optional = false) => {
+    const v = version(cmd);
+    const ok = v !== null;
+    const mark = ok ? pc2.green("\u2713") : optional ? pc2.yellow("\u25CB") : pc2.red("\u2717");
+    const detail = ok ? pc2.dim(v) : pc2.dim(optional ? "not found (optional)" : "not found");
+    rows.push(`${mark} ${label.padEnd(9)} ${detail}`);
+    return ok;
+  };
+  check("node", "node");
+  check("npm", "npm");
+  check("pnpm", "pnpm", true);
+  check("uv", "uv", true);
+  check("python", process.platform === "win32" ? "python" : "python3", true);
+  check("docker", "docker", true);
+  check("make", "make", true);
+  note2(rows.join("\n"), project ? `Environment for ${project.name}` : "Environment");
+  const jsPm = project?.jsPm ?? "pnpm";
+  const pyPm = project?.pyPm ?? "uv";
+  if (jsPmInstallPlan(jsPm) && !hasCommand(jsPm)) {
+    await ensureJsPm(jsPm, { interactive: true });
+  }
+  if (pyPmInstallPlan(pyPm) && !hasCommand(pyPm)) {
+    await ensurePyPm(pyPm, { interactive: true });
+  }
+  outro2(pc2.green("Done."));
+}
+
 // src/index.ts
 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").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)").action(async (name, opts) => {
     const flags = { ...opts, name: name ?? opts.name };
     await runCreate(flags);
   });
   program.command("add").argument("<items...>", "apps (server/web/mobile) or component ids to add").description("Add an app or component to an existing generated project").option("-d, --dir <path>", "project directory (default: cwd)").action(async (items, opts) => {
     await runAdd(items, opts);
   });
+  program.command("doctor").description("Check your environment and install any missing package managers").option("-d, --dir <path>", "project directory (default: cwd)").action(async (opts) => {
+    await runDoctor(opts);
+  });
   return program;
 }
 async function main(argv = process.argv) {
@@ -159,6 +201,7 @@ export {
   buildProgram,
   main,
   runAdd,
-  runCreate
+  runCreate,
+  runDoctor
 };
 //# sourceMappingURL=index.js.map

package/modules/_core/mobile/metro.config.js

@@ -13,6 +13,8 @@ config.resolver.nodeModulesPaths = [
   path.resolve(projectRoot, "node_modules"),
   path.resolve(workspaceRoot, "node_modules"),
 ];
-config.resolver.disableHierarchicalLookup = true;
+// Keep Metro's default hierarchical node_modules lookup ON: under npm (and any
+// non-hoisted install) some Expo sub-deps (e.g. expo-asset) resolve from
+// expo/node_modules, and disabling the walk-up breaks bundling them.
 
 module.exports = config;

package/modules/_core/mobile/package.json

@@ -29,8 +29,10 @@
     "@testing-library/react-native": "^13.2.0",
     "@types/jest": "^29.5.14",
     "@types/react": "~19.1.10",
+    "babel-preset-expo": "~54.0.7",
     "jest": "^29.7.0",
     "jest-expo": "~54.0.0",
+    "react-test-renderer": "19.1.0",
     "typescript": "~5.9.2"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "partweave",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "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": "MIT",